Макросы¶

Содержимое макросов хранится в прошивке, а не на компьютере. Макрос играет при отключённой вендорской утилите и другой раскладке: прошивка помнит именно клавиши, а не символы.

Запись содержимого¶

Транзакция отличается от обычной: вместо 04 18 используется 04 19, а вместо 04 13 — 04 15.

SET 04 19                          begin            ACK: 04 19 00 01
SET 04 15 00*6 <число пакетов>     data-begin       ACK: 04 15 00 01 (эхо числа в байте [8])
SET <данные, пакетов × 64Б>        данные           (без ACK)
SET 04 02                          commit           ACK: 04 02 00 01 <LE16 sum>

Вендор после коммита не делает save. В проекте сохранение включается отдельно: без своего save макросы не переживут переподключение. Чужой save макросы не сохраняет и не затирает: у каждой области прошивки свой save.

Формат блоба¶

Блоб занимает до 896 байт (14 пакетов).

Событие состоит из восьми байт: [00 00][код][тип][задержка u16 LE][00][50].

В дампе слот 0 указывает на смещение 0x190 (400), слот 1 — на 0x1d8 (472). Ёмкость по дампу — 896 байт. Один макрос вмещает до 60 событий, если остальные слоты пусты.

Типы событий¶

Коды клавиш¶

Коллизия 05 и 06 не объяснена: вендорская утилита шлёт эти коды именно для громкости. По вендорскому XML видно происхождение: VK 175 даёт 05, VK 174 — 06. Стрелки Left и Right (5C и 5E) проверены на железе, Up и Down (5D и 5F) — предположение по соседству.

Задержки¶

Задержка хранится как u16 в миллисекундах. В двух событиях вендорского XML стоит delay_time="0", а в блобе прошивки оказалось 10: похоже на минимальное значение вендора.

Семантика задержки — пауза до или после события — по дампу не определяется. Значения переносятся как есть.

Привязка к клавише¶

Привязка выполняется обычной записью канала 04 11: [06, индекс, режим, счётчик]. Вендор после привязки делает save, в отличие от записи содержимого.

Правила работы с содержимым:

• несколько макросов живут только тогда, когда записаны одним блобом;
• каждый вызов 04 19 с одним слотом обнуляет остальные;
• при обращении к пустому слоту прошивка использует слот 0 (проверено: macro1 при пустом слоте 1 исполнял содержимое macro0);
• запись макросов сбивает таблицу переназначений и режим подсветки в оперативной памяти;
• после записи макросов переназначения и режим нужно отправить повторно;
• чтение содержимого макросов из прошивки не реализовано: канал чтения неизвестен.

Вендорский XML¶

Утилита экспортирует макрос в XML, по файлу на макрос. Имя макроса хранится в элементе macroinfo.

Блоб, собранный из вендорских XML, совпадает с дампом побайтово, кроме двух задержек 0 → 10.

Как макросы задаются из CLI и YAML, описано в разделах Команда macro и Команда apply.