扫地机器人 DP 及交互逻辑
更新时间：2025-12-22 07:17:57下载pdf
概述
本文档旨在规范扫地机器人设备与控制面板（全能基站公版小程序）之间部分重要的功能点（Data Point，DP）交互逻辑，确保设备功能的正确实现和用户体验的一致性。
核心功能模块
基础控制功能
- 清扫控制：启动/停止清扫，暂停/继续操作。
- 回充管理：自动回充控制和状态监控。
- 模式切换：支持多种清扫模式的无缝切换。
- 状态监控：多种设备状态的实时上报。
清扫模式支持
- 快速建图：智能路径规划，全覆盖建图。
- 全屋清扫：智能路径规划，全覆盖清扫。
- 选区清扫：基于房间的精准清扫。
- 划区清扫：矩形区域自定义清扫。
- 定点清扫：指哪扫哪，精确定位。
- 其他模式：遥控模式等扩展功能。
智能监控功能
- 故障诊断：多故障同时上报和识别。
- 实时视频：音视频监控开关控制。
基础功能 DP 定义
| DP ID | 功能点名称 | 标识符 | 数据传输类型 | 数据类型 | 功能点属性 |
|---|---|---|---|---|---|
| 1 | 清扫开关 | switch_go | 可下发可上报（rw） | Bool |
|
| 2 | 暂停/继续 | pause | 可下发可上报（rw） | Bool |
|
| 3 | 回充开关 | switch_charge | 可下发可上报（rw） | Bool |
|
| 4 | 模式 | mode | 可下发可上报（rw） | Enum | 默认值（不可修改删除，否则影响控制面板逻辑）：
|
| 5 | 状态 | status | 只上报（ro） | Enum | 默认值（不可修改删除，否则影响控制面板逻辑）：
|
| 28 | 故障上报 | total_error | 可下发可上报（rw） | Raw | 全部故障采用 Raw 类型，不区分机器故障或者基站故障，每一种故障为 1 Byte； 如果同时发生 1、2、3 号故障，则为： 010203，需要面板端自行判断分割每个故障 Byte；如果没有故障，则为 00 |
| 45 | 实时视频开关 | live_video_switch | 可下发可上报（rw） | Bool |
|
基础 DP 与面板交互逻辑
复杂协议控制命令详细说明
-
COMPLEX_CMD_E命令枚举：命令标识 功能描述 使用场景 ROOM_CLEAN_SET 房间清扫设置 选区清扫模式启动时 ROOM_CLEAN_QUERY 房间清扫查询 选区清扫暂停后继续时 ZONE_CLEAN_SET 区域清扫设置 划区清扫模式启动时 ZONE_CLEAN_QUERY 区域清扫查询 划区清扫暂停后继续时 SPOT_CLEAN_SET 定点清扫设置 定点清扫模式启动时 SPOT_CLEAN_QUERY 定点清扫查询 定点清扫暂停后继续时 -
接口回复详情：
ty_rvc_room_clean_data_response：选区清扫数据响应接口ty_rvc_zone_clean_data_response：划区清扫数据响应接口ty_rvc_spot_clean_data_response：定点清扫数据响应接口
以上复杂协议控制命令的具体内容，请参考 复杂协议控制。
快速建图模式
| 操作场景 | 交互逻辑 |
|---|---|
| 启动建图 | 点击开始：
|
| 暂停建图 | 点击暂停：
|
| 继续建图 | 点击继续：
|
| 建图中回充 | DP5 status = mapping/paused 时，点击回充：
|
| 回充中取消 | DP5 status = goto_charge 时，点击回充：
|
| 切换模式 | DP5 status = mapping/paused 时，切换其他模式，弹窗提示：此操作将会结束当前任务，是否确定结束？
|
全屋清扫模式
| 操作场景 | 交互逻辑 |
|---|---|
| 启动清扫 | 点击开始：
|
| 暂停清扫 | 点击暂停：
|
| 继续清扫 | 点击继续：
|
| 清扫中回充 | DP5 status = smart/paused 时，点击回充：
|
| 回充中取消 | DP5 status = goto_charge 时，点击回充：
|
| 切换模式 | DP5 status = smart/paused 时，切换其他模式，弹窗提示：此操作将会结束当前任务，是否确定结束？
|
选区清扫模式
| 操作场景 | 交互逻辑 |
|---|---|
| 启动清扫 | 点击开始：
|
| 暂停清扫 | 点击暂停：
|
| 继续清扫 | 点击继续：
|
| 清扫中回充 | 点击回充：
|
| 回充中取消 | DP5 status = goto_charge时，点击回充：
|
| 切换模式 | DP5 status = select_room/paused时，切换其他模式：弹窗提示：此操作将会结束当前任务，是否确定结束？
|
划区清扫模式
| 操作场景 | 交互逻辑 |
|---|---|
| 启动清扫 | 点击开始：
|
| 暂停清扫 | 点击暂停：
|
| 继续清扫 | 点击继续：
|
| 清扫中回充 | DP5 status = zone_clean /paused时，点击回充：
|
| 回充中取消 | DP5 status = goto_charge时，点击回充：
|
| 切换模式 | DP5 status = zone_clean /paused时，切换其他模式：弹窗提示：此操作将会结束当前任务，是否确定结束？
|
定点清扫（指哪扫哪）模式
| 操作场景 | 交互逻辑 |
|---|---|
| 启动清扫 | 点击开始：
|
| 暂停清扫 | 点击暂停：
|
| 继续清扫 | 点击继续：
|
| 清扫中回充 | DP5 status = goto_pos/pos_arrived /paused 时，点击回充：
|
| 回充中取消 | DP5 status = goto_charge 时，点击回充：
|
| 切换模式 | DP5 status = goto_pos/pos_arrived/paused 时，切换其他模式，弹窗提示：此操作将会结束当前任务，是否确定结束？
|
回充功能
| 操作场景 | 交互逻辑 |
|---|---|
| 主动回充 |
|
故障报告
| 功能 | 交互逻辑 |
|---|---|
| 故障上报 | 上报：DP28 total_error 数据格式：Raw 类型，一个字节代表一个错误示例
|
音视频功能
| 功能 | 交互逻辑 |
|---|---|
| 音视频开关 | 开始推送音视频流数据：
|
| 视频监控逻辑 | 条件判断：
|
注意事项
- 以上只基于公版全能基站小程序，对机器移动相关的 DP 交互做了说明，其它的 DP 交互可以参考 SDK 对应的 Demo 实现。
- 故障码需要面板端自行解析，支持多故障同时存在。
- 默认枚举值不可修改或删除，以保证控制面板逻辑正常运行。
- 状态和模式枚举支持后续扩展（需要与涂鸦产品经理对齐），但需保持向后兼容。
该内容对您有帮助吗？
是意见反馈该内容对您有帮助吗？
是意见反馈
关注“涂鸦智能”
涂鸦服务尽在掌握
关注“全球智能商业”
第一时间获取物联网资讯
