在线调试

概述

本文档主要介绍设备在线调试的方法和步骤，目前平台支持对三种协议的产品设备进行在线调试，分别是T-Link协议、MQTT协议和LWM2M协议。

在线调试说明

1.T-Link协议设备在线调试

目前T-Link协议设备支持数据上报、事件上报的在线调试，根据在创建产品时选择的消息格式（JSON或紧凑型二进制）不同，在线调试的界面稍有不同，但是操作步骤基本一致，接下来以JSON格式为例来介绍T-Link协议设备的在线调试步骤：

第一步：在“服务定义”中添加属性和服务

在进行在线调试之前，先创建好产品（通信协议选择T-Link，消息格式选择JSON），添加设备，然后在“服务定义”里定义好属性列表和服务列表。

在“属性列表”中定义好属性，如下图所示。

在“服务列表”里，定义了“数据上报1”、“事件上报1”两个服务。

第二步：切换到“设备信息管理”页，在设备列表的操作区域，点击在线调试按钮，进入在线调试页面。

在线调试页面如下图所示。页面头部显示了产品ID和设备ID信息，右边有“上线”、“下线”按钮。

点击右上角的“上线”按钮，设备上线后，“上线”按钮前面的状态变成“已上线”。

设备行为模拟区域提供了模拟设备行为的操作，具体如下：

选择服务类型：提供可选择的服务类型的列表（数据上报或事件上报）

选择服务：提供可选择的服务的列表（在“服务定义—服务列表”中增加的服务）

配置/JSON：显示了选择的服务所关联的属性，可以在“配置”页修改各属性值，也可以在“JSON”页直接修改json数据。

上报一次：点击该按钮后，模拟设备上报一次数据。

连续上报：点击该按钮后，弹出对话框，可以设置上报的间隔时间（以秒为单位），这样可以每隔一段时间就自动上报一次。

第三步：在线调试

数据上报：在“配置”页面调节各个属性的值，点击“上报一次”按钮，在设备日志区域会显示上报成功，如下图所示。将鼠标移到属性名称后面的info图标上，会显示该属性的类型、长度、最大值、最小值等信息。

还可以切换到“JSON”页面，直接修改JSON格式数据，点击“上报一次”按钮，实现数据上报的模拟。

事件上报：除了数据上报，还可以模拟事件上报，在服务类型里选择事件上报，然后修改或填写属性值，点击“上报一次”按钮，设置日志处显示了事件上报的信息。

T-Link协议二进制格式的设备在线调试：

上面介绍了T-Link协议JSON格式数据情况下的在线调试，当消息格式为二进制时（创建产品时通信协议选择T-Link，消息格式选择紧凑型二进制），在线调试的步骤基本一致，主要的区别在于JSON数据的输入框变成了“二进制”的输入框，如下图所示。在输入框中输入有效的十六进制数据后，点击“上报一次”按钮，设备日志区域会显示数据上报的信息。

2.MQTT协议设备在线调试

目前MQTT协议设备支持数据上报、事件上报的在线调试。MQTT协议的消息格式都是JSON，根据是否透传，在线调试的界面稍有不同。

i. MQTT非透传

接下来以数据上报为例，介绍MQTT协议非透传情况下的在线调试步骤。

在进行在线调试之前，先创建好产品（通信协议选择MQTT，是否透传选择“否”），添加设备，然后在服务定义里定义好属性列表和服务列表。

在“属性列表”中添加属性，如下图所示。

在“服务列表”里，定义了“数据上报1”服务，如下图所示。

切换到“设备信息管理”页，在设备列表的操作区域，点击在线调试按钮，进入在线调试页面。

在线调试页面如下图所示。页面头部显示了产品ID、设备ID等信息，右边有“上线”、“下线”按钮。

点击右上角的“上线”按钮，设备上线后，“上线”按钮前面的状态变成“已上线”。

设备行为模拟区域提供了模拟设备行为的操作，具体如下：

选择服务类型：提供可选择的服务类型的列表（数据上报或事件上报）

选择服务：提供可选择的服务的列表（在“服务定义—服务列表”中增加的服务）

配置/JSON：显示了选择的服务所关联的属性，可以在“配置”页修改各属性值，也可以在“JSON”页直接修改json数据。

上报一次：点击该按钮后，模拟设备上报一次数据。

连续上报：点击该按钮后，弹出对话框，可以设置上报的间隔时间（以秒为单位），这样可以每隔一段时间就自动上报一次。

在“配置”页面调节各个属性的值，点击“上报一次”按钮，在设备日志区域会显示上报成功，如下图所示。将鼠标移到属性名称后面的info图标上，会显示该属性的类型、长度、最大值、最小值等信息。

可切换到“JSON”页面，直接修改JSON格式数据，点击“上报一次”按钮，实现数据上报的模拟。

ⅱ.MQTT透传

以下为当选择透传时（创建产品时通信协议选择MQTT，是否透传选择“是”）场景下，在线调试的步骤:

MQTT协议透传没有服务定义，直接进入“设备信息管理”页，在设备列表的操作区域，点击在线调试按钮，进入在线调试页面，点击右上角的“上线”按钮后页面如下所示。

服务类型可以选择“数据上报”或“事件上报”，选择“数据上报”后，需要输入topic和json数据，如下图所示。

选择“事件上报”后，topic是固定的，不需要输入，只需要输入json数据，如下图所示。

3.LWM2M协议设备在线调试

目前LWM2M协议设备仅支持数据上报的在线调试，LWM2M协议的消息格式都是紧凑型二进制，根据是否透传，在线调试的界面稍有不同，但是操作步骤基本一致，接下来分别介绍LWM2M协议设备非透传/透传的在线调试步骤。

i. LWM2M协议非透传

在进行在线调试之前，先创建好产品（通信协议选择LWM2M，是否透传选择“否”），添加设备，然后在服务定义里定义好属性列表和服务列表。

第一步：在“属性列表”中添加属性，如下图所示。

在“服务列表”里，定义了“数据上报1”服务。

第二步：切换到“设备信息管理”页，在设备列表的操作区域，点击在线调试按钮，进入在线调试页面。

第三步：在线调试页面如下图所示。页面头部显示了产品ID、设备ID的信息，右边有“上线”、“下线”按钮。

第四步：点击右上角的“上线”按钮，设备上线后，“上线”按钮前面的状态变成“已上线”。

设备行为模拟区域提供了模拟设备行为的操作，具体如下：

选择服务类型：提供可选择的服务类型的列表（数据上报）

选择服务：提供可选择的服务的列表（在“服务定义—服务列表”中增加的服务）

配置/二进制：显示了选择的服务所关联的属性，可以在“配置”页修改各属性值，也可以在“十六进制”页直接输入十六进制数据。

上报一次：点击该按钮后，模拟设备上报一次数据。

连续上报：点击该按钮后，弹出对话框，可以设置上报的间隔时间（以秒为单位），这样可以每隔一段时间就自动上报一次。

第五步：在“配置”页面调节各个属性的值，点击“上报一次”按钮，在设备日志区域会显示上报成功，如下图所示。将鼠标移到属性名称后面的info图标上，会显示该属性的类型、长度、最大值、最小值等信息。

还可以切换到“二进制”页面，直接输入有效的十六进制数据，点击“上报一次”按钮，实现数据上报的模拟。

ii.LWM2M协议透传

上面介绍了LWM2M协议非透传情况下的在线调试，当选择透传时（创建产品时通信协议选择LWM2M，是否透传选择“是”），在线调试的步骤基本一致，主要的区别透传时没有服务定义，可以输入十六进制数据或字符，如下图所示。在输入框中输入有效的十六进制数据后，点击“上报一次”按钮，设备日志区域会显示数据上报的信息。

切换到“字符”按钮，可以输入任意字符，进行数据上报，如下图所示。