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
Функция |
Сведения о функции |
|---|---|
|
Назначение Запускает драйвер XHCI DbC ядра KasperskyOS. Параметры Нет. Возвращаемые значения В случае успеха возвращает |
|
Назначение Останавливает драйвер XHCI DbC ядра KasperskyOS. Параметры Нет. Возвращаемые значения В случае успеха возвращает |