查看设备信息

最近更新时间:2025-12-29 15:26:14

我的收藏
在开发阶段或设备量产运维阶段,用户都需要查看具体的设备信息。用户可在控制台查看设备基础信息,如三元组信息、状态、版本号、已订阅的 Topic 列表、物模型数据、云日志、设备上线离线历史日志等。本文将介绍如何在控制台查看设备相关数据。

查看设备基础信息

1. 登录 物联网开发平台,在控制台右上方,选择物联网开发平台所在地域。默认为广州区域。
2. 实例管理页面,找到对应的实例,单击实例卡片。
3. 在左侧菜单导航栏,选择设备管理 > 设备
4. 进入设备列表后,单击设备列表操作列中的查看,即可进入设备详情页。
说明:
如需快速找到目标设备,可使用搜索功能,详细说明可参见 搜索设备

5. 查看设备基本信息,包含设备身份认证信息、状态、固件版本等重要参数。

设备名称:产品下的唯一设备 ID,需要烧录到设备端。
产品ID:设备所属产品 ID,需要烧录到设备端。
所属产品:该设备所属产品的名称。
设备密钥:平台为每个设备随机生成的密钥,使用密钥认证需要将此信息烧录到设备端。
设备创建时间:设备初始创建成功的时间。
最后上线时间:设备最后一次成功连接平台的时间。
激活时间:设备第一次成功连接到平台的时间。
设备状态:设备当前状态。如设备成功通过 MQTT 协议成功连接至平台,则显示“在线”,如果设备离线,则显示“离线”,如果设备从未连接平台,初始创建的设备则状态为“未激活”。
固件版本:当设备首次上电或断网重连,一般会根据腾讯云物联网开发平台的 OTA 协议上报设备最新版本号,固件版本号默认只显示模块类型为 mcu 的版本号。

查看设备已订阅 Topic

用户在设备开发阶段或量产阶段,会碰到给设备下发控制消息后,设备侧并未接收到消息的问题。碰到这类问题,首先需要判断设备是否成功订阅了远控消息下发时指定的 Topic。进入设备详情页后,您可前往 Topic列表 > 已订阅Topic 查看设备订阅的 Topic 列表。


查看物模型数据

1. 当设备成功连接平台,并使用 物模型协议 向物模型 Topic 发布消息,则可以在设备详情页的“物模型数据”查看设备上报的属性、事件、行为等数据。

2. 设备的物模型属性功能项字段说明如下:
标识符:对应该设备的物模型中的标识符。
功能名称:对应物模型定义中的“功能名称”。
历史数据:单击查看,即可查询该功能项的历史上报数据。按时间展示该功能上报到云端的历史数据,验证上报的数据是否正确。
数据类型:对应物模型定义中功能的“数据类型”。
最新值:当设备在向云端上报数据时,只要某个功能的最新上报值发生变化,最新值列都会立刻显示设备上报的最新值。
更新时间:指最新值的变化时间。一般是设备上报该功能的发生时间。
说明:
当设备使用物模型协议格式上报数据,但在物模型日志无法查看到最新值时,需要确认上报的数据格式是否正确。具体可参考 物模型协议常见问题

查看云日志

查看内容日志

内容日志为用户提供了按 Topic 查询设备上下行内容日志的功能,可以查看设备与平台之间详细的数据报文,便于开发测试阶段的调试以及量产阶段定位问题。
1. 可以在设备详情中的云日志页面查看“物模型属性”Topic 的内容日志,若用户使用自定义 Topic,则应选择日志类型为“自定义Topic”。

2. 日志类型选择“属性”,Topic 下拉框会自动加载属性对应的 Topic,并查询出所选择日期范围设备与平台的所有上下行属性内容日志。用户可以按需选择不同的类型,即可查询不同的 Topic 所对应的上下行内容数据用于设备调试与问题定位。

查看上下线日志

1. 设备详情中的上下线日志为用户提供查询设备连接到平台(上线)以及设备从平台主动或被动断开连接的日志,便于定位分析设备离线、在线状态产生的业务问题。

2. Device disconnect 下线表示是设备主动关闭与平台的连接;Device keepalive timeout 表示设备没有发送MQTT标准协议的心跳,例如网络信号不佳,导致平台无法收到心跳,导致云端触发超时机制主动关闭该设备的MQTT连接。

查看行为日志

行为日志功能用于查看设备与云端交互的端到端轨迹日志,帮助用户快速诊断调试过程中出现的异常错误,如订阅 Topic 无权限、上行消息发布失败、规则引擎转发第三方服务失败等问题。该功能可用于定位设备与云端通信异常原因,提高设备开发调试效率。


在线调试

当您的真实设备已开启并成功对接到开发平台后,则可以使用在线调试对真实设备进行数据收发的测试。
1. 单击设备详情页的在线调试,进入在线调试页面。
2. 在线调试左侧的操控面板是根据设备所属产品的物模型自动生成,设置需要下发的数据后,单击发送,系统会自动触发控制指令到设备端。
3. 设备端接收到指令后,会立刻返回数据到云端并显示在右侧的文本框中。
4. 用户若想通过 API 下发控制指令与真实设备进行调试,可分别参考 设备远程控制设备透传指令控制,前者是以物模型协议下发控制指令,后者是以自定义 Payload 方式下发指令。