设备配置更新（联通用户专用）

概述

物联网平台提供设备配置更新功能，即用户可通过控制台对单个设备或批量设备的设备属性值进行修改，满足用户频繁、快捷、方便的管理设备的诉求。比如，某路灯最初设置温度属性达到A摄氏度时上报告警，用户需要修改该属性值为B摄氏度，即可修改其配置文件，然后通过控制台上传到物联网平台，以实现配置更新。

• 针对LWM2M协议设备的设备配置更新，物联网平台提供了设备影子功能，将修改设备的属性信息存储在设备影子中，待设备上线或上报数据时，将修改的设备属性值同步给设备，从而完成设备属性的修改。
• 针对原生MQTT协议接入或集成Agent Lite SDK的设备，物联网平台直接配置更新下发，修改设备的设备属性值。

物联网平台第一次给设备下发配置更新，如果当前的配置文件还没有下发给设备前，又进行了第二次的配置下发，则将两次的配置文件进行合并后再下发（如果配置项重复，则后一次会覆盖前一次）。

前提条件

设备的产品模型中已定义该设备服务属性，且该属性支持可配置，在界面上传的配置文件为JSON格式，才能完成配置更新下发。

单个设备配置更新

1. 登录物联网平台控制台，点击右上角“进入设备管理服务”。
2. 单击左下角，在“产品模型”界面上，单击设备所属产品模型的“详情”按钮，“维护能力配置”中的“设备配置”设置为“支持”。

   

3. 进入“所有设备”页面，单击设备所在行的按钮，可对设备进行配置更新。

   

4. 在弹出窗口中，按照下表配置参数。

   参数名称	参数说明
   任务名	创建设备配置下发的任务名称。
   执行类型	任务的执行类型。分为“现在”、“设备在线时”、“自定义”。选择“自定义”时需要设置“执行时间。”
   执行时间	执行类型选择“自定义”时生效，设置任务执行的时间。
   重试策略	否：不重试。 自定义：需要设置重试次数。
   重试次数	当“重试策略”为“自定义”时需要设置此参数。
   重试间隔（秒）	当“重试策略”为“自定义”时需要设置此参数。
   配置文件	需要导入设备的配置文件，可点击下载上一次下发成功的配置文件信息进行修改后再导入。 如果在此操作前，未对设备进行过配置下发的操作，点击下载设备配置文件会提示“找不到资源”，这种情况下只能通过用户自定义的方式，手动制作配置文件，支持配置下发修改的项需要与设备支持的能力（设备对应的产品模型）保持一致，且配置文件需要为JSON格式，例如： { "sensitivity": "0", "dataReportInterval": "20" }

批量设备配置更新

1. 登录物联网平台控制台，点击右上角“进入设备管理服务”。
2. 单击左下角，在“产品模型”界面上，单击设备所属产品模型的“详情”按钮，“维护能力配置”中的“设备配置”设置为“支持”。

   

3. 选择“ 批量任务> 批量设备配置”，单击页面右上角的“创建”。
4. 在弹出的“批量设备配置”窗口中，按照下表配置参数。

   参数名称	参数说明	配置原则
   任务名称	批量设备配置的任务名称。	按照实际情况填写。长度不超过50的字符串。
   是否使用策略	批量设备配置执行策略是否需要配置。	请根据实际情况选择，默认勾选。
   执行类型	选择批量设备配置的任务执行时间。	现在：任务创建完成后开始。 设备在线时：当物联网平台与设备互联时执行任务。 自定义：可以自定义选择开始和结束时间。“开始时间”和“结束时间”在“执行类型”参数设置为“自定义”时生效。
   重试策略	任务失败后是否需要自动重新执行，默认为“否”。	否：不重新执行。 自定义：可自定义重试次数。
   重试次数	“重试策略”参数设置为“自定义”时生效。	-
   重试间隔（秒）	“重试策略”参数设置为“自定义”时生效。	-

5. 单击“下一步”，进入下一步配置。按照实际情况配置参数。
6. 选择需要批量配置下发的设备群组，单击“下一步”，跳转至文件上传页面。单击，将整理好的Json格式设备配置信息文件上传。
   配置文件制作方法：

   • 之前有成功下发的配置文件：选择“设备 > 所有设备”，在右侧的窗口中单击相同类型设备所在行的按钮，在“配置文件”一栏，下载上一次下发成功的配置文件文件进行修改后再导入。
   • 之前未对设备进行过配置下发的操作：手动制作配置文件，支持配置下发修改的项需要与产品模型里支持的能力保持一致，且配置文件需要为JSON格式，例如：

     {    "sensitivity": "0",   
      "dataReportInterval": "20"
     }

7. 单击“提交”，完成批量设备配置任务创建。
8. 界面列表显示任务执行的状态和结果。如果成功率低于100%，则可以单击具体的任务名称，进入任务详情，查看执行失败的原因。

相关API接口

查询设备服务能力