Repository navigation
Releases
Keyrox v1.0.7
Keyrox v1.0.7
Исправлена обработка сна экрана и дополнен путь USB-восстановления.
- Приглушение использует события фактического сна и пробуждения экрана. Общие переходы питания дисплея больше не вызывают лишние изменения яркости.
- Перед изменением яркости добавлена задержка в одну секунду для быстрых переходов между состояниями.
- Проверка присутствия USB-устройства выполняется в процессе с таймаутом. Отсутствие устройства отдельно отмечается в журнале.
- После неудачного обычного USB-сброса выполняется запасная повторная регистрация через совместимый USB API.
- Добавлены автоматические проверки watchdog для зависшего запроса, отсутствия и возврата USB-устройства, восстановления после трёх ошибок и быстрых событий экрана.
Проверено на Intel iMac с macOS Sonoma через OCLP. Реальный цикл сна экрана дал яркость 4 → 1 → 4, пользователь подтвердил сохранение бирюзового свечения после пробуждения. Запасная повторная регистрация проверена на подключённой Keyrox при имитированном отказе обычного сброса. Локальные тесты протокола и watchdog прошли. Приложение и встроенная служба собраны для Intel и Apple Silicon.
Причина полного исчезновения клавиатуры с USB остаётся предметом диагностики. Если устройство отсутствует на шине, программной повторной регистрации нечего адресовать. Яркость эффекта не отражает состояние аппаратного переключателя Fn + Esc.
После переноса Keyrox.app в «Программы» отключите и повторно включите фоновую автозащиту в Settings, чтобы обновить отдельную установленную копию службы.
Keyrox v1.0.5
В этой версии добавлены приглушение подсветки при сне экрана и обновлённая фоновая защита Keyrox.
- При засыпании экрана обычные эффекты приглушаются до 1/4, при пробуждении восстанавливается прежняя яркость.
- Для Custom Matrix сохраняются цвета и индивидуальная яркость последнего кадра, отправленного новой версией приложения.
- Watchdog проверяет клавиатуру каждые 5 секунд. После трёх ошибок выполняет USB-восстановление с повтором через 30 секунд при неудаче.
- Проверки выполняются в отдельных процессах с ограничением времени. GUI, CLI и watchdog координируют HID-запросы.
- При пробуждении приложение сначала проверяет ответ клавиатуры, чтобы избежать лишнего USB-сброса.
Проверено на Keyrox TKL V2 (1a2c:2511), macOS Sonoma. Все 12 тестов протокола прошли. Собраны Universal binaries для Intel и Apple Silicon. Реальный сон экрана подтвердил цикл яркости 4 → 1 → 4 с сохранением эффекта. Проверены одновременные запросы CLI и watchdog, ограничение времени зависшего запроса, автоматический перезапуск службы и восстановление состояния яркости.
Аппаратное зависание после переподключения пока не повторилось. Эффективность автоматического восстановления при следующем аппаратном отказе требует проверки.
После установки перенесите Keyrox.app в «Программы». В Settings отключите и повторно включите фоновую автозащиту, чтобы обновить отдельную копию службы. Для приглушения Custom Matrix сначала примените поклавишные цвета в новой версии.
Keyrox v1.0.3 — Full Wire Effect Parity, Matrix Streaming & Profile Sync
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) между прошивкой контроллера, статусом и интерфейсом.
- Полное согласование 0-based индексов профилей (
- Расширенное тестовое покрытие:
- Набор модульных тестов
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.
Keyrox v1.0.1 — In-App Auto-Revive & 24/7 Watchdog
Keyrox for macOS v1.0.1
🛡️ Новые возможности (What's New):
- In-App Auto-Revive on Screen Wake: Приложение автоматически перехватывает системные события пробуждения экрана (
NSWorkspaceScreensDidWakeNotification) и отправляет аппаратный импульс USB Bus Reset без участия пользователя. - 24/7 Фоновый Watchdog Daemon: Автономный сверхлегкий системный демон
keyrox-watchdog(fat Universal binary, 88 KB) с защитой от глубокого засыпания шины USB (IOPMAssertionCreateWithName). - 1-Click Установка/Удаление из GUI: Переключатель в панели настроек позволяет в один клик активировать LaunchAgent (
io.github.sl1mus.keyrox-watchdog.plist) в автозагрузке macOS. - CLI Команды: Добавлены
keyrox-ctl install-daemonиkeyrox-ctl uninstall-daemon.
📦 Файлы сборки:
- Keyrox-macOS.dmg (1.4 MB Universal Fat Binary: ARM64 Apple Silicon + x86_64 Intel)
Keyrox Control for macOS v1.0.0 (Initial Release)
Keyrox Control for macOS v1.0.0 ⌨️⚡
Первый публичный релиз нативной панели управления и CLI-утилиты для клавиатуры Red Square Keyrox TKL под macOS (Apple Silicon & Intel).
Что нового:
- 🚀 Нативное приложение Cocoa + WebKit: Размер всего 1.1 МБ, без Electron и фонового потребления памяти.
- 💡 19 режимов подсветки: Тонкая настройка яркости, скорости и направления эффектов.
- 🎨 Поклавишная настройка (Custom Matrix): RGB-палитра, пресеты WASD/F-ряд/стрелки.
- 🔀 Ремап клавиш и макросы: Переназначение кнопок, мультимедиа-клавиши macOS.
- ⚡ Аппаратный перезапуск USB (Revive): Электрический сброс шины через IOKit при зависании чипа.
- Главное меню macOS: Настройки, About-панель и автоматическая проверка обновлений.