{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/Madhat69/pyidotmatrix/blob/da00f35446882c44a881c13def0d347296cee44e/docs/architecture.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "Implements the iDotMatrix BLE display protocol as a typed Python SDK while documenting findings from vendor APK analysis and hardware probes. Packet builders cover images, GIFs, text, effects and native display modes; a bundled CLI decodes Android btsnoop captures into annotated traffic. The project records feature status against a reference 32×32 panel.",
  "description_zh": "项目将 iDotMatrix BLE 显示屏协议实现为带类型的 Python SDK，并记录厂商 APK 分析与硬件探测所得的发现。数据包构造器覆盖图片、GIF、文字、灯效和设备原生模式；附带命令行工具可将 Android btsnoop 抓包解码为带注释的通信记录。功能状态以一块 32×32 面板为参考。",
  "entry_url": "https://awesomerea.org/resources/pyidotmatrix-protocol-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/pyidotmatrix-protocol-case/",
  "evidence_url": "https://github.com/Madhat69/pyidotmatrix/blob/da00f35446882c44a881c13def0d347296cee44e/README.md",
  "group": "cases",
  "id": "pyidotmatrix-protocol-case",
  "json_url": "https://awesomerea.org/resources/pyidotmatrix-protocol-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/pyidotmatrix-protocol-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/pyidotmatrix-protocol-case/index.md",
  "name": "pyidotmatrix: researching and implementing iDotMatrix BLE control",
  "name_zh": "pyidotmatrix：研究并实现 iDotMatrix BLE 控制协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Python 3.12–3.14 and bleak are required for BLE use.",
    "Hardware findings were checked against one 32×32 panel; weekly scheduling is partially verified.",
    "GPL-3.0-or-later."
  ],
  "requirements_zh": [
    "BLE 使用需要 Python 3.12 至 3.14 和 bleak。",
    "硬件研究基于一块 32×32 面板；每周计划功能仅部分得到测试。",
    "许可证：GPL-3.0-or-later。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/Madhat69/pyidotmatrix",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}