{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/eliBenven/freemicro/blob/64258eb6cc3312a43f9f9f86d87e55e0b609ccc5/README.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "FreeMicro implements Codex Micro key input and LED output through the device's vendor HID protocol, linking six keys to Claude Code project states. Its protocol notes describe different USB and Bluetooth LE report framing, device commands, and observed input events, with Python code for device control.",
  "description_zh": "FreeMicro 通过 Codex Micro 的厂商 HID 协议读取按键、控制 LED，并将六个按键关联到 Claude Code 项目状态。协议文档记录 USB 与 BLE 不同的报告帧格式、设备命令及输入事件，仓库提供相应的 Python 控制代码。",
  "entry_url": "https://awesomerea.org/resources/freemicro-codex-micro-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/freemicro-codex-micro-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/eliBenven/freemicro/blob/64258eb6cc3312a43f9f9f86d87e55e0b609ccc5/docs/PROTOCOL.md",
  "group": "cases",
  "id": "freemicro-codex-micro-case",
  "json_url": "https://awesomerea.org/resources/freemicro-codex-micro-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/freemicro-codex-micro-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/freemicro-codex-micro-case/index.md",
  "name": "FreeMicro: decoding Codex Micro's USB and Bluetooth control protocol",
  "name_zh": "FreeMicro：解析 Codex Micro 的 USB 与蓝牙控制协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "scope",
    "license"
  ],
  "requirements": [
    "A Codex Micro device, macOS, and Python 3.9+.",
    "The protocol observations are documented for a shipping unit with firmware v0.4.1.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Codex Micro 设备、macOS 和 Python 3.9+。",
    "协议观察记录对应一台运行 v0.4.1 固件的设备。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/eliBenven/freemicro",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}