# iDotMatrix: Home Assistant control through a reconstructed BLE protocol

> 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.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-06
- Original resource: <https://github.com/dallanwagz/idotmatrix-ha>
- Primary source: <https://github.com/dallanwagz/idotmatrix-ha/blob/e27d763dd06849ce7b7ccb54a4defc0a3fd5a295/README.md>
- Catalog page: <https://awesomerea.org/resources/idotmatrix-ha-case/>
- Record JSON: <https://awesomerea.org/resources/idotmatrix-ha-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/idotmatrix-ha-case/index.md)

## Requirements & limits

- **Prerequisites:** Home Assistant with a Bluetooth adapter or nearby ESPHome/Shelly Bluetooth proxy is required.
- **Limits:** The panel accepts only one BLE connection at a time.
- **Limits:** Some protocol modes, including carousel/GIF storage and rhythm/spectrum, are not exposed as Home Assistant entities.
- **License:** No licence file in the repository.

## Primary sources

1. <https://github.com/dallanwagz/idotmatrix-ha/blob/e27d763dd06849ce7b7ccb54a4defc0a3fd5a295/README.md>

## More in Protocols

- [Dell ControlVault 2 fingerprint on Linux: adapting a driver for BCM5880](https://awesomerea.org/resources/dell-controlvault2-fingerprint-linux-case/index.md) · Case study
- [epson-l3110-driver: investigating the printer's USB and ESC/P-R exchanges](https://awesomerea.org/resources/epson-l3110-driver-case/index.md) · Case study
- [MS5 WiFi Microscope: reconstructing the camera's UDP video protocol](https://awesomerea.org/resources/ms5-wifi-microscope-case/index.md) · Case study
- [lux-lat-long-log: reconstructing LUMIX S5 BLE GPS communication](https://awesomerea.org/resources/lux-lat-long-log-case/index.md) · Case study
- [Magene L308: reconstructing a smart taillight's BLE control protocol](https://awesomerea.org/resources/magene-l308-taillight-case/index.md) · Case study
- [xbloom-ble: a client for the xBloom Studio BLE protocol](https://awesomerea.org/resources/xbloom-ble-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.