设备管理
设备是产品的具体实例,可通过产品统一配置管理。
创建设备
注意事项
1、设备SN必须是唯一标识,不可与其他设备以及产品SN重复。
2、设备类型会从产品直接继承,并且不可更改。
3、物模型属性默认从产品直接继承,但设备可以自己添加独有属性,切记产品同步物模型时会覆盖设备独有属性。
4、告警配置规则默认从产品直接继承,但设备可以自己添加独有规则,切记产品同步告警规则时会覆盖设备独有告警规则。
5、指令下发配置默认从产品直接继承,但设备可以自己添加独有指令,切记产品同步指令下发时会覆盖设备独有指令。
6、设备类型:
直连设备:用于长连接设备,断开连接时平台将自动把设备置为离线状态。
网关设备:用于网关设备,设备状态完全由协议管理,协议中可以返回设备的在离线状态。
无状态设备:用于短链接或者无法获取状态的设备,无状态设备可以设置一段时间(心跳时间)未收到消息则自动离线。

设备详情
实时数据
- 实时数据页面设备可以
实时监测设备数据变化。 - 右上角也可以查看设备
历史数据,数据详情可以看到设备经过协议解析后的属性数据、设备上线、离线数据。

设备影子
- 设备影子用于保存设备的
期望状态,并与设备最后一次上报值进行对比。它适合设备暂时离线、需要在下次上线后恢复指定状态,或需要持续校验设备实际状态是否符合预期的场景。 - 进入设备详情后,切换到
设备影子页签。页面会按物模型属性展示期望值、最后上报值和属性标识符;点击属性卡片右上角的编辑按钮即可设置该属性的期望值。 - 设置期望值后,开启设备影子并点击
保存。只有设备端实际支持下发或处理的属性,才能最终同步为目标状态。 - 点击
同步配置可按需要选择:单次生效:适合临时同步一次期望状态。长期生效:适合持续保持设备状态与期望状态一致。逐项下发:按属性分别同步。批量下发:选择已配置的设备指令,一次下发多个属性。验证上报:开启后,平台会根据后续上报结果检查设备是否已达到期望状态;未达到时会按配置进行重试。
- 点击
上线指令可配置设备每次上线后自动执行的指令,例如自动恢复运行模式或重新下发关键配置。 - 点击
立即同步可手动创建一次同步任务;点击同步日志可查看任务结果、每个属性的期望值和最后上报值,以及重试和失败说明。 - 建议先通过设备指令测试确认设备可以正确处理目标属性或批量指令,再将设备影子用于长期自动同步。

物模型
- 该页面可以配置设备有哪些数据可以展示,统称为
物模型,配置时请注意数据类型,标识符即为协议解析后的属性的KEY。
指令下发和测试
- 功能下发需要协议
解析后再发送给相关设备,配置时请根据需要,不同功能配置不同的code,参数可以根据需要配置。 - 功能测试可以选择配置后的指令,然后自定义参数值,经过协议解析后发送给设备。
- 指令下发记录中可以查看下发成功与否,以及下发类型,
手动触发,规则触发,定时触发。


告警配置和记录
- 告警配置有丰富的比较符,可以配置与和或
多条件组合,但同一条规则中只能要么全与要么全或,可配置一段时间内不重复告警,以及告警之后的执行动作。

其余配置
- 每个设备都配备了额外的配置,可以单独配置
定期清理数据,自定义配置主要作用是随着消息携带进协议解析,特殊场景方便进行设备辨认。