# Ökoboiler：解析热泵热水器内部 UART 总线

> Ökoboiler 项目重建热泵热水器显示板与主控板之间的单线 UART 通信。文档说明 32 字节帧、XOR 掩码、CRC-16/Modbus，以及水箱温度、运行模式和光伏状态字段，并提供 Python 解码器与 ESPHome 传感器配置。

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

## 使用条件与局限

- **前提条件：**文档中的采集配置使用 Ökoboiler 设备和运行 ESPHome 的 ESP32-C6。
- **局限：**作者报告在一台设备上采集数天数据并验证了该协议。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/splattner/oekoboiler-uart-reverse-engineering/blob/8a164da1713b7ded0656419d2e7ca10d70035eb1/PROTOCOL.md>
2. <https://github.com/splattner/oekoboiler-uart-reverse-engineering/blob/8a164da1713b7ded0656419d2e7ca10d70035eb1/README.md>
3. <https://github.com/splattner/oekoboiler-uart-reverse-engineering/blob/8a164da1713b7ded0656419d2e7ca10d70035eb1/scripts/README.md>

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

- [Ritto 7630：重建对讲机门铃与开门信号](https://awesomerea.org/zh/resources/ritto-esp-case/index.md) · 案例
- [ha-c14：重建 C14 新风机总线协议](https://awesomerea.org/zh/resources/ha-c14-case/index.md) · 案例
- [Homiq Rescue：重建 Homiq 控制协议](https://awesomerea.org/zh/resources/homiq-rescue-case/index.md) · 案例
- [PreSonus StudioLive 16.0.2 USB：解析调音台控制消息](https://awesomerea.org/zh/resources/presonus-studiolive-16-0-2-usb-case/index.md) · 案例
- [DJI Mic Mini Monitor：解析接收器 USB 状态流](https://awesomerea.org/zh/resources/dji-mic-mini-monitor-case/index.md) · 案例
- [baseus-cli：重建 Baseus Bass BS1 NC 控制协议](https://awesomerea.org/zh/resources/baseus-cli-case/index.md) · 案例

## 关于此条目

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