设备生命周期管理
更新时间: 2023-04-10

通过平台的设备管理功能,可查询和管理设备的生命周期。

设备的生命周期状态代表设备相对于平台活跃状态,会对设备进行的操作产生限制和约束,例如当设备在线状态为离线时,对设备进行指令下发无法到达设备。

# 设备生命周期

# 生命周期定义

设备生命周期分为创建、激活、管理、删除等阶段,对应的平台定义一套固定的生命周期状态,用户按平台定义的生命周期状态进行设备开发,其他平台未定义的状态如用户需要可以自行在设备属性中进行定义。

平台预置的设备生命周期项:

状态类型 状态及状态项定义
激活状态 标识设备是否投用。
1. 未激活:设备的初始默认状态
2. 已激活:设备完成一次设备接入鉴权并通过,设备状态标记为已激活
在线状态 设备在线状态指业务上定义的设备与平台或设备与应用的业务连接关系,设备管理提供在线状态的托管,不提供在线状态的判定,设备在线状态由用户根据实际业务场景维护。
1. 在线:设备与平台或设备与应用保持业务连接关系,用户定义(例如:设备每30s发送一个心跳,业务应用在30s内接收到至少1次心跳即认为设备在线)
2. 离线:设备初始默认状态,设备与平台或设备与应用断开业务连接关系(例如:设备每30s发送一个心跳,业务应用在30s内未接收到心跳即认为设备离线)
启用状态 标识设备是否可以访问设备管理资源,设备权限开关,禁用设备可以在不重置鉴权密钥情况下限制设备资源访问,用于用户在业务场景中控制设备欠费、封禁等业务场景。
用户有启用禁用设备操作的权限。
1. 已启用:设备初始默认状态,启用状态下设备可以通过鉴权中心获得连接配置信息等
2. 已禁用:禁止设备端使用设备资源,禁用状态下设备不能通过鉴权中心
封禁状态 平台层面对设备状态的标识,基于封禁状态平台定义一系列的操作限制。
封禁状态优先级高于启用状态,设备封禁后无论设备是否激活、启用,设备均不能通过鉴权。
一般情况下封禁是物联网平台运营、运维层面的操作,用户只需关注封禁状态,封禁状态的接触需要联系平台处理。
1. 未封禁:初始化默认状态,设备可以进行正常操作
2. 已封禁:禁止设备端使用设备资源及用户通过服务端访问设备管理相关的云端api

# 生命周期管理

# 创建设备

首先需在平台上创建设备。可以在控制台创建设备或调用云端API创建设备。

  1. 创建设备时必须选择一个产品,同时指定设备的deviceName(唯一标识,产品下唯一),可选填写设备的备注名称(显示名称)

  2. 支持单个创建和批量创建

  3. 批量常见时支持表格导入方式批量及指定数量自动生成deviceName批量

  4. 单产品下默认最多可添加10万台设备,单账号下可添加10万台设备(具体限额限制,根据不同的平台商业版本可调可配)

  5. 创建设备时平台根据所选产品的配置为设备初始化资源配置,包括MQTT连接、视频连接等

# 激活设备

设备创建之后,默认为未激活状态。

  • 激活状态流转
初始状态 操作 最终状态
未激活 1. 设备完成首次接入鉴权通过,设备管理自动更新激活状态为已激活
2. 用户调用云端api更新设备激活状态为已激活
已激活
已激活 调用云端api更新设备激活状态为未激活 未激活

# 设备上线、下线

设备激活之后,用户可以根据业务需求更新设备的在线状态。

  • 在线状态流转
初始状态 操作 最终状态
离线 用户调用云端api更新设备在线状态为在线
离线检测周期内设备主动向平台上报任意消息
前置条件:设备
【已激活&已启用&未封禁】时才允许更新为在线
在线
在线 用户调用云端api更新设备在线状态为离线 离线

# 启用、禁用设备

在任意状态下,用户可以根据业务需求更新设备的启用状态。

  • 启用状态流转
初始状态 操作 最终状态
已启用 用户控制台或服务端api主动更新 已禁用
已禁用 用户控制台或服务端api主动更新 已启用

# 删除设备

用户可以根据业务需求通过控制台或服务端api主动删除设备。

删除设备后平台同时销毁设备资源且无法恢复,已部署或激活的设备除非在设备端更新重新获得配置,否则无法再与平台建立连接。

# 设备状态之间优先级关系

  1. 不同的状态类型之间互相独立,所有状态类型的状态共同决定设备最终的可操作性

  2. 当某个状态类型发生变化时不改变其他状态类型状态,例如当平台对设备进行封禁操作时,设备其他状态处于已激活、离线、已启用,当设备解除封禁后,依然保持已激活、离线、已启用;如封禁期间用户对设备状态进行了操作,例如禁用,则解除封禁后设备状态为已激活、离线、已禁用

  3. 设备的初始状态:未激活、离线、已启用、未封禁

  4. 状态操作权限优先级:封禁状态>启用状态>激活状态>在线状态

# 设备禁用/封禁操作对设备的影响

当设备被执行禁用或封禁操作时,平台会对设备操作权限执行如下限制:

  1. 设备不能通过鉴权中心认证,进而无法获取设备的资源配置信息
  2. 已连接的在线设备踢下线,同时不再推送设备上报消息到服务端订阅