FAQ

更新时间:2022-11-24 09:20:01下载pdf

产品定义常见问题

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

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

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

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

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

    FAQ

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

    例:假设数值范围为 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 下的面板编辑页面,查看扫地机图标是否已被人为更换;如若在未被更换,但图标却变化的情况下,可联系涂鸦相关人员进行确认。

    FAQ
  • 更换面板后,App 上已被配上的设备该如何同步?

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

激光扫地机开发常见问题

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

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

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

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

    FAQ
  • 没有调用重置接口,为什么会进入重置状态?

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

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

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

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

    答:没有,只能在应用层重启 SDK 进程。

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

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

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

    答:支持修改。

  • SDK 同步的是什么时间?

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

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

    答: 下发的 cmd 有区分类型,定时下的 cmd type 为 DP_CMD_TIMER。
    FAQ

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

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

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

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

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

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

  • 设计Init_flag字段的意义是?

    FAQ

​ 答: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 不做缓存,全由扫地机来缓存。

    FAQ
  • 全量路径和导航路径需要同时显示时,该怎么传输?

    答:协议文件中,有一个叫做全量路劲格式,其中 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,即可变为分区可自定义编辑状态。

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

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

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

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