# pyidotmatrix：研究并实现 iDotMatrix BLE 控制协议

> 项目将 iDotMatrix BLE 显示屏协议实现为带类型的 Python SDK，并记录厂商 APK 分析与硬件探测所得的发现。数据包构造器覆盖图片、GIF、文字、灯效和设备原生模式；附带命令行工具可将 Android btsnoop 抓包解码为带注释的通信记录。功能状态以一块 32×32 面板为参考。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-08
- 收录于：2026-11-09
- 原始资源：<https://github.com/Madhat69/pyidotmatrix>
- 一手来源：<https://github.com/Madhat69/pyidotmatrix/blob/da00f35446882c44a881c13def0d347296cee44e/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/pyidotmatrix-protocol-case/>
- 记录 JSON：<https://awesomerea.org/resources/pyidotmatrix-protocol-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/pyidotmatrix-protocol-case/index.md)

## 使用条件与局限

- **前提条件：**BLE 使用需要 Python 3.12 至 3.14 和 bleak。
- **局限：**硬件研究基于一块 32×32 面板；每周计划功能仅部分得到测试。
- **许可：**许可证：GPL-3.0-or-later。

## 一手来源

1. <https://github.com/Madhat69/pyidotmatrix/blob/da00f35446882c44a881c13def0d347296cee44e/README.md>
2. <https://github.com/Madhat69/pyidotmatrix/blob/da00f35446882c44a881c13def0d347296cee44e/docs/architecture.md>

## 同分区更多条目：协议

- [Skannerz Commander：重建玩具交易协议](https://awesomerea.org/zh/resources/skannerz-commander-trade-protocol-case/index.md) · 案例
- [AUKEY KM-G15 RGB Control：解析键盘 USB HID 控制命令](https://awesomerea.org/zh/resources/aukey-km-g15-rgb-case/index.md) · 案例
- [SonyBridge：重建第二代索尼耳机控制协议](https://awesomerea.org/zh/resources/sonybridge-v2-headphones-case/index.md) · 案例
- [HP Laser 1008a：重建 macOS 上的 SPL3 打印流程](https://awesomerea.org/zh/resources/hp-laser-1008a-spl3-case/index.md) · 案例
- [BMW iDrive：解析 F44 控制器 CAN 消息](https://awesomerea.org/zh/resources/bmw-idrive-can-case/index.md) · 案例
- [ESP32 Controller for Charlton & Jenrick Fireplace：重建壁炉遥控功能](https://awesomerea.org/zh/resources/esp32-fireplace-controller-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。