概述

 星纵物联网关支持通过MQTT接口将数据对接第三方平台，本文介绍星纵物联网关通过MQTT对接第三方平台具体步骤。

准备

• 星纵物联LoRaWAN^®网关
• MQTT服务器（本文使用在线MQTT服务器）
• MQTT客户端（本文使用MQTTX工具）

步骤

1. 创建网关应用

1. 进入“Network Server > 应用”，若之前没有创建应用，则点击添加应用。

2. 自定义填写“名称”和“描述”，然后保存配置。

3. 若之前已有创建应用，则直接点击编辑应用。

2. MQTT对接

2.1 获取MQTT服务器地址（测试用）

注意：为快速测试，可临时使用免费公共MQTT服务器测试，实际项目建议使用自有MQTT服务器或支持MQTT连接的物联网平台。

公共MQTT服务器1：broker.emqx.io   端口1883   无账号密码，无证书（本文使用该服务器测试）
公共MQTT服务器2：test.mosquitto.org   端口1883   无账号密码，无证书
公共MQTT服务器3：broker.hivemq.com   端口1883   无账号密码，无证书

MQTTX客户端工具连接MQTT服务器：

2.2 网关连接MQTT服务器

1. 点击编辑应用，数据传输类型选择MQTT，并配置对应的MQTT参数与上下行主题；

2. 保存配置后可通过状态来查看是否成功连接MQTT服务器。

2.3 获取上行数据

配置网关Uplink data上行主题：

格式要求：

• • 主题可自定义，用“/”对主题进行分级处理。

主题示例：

• • 网关Uplink Data发布主题：/milesight/uplink/2026
  • MQTT客户端工具订阅主题：/milesight/uplink/2026

点击此处下载MQTT报文说明

点击此处下载LoRaObject对象

2.4 配置下发控制

注意：

1. UG63 V2和SG50网关仅支持方式2，无法使用方式1 。
2. 下发时注意对应终端节点设备的类型，只有Class C类的终端节点设备才会及时下行与回复，Class A类终端节点设备需等待终端节点上报数据后才可成功下发。

方式1：节点devEUI携带在下发JSON载荷内（推荐）

配置网关Downlink data下行主题：

格式要求：

• • 主题可自定义，用“/”对主题进行分级处理。

主题示例：

• • 网关Downlink Data下行主题配置：/milesight/downlink/2026
  • MQTT客户端工具发布主题配置：/milesight/downlink/2026

下发JSON示例:

  {"devEUI":"24E124136E305969","confirmed":true,"fport":85,"data":"/xD/"}

字段详细解析：

{   
 “devEUI”: “24E124136E305969”,       #下发到devEUI为24E124136E305969的设备上  
“confirmed”: true,       #确认帧开关，true=启用确认包，false=禁用   
“fport”: 85,       #通信端口，星纵设备默认85；第三方设备请以原厂协议为准  
“data”: “/xD/”         #实际下发负载内容，网关默认使用Base64编码格式；HEX十六进制可通过工具一键转换，格式转换工具：HEX 转 Base64 在线工具
}

2. 下发指令后，可前往网关Network Server>数据流页面，查看下行数据包记录，确认指令是否下发成功。

方式2：节点DevEUI嵌入MQTT下行主题

配置网关Downlink data下行主题：

格式要求：

• • /milesight/downlink/$deveui，  其中/$deveui为固定格式，其他层级内容可自定义

主题示例：

下发指令到deveui为24E124136E305969的设备。

• • 网关Downlink Data订阅下行主题：/milesight/downlink/$deveui
  • MQTT客户端工具发布主题：/milesight/downlink/24E124136E305969

下发JSON示例:

{"confirmed":true,"fport":85,"data":"/xD/"}

字段详细解析：

{   
“confirmed”: true,      #确认帧开关，true=启用确认包，false=禁用   
“fport”: 85,          #通信端口，星纵设备默认85；第三方设备请以原厂协议为准   
“data”: “/xD/”      #实际下发负载内容，网关默认使用Base64编码格式；HEX十六进制可通过工具一键转换，格式转换工具：HEX 转 Base64 在线工具
}

2.5 MQTT组播下发控制

配置网关Multicast downlink data下行主题。

主题示例：

• • 网关Multicast downlink data订阅组播主题：/milesight/mult_downlink/0000001
  • MQTT客户端工具发布主题：/milesight/mult_downlink/0000001

注意：主题格式可自定义，两个主题一致即可。相同的下发主题，通过multicastName（组名）区分不同的组播分组。

下发JSON示例:

{"multicastName":"222222", "fPort":85, "data":"CAAA/w=="}

字段详细解析：

{   
“multicastName”: “222222”,     #组播组名  
“fPort”: 85,       #通信端口，星纵设备默认85；第三方设备请以原厂协议为准  
“data”: “CAAA/w==”    #实际下发负载内容，网关默认使用Base64编码格式；HEX十六进制可通过工具一键转换，格式转换工具：HEX 转 Base64 在线工具
}

2.6 新版本功能（dataType指定编码格式）

网关新版本支持通过dataType指定下发格式，支持hex/Base64/ASCII三种格式，未指定时默认Base64 。

• UG56：56.0.0.9 及以上
• UG65/UG67：60.0.0.49 及以上

下发内容示例：

{  
"devEUI": "24E124136E305969", 
"confirmed": true, 
"fport": 85, 
"dataType": "hex",
"data": "ff10ff" 
}

常见问题

1.下发控制指令后，mqtt看不见设备回复，如何处理？

• 前提条件:下发 MQTT 下行指令时，需开启确认帧模式，报文格式示例如下：

• 在网关mqtt应用里面添加ACK notification 主题（主题可自定义）,设置完成后在mqtt平台订阅此主题就行。