{
  "added_at": "2026-11-06",
  "additional_evidence_urls": [
    "https://github.com/electrondefuser/cbfirestorm/blob/65802f360916030cffa2207ac5f72fae183fe0ca/PROTOCOL.md"
  ],
  "category": "reconstruction-cases",
  "description_en": "Cosmic Byte Firestorm Controller implements a Linux client for the mouse's recovered USB settings protocol. Its Python CLI sends control and interrupt transfers to configure lighting effects, per-DPI indicator colours and sensitivity levels, while PROTOCOL.md records packet structures and command sequences.",
  "description_zh": "Cosmic Byte Firestorm Controller 是基于已解析 USB 设置协议实现的 Linux 鼠标控制工具。其 Python 命令行程序通过控制传输和中断传输配置灯效、各档 DPI 指示颜色及灵敏度；PROTOCOL.md 记录了数据包结构和命令序列。",
  "entry_url": "https://awesomerea.org/resources/cosmic-byte-firestorm-controller-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/cosmic-byte-firestorm-controller-case/",
  "evidence_url": "https://github.com/electrondefuser/cbfirestorm/blob/65802f360916030cffa2207ac5f72fae183fe0ca/README.md",
  "group": "cases",
  "id": "cosmic-byte-firestorm-controller-case",
  "json_url": "https://awesomerea.org/resources/cosmic-byte-firestorm-controller-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/cosmic-byte-firestorm-controller-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/cosmic-byte-firestorm-controller-case/index.md",
  "name": "Cosmic Byte Firestorm Controller: a USB protocol client for mouse settings",
  "name_zh": "Cosmic Byte Firestorm Controller：基于 USB 协议的鼠标设置客户端",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "testing",
    "license"
  ],
  "requirements": [
    "Linux and a Cosmic Byte Firestorm mouse with VID 0x04d9 and PID 0xa09f; USB access typically requires sudo.",
    "Running from source requires Python, pyusb and PyYAML.",
    "Device support was tested only with the named Firestorm model.",
    "GPL-3.0 licence."
  ],
  "requirements_zh": [
    "需要 Linux 和 VID 为 0x04d9、PID 为 0xa09f 的 Cosmic Byte Firestorm 鼠标；访问 USB 通常需要 sudo。",
    "从源码运行需要 Python、pyusb 和 PyYAML。",
    "设备支持仅在所述 Firestorm 型号上测试。",
    "采用 GPL-3.0 许可证。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/electrondefuser/cbfirestorm",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}