1.如何进入设备调试?


调试中心-1.png


在完成产品信息,功能定义及人机交互配置后,就可以通过调试中心在线调试设备所有业务功能。点击第三步的设备调试即可进入调试中心页面。

1.1、账号授权

在进行设备功能调试前,首先确保该设备已经在厂商云完成配网绑定。然后在调试中心进行用户账号Oauth授权绑定。流程如下:

image.png


1.2、选择天猫精灵音箱

调试中心-2.png


进入调试页面后会展示当前登录用户名下绑定的天猫精灵,当存在多天猫精灵时,由用户指定天猫精灵作为调试音箱。后续语音调试都是使用已选择的音箱进行的。

1.3、选择待测试的设备

1.1、账号授权 完成后,选择设备调试页面会展示授权的账号下与当前产品型号对应的真实设备(前提是该设备必须在厂商云先配网绑定)。注意此处只显示当前产品对应的设备

image.png

开发者可以选择一个真实设备点击“在线调试”进入设备调试页面。

如果页面未展示该产品对应的设备,请点击“刷新一下”按钮,天猫精灵IoT平台会主动向厂商云发起设备发现请求到厂商云,重新获取该授权用户下的设备。

image.png


2.语音调试

语音调试,主要模拟用户通过天猫精灵进行语音控制设备,页面展示整个语音交互过程的对话流信息。同时也展示当前语音控制发送到厂商云的设备控制日志信息,方便开发者问题排查。

image.png


通过点击在线调试进入设备调试页面后会展示出语音调试页面:

  • 标准语料:为了提高测试效率减少用户口头进行每个功能测试,平台根据产品的功能定义提供每个功能的常用语音表述文本。选择平台默认的标准语料点击发送测试,该语料文本就下发到1.2步骤所选择的天猫精灵进行识别和设备控制。
  • 泛化语料:输入想测试的语料进行调试,这里的语料是指用户对天猫精灵说的话,经过ASR识别后的自然语言文本

平台已开放的IoT语料均已做过NLP模型训练泛化。


页面中实时消息显示的是从天猫精灵云发送控制请求到厂商云的日志,如有问题请复制当前发送请求的traceid,提供traceid和问题描述给相关技术支持同学


3.触屏调试

触屏调试是模拟APP或带屏音箱上设备控制面板上渲染的功能操作。APP或带屏音箱上会根据产品的功能定义为每个设备生成用于触屏控制的设备控制面板。

首先选择“触屏测试”单选按钮,进入触屏测试页面。

image.png

然后选择需要测试的功能,并设置该属性的值,然后点击“发送测试”按钮。这时天猫精灵云就会把该属性及属性值封装成 2.5.1 设置设备属性值操作 协议下发给厂商云。

实时消息页面会展示当前属性控制下发的全链路日志及厂商云返回的响应日志。开发者可以根据日志排查开发中遇到的问题。


4.协议测试

协议测试使用的场景是厂商在创建产品时“数据格式”选择是“透传/自定义”,这时需要厂商开发协议透传脚本进行将天猫精灵产品功能转换成厂商云对应的设备控制指令,详情请查看协议透传脚本。如某厂商编写的协议转换透传脚本测试效果如下:

image.png

协议测试使用比较特殊,请厂商根据自己实际情况进行测试。


4.常用FAQ

Q:设备调试过程中,设备消息无法上报,导致后续产品流程无法继续

A:


Q:指令无法控制,设备无反应

A: 1.先确定产品开发是否按照目录到达 IoT开放平台->开发指南->嵌入式开发 确定设备严格按照协议开发

    2.满足1的前提下,通过输入指定指令是否到设备端

    3.满足以上 1. 2 如果还未确定问题,在相关技术支持通过问题模式反馈给技术支持


Q:调试中心设备控制报错

A:1.反馈真实设备能控制,由于APP面板控制下发多个属性导致设备不能控制

   

Q:设备控制,错误码对应具体原因

A:常用控制错误码详解


错误码

对外错误信息

错误信息


310004

未找到对应产品信息

未找到对应产品信息

根据pk未获取到产品信息

通用

310009

json命令格式解析错误

json命令格式解析错误

json命令格式解析错误

json调试

310010

三元组创建信息错误

三元组创建信息错误

三元组或Mac信息为空

绑定虚拟设备

310011

虚拟设备绑定错误

虚拟设备绑定错误

绑定过程发生错误

绑定虚拟设备

310012

该产品不支持虚拟设备

该产品不支持虚拟设备

不是mesh/BLE/wifi的其中一种,不支持绑定虚拟设备

绑定虚拟设备

310013

虚拟设备解绑错误

虚拟设备解绑错误

解绑过程错误

解绑虚拟设备

310014

协议创建错误

协议创建错误


二进制调试

310015

设备控制失败

二进制指令控制过程失败

二进制调试

310016

设备控制失败

Json指令控制过程失败

json调试

310017

系统内部异常

tair写入失败

tair存入用户和设备映射信息失败

绑定虚拟设备

310018

调试指令不能为空

调试指令不能为空

json/二进制调试

310019

调试指令与设备类型不匹配

调试指令与设备类型不匹配

json/二进制调试

310020

指令下发错误

指令下发错误

二进制调试

310021

系统内部异常

阿里云控制错误


json调试

310022

获取设备品类错误

获取设备品类错误

根据DevType未获取到设备品类

绑定虚拟设备

310023

缺少用户信息

缺少userId

通用

310024

缺少设备信息

缺少deviceId

通用

310025

缺少产品信息

缺少productKey

通用

310026

缺少天猫精灵设备信息

缺少uuid

二进制调试

310027

获取设备默认属性失败

获取设备默认属性失败

开放平台获取设备默认属性失败

启动虚拟设备

302002

设备操作不支持

设备操作不支持

存量设备不支持绑定虚拟设备

绑定虚拟设备