中弘空调接入
简介
中弘协议（zhonghong）是联犀平台对接中弘（中宏）空调网关的 MQTT 直连协议。认证方式为 Username=产品ID + 任意密码，设备通过 MQTT 连接并按中弘 Topic 收发数据。
应用场景
- 中弘空调网关：中弘/中宏空调网关及子设备（电表、内外机）接入
- 空调控制：抄读、属性读写、控制指令下发
前置条件
- 协议容器已部署：
protocol-zhonghong容器运行正常 - MQTT Broker 可访问：平台 MQTT 服务端口 1883 开放
产品配置
创建产品时选择协议 zhonghong（传输协议 MQTT）。
设备接入
设备详情「设备接入」Tab 展示连接参数（产品ID/设备名自动填入）：
连接参数
| 参数 | 值 |
|---|---|
| Broker | mqtt://{host}:1883 |
| Username | 产品 ID（zhonghong 协议产品的 ProductID） |
| Password | 任意非空值（协议不校验，但 EMQX 认证链可能要求非空） |
| ClientID | 任意字符串，即设备名（deviceName） |
Topic 清单
| 方向 | Topic | 说明 |
|---|---|---|
| 上行 | zhonghong/up/{产品ID}/{设备名} | 设备数据上行 |
| 下行 | zhonghong/down/{产品ID}/{设备名} | 设备数据下行 |
前导斜杠可省略（订阅、解析与 ACL 均双兼容）。
报文格式
{
"sn": 1,
"cmd": "energy_read | property_read | control_write | info | property | function",
"uuid": "xxx",
"body": {}
}技术方案
接入架构
中弘空调网关 ──MQTT──> protocol-zhonghong 容器(订阅 zhonghong/up/+/+) ──> 联犀平台- 登录认证：
Username作为产品 ID 查产品，ClientID作为设备名查设备（密码不校验） - 上行 topic
zhonghong/up/{pid}/{dn}解析（带/不带前导斜杠均兼容） - 下行经
zhonghong/down/{pid}/{dn}发布 - 子设备自动注册（
{网关名}_{addr}挂在固定产品下）
注意事项
- Username 必须是中弘协议产品的 ProductID，否则认证拒绝
- Password 协议不校验，建议填任意非空值
- 三元组生成不适用本协议（连接参数如上，配置页按此展示）
更新日志
2026/8/20 21:56
查看所有更新日志
70f71-于
