Skip to content

Releases

Keyrox v1.0.7

Choose a tag to compare

@sl1mus sl1mus released this 22 Nov 07:40

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

Choose a tag to compare

@sl1mus sl1mus released this 17 Nov 18:33

В этой версии добавлены приглушение подсветки при сне экрана и обновлённая фоновая защита 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

Choose a tag to compare

@sl1mus sl1mus released this 17 Nov 08:09

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.

Keyrox v1.0.1 — In-App Auto-Revive & 24/7 Watchdog

Choose a tag to compare

@sl1mus sl1mus released this 14 Nov 20:23

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)

Choose a tag to compare

@sl1mus sl1mus released this 14 Nov 20:05

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-панель и автоматическая проверка обновлений.