cmd报文接口详细文档
<h2>扫地机上传报文mqtt发送的topic格式</h2>
<pre><code>BNIOT/ROBOT/{sno}
sno为设备号</code></pre>
<h2>数据包报文格式</h2>
<pre><code>{
&quot;cmd&quot;:103,
&quot;sno&quot;:&quot;设备号&quot;,
&quot;data&quot;:{
}
}</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>
<tr>
<td>20041</td>
<td>障碍物识别上传图片，详细说明地址：<a href="https://www.showdoc.com.cn/baanooliot/9534108835312773">https://www.showdoc.com.cn/baanooliot/9534108835312773</a></td>
</tr>
</tbody>
</table>
<h2>cmd报文code=1</h2>
<h4>心跳数据包，扫地机每间隔60秒上报一次</h4>
<pre><code>{
&quot;cmd&quot;:1,
&quot;sno&quot;:1,
&quot;data&quot;: 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>{
&quot;cmd&quot;:2,
&quot;sno&quot;:1,
&quot;data&quot;: {
&quot;clean_method&quot;,1,
&quot;clean_area&quot;:100,
&quot;clean_time&quot;:60,
&quot;residual_electricity&quot;:80,
&quot;clean_state&quot;:1,
&quot;clean_type&quot;:1,
&quot;start_mode&quot;: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>{
&quot;cmd&quot;:101,
&quot;sno&quot;:1,
&quot;data&quot;: null
}</code></pre>
<h2>cmd code=103</h2>
<h4>配网状态，扫地机配网成功后校验设备是否被服务器接收，扫地机主动上报</h4>
<pre><code>{
&quot;cmd&quot;:103,
&quot;sno&quot;:&quot;设备号&quot;,
&quot;data&quot;: {
&quot;status&quot;:1,
&quot;msg&quot;:&quot;配网成功&quot;,
&quot;user_id&quot;:&quot;123456812211248&quot;,//用户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>{
&quot;cmd&quot;:104
}</code></pre>
<h2>cmd code=105</h2>
<h4>关闭视频流，app下发指令关闭摄像头</h4>
<pre><code>{
&quot;cmd&quot;:105
}</code></pre>
<h2>cmd code=106</h2>
<h4>前进，app下发指令扫地机前进</h4>
<pre><code>{
&quot;cmd&quot;:106
}</code></pre>
<h2>cmd code=107</h2>
<h4>后退，app下发指令扫地机后退</h4>
<pre><code>{
&quot;cmd&quot;:107
}</code></pre>
<h2>cmd code=108</h2>
<h4>向左，app下发指令扫地机向左</h4>
<pre><code>{
&quot;cmd&quot;:108
}</code></pre>
<h2>cmd code=109</h2>
<h4>向右，app下发指令扫地机向右</h4>
<pre><code>{
&quot;cmd&quot;:109
}</code></pre>
<h2>cmd code=110</h2>
<h4>暂停，app下发指令扫地机向右</h4>
<pre><code>{
&quot;cmd&quot;:110
}</code></pre>
<h2>cmd code=11250</h2>
<h4>地机清扫模式编辑</h4>
<pre><code>{
&quot;cmd&quot;:11250,
&quot;data&quot;: {
&quot;water_volume&quot;:10,
&quot;suction&quot;:2,
&quot;forcibly_dragged&quot;:1,
&quot;clean_times&quot;:2,
&quot;model&quot;: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>{
&quot;cmd&quot;:11252,
&quot;data&quot;: {
&quot;clean_area&quot;:10,
&quot;clean_time&quot;:123456952232,
&quot;residual_electricity&quot;:80,
&quot;report_time&quot;:1461464561216,
&quot;clean_state&quot;:1,
&quot;clean_type&quot;:1,
&quot;start_mode&quot;: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>{
&quot;cmd&quot;:11256,
&quot;data&quot;: {
&quot;serial_number&quot;: 1,
&quot;version&quot;: 60,
&quot;mcu_version&quot;: null,
&quot;wifi_version&quot;: &quot;1&quot;,
&quot;ip&quot;: &quot;1&quot;,
&quot;mac_addr&quot;: null,
&quot;wifi_strength&quot;:&quot;&quot;,
&quot;device_model&quot;: 1653613724000,
&quot;bind_time&quot;: 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>