设备管理

更新时间：2024-09-10 01:49:14

设备管理主要提供设备相关的操作，用于集中管理和监控物联网设备，提高处理设备的效率和可靠性。功能包括查看设备信息、冻结或解冻设备、获取设备冻结状态、删除设备、恢复出厂设置、修改设备属性、设备转移、查看设备日志以及设备 OTA 相关功能等。

基础概念

名词	说明
属性	指设备基础属性，包含设备名称、图标和经纬度信息。经纬度数据格式为 `lon:lat`。
冻结	设备冻结后，App 首页设备列表的设备面板完全无法进入，设备上会出现冻结图标。冻结状态的设备，无法通过云端控制，但是上报或局域网控制等不受影响。
解冻	对应设备恢复服务，冻结标志和提示语消失。 App 端刷新面板后设备正常操作。
冻结状态	查询设备的冻结状态，被冻结的设备通过云端无法控制，同时设备上会出现冻结图标。
删除设备	根据设备 ID 来移除设备，被移除的设备无法查询、无法控制。但是，重新激活后，如果设备 ID 不变，所配置的联动规则、定时等规则会重新生效
恢复出厂设置	设备被删除，并且本地数据会被清除。被恢复出厂设置的设备无法查询、无法控制，同时所配置的联动规则、定时等规则都会被清除。
设备转移	用户将有权限的设备，从当前所属空间转移到其他有权限的空间。如果其他用户有转移后的空间的权限，则可以查看到这个设备并且可以操作此设备。
设备日志 ^{注释 1}	日志类型：上线（设备上线日志）下线（设备下线日志）设备激活（设备激活日志）设备重置（设备重置日志）指令下发（设备指令下发日志，例如通过 App 操作设备的指令）固件升级（设备固件升级日志）数据点上报（设备上报日志，例如设备主动上报当前状态，如电表电量）设备信号量（设备信号强度，剩余内存等日志信息）设备重启（设备重启日志）定时信息（客户设定的设备定时信息日志）
设备上报日志 ^{注释 1}	设备日志功能点上报的日志查询，适合查询指定功能点数据展示。如电表电量定时上报，可以根据功能点查询设备历史上报的数据信息。
获取设备可用的固件升级	检测设备所有通道 ^{注释 2} 是否有可用的升级，当设备有可用升级时，返回信息里面 `upgradeStatus` = `1`，此时可以通过触发设备升级接口使设备进入升级过程。
触发设备固件进行升级	触发设备开始固件升级，会异步给设备下发升级通知。设备收到升级指令后，开始进行固件升级。
获取设备固件升级进度	当处于升级过程中时，可以获取到设备当前的升级进度，进度最大为 100。

^{注释 1} 日志存储的周期默认为七天，如您需要增加日志存储时间，可开通日志存储服务自定义存储周期与存储的设备日志类型。
^{注释 2} 一个设备可能会存在多个硬件模组，例如 Wi-Fi 模组 + MCU，通道用于区分具体的硬件模组。升级的时候，可以只针对特定模组升级。

API 列表

API	接口地址
获取设备状态上报日志	GET:/v2.0/cloud/thing/{device_id}/report-logs
获取设备升级进度	GET:/v2.0/cloud/thing/{device_id}/firmware/{channel}/progress
批量查询设备详情	GET:/v2.0/cloud/thing/batch
移除设备	DELETE:/v2.0/cloud/thing/{device_id}
获取设备升级信息	GET:/v2.0/cloud/thing/{device_id}/firmware
查询单个设备详情	GET:/v2.0/cloud/thing/{device_id}
确认开始设备升级	POST:/v2.0/cloud/thing/{device_id}/firmware/{channel}
获取设备状态	GET:/v2.0/cloud/thing/{device_id}/state
获取设备操作日志	GET:/v2.0/cloud/thing/{device_id}/logs
修改设备基础属性	POST:/v2.0/cloud/thing/{device_id}/attribute
冻结/解冻设备	POST:/v2.0/cloud/thing/{device_id}/freeze
转移设备	POST:/v2.0/cloud/thing/{device_id}/transfer
恢复出厂设置	POST:/v2.0/cloud/thing/{device_id}/reset

使用限制

限制项	最高限制
批量查询设备详情接口一次查询设备数量上限	20 个
设备日志每页返回最大条数	100 条

场景示例

光储系统在家庭中的应用越来越普及。家庭用户购买光储系统后，可以利用太阳能发电并储存电能，以便在夜间或天气不好时供应电力。

鉴于光储系统体积较大且需要专业安装，经销商会派专业施工人员去用户家中安装设备并为其配备网络，并通过商家版行业App进行任务协调和状态跟进。施工人员可以登录 App 查看各个工单任务及其状态。

为了更好地了解设备运行情况和售后信息，设备需要通过商家版行业 App 进行配网，然后交付给用户所在的家庭使用。用户则可以通过用户版 App 来操作设备。因此，设备无法直接配网到用户家庭。

最佳实践

详情请参考 IoT Core 设备管理实践。

上一篇判断父子关系