cmd报文接口详细文档

<h2>扫地机上传报文mqtt发送的topic格式</h2> <pre><code>BNIOT/ROBOT/{sno} sno为设备号</code></pre> <h2>数据包报文格式</h2> <pre><code>{ "cmd":103, "sno":"设备号", "data":{ } }</code></pre> <h2>字段描述</h2> <table> <thead> <tr> <th>字段名称</th> <th>字段类型</th> <th>字段描述</th> </tr> </thead> <tbody> <tr> <td>cmd</td> <td>int</td> <td>命令字 code码</td> </tr> <tr> <td>sno</td> <td>String</td> <td>设备号</td> </tr> <tr> <td>data</td> <td>object</td> <td>数据报文对象</td> </tr> </tbody> </table> <h2>cmd/code码说明描述</h2> <table> <thead> <tr> <th>CODE</th> <th>描述信息</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>设备心跳</td> </tr> <tr> <td>2</td> <td>历史清扫记录</td> </tr> <tr> <td>101</td> <td>app下发重建地图指令</td> </tr> <tr> <td>102</td> <td>app下发定位扫地机指令</td> </tr> <tr> <td>103</td> <td>配网成功</td> </tr> <tr> <td>104</td> <td>开启视频流</td> </tr> <tr> <td>105</td> <td>关闭视频流</td> </tr> <tr> <td>106</td> <td>前进</td> </tr> <tr> <td>107</td> <td>后退</td> </tr> <tr> <td>108</td> <td>向左</td> </tr> <tr> <td>109</td> <td>向右</td> </tr> <tr> <td>110</td> <td>暂停</td> </tr> <tr> <td>1000</td> <td>清扫方案——房间类型</td> </tr> <tr> <td>1010</td> <td>运行状态</td> </tr> <tr> <td>1015</td> <td>清扫方案</td> </tr> <tr> <td>1020</td> <td>是否使用清扫方案</td> </tr> <tr> <td>1050</td> <td>材料重置</td> </tr> <tr> <td>1100</td> <td>扫地机功能表</td> </tr> <tr> <td>11050</td> <td>设备定时器编辑</td> </tr> <tr> <td>11055</td> <td>设备定时器删除</td> </tr> <tr> <td>11250</td> <td>扫地机清扫模式编辑</td> </tr> <tr> <td>11251</td> <td>扫地机AI开关</td> </tr> <tr> <td>11252</td> <td>实时上传清扫信息(清扫面积、清扫时间、避障次数、电量、状态、)</td> </tr> <tr> <td>11253</td> <td>设置坐标信息(禁区等)</td> </tr> <tr> <td>11254</td> <td>指定区域清扫</td> </tr> <tr> <td>11255</td> <td>清洗抹布</td> </tr> <tr> <td>11256</td> <td>设备详情(wifi信号,版本,ip等)</td> </tr> <tr> <td>20000</td> <td>设备邀请</td> </tr> <tr> <td>20010</td> <td>设备扫码邀请</td> </tr> <tr> <td>20020</td> <td>设备邀请同意</td> </tr> <tr> <td>20030</td> <td>设备离线</td> </tr> <tr> <td>20040</td> <td>机器上传图片</td> </tr> </tbody> </table> <h2>cmd报文code=1</h2> <h4>心跳数据包，扫地机每间隔60秒上报一次</h4> <pre><code>{ "cmd":1, "sno":1, "data": null }</code></pre> <h5>字段描述</h5> <table> <thead> <tr> <th>字段名称</th> <th>字段类型</th> <th>字段描述</th> </tr> </thead> <tbody> <tr> <td>cmd</td> <td>int</td> <td>命令字 code码</td> </tr> <tr> <td>sno</td> <td>String</td> <td>设备号</td> </tr> <tr> <td>data</td> <td>object</td> <td>数据报文对象</td> </tr> </tbody> </table> <h2>cmd报文code=2</h2> <h4>历史清扫记录，扫地机每清扫完成一次上报清扫完成结果</h4> <pre><code>{ "cmd":2, "sno":1, "data": { "clean_method",1, "clean_area":100, "clean_time":60, "residual_electricity":80, "clean_state":1, "clean_type":1, "start_mode":1 } }</code></pre> <h5>data字段描述</h5> <table> <thead> <tr> <th>字段名称</th> <th>字段类型</th> <th>字段描述</th> </tr> </thead> <tbody> <tr> <td>clean_method</td> <td>int</td> <td>清扫方案 0指定房间，1全屋清扫 2指定区域</td> </tr> <tr> <td>clean_area</td> <td>int</td> <td>清扫面积 数值范围：0-9999 单位：㎡</td> </tr> <tr> <td>clean_time</td> <td>int</td> <td>清扫时间 默认区间为0min—9999分钟（没有小数点）</td> </tr> <tr> <td>residual_electricity</td> <td>int</td> <td>剩余电量 默认区间为0%—100%（没有小数点），如果需要显示为小数点</td> </tr> <tr> <td>clean_state</td> <td>int</td> <td>清扫转台：0：清扫中断 1：清扫完成</td> </tr> <tr> <td>clean_type</td> <td>int</td> <td>清扫类型：0安静 1：正常 2：强力</td> </tr> <tr> <td>start_mode</td> <td>int</td> <td>启动方式：0 设备端启动1：app启动</td> </tr> <tr> <td>start_mode</td> <td>int</td> <td>启动方式：0 设备端启动1：app启动</td> </tr> </tbody> </table> <h2>cmd报文code=101</h2> <h4>app下发重建地图指令，用户端下发指令</h4> <pre><code>{ "cmd":101, "sno":1, "data": null }</code></pre> <h2>cmd code=103</h2> <h4>配网状态，扫地机配网成功后校验设备是否被服务器接收，扫地机主动上报</h4> <pre><code>{ "cmd":103, "sno":"设备号", "data": { "status":1, "msg":"配网成功", "user_id":"123456812211248",//用户id } }</code></pre> <h5>字段描述</h5> <table> <thead> <tr> <th>字段名称</th> <th>字段类型</th> <th>字段描述</th> </tr> </thead> <tbody> <tr> <td>status</td> <td>int</td> <td>配网状态 1成功，0失败</td> </tr> <tr> <td>msg</td> <td>String</td> <td>描述状态信息</td> </tr> <tr> <td>user_id</td> <td>long</td> <td>用户id</td> </tr> </tbody> </table> <h2>cmd code=104</h2> <h4>开启视频流，app下发指令打开摄像头</h4> <pre><code>{ "cmd":104 }</code></pre> <h2>cmd code=105</h2> <h4>关闭视频流，app下发指令关闭摄像头</h4> <pre><code>{ "cmd":105 }</code></pre> <h2>cmd code=106</h2> <h4>前进，app下发指令扫地机前进</h4> <pre><code>{ "cmd":106 }</code></pre> <h2>cmd code=107</h2> <h4>后退，app下发指令扫地机后退</h4> <pre><code>{ "cmd":107 }</code></pre> <h2>cmd code=108</h2> <h4>向左，app下发指令扫地机向左</h4> <pre><code>{ "cmd":108 }</code></pre> <h2>cmd code=109</h2> <h4>向右，app下发指令扫地机向右</h4> <pre><code>{ "cmd":109 }</code></pre> <h2>cmd code=110</h2> <h4>暂停，app下发指令扫地机向右</h4> <pre><code>{ "cmd":110 }</code></pre> <h2>cmd code=11250</h2> <h4>地机清扫模式编辑</h4> <pre><code>{ "cmd":11250, "data": { "water_volume":10, "suction":2, "forcibly_dragged":1, "clean_times":2, "model":1 } }</code></pre> <h5>data字段描述(必须会有一个字段存在)</h5> <table> <thead> <tr> <th>字段名称</th> <th>字段类型</th> <th>是否必填字段</th> <th>字段描述</th> </tr> </thead> <tbody> <tr> <td>water_volume</td> <td>int</td> <td>否</td> <td>水量 0：低1：中2：高</td> </tr> <tr> <td>suction</td> <td>int</td> <td>否</td> <td>清扫吸力：0安静 1：正常 2：强力</td> </tr> <tr> <td>forcibly_dragged</td> <td>int</td> <td>否</td> <td>电动强拖 1开 2关</td> </tr> <tr> <td>clean_times</td> <td>int</td> <td>否</td> <td>清扫次数 1开 2关</td> </tr> <tr> <td>model</td> <td>int</td> <td>否</td> <td>清扫模式 1：扫拖</td> </tr> </tbody> </table> <h2>cmd code=11252</h2> <h4>实时上传清扫信息(清扫面积、清扫时间、避障次数、电量、状态、)</h4> <pre><code>{ "cmd":11252, "data": { "clean_area":10, "clean_time":123456952232, "residual_electricity":80, "report_time":1461464561216, "clean_state":1, "clean_type":1, "start_mode":1 } }</code></pre> <h5>data字段描述</h5> <table> <thead> <tr> <th>字段名称</th> <th>字段类型</th> <th>字段描述</th> </tr> </thead> <tbody> <tr> <td>clean_area</td> <td>int</td> <td>清扫面积 数值范围：0-9999 单位：㎡</td> </tr> <tr> <td>clean_time</td> <td>int</td> <td>清扫时间 默认区间为0min—9999分钟（没有小数点）</td> </tr> <tr> <td>residual_electricity</td> <td>int</td> <td>剩余电量 默认区间为0%—100%（没有小数点），如果需要显示为小数点</td> </tr> <tr> <td>report_time</td> <td>long</td> <td>上报时间 数值型(时间戳)</td> </tr> <tr> <td>clean_state</td> <td>int</td> <td>清扫转台：0：清扫中断 1：清扫完成</td> </tr> <tr> <td>clean_type</td> <td>int</td> <td>清扫类型：0安静 1：正常 2：强力</td> </tr> <tr> <td>start_mode</td> <td>int</td> <td>启动方式：0 设备端启动1：app启动</td> </tr> <tr> <td>obstacles_num</td> <td>int</td> <td>避障次数</td> </tr> <tr> <td>end_time</td> <td>long</td> <td>清扫结束时间（时间戳秒） cmd为2时存在</td> </tr> </tbody> </table> <h2>cmd code=11256</h2> <h4>设备详情(wifi信号,版本,ip等)</h4> <pre><code>{ "cmd":11256, "data": {         "serial_number": 1,         "version": 60,         "mcu_version": null,         "wifi_version": "1",         "ip": "1",         "mac_addr": null, "wifi_strength":"",         "device_model": 1653613724000, "bind_time": 1 } }</code></pre> <h5>data字段描述</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">serial_number</td> <td style="text-align: left;">String</td> <td>序列号</td> </tr> <tr> <td style="text-align: left;">version</td> <td style="text-align: left;">String</td> <td>版本</td> </tr> <tr> <td style="text-align: left;">mcu_version</td> <td style="text-align: left;">String</td> <td>MCU版本</td> </tr> <tr> <td style="text-align: left;">wifi_version</td> <td style="text-align: left;">String</td> <td>WIFI版本</td> </tr> <tr> <td style="text-align: left;">ip</td> <td style="text-align: left;">String</td> <td>ip地址</td> </tr> <tr> <td style="text-align: left;">mac_addr</td> <td style="text-align: left;">String</td> <td>MAC地址</td> </tr> <tr> <td style="text-align: left;">wifi_strength</td> <td style="text-align: left;">Int</td> <td>WiFi强度</td> </tr> <tr> <td style="text-align: left;">device_model</td> <td style="text-align: left;">String</td> <td>设备型号</td> </tr> </tbody> </table>