操作场景
设备开发完成后，需要进入设备调试阶段调试设备与云端的通信是否正常。设备调试提供了真实设备在线调试及虚拟设备调试，并可通过控制台查询设备上报的当前数据、历史通信日志、事件及上下线记录等。本文档主要介绍如何进行设备调试。
前提条件
操作步骤
新建设备
1. 在 物联网开发平台 进入公共实例后，选择目标产品然后单击设备调试，进入设备调试环节。
2. 单击新建设备，如下图输入设备名，单击保存，即可创建设备。
3. 创建成功后，将会在“设备调试”列表页中查看到新建成功的设备。首次创建成功的设备默认状态为“未激活”。
4. 在列表中单击二维码可以快速绑定真实设备，帮助开发者降低开发难度。量产后为了安全性，将会关闭二维码入口。
查看设备信息
1. 新建设备成功后，需要查询设备信息，获取重要参数及进行设备调试。
2. 单击设备列表的设备名称，默认进入设备信息页，即可查看设备的基本信息。
设备名称：产品下的唯一设备 ID，一般需要烧录到设备端。
产品ID：设备所属产品 ID，一般需要烧录到设备端。
所属产品：该设备所属产品名称。
设备密钥：平台为每个设备随机生成的密钥，使用密钥认证需要将此信息烧录到设备端。
设备创建时间：设备初始创建成功的时间。
最后上线时间：设备最后一次连接平台的时间。
激活时间：设备第一次成功连接到平台的时间。
设备状态：设备当前状态。如设备成功通过 MQTT 连接至平台，则显示“在线”，如果设备离线，则显示“离线”，如果设备从未连接平台，则显示“未激活”。
查看物模型日志
1. 当设备成功连接平台，并向物模型Topic发布消息，则可以在“设备云端日志”下的“物模型日志”查看设备上报的属性、事件、行为等数据。
2. 列表中将该设备的物模型的属性功能项全部列出。
标识符：对应该设备的物模型中的标识符。
功能名称：对应物模型定义中的“功能名称”。
历史数据：单击查看，即可查询该功能项的历史上报数据。按时间展示该功能上报到云端的历史数据，验证上报的数据是否正确。
数据类型：对应物模型定义中功能的“数据类型”。
最新值：当设备在向云端上报数据时，只要某个功能的最新上报值发生变化，最新值列都会立刻显示设备上报的最新值。
更新时间：指最新值的变化时间。一般是设备上报该功能的发生时间。
查看内容日志
1. 内容日志为用户提供了按 Topic 查询设备上下行内容日志的功能。用户选择“内容日志”，会展示“日志类型”下拉列表。
2. 日志类型选择“属性”，Topic 下拉框自动加载属性对应的 Topic，并查询出所选择日期范围设备与平台的所有上下行属性内容日志。用户可以按需选择不同的类型，即可查询不同的 Topic 所对应的上下行内容数据用于设备调试与问题定位。
查看上下线日志
1. 上下线日志为用户提供查询设备连接到平台（上线）以及设备从平台主动或被动断开连接的日志。
2. Device disconnect 下线表示是设备主动关闭与平台的连接；Device keepalive timeout 表示设备没有发送心跳，导致超时连接关闭。
查看云端诊断日志
云端诊断日志功能用于查看设备与云端交互的端到端轨迹日志，帮助用户快速诊断在调试过程中设备出现的异常错误，如订阅 topic 无权限、上行消息发布失败、规则引擎转发第三方服务失败等错误异常事件定位。该文档用于在设备与云端消息通信内容定位原因，并寻求解决方案。
在线调试
1. 当您的真实设备已成功对接到开发平台后，则可以使用在线调试对真实设备进行数据收发的测试。
2. 单击在线调试，即可进入在线调试功能。前提是真实设备已开启并成功连接到开发平台。
3. 在线调试左侧的操控面板是根据设备所属产品的物模型自动生成，设置需要下发的数据后，单击发送后，系统会自动触发控制指令到设备端。
4. 设备端接收到指令后，会立刻返回数据到云端并显示在右侧的文本框中。
5. 用户若想通过 API 下发控制指令与真实设备进行调试，可分别参考 设备远程控制 与 设备透传指令控制 两个API，一种分别是以物模型协议下发控制指令，另一种是以自定义 Payload 方式下发指令。
