Skip to content

Keyrox v1.0.3 — Full Wire Effect Parity, Matrix Streaming & Profile Sync

Choose a tag to compare

@sl1mus sl1mus released this 17 Nov 08:09
· 3 commits to main since this release

Keyrox macOS v1.0.3 — 100% Wire Protocol Parity & Lighting Fixes 🚀

Нативная панель управления и CLI-утилита для клавиатуры Red Square Keyrox TKL (0x1A2C:0x2511 / 0x1511, контроллер ITE Tech GK8911M).

В релизе v1.0.3 полностью устранены все проблемы с переключением динамических эффектов подсветки, сохранением пользовательских цветов и профилей, достигнут 100% паритет с оригинальной Windows-утилитой KeyroxTKLSkeleton.exe.

🛠️ Что нового и исправлено в v1.0.3:

  • Истинный опкод переключения эффектов (KEYROX_CMD_EFFECT = 0x04):
    • Заменена ошибочная отправка команды 0x08 на аппаратный опкод активного эффекта 0x04 с таблицей effects_by_wire (Wave, Const, Breathe, Heartrate, Point, Rain, Stars, Spectrum, Plumflower, Shoot, Rotate, Circle Diffusion, Custom).
  • Сверхбыстрый стриминг матрицы (Single-Packet 60 FPS):
    • Внедрён аппаратный опкод KEYROX_CMD_REMAP (0x07) с фреймом 0x01b0 (432 байта) для обновления всей 87-клавишной матрицы одним отчётом за < 2 мс.
  • Flash-фиксация и аппаратный тайминг (Pacing):
    • Все операции смены эффектов, профилей и параметров аппаратно сохраняются через KEYROX_CMD_SAVE (0x09) с гарантированным интервалом 30 мс, полностью устраняя USB Endpoint Stall (0xe00002d6).
  • Синхронизация профилей:
    • Полное согласование 0-based индексов профилей (P1..P4, 0..3) между прошивкой контроллера, статусом и интерфейсом.
  • Расширенное тестовое покрытие:
    • Набор модульных тестов make test расширен до 12 тестов (12/12 PASS).

📦 Дистрибутив:

  • Keyrox-macOS.dmg (1.7 MB) — Универсальный установщик (Apple Silicon M1/M2/M3/M4 + Intel x86_64).
    • SHA-256: d832c6e1728908e2e7d1c3a87d68f8adf6e9cea6356c38d7c481e988955a1c30
  • Бандл содержит нативный GUI Keyrox.app, консольную утилиту keyrox-ctl и фоновый сервис автозащиты keyrox-watchdog.