# cherry-mx-lighting-mac：重建 Cherry MX 10.0N RGB 灯光控制

> cherry-mx-lighting-mac 为 Cherry MX 10.0N RGB 键盘重建灯光控制，并提供 macOS 菜单栏应用。作者观察 Cherry Utility 的 USB HID 通信，记录五条报文的发送顺序，以及效果、亮度、速度和 RGB 颜色的字节位置；应用还通过 hidutil 重映射按键。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-09
- 原始资源：<https://github.com/AlexBongers/cherry-mx-lighting-mac>
- 一手来源：<https://github.com/AlexBongers/cherry-mx-lighting-mac/blob/cb0d54398d2cdd7a4bdf1bad1e7737ab3f241500/PROTOCOL.md>
- 目录页面：<https://awesomerea.org/zh/resources/cherry-mx-lighting-mac-case/>
- 记录 JSON：<https://awesomerea.org/resources/cherry-mx-lighting-mac-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/cherry-mx-lighting-mac-case/index.md)

## 使用条件与局限

- **前提条件：**需要 Cherry MX 10.0N RGB 键盘和 macOS；作者在搭载 Apple Silicon 的 macOS 27 上测试了 USB 设备 046A:00E2。
- **前提条件：**构建需要 Xcode Command Line Tools；向键盘写入数据需要“输入监控”权限。
- **局限：**效果方向、逐键颜色和 Custom 模式尚未完成；其他 Cherry 型号未经测试。
- **许可：**MIT 许可证。

## 一手来源

1. <https://github.com/AlexBongers/cherry-mx-lighting-mac/blob/cb0d54398d2cdd7a4bdf1bad1e7737ab3f241500/PROTOCOL.md>
2. <https://github.com/AlexBongers/cherry-mx-lighting-mac/blob/cb0d54398d2cdd7a4bdf1bad1e7737ab3f241500/README.md>

## 同分区更多条目：协议

- [labelibre：通过重建的 BLE 协议直接驱动 SUPVAN T50M Pro](https://awesomerea.org/zh/resources/labelibre-supvan-case/index.md) · 案例
- [synaptics-009b-fprintd：重建 Synaptics 06cb:009b 的 Linux 支持](https://awesomerea.org/zh/resources/synaptics-009b-fprintd-case/index.md) · 案例
- [STRIDE：基于 FitPro 协议的 NordicTrack 跑步机替代控制台](https://awesomerea.org/zh/resources/stride-fitpro-treadmill-case/index.md) · 案例
- [TonePush：重建 Line 6 HX 的 USB 编辑协议](https://awesomerea.org/zh/resources/tonepush-case/index.md) · 案例
- [ESP32Drop：在 ESP32-S3 上重建 AirDrop 与 AWDL](https://awesomerea.org/zh/resources/esp32drop-case/index.md) · 案例
- [Valeton GP-50 Editor：通过重建的 SysEx 协议实时编辑预设](https://awesomerea.org/zh/resources/valeton-gp50-editor-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。