{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/splattner/oekoboiler-uart-reverse-engineering/blob/8a164da1713b7ded0656419d2e7ca10d70035eb1/README.md",
    "https://github.com/splattner/oekoboiler-uart-reverse-engineering/blob/8a164da1713b7ded0656419d2e7ca10d70035eb1/scripts/README.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "The Ökoboiler study reconstructs the single-wire UART exchange between a heat-pump water heater's display and control boards. It documents 32-byte frames, XOR masking, CRC-16/Modbus and fields for tank temperature, operating mode and PV state, with a Python decoder and an ESPHome sensor configuration.",
  "description_zh": "Ökoboiler 项目重建热泵热水器显示板与主控板之间的单线 UART 通信。文档说明 32 字节帧、XOR 掩码、CRC-16/Modbus，以及水箱温度、运行模式和光伏状态字段，并提供 Python 解码器与 ESPHome 传感器配置。",
  "entry_url": "https://awesomerea.org/resources/oekoboiler-uart-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/oekoboiler-uart-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/splattner/oekoboiler-uart-reverse-engineering/blob/8a164da1713b7ded0656419d2e7ca10d70035eb1/PROTOCOL.md",
  "group": "cases",
  "id": "oekoboiler-uart-case",
  "json_url": "https://awesomerea.org/resources/oekoboiler-uart-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/oekoboiler-uart-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/oekoboiler-uart-case/index.md",
  "name": "Ökoboiler: decoding the water heater's internal UART bus",
  "name_zh": "Ökoboiler：解析热泵热水器内部 UART 总线",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "The documented capture setup uses an Ökoboiler unit and an ESP32-C6 running ESPHome.",
    "The author reports validating the protocol on one unit over several days of traffic.",
    "MIT licence."
  ],
  "requirements_zh": [
    "文档中的采集配置使用 Ökoboiler 设备和运行 ESPHome 的 ESP32-C6。",
    "作者报告在一台设备上采集数天数据并验证了该协议。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/splattner/oekoboiler-uart-reverse-engineering",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}