Pioszym/ha-c14

# ha-c14 ESP32 作为主站/桥接/从站运行于 C14 总线（COMPIT/PRO-VENT），用于控制 AERO3Bv2 热回收通风机及其配套的 Nano Color CTP PRO5v10 房间面板。 ## 文件列表 - **[PROTOCOL.md](PROTOCOL.md)** — C14 协议逆向工程完整文档（帧映射、编码、校验和、时序） - **[c14.example.yaml](c14.example.yaml)** — 用户模板示例。复制后根据需求修改替换变量、UART 引脚及密钥即可使用。 - **[packages/c14_core.yaml](packages/c14_core.yaml)** — C14 核心引擎：全局变量、脚本、主站循环、30字节帧解析器、Home Assistant 实体（开关/选择/数字/传感器）。用户无需手动复制——通过 GitHub 包自动获取。 ## 硬件要求 - ESP32-WROOM-32（或兼容型号） - 1个 RS485 模块 HW-0519（3.3V 电压，自动方向控制），**并联**接入 Nano↔AERO 通信总线的 A1/B1 线路（单总线接入点——ESP 监听全部通信并可主动发送数据帧） - 默认 RX/TX 引脚：GPIO16/17（可在你的 `*.yaml` 文件中修改其他引脚） ## 安装步骤 1. 将此仓库中的 `c14.example.yaml` 复制到你的 `/config/esphome/` 目录，例如命名为 `c14.yaml` 2. 编辑你的配置文件： - `substitutions:` 部分 — 设置 `device_name`、`friendly_name` - `uart:` 部分 — 检查 `rx_pin`/`tx_pin` 引脚定义。**切勿修改 `id: uart_bus`**——`c14_core.yaml` 将此 ID 作为接口约定使用。 3. 在 `/config/esphome/` 的 `secrets.yaml` 文件中添加： ``` wifi_ssid: "你的WiFi名称" wifi_password: "WiFi密码" api_key: "生成的ESPHome API密钥" ota_password: "OTA更新密码" ``` 4. 执行 `esphome run c14.yaml`（编译、上传、查看日志一站式完成） - 首次运行：ESPHome 会将本仓库克隆到 `.esphome/packages/<哈希值>/` 并加载 `c14_core.yaml` - 后续运行：使用本地缓存，每 `1天` 自动刷新（参见 `packages:` 中的 `refresh:` 配置） - 若通过 HA 插件使用 ESPHome，也可在仪表板中直接点击 **安装** 5. 接入 Home Assistant 后，实体将以 `switch.<设备名>_master_on`、`select.<设备名>_termostat`、`select.<设备名>_wentylacja` 等格式出现。 ## 版本控制与更新通知 `c14.example.yaml` 默认锁定到特定标签（如 `ref: v1.3`）。版本列表：https://github.com/Pioszym/ha-c14/releases **更新通知：** 需要最新开发版？将 `ref: vX.Y` 改为 `ref: main`。请注意 main 分支可能包含实验性功能。 ## 项目状态 逆向工程进行中。大部分关键字段已破解——ESP 主站模式可稳定运行并控制热回收通风机。详见 [PROTOCOL.md](PROTOCOL.md)。 ## 免责声明 本项目是**独立的逆向工程**，旨在将 COMPIT C14 / Prodmax 热回收通风机集成到 Home Assistant。所有技术观察均基于作者自有设备完成。 - 本项目与 COMPIT Sp. z o.o. 或 Prodmax **无关联**、未获赞助、未经授权 - "COMPIT"、"C14"、"Nano CTP"、"AERO"、"Prodmax" 为各自所有者的商标——仅作描述性使用（*指示性合理使用*）以表明硬件兼容性 - 发布依据： - 欧盟指令 2009/24/EC（为实现互操作性进行逆向工程的权利） - 波兰《著作权及邻接权法》第75条 - 欧盟法院判决 *SAS Institute 诉 WPL* (C-406/10)——为互操作性进行逆向工程是允许的 - RS-485 帧格式属于**技术事实**（非受保护作品）——其可描述性与 JSON、MIDI、ASCII 格式相当 - ESP32 固件代码为作者的**原创作品**（ESPHome lambda 函数），并非 COMPIT 固件的副本 - **使用风险自负**——作者对可能出现的设备损坏或通风系统故障不承担责任 ### 许可协议 - **文档**（PROTOCOL.md、README.md）：[CC-BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) - **固件代码**（c14.example.yaml、packages/c14_core.yaml、ESPHome lambda 函数）：[MIT](https://opensource.org/licenses/MIT) ### 用户须知 修改热回收通风机控制器可能导致制造商保修失效。在将 ESP32 连接到 C14 总线前，请确认保修条款。

标签：ESP32, ESPHome, Home Assistant, RS-485, UART通信, 主从模式, 云资产清单, 传感器集成, 固件开发, 安全认证, 开关控制, 总线通信, 数字控制, 文档化, 智能家居, 智能通风, 暖通空调, 桥接器, 热回收通风机, 物联网, 硬件接口, 空气质量控制, 能源管理, 自动化集成, 节能系统, 设备控制, 逆向工程, 选择控制