迅鸣物联网文档

迅鸣物联网文档


4G产品MQ协议_V2

<h1>硬件V2协议</h1> <p><code>**提示:只有comm与sync指令的parmas分v1与v2协议,其他指令不分;**</code></p> <h2>一、参数说明</h2> <ul> <li>devicesn: devicesn 是区分网关设备与网关子设备的,topic地址里有个网关sn,子设备sn = 网关sn + devicesn,如果devicesn是空的就代表这条数据是网关数据</li> <li>Mode_id:数据解析规则编号,每个mode_id对应独立的云端数据解析器。网关设备的mode_id为 2006</li> <li>servicesid :设备控制页面匹配用,每个serviceid都有独立的展示页面。</li> <li>timeStamp:时间戳,避免收到过期指令。(暂未使用)</li> <li>node_id : 网关那边区分设备用的</li> <li>action:指令集。Command:触发上报数据及控制指令。Sync:定时上报数据,时间可配置。Config:配置设备及读取设备配置。</li> <li>params:</li> </ul> <table> <thead> <tr> <th>KEY</th> <th>名称</th> <th>范围/阈值</th> <th>指令集</th> <th>示例</th> <th>数据类型</th> <th>上报频率</th> <th>备注</th> </tr> </thead> <tbody> <tr> <td>11</td> <td>锁</td> <td>true/false</td> <td>command/ sync</td> <td>{&quot;11&quot;:true}</td> <td>boolean</td> <td>触发/定时</td> <td>发给设备则是控制指令</td> </tr> <tr> <td>12</td> <td>温度2</td> <td>-80~+100℃</td> <td>sync</td> <td>{&quot;12&quot;:&quot; 36.5&quot; }</td> <td>String</td> <td>定时</td> <td>外置温度传感器</td> </tr> <tr> <td>23</td> <td>温度2告警</td> <td>command</td> <td>{&quot;12&quot;:38,&quot;23&quot;:1}</td> <td>Number</td> <td>触发</td> <td>只有command时发送,1为大于阈值告警,2为小于阈值告警</td> </tr> <tr> <td>13/14</td> <td>GPS</td> <td>sync</td> <td>{&quot;13&quot;:&quot;29.6167812&quot;,&quot;14&quot;:&quot; 106.5049362&quot;}</td> <td>String</td> <td>触发的定时</td> <td>直接可用经纬度。(震动触发,震动停止后延时5分钟停止)</td> </tr> <tr> <td>15</td> <td>信号强度</td> <td>sync</td> <td>{&quot;15&quot;:&quot;72&quot;}</td> <td>String</td> <td>定时</td> <td>百分比</td> </tr> <tr> <td>16/17</td> <td>温湿度-温度/湿度</td> <td>-40~85℃/0-95%</td> <td>sync</td> <td>{&quot;16&quot;:36.5, &quot;17&quot;:72}</td> <td>Number</td> <td>定时</td> <td>湿度为百分比</td> </tr> <tr> <td>18/19</td> <td>AGPS</td> <td>sync</td> <td>{&quot;18&quot;:&quot;29.6167812&quot;,&quot;19&quot;:&quot; 106.5049362&quot;}</td> <td>String</td> <td>每1小时</td> <td>直接可用经纬度</td> </tr> <tr> <td>20</td> <td>电量</td> <td>sync</td> <td>{&quot;20&quot;:&quot;80&quot;}</td> <td>String</td> <td>定时</td> <td>百分比</td> </tr> <tr> <td>21</td> <td>是否倾倒</td> <td>true/false</td> <td>command</td> <td>{&quot;21&quot;:true}</td> <td>boolean</td> <td>触发</td> <td>倾倒为true不倾倒为false</td> </tr> <tr> <td>22</td> <td>温度1</td> <td>-40~+85℃</td> <td>sync</td> <td>{&quot;22&quot;:&quot;37.6&quot;}</td> <td>String</td> <td>定时</td> </tr> <tr> <td>23</td> <td>温度报警</td> <td>0,1,2</td> <td>alarm</td> <td>{&quot;22&quot;:&quot;37.6&quot;}</td> <td>String</td> <td>定时</td> <td>0恢复报警,1高温报警,2低温报警</td> </tr> <tr> <td>24</td> <td>继电器</td> <td>true/false</td> <td>command/ sync</td> <td>{&quot;24&quot;:true}</td> <td>boolean</td> <td>触发/定时</td> <td>发给设备则是控制指令</td> </tr> <tr> <td>25</td> <td>12温度的上限</td> <td>-80~+100℃</td> <td>config</td> <td>{&quot;25&quot;:100 }</td> <td>Number</td> <td>\</td> <td>25/26/27必须一起上报</td> </tr> <tr> <td>26</td> <td>12温度的下限</td> <td>-80~+100℃</td> <td>config</td> <td>{&quot;26&quot;:-80 }</td> <td>Number</td> <td>\</td> <td>25/26/27必须一起上报</td> </tr> <tr> <td>27</td> <td>12温度告警的回差</td> <td>∞</td> <td>config</td> <td>{&quot;27&quot;:5 }</td> <td>Number</td> <td>\</td> <td>25/26/27必须一起上报</td> </tr> <tr> <td>28</td> <td>采集周期</td> <td>10-3600</td> <td>config</td> <td>{&quot;28&quot;:&quot;3600&quot;}</td> <td>String</td> <td>\</td> <td>单位/秒</td> </tr> <tr> <td>29</td> <td>配置二维码</td> <td>| config</td> <td>String</td> <td>\</td> <td>URL最大长度100</td> </tr> <tr> <td>30</td> <td>位移检测阈值</td> <td>| config</td> <td>String</td> <td>\</td> <td>单位mg</td> </tr> <tr> <td>31</td> <td>碰撞检测阈值</td> <td>| config</td> <td>String</td> <td>\</td> <td>单位mg</td> </tr> <tr> <td>32</td> <td>倾倒检测阈值</td> <td>| config</td> <td>String</td> <td>\</td> <td>单位°</td> </tr> <tr> <td>40</td> <td>播放语音</td> <td>| command</td> <td>{&quot;40&quot;:&quot;欢迎&quot;}</td> <td>String</td> <td>\</td> <td>&quot;&quot;空表示停止播放</td> </tr> <tr> <td>41</td> <td>播放音量</td> <td>1-7</td> <td>command</td> <td>{&quot;40&quot;:&quot;欢迎&quot;,&quot;41&quot;:7}</td> <td>Number</td> <td>\</td> <td>可省略,默认系统设置音量</td> </tr> <tr> <td>42</td> <td>是否循环播放</td> <td>true/false</td> <td>command</td> <td>{&quot;40&quot;:&quot;欢迎&quot;,&quot;42&quot;:false}</td> <td>boolean</td> <td>\</td> <td>可省略,默认false</td> </tr> <tr> <td>43</td> <td>语音文本编码</td> <td>true/false</td> <td>command</td> <td>{&quot;40&quot;:&quot;欢迎&quot;,&quot;43&quot;:false}</td> <td>boolean</td> <td>\</td> <td>可省略,默认false;true=utf8,false=gb2312</td> </tr> <tr> <td>46</td> <td>开锁保持时间</td> <td>1-3600,000</td> <td>command</td> <td>{&quot;24&quot;:true,&quot;46&quot;:1000}</td> <td>Number</td> <td>\</td> <td>可省略,单位:ms。默认系统设置保持时间,0=常开</td> </tr> </tbody> </table> <h2>二、数据上报数据展示</h2> <p><strong>1</strong> 、 <strong>SYNC</strong> 定时上报数据样例 :</p> <p>Topic: /xm/sh/response/mqtt/网关sn号/2006/v2</p> <p>Data:</p> <pre><code class="language-json">{ &amp;quot;header&amp;quot;:{&amp;quot;timeStamp&amp;quot;:&amp;quot;&amp;quot;}, &amp;quot;payload&amp;quot;:{ &amp;quot;devices&amp;quot;:[{ &amp;quot;devicesn&amp;quot;:&amp;quot;&amp;quot;, &amp;quot;action&amp;quot;:&amp;quot;sync&amp;quot;, &amp;quot;params&amp;quot;:{ &amp;quot;11&amp;quot;:true, &amp;quot;12&amp;quot;:&amp;quot;36.5&amp;quot;, &amp;quot;13&amp;quot;:&amp;quot;29.124653&amp;quot;, &amp;quot;14&amp;quot;:&amp;quot;106.45633&amp;quot;, &amp;quot;15&amp;quot;:&amp;quot;72&amp;quot;, &amp;quot;16&amp;quot;:&amp;quot;36.5&amp;quot;, &amp;quot;17&amp;quot;:&amp;quot;72&amp;quot;, &amp;quot;18&amp;quot;:&amp;quot;29.123456&amp;quot;, &amp;quot;19&amp;quot;:&amp;quot;106.45678&amp;quot;, &amp;quot;20&amp;quot;:&amp;quot;59&amp;quot;, &amp;quot;21&amp;quot;:true }, &amp;quot;serviceid&amp;quot;:&amp;quot;20060101&amp;quot; }] } } </code></pre> <p><strong>2</strong> 、 <strong>Conmmand</strong> 触发上报样例 :</p> <p>示例: 温度大于阈值告警</p> <p>Topic: /xm/sh/response/mqtt/网关sn号/2006/v2</p> <p>Data:</p> <pre><code class="language-json">{&amp;quot;header&amp;quot;:{&amp;quot;timeStamp&amp;quot;:&amp;quot;&amp;quot;},&amp;quot;payload&amp;quot;:{&amp;quot;devices&amp;quot;:[{&amp;quot;devicesn&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;action&amp;quot;:&amp;quot;command&amp;quot;,&amp;quot;params&amp;quot;:{&amp;quot;12&amp;quot;:&amp;quot;36.5&amp;quot;,&amp;quot;23&amp;quot;:&amp;quot;1&amp;quot;},&amp;quot;serviceid&amp;quot;:&amp;quot;20060101&amp;quot;}]}}</code></pre> <h2>三、下发配置数据(旧,逐步淘汰)</h2> <p>配置温度告警阈值示例:</p> <p>Topic: /xm/sh/request/mqtt/网关sn号/2006/v2</p> <p>Data:</p> <pre><code class="language-json">{&amp;quot;header&amp;quot;:{&amp;quot;timeStamp&amp;quot;:&amp;quot;&amp;quot;},&amp;quot;payload&amp;quot;:{&amp;quot;devices&amp;quot;:[{&amp;quot;devicesn&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;action&amp;quot;:&amp;quot;config&amp;quot;,&amp;quot;params&amp;quot;:{&amp;quot;12&amp;quot;:&amp;quot;36.5&amp;quot;,&amp;quot;23&amp;quot;:&amp;quot;1&amp;quot;},&amp;quot;serviceid&amp;quot;:&amp;quot;20060101&amp;quot;}]}}</code></pre> <h2>三、非常规配置修改查询(新)</h2> <p>(根据配置变量名直接操作,变量名见产品资料,不同4g产品配置不同。) <strong>下发非常规配置:</strong></p> <pre><code class="language-json">{&amp;quot;header&amp;quot;:{&amp;quot;timeStamp&amp;quot;:&amp;quot;&amp;quot;},&amp;quot;payload&amp;quot;:{&amp;quot;devices&amp;quot;:[{&amp;quot;action&amp;quot;:&amp;quot;writeconfig&amp;quot;,&amp;quot;params&amp;quot;:{&amp;quot;PT100_DIFF&amp;quot;:100}}]}}</code></pre> <p><strong>通过串口方式操作:</strong></p> <pre><code class="language-json">//串口发送指令需要在json前面加引导符“+comm,”。 //发送 (提示读取参数值必须有,不使用但json解析需要,可固定为“0”) &amp;gt;[Tx-&amp;gt;][下午 7:17:42][asc] +comm,{&amp;quot;header&amp;quot;:{&amp;quot;timeStamp&amp;quot;:&amp;quot;&amp;quot;},&amp;quot;payload&amp;quot;:{&amp;quot;devices&amp;quot;:[{&amp;quot;action&amp;quot;:&amp;quot;writeconfig&amp;quot;,&amp;quot;params&amp;quot;:{&amp;quot;POWER_CHECK_WAIT_TIM&amp;quot;:5000}}]}} &amp;gt;[Rx&amp;lt;-][下午 7:17:42][asc] set POWER_CHECK_WAIT_TIM=5000 is true, //读取 &amp;gt;[Tx-&amp;gt;][下午 7:17:57][asc] +comm,{&amp;quot;header&amp;quot;:{&amp;quot;timeStamp&amp;quot;:&amp;quot;&amp;quot;},&amp;quot;payload&amp;quot;:{&amp;quot;devices&amp;quot;:[{&amp;quot;action&amp;quot;:&amp;quot;readconfig&amp;quot;,&amp;quot;params&amp;quot;:{&amp;quot;POWER_CHECK_WAIT_TIM&amp;quot;:00}}]}} &amp;gt;[Rx&amp;lt;-][下午 7:17:57][asc] sync,00,20070101,{&amp;quot;POWER_CHECK_WAIT_TIM&amp;quot;:5000}</code></pre> <h2>四、下发控制指令:</h2> <p>开锁示例:</p> <p>Topic: /xm/sh/request/mqtt/网关sn号/2006/v2</p> <p>Data:</p> <pre><code class="language-json">{&amp;quot;header&amp;quot;:{&amp;quot;timeStamp&amp;quot;:&amp;quot;&amp;quot;},&amp;quot;payload&amp;quot;:{&amp;quot;devices&amp;quot;:[{&amp;quot;devicesn&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;action&amp;quot;:&amp;quot;command&amp;quot;,&amp;quot;params&amp;quot;:{&amp;quot;11&amp;quot;:true}}]}}</code></pre> <p><strong>注意: ①全部为英文字符。 ②不能有空格。</strong></p> <h2>五、注意事项:</h2> <p><strong>1、GPS需要到室外才能获取到数据,无效数据不发,空旷区域定位大约需要1分钟。</strong> <strong>2、20230806日后发货设备,版本号3.3.7以后,支持默认密码写配置(默认密码:13256666293),默认配置不可读取。</strong> <strong>3、配置工具使用“smartDTU configTool”,写配置将覆盖原配置,主要用于将设备“迅鸣云”迁移到“自建服务器”时使用。</strong></p> <h2>六、智能终端功能:</h2> <p><strong> 冷链项目显示屏内容解释如下: </strong></p> <p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=8d093c0b6430c66a8c29943fc2701133" alt="" /></p> <table> <thead> <tr> <th>区域</th> <th>内容</th> <th>备注</th> </tr> </thead> <tbody> <tr> <td>全局信息</td> <td>时间</td> <td>联网后自动校准</td> </tr> <tr> <td></td> <td>日期</td> <td>联网后自动校准</td> </tr> <tr> <td></td> <td>信号强度</td> <td>&gt;1 格信号有效,否则数据传输不稳定</td> </tr> <tr> <td></td> <td>电量</td> <td>检测外部供电池电量,电池电压 12v</td> </tr> </tbody> </table> <table> <thead> <tr> <th>区域</th> <th>内容</th> <th>备注</th> </tr> </thead> <tbody> <tr> <td>状态显示</td> <td>锁 1</td> <td>锁 1 的开关状态</td> </tr> <tr> <td></td> <td>继电器</td> <td>继电器的开关状态</td> </tr> <tr> <td></td> <td>震动</td> <td>检测到震动后显示,延时 5s 后隐藏,会触发 GPS 开机</td> </tr> <tr> <td></td> <td>倾斜</td> <td>检测到倾倒后显示,恢复后延时 5s 隐藏,可设置检测角度</td> </tr> <tr> <td></td> <td>碰撞</td> <td>检测到碰撞后显示,恢复后延时 5s 隐藏,可设置碰撞强度</td> </tr> </tbody> </table> <table> <thead> <tr> <th>区域</th> <th>内容</th> <th>备注</th> </tr> </thead> <tbody> <tr> <td>计时</td> <td>开机时间</td> <td>开机到现在的运行时间,单位秒</td> </tr> </tbody> </table> <table> <thead> <tr> <th>区域</th> <th>内容</th> <th>备注</th> </tr> </thead> <tbody> <tr> <td>环境温湿度</td> <td>温度</td> <td>SHT3X 的温度</td> </tr> <tr> <td></td> <td>最大值</td> <td>开机到现在的温度最大值</td> </tr> <tr> <td></td> <td>最小值</td> <td>开机到现在的温度最大值</td> </tr> <tr> <td></td> <td>湿度</td> <td>SHT3X 的湿度</td> </tr> <tr> <td></td> <td>最大值</td> <td>开机到现在的湿度最大值</td> </tr> <tr> <td></td> <td>最小值</td> <td>开机到现在的湿度最小值</td> </tr> </tbody> </table> <table> <thead> <tr> <th>区域</th> <th>内容</th> <th>备注</th> </tr> </thead> <tbody> <tr> <td>外部温度</td> <td>告警最大值</td> <td>外部温度传感器的告警最大值,支持小数点后 1 位</td> </tr> <tr> <td></td> <td>告警最小值</td> <td>外部温度传感器的告警最小值,支持小数点后 1 位</td> </tr> <tr> <td></td> <td>最大值</td> <td>开机到现在外部温度传感器的温度最大值</td> </tr> <tr> <td></td> <td>最小值</td> <td>开机到现在外部温度传感器的温度最小值</td> </tr> <tr> <td></td> <td>平均值</td> <td>开机到现在外部温度传感器的平均值</td> </tr> <tr> <td></td> <td>告警保持时间</td> <td>开机到现在外部温度传感器超过告警阈值后持续的时间</td> </tr> <tr> <td></td> <td>当前温度</td> <td>外部温度传感器当前值</td> </tr> </tbody> </table> <table> <thead> <tr> <th>区域</th> <th>内容</th> <th>备注</th> </tr> </thead> <tbody> <tr> <td>定位</td> <td>AGPS</td> <td>有 4G 信号即可定位,精度±50m,1 小时上报 1 次,仅获取到有效数据时上报</td> </tr> <tr> <td></td> <td>GPS</td> <td>室外有效,空旷区域定位时间&lt;1 分钟,精度±5m,GPS 运行时图标会闪烁,震动触发开启,并延时 3 分钟关闭,仅获取到有效数据时上报</td> </tr> </tbody> </table> <h2>[点击查看 4G 智能终端产品简介](<a href="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=dbb1b175bb2e1a843c01cc0cedd19148">https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=dbb1b175bb2e1a843c01cc0cedd19148</a> &quot;[迅鸣物联网智能终端功能列表.pdf&quot;)</h2>

页面列表

ITEM_HTML