Команды¶

Все команды идут через транзакцию begin → data → commit → save и безопасны: печать не прерывается, прошивка остаётся живой. Исключение — macro set и macro clear: вендор после записи макросов save не делает, поэтому в проекте сохранение включается ключом --save.

Справочник¶

Команда	Назначение	Страница
`mode`	Включить режим подсветки	mode
`paint`	Раскрасить клавиши	paint
`remap`	Переназначить клавиши	remap
`macro`	Записать макросы и работать с XML	macro
`apply`	Применить YAML-профиль	apply
`raw`	Отправить произвольный payload	raw и scan
`scan`	Перебрать режимы	raw и scan
`keys`	Прочитать живой кадр	Служебные
`off`	Выключить подсветку	Служебные
`default`	Вендорский сброс	Служебные
`reset`	USB reset	Служебные
`version`	Версия утилиты	Служебные

Общие ключи¶

Ключ	Действие
`--no-save`	Не писать настройку во флеш
`--help`	Показать справку по команде

--no-save поддерживают mode, paint, remap, raw и macro set. По умолчанию настройка сохраняется во флеш и переживает выключение клавиатуры. У macro set и macro clear наоборот: по умолчанию save выключен, а ключ --save включает запись во флеш.

Формат значений¶

цвет — RRGGBB или имя CSS, см. Именованные цвета;
клавиша — имя, символ, синоним или hex-индекс, см. Имена клавиш;
режим — номер от 1 до 19, hex, алиас или off, см. Режимы подсветки.

Порядок в профиле¶

Команда apply применяет секции всегда в одном порядке, независимо от их порядка в файле:

remap;
paint;
mode;
raw;
macro;
повторно remap и paint или mode.

Секция mode пропускается с предупреждением, если в профиле есть paint: раскраска видна только в режиме 0x80, и любой другой режим её перекрыл бы.

Подробности — в разделе Команда apply.