Служебные команды¶

Эти команды не принимают аргументов и не входят в YAML-профиль.

Команда	Действие
`keys`	прочитать живой кадр подсветки
`off`	выключить подсветку
`default`	вендорский payload по умолчанию
`reset`	USB port reset
`version`	версия утилиты

keys¶

./katana.py keys

Читает текущие цвета всех 143 слотов с учётом яркости и активных анимаций. Результат печатается сеткой по 16 слотов в строке, ...... означает чёрный цвет.

Чтение использует канал 04 f5 и делает save, поэтому кадр читается около 0,6 секунды. Схема чтения описана в разделе Раскраска клавиш.

off¶

Выключает подсветку: отправляет payload из нулей и признак aa55.

default¶

Отправляет вендорский payload по умолчанию: режим 0x80 с пустой таблицей. Это не полный заводской сброс: макросы и переназначения команда не трогает.

reset¶

Выполняет USB port reset, чтобы снять залипание прошивки. Клавиатура не отваливается от системы, переподключение занимает около 2–12 секунд.

Если reset не помог с первого раза, повторите его с паузой 5–10 секунд.

version¶

./katana.py version

Печатает версию утилиты, например katana.py 1.0.0. Это единственная команда, которой не нужна клавиатура: устройство не открывается, поэтому команда работает без подключённой клавиатуры и без udev-правила.

Версия хранится в константе VERSION файла katana.py.

Решение проблем¶

Сначала проверьте версию: ./katana.py version. Если команда не отвечает, проблема в запуске утилиты, а не в устройстве.
Команда отклоняется со статусом 00 или ff — сессия залипла. Повторите команду, затем выполните ./katana.py reset.
reset не помог — выключите и включите клавиатуру физически.
Подробности и все известные грабли — в разделе Транспорт и транзакции.

Если не работает доступ к устройству, проверьте udev-правило по разделу Установка.