迅鸣物联网文档

迅鸣物联网文档


4G产品MQ协议_V2

硬件V2协议

一、参数说明

  • devicesn: devicesn 是区分网关设备与网关子设备的,topic地址里有个网关sn,子设备sn = 网关sn + devicesn,如果devicesn是空的就代表这条数据是网关数据
  • Mode_id:数据解析规则编号,每个mode_id对应独立的云端数据解析器。网关设备的mode_id为 2006
  • servicesid :设备控制页面匹配用,每个serviceid都有独立的展示页面。
  • timeStamp:时间戳,避免收到过期指令。(暂未使用)
  • node_id : 网关那边区分设备用的
  • action:指令集。Command:触发上报数据及控制指令。Sync:定时上报数据,时间可配置。Config:配置设备及读取设备配置。
  • params:
KEY 名称 范围/阈值 指令集 示例 数据类型 上报频率 备注
11 true/false command/ sync {"11":true} boolean 触发/定时 发给设备则是控制指令
12 温度2 -80~+100℃ sync {"12":" 36.5" } String 定时 外置温度传感器
23 温度2告警 command {"12":38,"23":1} Number 触发 只有command时发送,1为大于阈值告警,2为小于阈值告警
13/14 GPS sync {"13":"29.6167812","14":" 106.5049362"} String 触发的定时 直接可用经纬度。(震动触发,震动停止后延时5分钟停止)
15 信号强度 sync {"15":"72"} String 定时 百分比
16/17 温湿度-温度/湿度 -40~85℃/0-95% sync {"16":36.5, "17":72} Number 定时 湿度为百分比
18/19 AGPS sync {"18":"29.6167812","19":" 106.5049362"} String 每1小时 直接可用经纬度
20 电量 sync {"20":"80"} String 定时 百分比
21 是否倾倒 true/false command {"21":true} boolean 触发 倾倒为true不倾倒为false
22 温度1 -40~+85℃ sync {"22":"37.6"} String 定时
24 继电器 true/false command/ sync {"24":true} boolean 触发/定时 发给设备则是控制指令
25 12温度的上限 -80~+100℃ config {"25":"100" } String \
26 12温度的下限 -80~+100℃ config {"26":"-80" } String \
27 12温度告警的回差 config {"27":"5" } String \
28 采集周期 10-3600 config {"28":"3600"} String \ 单位/秒
29 配置二维码 | config String \ URL最大长度100
30 位移检测阈值 | config String \ 单位mg
31 碰撞检测阈值 | config String \ 单位mg
32 倾倒检测阈值 | config String \ 单位°
40 播放语音 | command {"40":"欢迎"} String \ ""空表示停止播放
41 播放音量 1-7 command {"40":"欢迎","41":7} Number \ 可省略,默认系统设置音量
42 是否循环播放 true/false command {"40":"欢迎","42":false} boolean \ 可省略,默认false
43 语音文本编码 true/false command {"40":"欢迎","43":false} boolean \ 可省略,默认false;true=utf8,false=gb2312
46 开锁保持时间 1-3600,000 command {"24":true,"46":1000} Number \ 可省略,单位:ms。默认系统设置保持时间,0=常开

二、数据上报数据展示

1SYNC 定时上报数据样例 :

Topic: /xm/sh/response/mqtt/网关sn号/2006/v2

Data:

{
"header":{"timeStamp":""},
"payload":{
"devices":[{
"devicesn":"",
"action":"sync",
"params":{
"11":true,
"12":"36.5",
"13":"29.124653",
"14":"106.45633",
"15":"72",
"16":"36.5",
"17":"72",
"18":"29.123456",
"19":"106.45678",
"20":"59",
"21":true
},
"serviceid":"20060101"
}]
}
}

2Conmmand 触发上报样例 :

示例: 温度大于阈值告警

Topic: /xm/sh/response/mqtt/网关sn号/2006/v2

Data:

{"header":{"timeStamp":""},"payload":{"devices":[{"devicesn":"","action":"command","params":{"12":"36.5","23":"1"},"serviceid":"20060101"}]}}

三、下发配置数据(旧,逐步淘汰)

配置温度告警阈值示例:

Topic: /xm/sh/request/mqtt/网关sn号/2006/v2

Data:

{"header":{"timeStamp":""},"payload":{"devices":[{"devicesn":"","action":"config","params":{"12":"36.5","23":"1"},"serviceid":"20060101"}]}}

三、非常规配置修改查询(新)

(根据配置变量名直接操作,变量名见产品资料,不同4g产品配置不同。) 下发非常规配置:

{"header":{"timeStamp":""},"payload":{"devices":[{"action":"writeconfig","params":{"PT100_DIFF":100}}]}}

非常规配置读取

{"header":{"timeStamp":""},"payload":{"devices":[{"action":"readconfig","params":{"PT100_DIFF":100}}]}}

四、下发控制指令:

开锁示例:

Topic: /xm/sh/request/mqtt/网关sn号/2006/v2

Data:

{"header":{"timeStamp":""},"payload":{"devices":[{"devicesn":"","action":"command","params":{"11":true}}]}}

注意: ①全部为英文字符。 ②不能有空格。

五、注意事项:

1.GPS需要到室外才能获取到数据,无效数据不发,空旷区域定位大约需要1分钟

六、智能终端功能:

冷链项目显示屏内容解释如下:

区域 内容 备注
全局信息 时间 联网后自动校准
日期 联网后自动校准
信号强度 >1 格信号有效,否则数据传输不稳定
电量 检测外部供电池电量,电池电压 12v
区域 内容 备注
状态显示 锁 1 锁 1 的开关状态
继电器 继电器的开关状态
震动 检测到震动后显示,延时 5s 后隐藏,会触发 GPS 开机
倾斜 检测到倾倒后显示,恢复后延时 5s 隐藏,可设置检测角度
碰撞 检测到碰撞后显示,恢复后延时 5s 隐藏,可设置碰撞强度
区域 内容 备注
计时 开机时间 开机到现在的运行时间,单位秒
区域 内容 备注
环境温湿度 温度 SHT3X 的温度
最大值 开机到现在的温度最大值
最小值 开机到现在的温度最大值
湿度 SHT3X 的湿度
最大值 开机到现在的湿度最大值
最小值 开机到现在的湿度最小值
区域 内容 备注
外部温度 告警最大值 外部温度传感器的告警最大值,支持小数点后 1 位
告警最小值 外部温度传感器的告警最小值,支持小数点后 1 位
最大值 开机到现在外部温度传感器的温度最大值
最小值 开机到现在外部温度传感器的温度最小值
平均值 开机到现在外部温度传感器的平均值
告警保持时间 开机到现在外部温度传感器超过告警阈值后持续的时间
当前温度 外部温度传感器当前值
区域 内容 备注
定位 AGPS 有 4G 信号即可定位,精度±50m,1 小时上报 1 次,仅获取到有效数据时上报
GPS 室外有效,空旷区域定位时间<1 分钟,精度±5m,GPS 运行时图标会闪烁,震动触发开启,并延时 3 分钟关闭,仅获取到有效数据时上报

[点击查看 4G 智能终端产品简介](https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=dbb1b175bb2e1a843c01cc0cedd19148 "[迅鸣物联网智能终端功能列表.pdf")

页面列表

ITEM_HTML