{
  "added_at": "2026-11-08",
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "gloriousctl adds Linux control of Pixart Model I 2 mice through a hardware-mapped, write-only HID report format. The author documents corrected DPI, stage color, polling-rate, and fragment timing fields, alongside a CLI and GTK front end.",
  "description_zh": "gloriousctl 通过实物测绘的只写 HID 报文，在 Linux 上控制 Pixart Model I 2 鼠标。作者记录了 DPI、档位颜色、轮询率和分片时序字段的修正，并提供命令行与 GTK 界面。",
  "entry_url": "https://awesomerea.org/resources/gloriousctl-linux-pixart-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/gloriousctl-linux-pixart-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/zeppybabe/gloriousctl-linux/blob/cbf041afd30fd8d6709da13d15f8e56926429b99/README.md",
  "group": "cases",
  "id": "gloriousctl-linux-pixart-case",
  "json_url": "https://awesomerea.org/resources/gloriousctl-linux-pixart-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/gloriousctl-linux-pixart-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/gloriousctl-linux-pixart-case/index.md",
  "name": "gloriousctl: mapping Pixart Model I 2 mouse settings",
  "name_zh": "gloriousctl：测绘 Pixart Model I 2 鼠标设置协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "attribution"
  ],
  "requirements": [
    "Linux, hidapi, a C compiler, and make; the GUI also needs PyGObject and GTK 3.",
    "Pixart settings are write-only, so displayed values come from a local cache.",
    "EUPL-1.2 license; the SinoWealth code and original CLI derive from enkore/gloriousctl."
  ],
  "requirements_zh": [
    "需要 Linux、hidapi、C 编译器和 make；图形界面另需 PyGObject 与 GTK 3。",
    "Pixart 设置只可写入，界面显示值来自本地缓存。",
    "采用 EUPL-1.2 许可证；SinoWealth 代码及原始命令行结构源自 enkore/gloriousctl。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/zeppybabe/gloriousctl-linux",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}