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地址) | 根据实际情况填写，可以为空 |
| serialNuｍ(网关可用串口数量) | 根据实际情况填写，可以为空 |
| ethNuｍ(网关可用网口数量) | 根据实际情况填写，可以为空 |
| 反馈超时时间(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