Heat Pump Modbus Database

一个全面的、开源的用于热泵集成的Modbus寄存器数据库，提供了不同制造商热泵系统的统一寄存器映射，支持多种平台配置生成

A comprehensive, open-source Modbus register database for heat pump integration, which provides unified register mappings for heat pump systems from different manufacturers and supports configuration generation for multiple platforms.

原始信息汇总

数据集概述

基本信息

• 数据集名称：Heat Pump Modbus Database
• 维护者：Warm Energy Labs Ltd
• 许可证：MIT License
• 用途：热泵集成Modbus寄存器统一数据库

数据集描述

本数据集是一个开源的、社区驱动的Modbus寄存器映射数据库，旨在简化不同平台的热泵集成。数据集由Warm Energy Labs Ltd内部用于热泵监控和控制系统，并分享给社区以推动热泵集成标准的发展。

主要特性

• 多平台支持：生成Home Assistant和ESPHome的配置
• 标准化格式：为不同制造商的类似寄存器提供通用接口
• JSON源文件：易于阅读、编辑和验证
• 自动化构建：单命令生成所有平台配置
• 验证工具：内置JSON验证器确保数据质量

支持的热泵型号

三星（Samsung）

• 系列：Gen 6和Gen 7
• 测试状态：已测试
• 支持型号数量：20个
• 通信参数：波特率9600，偶校验

具体型号系列

• BXYD系列：AE080BXYDEG/EU, AE120BXYDEG/EU, AE140BXYDEG/EU, AE080BXYDGG/EU, AE120BXYDGG/EU, AE140BXYDGG/EU（容量范围：8-14kW）
• CXYD系列：AE050CXYDEK/EU, AE080CXYDEK/EU, AE120CXYDEK/EU, AE160CXYDEK/EU, AE080CXYDGK/EU, AE120CXYDGK/EU, AE160CXYDGK/EU（容量范围：5-16kW）
• CXYB系列：AE050CXYBEK/EU, AE080CXYBEK/EU, AE120CXYBEK/EU, AE160CXYBEK/EU, AE080CXYBGK/EU, AE120CXYBGK/EU, AE160CXYBGK/EU（容量范围：5-16kW）

已测试型号：AE160CXYDEK/EU

Grant/Aerona

• 型号系列：Aerona3（Chofu）
• 测试状态：未测试
• 备注：通过逆向工程得出的Modbus映射草案，波特率：19200

项目结构

modbus-heat-pump-database/ ├── src/ # 源JSON寄存器定义 │ ├── samsung/ # 三星热泵寄存器 │ └── aerona/ # Grant/Aerona热泵寄存器 ├── builds/ # 生成的配置（git忽略） │ └── <manufacturer>/ │ ├── homeassistant/ # Home Assistant YAML文件 │ └── esphome/ # ESPHome设备配置 ├── build.sh # 主构建脚本 ├── build.php # 统一PHP构建器 ├── validate-json.php # JSON验证工具 ├── COMMON_INTERFACE.md # 通用寄存器映射 └── CONTRIBUTING.md # 贡献指南

使用说明

1. 克隆仓库：git clone https://github.com/warm-energy/modbus-heat-pump-database.git
2. 构建配置：运行./build.sh
3. 查找配置：Home Assistant配置位于builds/<manufacturer>/homeassistant/，ESPHome配置位于builds/<manufacturer>/esphome/

开发工具

• 验证JSON文件：php validate-json.php
• 构建特定平台：php build.php（构建所有格式），php build-esphome.php（仅构建ESPHome配置）
• 清理构建：./build.sh --clean（删除旧构建并重新构建）

免责声明

使用风险自负：向热泵发送Modbus命令可能会损坏设备。不保证这些寄存器映射对您的特定设备正确或安全。请始终查阅热泵文档并仔细测试。

相关资源

• 贡献指南：CONTRIBUTING.md
• 通用接口标准：COMMON_INTERFACE.md
• 许可证详情：LICENSE文件

支持渠道

• 问题报告：GitHub Issues
• 讨论：GitHub Discussions
• 商业支持：联系Warm Energy Labs Ltd

搜集汇总

数据集介绍

构建方式

在热泵系统集成领域，制造商对Modbus寄存器的实现存在显著差异。本数据集采用社区驱动的协作模式，通过收集和标准化不同厂商的寄存器映射信息构建而成。源数据以JSON格式存储，便于人工编辑与自动化处理，同时内置验证工具确保数据结构的一致性。构建过程通过统一脚本自动生成多平台配置文件，实现了从原始寄存器定义到应用配置的无缝转换。

特点

该数据集的核心价值在于其跨平台兼容性与标准化设计。针对家庭自动化领域的实际需求，它支持Home Assistant和ESPHome两大主流平台，提供即插即用的配置文件。数据集采用统一的接口规范，使不同厂商的相似寄存器具有一致的访问逻辑，显著降低了集成复杂度。其模块化结构允许灵活扩展新厂商支持，而开源特性则促进了社区持续优化与验证。

使用方法

使用者可通过克隆代码库并执行构建脚本快速获取所需配置。数据集提供针对不同平台的自动化构建选项，用户可根据目标系统选择生成Home Assistant的YAML文件或ESPHome设备配置。实际部署前需严格验证目标热泵型号的兼容性，并参照制造商文档确认通信参数。建议在测试环境中逐步验证寄存器读写操作，确保系统稳定性后再投入生产环境使用。

背景与挑战

背景概述

在可再生能源与智能家居系统融合的背景下，Heat Pump Modbus Database由Warm Energy Labs Ltd于近年创建，旨在解决热泵设备通信协议碎片化问题。该数据集聚焦于不同制造商热泵Modbus寄存器的统一映射，为跨平台集成提供标准化接口，显著推动了热泵监控与控制技术的互操作性与自动化水平，对能源管理领域的开源生态建设具有重要贡献。

当前挑战

该数据集核心挑战在于热泵制造商寄存器实现的异构性，需克服协议逆向工程与兼容性验证的技术难题；构建过程中面临寄存器映射准确性保障、多厂商设备测试覆盖不足以及安全风险控制等实际困难，需依赖社区协作与持续验证以提升数据可靠性。

常用场景

经典使用场景

在暖通空调系统集成领域，该数据集为研究人员提供了标准化的Modbus寄存器映射模板，极大简化了不同品牌热泵设备的通信协议解析过程。通过统一的JSON格式定义，支持对三星、格兰特等主流热泵品牌的运行参数监控，包括温度调节、功耗统计和故障诊断等核心功能的寄存器寻址方案，为跨平台设备兼容性研究奠定数据基础。

衍生相关工作

基于该数据集衍生的经典工作包括Home Assistant官方集成的热泵智能控制模块，以及ESPHome社区开发的多品牌设备适配框架。学术界据此开展了建筑能源管理系统优化研究，工业界则衍生出Warm Energy Labs的商业监控平台。这些成果共同推动了热泵Modbus通信协议的标准化进程，并催生了多项关于设备互操作性的国际技术白皮书。

数据集最近研究

最新研究方向

在建筑能源智能化管理领域，热泵系统的Modbus协议集成正成为研究热点。该数据集通过标准化不同厂商的寄存器映射，显著推动了多平台兼容性研究，特别是在Home Assistant和ESPHome生态中的自动化控制应用。随着碳中和目标的推进，热泵设备的精细化管理需求日益凸显，该资源为能效优化算法开发和故障预测模型构建提供了关键数据支撑。开源社区的持续贡献不仅加速了制造商特定协议的逆向工程进程，更促进了智能家居与能源互联网系统的深度融合。