设备影子

功能介绍

在设备列表中，单击具体的设备进入到设备的详情页面。

设备影子是一个Json文件，主要用于存储设备属性当前上报的属性值和IoT平台期望下发给设备的属性值，且设备影子功能只存储最近一次的上报值和期望值。每个设备有且只有一个影子。

应用场景

• 查询设备属性状态：

  • 北向应用直接向设备查询状态时，由于设备可能长时间处于离线状态或因网络不稳定掉线，因此不能及时获取设备当前的状态。使用设备影子机制，设备影子保存的是设备最新的状态，一旦设备状态产生变化，设备会将状态同步到设备影子。应用便可以及时获取查询结果，无需关注设备是否在线。

  • 很多的北向应用频繁的查询设备状态，由于设备处理能力有限，频繁查询会损耗设备性能。使用设备影子机制，设备只需要主动同步状态给设备影子一次，多个应用程序请求设备影子获取设备状态，即可获取设备最新状态，从而将应用程序和设备解耦。
• 修改设备属性信息：设备管理员通过管理门户或者调用北向API接口修改设备的属性信息，由于设备可能长时间处于离线状态，修改设备属性的操作不能及时下发给设备。在这种情况下，IoT平台可以将修改设备的属性信息存储在设备影子中，待设备上线后，将修改的设备属性值同步给设备，从而完成设备属性的修改。

  说明：

  • 仅适用于支持LWM2M协议的设备。
  • 设备影子所修改的属性信息，只支持LWM2M协议定义的属性信息，用户自定义的设备属性信息暂不支持修改。

查看方法

在“设备影子”页签中，可以查看当前设备属性数据，包括“上报值”和“期望值”，如图1所示。设备管理员可以通过北向应用或者管理门户对设备当前的属性进行修改。

• 如果当前界面中看到“上报值”与“期望值”不一致，原因可能是设备未在线，暂时存储在设备影子中，待同步给设备，期望值会存在深色底纹。
  图1 上报值与期望值不一致
  
• 如果当前界面看到的“上报值”与“期望值”一致，则表示设备最近一次上报的属性值与用户期望下发的属性值一致，期望值为白色底纹。
  图2 上报值与期望值一致