FAQ

产品定义常见问题

• 如何增加自定义扫地机的工作状态值？

  答：可以在默认的状态值后面添加其他自定义状态值，但是默认状态值不可删除，默认状态值的单次拼写也不可随意更改，只可调整默认状态值的顺序。

• 为什么新增 DP 或修改 DP 信息后，提示 DP NOT FOUND ？

  答：每次新增或修改 DP 信息后，设备需要重新配网才能生效。

• 类似清扫面积这个数值型 DP 中的间距和倍数是什么意思？

  

  答：倍数参数表示显示数值的小数点位数；间距表示相邻两数值的差值。

  例：假设数值范围为 0~9999；

  • 倍数为 0 时，表示面板显示的数值没有小数点，皆为整数；若此时间距为 1，那么可取数值和面板显示数值皆为 0,1,2,3…9999；若此时间距为 3，那么可取数值和面板显示数值皆为 0,3,6,…9999。
  • 倍数为 1 时，表示面板显示的数值带一位小数点；若此时间距为 1，那么当可取数值为 0,1,2,3…9999 时，面板显示 0.0,0.1,0.2,0.3…999.9; 间距为 2 时同上。

界面配置常见问题

• 为什么陀螺仪机器的图标会变了？

  答：可先自行登录到涂鸦 IoT 开发平台，进入使用 PID 下的面板编辑页面，查看扫地机图标是否已被人为更换；如若在未被更换，但图标却变化的情况下，可联系涂鸦相关人员进行确认。

  

• 更换面板后，App 上已被配上的设备该如何同步？

  答：在涂鸦 IoT 开发平台成功更换面板后，App 上退出面板至 App 首页下拉刷新页面后再进入面板，面板随着会被更新（如若遇到面板未被更新的情况，可清除 App 缓存后，再重复进行上述操作）。

激光扫地机开发常见问题

• 出现域名解析失败的原因是什么？

  答：地图实时上传需要建立 HTTPS 连接，域名解析失败后，会断开连接，返回-2000/-5/-1102 等一系列错误；同时，如出现网络波动，MQTT 断开连接后，因域名解析失败，不会重连回去，云端检测不到设备的 MQTT 回复，就会判断设备离线。

  

• 为什么在固件升级的过程中，SDK 不会更新版本号？

  答：用户传的参数没有更新版本号或者更新成错误的版本号，因为版本号是用户通过以下接口传进 SDK。

  

• 没有调用重置接口，为什么会进入重置状态？

  答：因为 .db 文件丢失。丢失后，读取 .db 文件失败，就会进入重置状态。

  

• 涂鸦 SDK 是否有经过数字签名？

  答：有数字签名，签名证书是配网的时候由服务器下发，然后存在本地。在配网之前数据是用 AUTHKEY 加密的。

• 本地重置设备的时候，SDK 有没有提供重启接口？

  答：没有，只能在应用层重启 SDK 进程。

• 涂鸦 SDK 是否同时支持快连模式和热点模式？

  答：由 Wi-Fi 芯片决定，再由用户在应用层去做适配。

• 热点模式的热点名称能否修改？

  答：支持修改。

• SDK 同步的是什么时间？

  答：设备配网连上云后，就会去云端同步时间，同步过来的是 UTC+本地时区，配网的时候，手机是哪个时区就同步那个时区。

• 如何区分是通过定时功能下发的 DP？

  答： 下发的 cmd 有区分类型，定时下的 cmd type 为 DP_CMD_TIMER。
  

• 语音包下载的接口是哪个？

  答：SDK 没有语音包下载的接口，App 会给设备发一个 url，设备拿到 url 后自行去下载语音包。

• 涂鸦 App 显示的清扫时间和清扫面积，是单次清扫的还是累计的？

  答：清扫时间和清扫面积是指当前清扫的且是设备实时上报的内容。

• UUID 和 AUTHKEY 必须是一机一码吗？

  答：是的，每台设备需要绑定不同的 UUID 和 AUTHKEY。

• 设计Init_flag字段的意义是？

  

​ 答：1). 全量路径 ID 可以一直呈 +1 的方式自增变化的话，设备上报该字段为 0x00。

​ 2).为让面板显示的全量路径连续，出现以下情况时，全量路径的前 5 包上报 Init_flag 为 0x01：

​ a. 全量路径 ID 达到极限值，此时需要从 0 开始上报。

​ b. 机器重启后，无法保存重启前的 ID 数，仍需从 0 开始上报时。

​ c. 全量路径上报过程中出现 ID 变小或 ID 相同，却出现全量路径包变小的情况。

• 激光扫地机地图协议中描述的房间号 60. 61. 63 有什么不同?

​ 答：60：可清扫区内的正常房间，不带分房间数据。

​ 61：房间间隙，在可清扫区内，但是不在任何一个房间内。

​ 63：就是不符任一种定义的未知区域。

<img src="https://images.tuyacn.com/fe-static/docs/img/2e239eb9-0e39-4aae-8297-88b5e6a55873.png" height=5%/>

• App 请求增量路径，设备端是否可以忽略该请求，只上报全量路径？

  答：目前我们的公版虽然是全量+增量的方式，设备端可以忽略增量请求，直接上报全量数据，App 已做兼 容。

• 设备端可以主动更新上报实时地图吗？

  答：App 每 2s 获取一次增量轨迹，地图和全量轨迹有变化设备端自动上报。

• 如图所示，是扫地机还是 SDK 来缓存？

  答：SDK 不做缓存，全由扫地机来缓存。

  

• 全量路径和导航路径需要同时显示时，该怎么传输？

  答：协议文件中，有一个叫做全量路劲格式，其中 type 代表普通模式，0X00 代表普通的路径数据，没有导航路径数据；0X01 代表复杂模式，代表数 据中，既有普通路径数据，也有复杂数据（例如：导航、转场、回充等）；复杂数据是通过每个点中，包含了点类型来区分的，例如一个点 四个字节，分别代表 X 和 Y，X 有 16 位，Y 有 16 位，点类型是取 X 的最后一 位和 Y 的最后一位来代表点类型：

  ​ 00：转场路径点；

  ​ 01：正常清扫点；

  ​ 10：回充路径点；

  ​ 11：预留。

• 设备固件版本，格式是否可以做调整？

  答：格式必须为 XX.XX.XX，其中 XX 必须为数字；因为 OTA 升级时，涂鸦做大小的判断，即当需要升级的版本低于本地版本时，涂鸦不做升级（降级）提示；涂鸦保证只增不降。

• App 中耗材寿命可否不显示，设备端不提供该状态?

  答：该情况下，可以删掉对应的 DP。

• 划区框和禁区框的四个顶点，传输方向是什么？

  答：基于机器坐标系，顺时针方向，左上角为第一个点。

• 划区框、禁区框和虚拟墙可设置的最大个数是多少？

  答：目前划区域上线为 8 个，禁区和虚拟墙的上限是 8 个。

• 为什么激光扫地机上报地图数据后，App 端地图不显示？

  答：

  • 上报的地图数据格式有误.
  • 数据大小端转化问题。
  • 压缩问题。

• 地图管理点击使用地图提示超时。

  答： 保存地图时，上传地图的过程未传地图 ID 导致。

• 激光扫地机如何上报空地图？

  答：地图的宽度，高度要为 0，pix 数组中填充数据或不填充数据皆可。

• 保存地图显示当前地图不稳定，不可保存的原因是？

  答：地图数据的 type 字段，要传 0x01，即可变为分区可自定义编辑状态。

  

• 陀螺仪扫地机的清扫记录在什么情况下会被清空？

  答：设备 ID 变化的情况下，清扫记录会被清空。

• 激光扫地机的清扫记录在什么情况下会被清空？

  答： 设备所在的 App 家庭 和 设备 ID，两者只要有一个发生变化，清扫记录就会被清空。