{
  "added_at": "2026-11-06",
  "category": "reconstruction-cases",
  "description_en": "iDotMatrix Home Assistant integration controls the HXS-002 / NL-XSD-32 LED panel over a BLE protocol derived from analysis of the vendor Android app. Its vendored protocol module and hardware-capture tests support power, brightness, clock controls and chunked 32×32 image uploads with CRC32.",
  "description_zh": "iDotMatrix Home Assistant 集成利用对厂商 Android 应用的分析所得 BLE 协议，控制 HXS-002 / NL-XSD-32 LED 面板。仓库中的协议模块和基于硬件抓包的测试覆盖电源、亮度、时钟控制，以及带 CRC32 的分块 32×32 图像上传。",
  "entry_url": "https://awesomerea.org/resources/idotmatrix-ha-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/idotmatrix-ha-case/",
  "evidence_url": "https://github.com/dallanwagz/idotmatrix-ha/blob/e27d763dd06849ce7b7ccb54a4defc0a3fd5a295/README.md",
  "group": "cases",
  "id": "idotmatrix-ha-case",
  "json_url": "https://awesomerea.org/resources/idotmatrix-ha-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/idotmatrix-ha-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/idotmatrix-ha-case/index.md",
  "name": "iDotMatrix: Home Assistant control through a reconstructed BLE protocol",
  "name_zh": "iDotMatrix：通过重建的 BLE 协议接入 Home Assistant",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "limits",
    "license"
  ],
  "requirements": [
    "Home Assistant with a Bluetooth adapter or nearby ESPHome/Shelly Bluetooth proxy is required.",
    "The panel accepts only one BLE connection at a time.",
    "Some protocol modes, including carousel/GIF storage and rhythm/spectrum, are not exposed as Home Assistant entities.",
    "No licence file in the repository."
  ],
  "requirements_zh": [
    "需要 Home Assistant，以及蓝牙适配器或附近的 ESPHome/Shelly 蓝牙代理。",
    "面板同一时间只接受一个 BLE 连接。",
    "轮播/GIF 存储及节奏/频谱等协议模式尚未作为 Home Assistant 实体提供。",
    "仓库中没有许可证文件。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/dallanwagz/idotmatrix-ha",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}