联犀开发者文档

中弘空调接入

约 540 字大约 2 分钟

设备接入第三方协议中弘空调

2026-08-20

简介

中弘协议（zhonghong）是联犀平台对接中弘（中宏）空调网关的 MQTT 直连协议。认证方式为 Username=产品ID + 任意密码，设备通过 MQTT 连接并按中弘 Topic 收发数据。

应用场景

  • 中弘空调网关：中弘/中宏空调网关及子设备（电表、内外机）接入
  • 空调控制：抄读、属性读写、控制指令下发

前置条件

  1. 协议容器已部署：protocol-zhonghong 容器运行正常
  2. MQTT Broker 可访问：平台 MQTT 服务端口 1883 开放

产品配置

创建产品时选择协议 zhonghong（传输协议 MQTT）。

设备接入

设备详情「设备接入」Tab 展示连接参数（产品ID/设备名自动填入）：

设备接入

连接参数

参数值
Brokermqtt://{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/21 03:59
查看所有更新日志
  • 4ab8f-Merge #25 into master from docs/third-party-protocols于