{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/AlexBongers/cherry-mx-lighting-mac/blob/cb0d54398d2cdd7a4bdf1bad1e7737ab3f241500/README.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "cherry-mx-lighting-mac reconstructs lighting control for the Cherry MX 10.0N RGB keyboard in a macOS menu bar app. The author observed Cherry Utility's USB HID traffic and documented a five-report sequence, including bytes for effect, brightness, speed and RGB colour; the app also remaps keys through hidutil.",
  "description_zh": "cherry-mx-lighting-mac 为 Cherry MX 10.0N RGB 键盘重建灯光控制，并提供 macOS 菜单栏应用。作者观察 Cherry Utility 的 USB HID 通信，记录五条报文的发送顺序，以及效果、亮度、速度和 RGB 颜色的字节位置；应用还通过 hidutil 重映射按键。",
  "entry_url": "https://awesomerea.org/resources/cherry-mx-lighting-mac-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/cherry-mx-lighting-mac-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/AlexBongers/cherry-mx-lighting-mac/blob/cb0d54398d2cdd7a4bdf1bad1e7737ab3f241500/PROTOCOL.md",
  "group": "cases",
  "id": "cherry-mx-lighting-mac-case",
  "json_url": "https://awesomerea.org/resources/cherry-mx-lighting-mac-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/cherry-mx-lighting-mac-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/cherry-mx-lighting-mac-case/index.md",
  "name": "cherry-mx-lighting-mac: reconstructing Cherry MX 10.0N RGB lighting control",
  "name_zh": "cherry-mx-lighting-mac：重建 Cherry MX 10.0N RGB 灯光控制",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Cherry MX 10.0N RGB keyboard and macOS; the author tested USB device 046A:00E2 on macOS 27 with Apple Silicon.",
    "Xcode Command Line Tools are required to build; Input Monitoring permission is required to write to the keyboard.",
    "Effect direction, per-key colours and Custom mode are unfinished; other Cherry models are untested.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Cherry MX 10.0N RGB 键盘和 macOS；作者在搭载 Apple Silicon 的 macOS 27 上测试了 USB 设备 046A:00E2。",
    "构建需要 Xcode Command Line Tools；向键盘写入数据需要“输入监控”权限。",
    "效果方向、逐键颜色和 Custom 模式尚未完成；其他 Cherry 型号未经测试。",
    "MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/AlexBongers/cherry-mx-lighting-mac",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}