{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/kaechele/bonaparte/blob/1760e4ab291c5b1bb86d88bee251fb9c46e5f4ec/README.md",
    "https://github.com/kaechele/bonaparte/blob/1760e4ab291c5b1bb86d88bee251fb9c46e5f4ec/pyproject.toml"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "Bonaparte implements a Python client for Napoleon eFIRE fireplace controllers and documents their Bluetooth LE control protocol. Its reference specifies GATT characteristics, request and response packet fields, XOR checksums, and commands for settings such as power, thermostat, and night-light level.",
  "description_zh": "Bonaparte 提供 Napoleon eFIRE 壁炉控制器的 Python 客户端，并记录其 Bluetooth LE 控制协议。协议文档列出 GATT 特征值、请求与响应包字段、XOR 校验和，以及电源、恒温器和夜灯亮度等控制命令。",
  "entry_url": "https://awesomerea.org/resources/bonaparte-efire-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/bonaparte-efire-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/kaechele/bonaparte/blob/1760e4ab291c5b1bb86d88bee251fb9c46e5f4ec/docs/bluetooth_protocol.md",
  "group": "cases",
  "id": "bonaparte-efire-case",
  "json_url": "https://awesomerea.org/resources/bonaparte-efire-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/bonaparte-efire-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/bonaparte-efire-case/index.md",
  "name": "Bonaparte: reconstructing the Napoleon eFIRE Bluetooth control protocol",
  "name_zh": "Bonaparte：重建 Napoleon eFIRE 蓝牙控制协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "license"
  ],
  "requirements": [
    "Python 3.13 or later, with bleak and bleak-retry-connector.",
    "A Napoleon eFIRE-enabled fireplace controller.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Python 3.13 或更高版本，以及 bleak 和 bleak-retry-connector。",
    "需要支持 Napoleon eFIRE 的壁炉控制器。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/kaechele/bonaparte",
  "verification": "source-reviewed",
  "verified_at": "2026-11-07"
}