设备管理

更新时间:2024-06-28 05:55:34下载pdf

设备管理主要提供设备相关的操作,用于集中管理和监控物联网设备,提高处理设备的效率和可靠性。功能包括查看设备信息、冻结或解冻设备、获取设备冻结状态、删除设备、恢复出厂设置、修改设备属性、设备转移、查看设备日志以及设备 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 来操作设备。因此,设备无法直接配网到用户家庭。

施工人员商家 App设备用户 App用户登录创建一个站点空间配网新设备空间模型将设备从空间转移到家庭家庭模型登录操作和使用施工人员商家 App设备用户 App用户设备转移应用场景示例

最佳实践

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