星纵网关MQTT对接第三方平台
目录
概述
星纵物联网关支持通过MQTT接口将数据对接第三方平台,本文介绍星纵物联网关通过MQTT对接第三方平台具体步骤。
准备
- 星纵物联LoRaWAN®网关
- MQTT服务器
步骤
1. 创建应用
- 进入“Network Server > 应用”,若之前没有创建应用,则点击添加应用。
- 自定义填写“名称”和“描述”,然后保存配置。
- 若之前已有创建应用,则直接点击编辑应用。
2. MQTT对接
2.1 MQTT服务器搭建与验证
请确保您的平台支持MQTT连接,若无对应平台或服务器,可参考如下步骤快速搭建一个MQTT服务器。
- MQTT服务器搭建可参考 https://mosquitto.org/;
- 搭建完成后可通过工具fx连接服务器进行测试,请根据要求配置;
- Broker Adderss:填写MQTT服务器地址
- Broker Port:填写MQTT服务器端口,常规为1883
- Cilent ID:客户端ID具备唯一性,即连接到同一个MQTT服务器的客户端需具备不同客户端ID,可点击“Generate”自动生成。
- 保存配置后点击“Connect”,如果连接成功则MQTT服务器正常运行。
2.2 网关连接MQTT服务器
- 点击编辑应用,数据传输类型选择MQTT,并配置对应的MQTT参数与上下行主题;
- 保存配置后可通过状态来查看是否成功连接MQTT服务器。
2.3 获取上行数据
配置网关Uplink data上行主题。
格式要求:
-
- 主题可自定义,用“/”对主题进行分级处理。
主题示例:
-
- 网关Uplink Data发布主题:/milesight/uplink
- fx订阅主题:/milesight/uplink
2.4 配置下发控制
方式一:单点下发数据
配置网关Downlink data下行主题。
格式要求:
-
- /milesight/downlink/$deveui,其中/$deveui为固定格式,其他层级内容可自定义
主题示例:
下发指令到deveui为24e1641194715215的设备。
-
- 网关Downlink Data订阅下行主题:/milesight/downlink/$deveui
- fx发布主题:/milesight/downlink/24e1641194715215
内容示例:
{"confirmed": true,"fport": 85,"data": "CQEA/w=="}
内容解析:下发端口为85,内容为CQEA/w==,启用确认包
注意:
-
- 下发内容只能使用Base 64格式,可以通过Hex转Base64进行数据转换。
- 下发时注意对应终端节点设备的类型,只有Class C类的终端节点设备才会及时下行与回复,Class A类终端节点设备需等待终端节点上报数据后才可成功下发。
方式二:节点DevEUI在下发内容里面
网关Downlink data下行主题格式以斜杆开头,内容可自定义。
主题示例:
- 网关Downlink Data下行主题配置:/milesight/downlink
- fx发布主题配置:/milesight/downlink
通过MQTTx客户端下发指令到deveui为24E124460E040073的阀控器设备。
2.5 MQTT组播下发控制
配置网关Multicast downlink data下行主题。
主题示例:
-
- 网关Multicast downlink data订阅组播主题:/milesight/mult_downlink/0000001
- fx发布主题:/milesight/mult_downlink/0000001
注意:主题格式可自定义,两个主题一致即可。相同的下发主题,通过multicastName(组名)区分不同的组播分组。
内容示例:
{"multicastName":"222222","fPort":85,"data":"CAAA/w=="}
内容解析:222222组名,下发端口85,下发内容CAAA/w==
2.6 补充说明
1.下发控制之后mqtt看不见设备回复
解决方法:
前提条件:下发mqtt指令时下发的是确认包格式true{"confirmed": true,"fport": 85,"data": "下发控制指令的base64格式"};
在网关mqtt应用里面添加ACK notification 主题(主题可自定义),设置完成—在mqtt平台订阅此主题就行。