设备管理

菜单：物联网 > 设备管理（列表路由 /iot/device-info，详情路由 /iot/deviceInfo/info?id=）

设备列表

• 搜索：产品、设备唯一标志（deviceName）、设备别名、设备状态（在线/离线）、启动状态、创建时间。
• 新增：填写所属产品、设备标志（deviceName）、设备别名、备注、启动状态。deviceName 平台全局唯一（跨产品不能重名），创建后不可修改。
• 批量新增：选择产品后上传 CSV / XLS 文件（页面提供模板下载），单次最多 1000 台；每台设备自动生成 32 位十六进制的 DeviceSecret 并自动创建设备影子。
• 导出：导出当前设备列表。
• 启动状态开关：列表中每行的状态开关即 startupState。停用（0→关闭）在线设备时，平台会立即调用 EMQX REST 将其强制踢下线；停用后新连接鉴权也会被拒绝。
• 删除：级联清理设备的分组关联、网关-子设备关联与版本记录；在线设备删除时同样会被踢下线。
• 修改：设备标志（deviceName）、DeviceSecret、所属产品、设备状态不可修改，仅别名、备注、启动状态可更新。

注意

DeviceSecret 默认以掩码显示，在设备详情页头部单击「获取」并完成短信验证后查看。泄露后他人可伪造该设备连接平台。

设备详情页签

设备详情页顶部展示设备名、在线状态标签、设备二维码、DeviceSecret（验证后查看）、ProductKey 与 deviceName（可复制）。

页签	功能
设备信息	产品、ProductKey、设备别名（内联编辑）、设备类型、联网方式、RSSI、软件版本；设备本地日志上报开关；MQTT连接 / MQTTS连接 → 获取连接信息（返回 clientId / username / password / host / port / keepalive，直接用于设备连接调试，详见建立 MQTT 连接）
物模型	四个子页签：设备属性（最新值卡片、属性历史查询与导出）、远程调用（执行服务调用、查看调用记录）、设备事件（按时间范围查询事件记录）、属性配置（对「读写」属性下发设置值）
控制面板	为该设备配置 amis 低代码可视化控制面板，详见控制面板
设备影子	查看完整影子 JSON 与最近更新时间；单击 更新影子 可编辑 reported 与 desired 两段 JSON。云端修改 desired 后，平台会向在线设备实时推送 control 消息。协议细节见设备影子
设备调试	上下行消息流水（聊天式卡片，支持自动刷新与滚动加载）+ 模拟发送：选择设备已订阅的 Topic、QoS 0/1/2、JSON / HEX 格式发送，用于联调验证（即消息流水记录）
设备升级	显示设备当前软件版本；升级功能已迁移至 OTA 页面，单击跳转OTA 升级管理
分组	查看与调整该设备所属分组，详见设备分组
任务	设备定时任务已迁移至独立的任务功能模块，单击跳转设备任务
子设备	仅网关设备（节点类型为网关）显示：添加 / 移除网关下的子设备
Topic 列表	展示该设备当前订阅的 Topic 与 QoS
本地日志	查看设备上报的本地日志（模块、追踪标识、代码、级别、内容），支持导出

物模型远程操作说明

• 属性配置（设置属性）：仅列出物模型中读写类型为「读写」的属性；下发使用 QoS 0 且平台不等待设备回复，设置是否生效以设备随后的属性上报为准。
• 远程调用（服务调用）：调用方式由物模型中服务定义的 调用方式（callType） 决定——同步服务等待设备回复（10 秒超时），异步服务下发即返回；设备离线时调用报「设备离线」错误。

注意事项

• 控制台状态经 Kafka 链路同步，存在秒级延迟；「设备实际在线但后台显示离线」时，属性设置与服务调用也会失败，可稍后重试。
• 设备调试页签的模拟发送走 EMQX REST 下发，是验证设备订阅与解析逻辑的最快方式，详见联调与验证。