设备基础
在项目控制台的左侧导航「设备」中,可以查看和管理项目下的所有设备,包括所有设备、设备类型和设备分组。
设备列表
在左侧导航「设备」中点击「所有设备」,查看项目下的全部设备,支持按以下条件筛选:

- 关键字:按设备名称或设备码模糊搜索。
- 设备类型:选择一个设备类型,查看该类型下的设备。
- 在线状态:1 在线,2 离线。
- 活跃状态:设备最近是否上报过数据,包括 1 活跃、2 5 分钟内活跃、3 1 小时内活跃、4 1 天内活跃、20 不活跃、21 不活跃超过 1 天、22 不活跃超过 3 天、23 不活跃超过 7 天、30 从未活跃。
- 告警状态:1 未告警,2 告警中,3 普通告警,4 重要告警,5 紧急告警。
- 设备分组:只查看某个分组下的设备。
- 接入类型:1 直连设备,2 子设备,3 网关设备。
- 创建时间:按创建时间区间筛选。
列表中每一行显示设备的名称、设备码、所属类型、在线状态、告警状态、最后活跃时间以及 OTA 版本等信息,支持按最后活跃时间、创建时间、名称、设备码排序。
设备详情
在设备列表中点击设备名称,进入设备详情页面。详情页按「概览、链接、信息、属性、事件、命令、规则、任务、告警、上下线、用户、调试、设置、操作日志」等页签组织设备数据,概览页展示当前属性值:

基本信息
基本信息包括设备码、设备唯一标识(DeviceKey)、所属设备类型、接入类型与接入协议、在线状态、启用状态等。
- 启用状态:设备被禁用后将无法连接平台。0 表示启用,1 表示禁用。
- 设备证书:设备的连接凭据(设备码、设备密钥等),可在详情中查看。设备接入方式的详细说明请浏览 设备证书。
位置信息
支持为设备维护位置信息,包括坐标(经纬度)、行政区划代码,以及建筑、单元、楼层、房号等结构化地址。设备上报的坐标会显示在设备地图中,也可以在此手动编辑。
固件信息
如果设备类型定义了 OTA 模块,这里会显示每个模块当前的固件版本。固件升级的说明请浏览 OTA 升级。
在线与活跃时间
- 首次上线时间:设备第一次接入平台的时间。
- 最后上线时间:设备最近一次建立连接的时间。
- 最后活跃时间:设备最近一次上报数据的时间。判断设备是否"假在线"(连接还在但不再上报数据)时,以最后活跃时间为准。
设备分组
设备分组用于将设备按业务场景组织为树形结构,例如"园区 - 楼栋 - 楼层"。在左侧导航「设备」中点击「设备分组」管理分组:

- 点击「创建设备分组」,填写分组名称,可以选择父分组形成层级。
- 在设备详情或设备列表中,将设备加入分组。
- 将设备从分组移出后,设备本身不受影响,只是不再属于该分组。
每个设备同一时间只属于一个分组。分组树接口返回各分组的设备数量与子分组数量,方便在应用中展示。
编辑与删除设备
- 编辑:可修改设备名称、描述、位置信息等。
- 删除:删除设备会同时清除设备的连接凭据和历史数据,操作前请确认设备已停止上报。
WARNING
删除设备不可恢复,请谨慎操作。
