BL102 使用技巧视频操作
金鸽 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"，代表此为平台下行数据。
注意：布尔量下发值不带双引号，数值型下发的值要带双引号。