XinAo_ShuNengWuLian_MQTT
协议文本详情请见《微控-MQTT数据格式规范 v2.2.2 正式发布版.pdf》
准备工作
- MQTT服务器通讯参数,如:ClientID、Username、Password、hostName(MQTT服务器IP地址或者域名)、Port(端口号)
- 仪表(被采集设备)的通讯点表,即公共地址、功能类型、信息序号、组号条目号等
- 仪表(被采集设备)物理链路正确接入网关
一、通道配置
1.1 通讯配置
需要在Net下创建通道
“传输层协议”无需选择
“应用层协议”选择“XinAo_ShuNengWuLian_MQTT”协议。
1.2 驱动属性配置
参数 | 说明 |
---|---|
ClientID | 可为空。填写MQTT的设备客户端ID |
Username | MQTT服务器用户名 |
Password | MQTT服务器密码 |
hostName | MQTT服务器地址 |
Port | MQTT服务器端口号 |
Version | 平台物联网云平台使用的MQTT协议均为3.1或3.1.1版本 |
QOS subscribe | 订阅的消息质量为QoS1 |
QOS published | 发布的消息质量为QoS1 |
KeepAlive(s) | 心跳设定。通过KeepAlive参数设置保活周期,取值范围为10~300,默认为30s |
cleanSession | 0-false —— 开启会话重用机制。网络断开重连后,恢复之前的Session信息。需要客户端和服务器有相关Session持久化机制。 1-true —— 关闭会话重用机制。每次Connect都是一个新Session,会话仅持续和网络连接同样长的时间。 |
pKey(供应商产品系列编号*) | 必填项,topic的一部分,应由平台应用定义和提供 |
sn(物联网关编号*) | 必填项,topic的一部分,应由平台应用定义和提供 |
compId(厂家ID) | 根据实际情况填写,可以为空 |
name(设备名称) | 根据实际情况填写,可以为空 |
sVer(软件版本) | 根据实际情况填写,可以为空 |
hVer(硬件版本) | 根据实际情况填写,可以为空 |
meId(移动设备识别码) | 根据实际情况填写,可以为空 |
loc(经纬度,用逗号分隔经纬度,可缺省) | 根据实际情况填写,可以为空 |
encr(加密方式) | 根据实际情况填写,可以为空 |
connType(设备通信方式) | 根据实际情况填写,可以为空 |
mac(MAC地址) | 根据实际情况填写,可以为空 |
serialNum(网关可用串口数量) | 根据实际情况填写,可以为空 |
ethNum(网关可用网口数量) | 根据实际情况填写,可以为空 |
反馈超时时间(ms) | 反馈超时时间(ms) |
数据周期(s) | 上送实时数据的数据周期(s),最小可为每秒传输一次 |
变化上传使能 | 无效 |
caCrt.pem | 仅当“encr”参数设置为“TLSv1”时,此参数有效,复制caCrt.pem文件的内容,拷贝到此处 |
clientCrt.pem | 仅当“encr”参数设置为“TLSv1”时,此参数有效,复制clientCrt.pem文件的内容,拷贝到此处 |
clientKey.key | 仅当“encr”参数设置为“TLSv1”时,此参数有效,复制clientKey.pKey文件的内容,拷贝到此处 |
单个离线文件占用存储空间(单位:字节) | 默认为102400 |
所有离线文件占用存储总空间(单位:字节) | 默认为10240000 |
v类型,值类型 | 0:值为数值类型;1:值为字符串类型(保留3位小数) |
二、设备配置
2.1 基本信息
参数 | 说明 |
---|---|
名称 | 设备名称,自定义 |
描述 | 设备描述,自定义 |
sysId | sysId(sysId为系统编码,可缺省,当一个网关传送多个站(系统)时才填写) |
dev(采集设备id序列号,可缺省,缺省或为0代表整个网关数据) | dev(采集设备id序列号,可缺省,缺省或为0代表整个网关数据) |
2.2 点表
关联需要转发的点
参数 | 说明 |
---|---|
采集点名 | 会按照"变量名"和通道自动生成 |
变量名 | 变量名 |
变量描述 | 变量描述 |
变量编号 | 变量编号 |
m(指标名称) | 指标名称,可表示为测点名称、测点ID等。 m(指标名称)为空时,报文中使用"采集点名"作为m(指标名称) |
如需协议文本请联系我公司。
三、常见问题
如果不能正常通讯,请依次检查下列设置:
1、 检查网络是否通畅
2、 注意一个网关只允许出现一个该驱动,检查下是否存在多个通道使用该驱动
3、离线报文过多时可能会造成网关无法正常通讯
4、MQTT的clientId是由pKey和sn参数组合而成的,格式为${pKey}D${sn},注意不要将clientId应为唯一参数,不应与其它网关的clientId相同
5、检查Username和Password配置是否正确
6、检查hostName和Port参数配置是否正确
7、如果使用arm型号网关,需要安装TF卡,用于离线数据和数据存储
更新时间 2022年10月18日15:24:03