# Bonaparte：重建 Napoleon eFIRE 蓝牙控制协议

> Bonaparte 提供 Napoleon eFIRE 壁炉控制器的 Python 客户端，并记录其 Bluetooth LE 控制协议。协议文档列出 GATT 特征值、请求与响应包字段、XOR 校验和，以及电源、恒温器和夜灯亮度等控制命令。

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

## 使用条件与局限

- **前提条件：**需要 Python 3.13 或更高版本，以及 bleak 和 bleak-retry-connector。
- **前提条件：**需要支持 Napoleon eFIRE 的壁炉控制器。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/kaechele/bonaparte/blob/1760e4ab291c5b1bb86d88bee251fb9c46e5f4ec/docs/bluetooth_protocol.md>
2. <https://github.com/kaechele/bonaparte/blob/1760e4ab291c5b1bb86d88bee251fb9c46e5f4ec/README.md>
3. <https://github.com/kaechele/bonaparte/blob/1760e4ab291c5b1bb86d88bee251fb9c46e5f4ec/pyproject.toml>

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

- [skyrcUSB：通过重建协议读取 skyRC 充电器](https://awesomerea.org/zh/resources/skyrcusb-case/index.md) · 案例
- [mqtt-energi：重建 myenergi 设备通信格式](https://awesomerea.org/zh/resources/mqtt-energi-case/index.md) · 案例
- [RedFIS：重建 Audi A3 8P 仪表显示协议](https://awesomerea.org/zh/resources/a3-8p-redfis-case/index.md) · 案例
- [GalaxyBuds-rs：实现 Galaxy Buds 蓝牙协议](https://awesomerea.org/zh/resources/galaxybuds-rs-case/index.md) · 案例
- [ETEKCITY Smart Nutrition Scale：解析 ESN00 蓝牙数据包](https://awesomerea.org/zh/resources/metekcity-case/index.md) · 案例
- [mi-scale-2：解析 Mi Smart Scale 2 体重消息](https://awesomerea.org/zh/resources/mi-scale-2-case/index.md) · 案例

## 关于此条目

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