功能概述:
参考本文档可实现将传感器采集到的数据信息,以 Json 格式通过 Mqtt 传输给远端的云服务器。
Json 消息包含内容如下:
Json对象 |
描述 |
类型 |
单位 |
值域 |
---|
Uid |
设备唯一标识 |
字符串 |
无 |
无 |
Temp |
温度 |
浮点数 |
° |
0-45° |
Humi |
湿度 |
浮点数 |
% |
0-100 |
Cod |
COD |
浮点数 |
mg |
0-500mg |
发送的 Mqtt 消息 Json 字符串形式举例如下(以温湿度传感器为例):
{"Uid":"Test01","Temperature":25.2, "Humidity":76.7}
步骤一:接线
- 通过 DC 座或者端子座的 “+” 和 “-” 给设备提供 5-24V 电源
- "A" 和 "B" 接 485 总线的 A 和 B 端
- "ANT1" SMA 接口接 4G 天线,"ANT2" SMA 接口接 GPS 天线(如果ANT2有的话)
步骤二:拷贝代码
首先用 TypeC USB 数据线将设备和电脑连接,然后在电脑上会自动出现一个 1.6MB 大小的 U 盘(如果 U 盘大小是 0MB,则需用 FAT32 快速格式化该盘),接着将 /Code/ 文件夹中的 main.lua 代码文件拷贝覆盖至该 U 盘。
步骤三:更新配置信息
在 U 盘中用记事本或者其他代码文本编辑器打开 main.lua 代码文件,用户需编辑文件开头部分的 配置信息 ,替换成实际信息然后 ctrl+S 保存即可,最后拔掉 USB 线,设备此时如果仍有供电,则会自动耗时 2 秒时间更新代码,否则设备下次上电时会自动耗时 2 秒时间更新代码。需要更改的配置信息如下:
这里只需关心 Part1,Part3,Part5 参数即可。
SysMode = 1
SysGpsUse = "NO_GPS"
SysWorkInterval = 10
SysSleepEn = 0
SysMyID = "Test01"
MqttServerAddr = "mqtt.ctwing.cn"
MqttServerPort = 1883
MqttClientID = "15589964DTU01"
MqttUserName = "ShineBlink"
MqttPassword = "lMmugH2yURmY2uJqkNby-zQHGJ67ngjMAYR6kkGQmko"
MqttSubTopic = "device_control"
MqttPubTopic = "$device_send"
MbAddr = 0x01
MbBaudRate = "BAUDRATE_9600"
(1)工作模式配置
[SysMode] 需设置成 1 ,表示设备以 4G_Mqtt 模式工作。
(2)GPS 功能关闭(默认不带GPS)
[SysGpsUse] 需设置成 "NO_GPS",如需GPS功能需另外定制带GPS定位功能的4G模组。
(3)Modbus 传感器参数配置
[MbAddr] 为传感器的 Modbus 地址,默认需设置为 0x01
[MbBaudRate] 为传感器的 485 通信波特率,默认需设置为 "BAUDRATE_9600"
(4)Mqtt 通信配置
上面Part3中的 Mqtt 参数是以接入天翼云(Ctwing)为案例填写的,用户需要根据自己所接的 Mqtt 云服务器做相应的更改。
(5)采集传输工作周期设置
[SysWorkInterval] 该值设置的越大工作采样和传输间隔时间越长,这样可以减少 Sim 卡流量的消耗,建议结合实际情况设置,单位秒。
(6)低功耗休眠功能开启(需外挂 BatteryFriend )
[SysSleepEn] 设置为 1 时将开启低功耗功能。当该功能开启后,设备每次采集并传输完数据后将进入休眠状态,休眠时间为 [SysWorkInterval] 秒,休眠期间设备的电流仅为 uA 级别。
注意1:如果没有外挂 BatteryFriend 电池低功耗管理硬件设备, [SysSleepEn] 即使设置为 1 也不会有低功耗休眠功能!
注意2:BatteryFriend 和本设备配合使用的教程请访问ShineBlink 的gitee开源仓库
步骤四:开始工作
上电后观察设备的 LED 指示灯状态:
白色:表明刚上电
红色:表明已检测到 Sim 卡
蓝色:表明已连上附近基站
绿色:表明已和服务器建立连接
测试方法:
如果自己没有远端 Mqtt 测试服务器,可选择天翼云(Ctwing),OneNet,阿里云等作为设备 Mqtt 接入的云,这里我们以天翼云中的 Mqtt 透传服务作为例子来演示 Mqtt 的接入,其他云的接入也就大同小异。
服务器接入实例教程请访问ShineBlink 的gitee开源仓库