2.2 MQTT推送
2.2.1 第三方对接实现
由HAI平台主动向MQTT Broker固定主题发送末端设备的数据, 对接方需要链接订阅此MQTT Broker 解析HAI平台推送的数据
1.第三方需提供MQTT Broker地址, 端口号, 用户名, 密码, 主题等信息给现场调试人员
MQTT Broker要求如下:
- 现场HAI平台服务器与此MQTT Broker之间的网络是通的
- HAI平台暂不支持证书认证 MQTT Broker 需要取消证书认证
- 用户名具备当前主题与当前主题/command 发布与订阅权限,例如提供住主题为/test那么此用户需要具备/test与/test/command的发布与订阅权限
- 消息级别均为QOS0
- 第三方收到HAI平台数据后无需回复与应答操作
2.现场调试人员沟通如果HAI平台对接已经建立完成需要第三方验证对接数据是否收到,确认无误之后解析对接数据
3.解析数据需要用到现场调试人员导出的设备点位与说明excel字段, 请联系现场调试人员索要对接字段文档
4.对接数据解析注意事项
- excel中设备列表Sheet为HAI平台设备, 每一行代表一个设备, 设备唯一标识为"唯一UDID"字段
- 设备列表中的"设备型号编码"请重点关注, 每种设备型号所具备的点位信息可能不同, 具体点位描述在其他Sheet中查找与设备型号编码一致的点位描述Sheet
- 点位描述的Sheet 中所描述的为设备的devices_json_object 字段, 具体的点位名称与描述请参考excel中对应的Sheet
- 因一种设备型号编码代表一种类型的设备, 每种型号的设备具备的点位可能不同(例如温控器与水电表) 所以需要对接方自行判断型号队形的点位功能(请使用设备型号编码判断,不要使用设备型号ID, ID会发生变化)
- 授权码Sheet中所描述的授权码字段只有在设备控制时才会用到, 如果第三方对接不需要控制设备可以忽略此Sheet
2.1.1 现场调试人员实现
1.所有对接设备录入完成,网关可以没调试设备可以为离线状态,但是平台一点要将对接设备全部录入在进行操作否则导出点位会出现缺漏
2.联系第三方对接人员索要 mqtt主题,mqtt地址,mqtt用户名,mqtt密码
3.现场调试人员登录到HAI平台, 点击左侧菜单 系统管理 数据对接 点击创建数据对接
对接信息填写
绑定对接设备
确认提交开始对接
点击提交完成, 测试对接是否能推送到第三方
校验失败:
校验成功:
导出设备列表与设备协议注意:导出后此文件需要给到第三方对接,
如果此时对接设备还没有全部录入需要后续添加操作时在导出给到第三方对接
