KasperskyOS Community Edition 1.3
Русский
KasperskyOS API > Библиотека libkos > Управление драйвером XHCI DbC ядра KasperskyOS (xhcidbg_api.h)

Управление драйвером XHCI DbC ядра KasperskyOS (xhcidbg_api.h)

API определен в заголовочном файле sysroot-*-kos/include/coresrv/xhcidbg/xhcidbg_api.h из состава KasperskyOS SDK.

API предназначен для использования в коде драйверов, реализующих стек USB (драйверов класса kusb), и позволяет останавливать и запускать драйвер XHCI DbC (Debug Capability) ядра KasperskyOS. (Ядро KasperskyOS включает драйвер XHCI DbC, который представляет собой упрощенный драйвер контроллера XHCI и используется ядром для диагностического вывода либо GDB-сервером ядра для взаимодействия с отладчиком GDB.) Если драйверу класс kusb нужно перезагрузить контроллер XHCI, то драйвер XHCI DbC ядра необходимо остановить вызовом функции KnXhcidbgStop() перед перезагрузкой и запустить вызовом функции KnXhcidbgStart() после перезагрузки. Если этого не сделать, перезагрузка контроллера XHCI приведет к невозможности выполнять диагностический вывод (или отладку) через порт USB.

Для аппаратных платформ Raspberry Pi 4 B и Radxa ROCK 3A API не реализован (функции возвращают rcUnimplemented).

Сведения о функциях API приведены в таблице ниже.

Функции xhcidbg_api.h

Функция

Сведения о функции

KnXhcidbgStart()

Назначение

Запускает драйвер XHCI DbC ядра KasperskyOS.

Параметры

Нет.

Возвращаемые значения

В случае успеха возвращает rcOk, иначе возвращает код ошибки.

KnXhcidbgStop()

Назначение

Останавливает драйвер XHCI DbC ядра KasperskyOS.

Параметры

Нет.

Возвращаемые значения

В случае успеха возвращает rcOk, иначе возвращает код ошибки.

Идентификатор статьи: libkos_xhcidbg_api, Последнее изменение: 27 янв. 2025 г.
В начало