# FreeMicro：解析 Codex Micro 的 USB 与蓝牙控制协议

> FreeMicro 通过 Codex Micro 的厂商 HID 协议读取按键、控制 LED，并将六个按键关联到 Claude Code 项目状态。协议文档记录 USB 与 BLE 不同的报告帧格式、设备命令及输入事件，仓库提供相应的 Python 控制代码。

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

## 使用条件与局限

- **前提条件：**需要 Codex Micro 设备、macOS 和 Python 3.9+。
- **范围：**协议观察记录对应一台运行 v0.4.1 固件的设备。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/eliBenven/freemicro/blob/64258eb6cc3312a43f9f9f86d87e55e0b609ccc5/docs/PROTOCOL.md>
2. <https://github.com/eliBenven/freemicro/blob/64258eb6cc3312a43f9f9f86d87e55e0b609ccc5/README.md>

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

- [Mittzon Standing Desk：解码 LIN 总线并接入 Home Assistant](https://awesomerea.org/zh/resources/mittzon-homeassistant-case/index.md) · 案例
- [zenvision-linux：重建 ASUS ZenVision OLED 的 USB 控制协议](https://awesomerea.org/zh/resources/zenvision-linux-case/index.md) · 案例
- [orba-protocol：重建 Artiphon Orba 2 控制消息](https://awesomerea.org/zh/resources/orba-protocol-artiphon-orba-2-case/index.md) · 案例
- [TrikiEmu：重建 Żabka Triki BLE 控制器](https://awesomerea.org/zh/resources/trikiemu-zabka-triki-case/index.md) · 案例
- [TrikiScope：解码 Żabka Triki 的 BLE 运动数据流](https://awesomerea.org/zh/resources/trikiscope-zabka-triki-case/index.md) · 案例
- [G2CC：基于蓝牙流量分析重建 Even G2 客户端](https://awesomerea.org/zh/resources/g2cc-even-g2-client-case/index.md) · 案例

## 关于此条目

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