{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/ThePaladini/ba-key308-macos/blob/b3d9e1f7e2ee3286b34cdf47a8b49ab4f54c087b/docs/PROTOCOL.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "Reconstructs the Basike BA-KEY308 keyboard's HID configuration protocol from the vendor's Windows app and implements it in a macOS menu-bar app and CLI. The protocol notes cover Feature reports, command classes and Bluetooth, USB and 2.4 GHz receiver transport. The app controls lighting, per-key colors and profiles.",
  "description_zh": "项目从厂商 Windows 程序还原 Basike BA-KEY308 键盘的 HID 配置协议，并以 macOS 菜单栏应用和命令行工具实现。协议笔记记录了 Feature report、命令类别，以及蓝牙、USB 和 2.4 GHz 接收器传输；应用可控制灯效、逐键颜色和配置。",
  "entry_url": "https://awesomerea.org/resources/ba-key-menu-protocol-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/ba-key-menu-protocol-case/",
  "evidence_url": "https://github.com/ThePaladini/ba-key308-macos/blob/b3d9e1f7e2ee3286b34cdf47a8b49ab4f54c087b/README.md",
  "group": "cases",
  "id": "ba-key-menu-protocol-case",
  "json_url": "https://awesomerea.org/resources/ba-key-menu-protocol-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/ba-key-menu-protocol-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/ba-key-menu-protocol-case/index.md",
  "name": "BA-KEY Menu: reconstructing Basike keyboard HID control",
  "name_zh": "BA-KEY Menu：重建 Basike 键盘 HID 控制协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "macOS 13 or newer is required; source builds use Swift 5.9 or newer.",
    "Basike BA-KEY308 was tested over Bluetooth and USB; Dareu EK75 and Husky Nomadic support is experimental.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 macOS 13 或更新版本；源码构建使用 Swift 5.9 或更新版本。",
    "Basike BA-KEY308 已通过蓝牙和 USB 测试；Dareu EK75 与 Husky Nomadic 支持仍属实验阶段。",
    "许可证：MIT。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/ThePaladini/ba-key308-macos",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}