PLC采集网关MQTT上云平台操作技巧

金鸽 MQTT 的配置

操作步骤：（1）双击“金鸽 IoT”弹出金鸽 MQTT 配置框。（2）点击启用按钮，

启用金鸽 MQTT。默认：关闭。灰色表示：不启用，绿色表示：启用。（3）IP/域名：

1883.dtuip.com，默认填写好，不需要填写。（4）端口：1883，默认填写好，不需要

填写。（5）Client ID：填写金鸽平台的序列号，需要联系销售提供序列号。（6）用户

名：MQTT，默认填写好，不需要填写。（7）密码：MQTTPW，默认填写好，不需要

填写。（8）订阅主题：填写格式：金鸽平台的序列号/+，需要联系销售提供序列号。

（9）发布主题：填写金鸽平台的序列号，需要联系销售提供序列号。（10）上传周

期：数据定时发布间隔时间，默认 30S。（11）MQTT 数据补传：是否启用掉线数据补

传，点击按钮启用。灰色表示：不启用，绿色表示：启用。（12）选择数据点上传：在

配置框右边的方框内选择要上传的数据点，默认空白表示全部上传。（13）点击“确

定”，确定金鸽 MQTT 的配置。（14）点击“写入配置”，网关设备重启后，金鸽

MQTT 才启用。重新打开配置软件登录设备，可以在基本信息页面可以看到“金鸽

MQTT 上线状态”的提示灯是绿色，表示金鸽 MQTT 已连接上。最右边显示从机设备

在线的状态。

5.4.16 在金鸽云上查看和下发数据

在平台上先配置数据点，在配置数据点的标识符，标识符与配置软件的 MQTT 标

识一致。部分数据点配置如下。如：采集 S7-200SMART 数据点 VW0，在配置软件上

的 MQTT 标识为“VW0”，则金鸽云上读写标识要为“VW0”。

5.4.17 金鸽 MQTT 的数据格式

MQTT Client 和 MQTT Client II 的“KingPigeon”JSON 数据格式和金鸽 MQTT 的

数据格式一样详情如下

1）设备发布消息中有效载荷数据格式

发布主题：序列号（对应配置的发布主题设置项）

{

"sensorDatas": [

{

//布尔量

"flag": "Y0", //读写标识

"switcher": 1 //数据类型及值

},

{

//数值型

"flag": "VW0", //读写标识

"value": 8 //数据类型及值

},

{

//4G 模块信号值

"flag": " signal_strength ", //读写标识，标识符固定不能修改

"value": 28 //数据类型及值

}

]"state":"alarm", //报警标识符（配置软件“报警与事件”配置有报警事件，触

发报警时才有此标识，定时上报数据无此标识）

"state":"recovery", //报警恢复标识符（报警恢复时才有此标识，定时上报数据

无此标识）

"gateway_indentify": "BeiLai Gateway" //网关名称标识符，上传网关名称

"time": "1622700769", //时间标识符，数据发布的时间戳

"addTime": "2021-06-03 06:12:49" //时间标识符，上传网关的时间

"retransmit":"enable" //重传标识符，表示 MQTT 历史数据（有重传历史数据时

才有此标识，定时上报数据无此标识）

}注：

//读写标识：字符为"flag"，其后为"数据点的 MQTT 标识符"，添加数据点时填写

的 MQTT 标识符，可以自主定义。

//数据类型及值：根据类型分为：

1、布尔量数据：字符为"switcher"，其后为"0"或"1"（0 代表断开，1 代表闭

合）。

2、数值型数据：字符为"value"，其后为"具体数值"。

//报警、恢复标识：字符为"state"，其后为"alarm"或"recovery"（alarm 代表报

警数据，recovery 代表报警恢复数据）。

//网关名称标识：字符为"gateway_indentify"，其后为"网关的名称"。

//时间标识：字符为"time"，其后为"具体的上报时间戳"。

//时间标识：字符为"addtime"，其后为"网关的时间"。

//重传标识：字符为"retransmit"，其后为"enable"

网络掉线期间采集到的数据会暂存在设备，在网络恢复时重新发布，用“retransmit”字段标识，表示历史数据。（需要在配置界面上启用数据补传）

2）设备订阅消息中有效载荷数据格式

订阅主题：序列号/+（对应配置的订阅主题设置项）

（金鸽 2.0 下行发布报文用的主题名为“序列号/传感器 ID”，所以设备订阅主题

需要加上通配符“/+”，这样才能收到平台下发数据实现控制）

{

"sensorDatas":

[

{ //布尔量下发

"sensorsId": 211267, //平台传感器 ID

"switcher":1, //数据类型及值

"flag":"Y0" //读写标识

},

{ //数值型下发

"sensorsId": 160239, //平台传感器 ID

"value":"10", //数据类型及值

"flag":"VW0" //读写标识

}

],

"down":"down" //平台下行报文标识

}

注：

//平台传感器 ID：字符为"sensorsID"，其后为 ID 号（ID 由平台自动生成），自

建平台不用关心该项。

//数据类型及值：根据类型分为：

1、开关型数据：字符为"switcher"，其后为"0"或"1"（0 代表断开，1 代表闭

合）

2、数值型数据：字符为"value"，其后为"具体数值"

//读写标识：字符为"flag"，其后为"代表数据点的 MQTT 标识"

//平台下行报文标识：字符为"down"，其后为"down"，代表此为平台下行数据。

注意：布尔量下发值不带双引号，数值型下发的值要带双引号。