远程配置 - 阿里云物联网平台

通过物联网平台提供的远程配置功能，开发人员可在不用重启设备或中断设备运行的情况下，在线远程更新设备的系统参数、网络参数等配置信息。

前提条件

设备端SDK已支持远程配置服务。设备主动请求配置信息和物联网平台推送配置信息的Topic及Alink数据格式说明，请参见远程配置。

说明

设备端SDK开发方法，请参见下载设备端SDK。如果使用物联网平台提供的C Link SDK开发：

C SDK 3.x或2.x：需在SDK中定义FEATURE_SERVICE_OTA_ENABLED = y，并通过该SDK提供的接口linkkit_cota_init，初始化远程配置（Config Over The Air，COTA）。
C SDK 4.x：需在SDK定制页面的高级能力下，选中OTA，使设备端支持远程配置服务，请参见操作步骤。

背景信息

通常情况下，开发人员可通过推送升级包到设备端更新设备的配置信息（系统参数、网络参数、本地策略等）。此方法将加大设备固件版本的维护工作，且需要设备中断运行，才能完成更新。

为解决上述问题，物联网平台提供了远程配置更新功能，无需设备重启或中断运行，即可在线完成配置信息的更新。

说明

远程配置功能是从产品维度修改设备配置，即从物联网平台上传的配置文件对所有设备生效，不可指定对单个设备生效。

功能说明

物联网平台远程配置功能支持：

开启或关闭产品的远程配置。
在线编辑配置文件，并管理版本。
从物联网平台推送配置文件，批量更新设备配置信息。
设备主动请求更新配置信息。

应用场景

远程配置使用分为两种场景：

物联网平台推送配置信息到设备端：您在物联网平台控制台批量推送配置信息给设备，设备接收后，修改本地配置文件。
设备主动请求配置信息：设备主动向物联网平台请求新的配置文件，并进行更新。

下文为您介绍上述场景的操作流程。

场景一：物联网平台推送配置信息给设备端

在物联网平台控制台，向某一产品下的所有设备批量推送配置文件。

设备上线。
设备端开发流程和代码示例，请参见Link SDK文档。
重要
开发设备端时，需配置设备端订阅推送配置信息的Topic：/sys/${productKey}/${deviceName}/thing/config/push。
在物联网平台控制台中，编辑配置文件。
1. 登录物联网平台控制台。
2. 在实例概览页面，选择目标环境，找到对应的实例，单击实例ID或备注名称。
  重要
  目前仅开通企业版实例服务的地域下，执行此步骤。其他地域，请跳过此步骤。地域及实例的支持说明，请参见实例概述。
3. 在左侧导航栏，选择监控运维 > 远程配置。
4. 选择产品，打开远程配置开关，单击编辑。
5. 在配置模板下的编辑区，编写或粘贴JSON格式的配置信息。
  说明
  产品配置模板适用于该产品下的所有设备。目前，不支持在物联网平台向单个设备推送配置文件。
6. 编辑完成配置信息后，单击保存，然后单击确认。
  完成保存后，您可手动将配置信息批量更新到该产品下的所有设备，设备可主动请求更新该配置信息。
单击批量更新，然后单击确认更新。
完成确认后，物联网平台会向该产品下的所有设备批量推送配置文件。
您单击批量更新后，如果物联网平台判断不是可信环境，会发起短信验证。当您完成短信验证后，物联网平台才会向设备下发配置文件。
重要
- 从本次推送成功开始计时，同一产品下，1小时内不支持再次推送新的配置文件。
- 同一产品的同一配置文件，仅支持从物联网平台推送一次。即使后续重复本操作，也无法再次推送相同的配置文件。
- 如需停止批量更新设备配置信息，请关闭该产品的远程配置开关。关闭远程配置后，物联网平台将停止所有更新推送，并且拒绝设备的主动更新请求。
设备端接收物联网平台下发的配置文件下载链接后，自行更新配置。
说明
物联网平台下发的配置文件下载链接有效期为30分钟，设备端需要及时下载。
（可选）查看和管理配置文件版本。
远程配置默认保存最近5次的修改记录。如果重新编辑并提交配置文件成功，上一版的配置信息将显示在下方的配置版本记录列表中。
您可查看版本更新时间和配置内容，方便追溯。单击目标版本的查看，在弹出对话框中，查看该版本的配置内容。您可在对话框中，单击恢复至此版本，所选版本的内容会恢复至编辑区中。您可在编辑区修改内容，进行批量更新。

场景二：设备主动请求配置信息

设备主动查询并更新配置信息流程图如下。

设备上线。
设备端开发流程和代码示例，请参见Link SDK文档。
说明
开发设备端时，已配置设备端订阅物联网平台响应设备请求配置信息的Topic：/sys/${productKey}/${deviceName}/thing/config/get_reply。
在物联网平台控制台中，开启远程配置，编辑配置信息，请参见场景一的步骤2。
设备端使用接口linkkit_invoke_cota_get_config来触发远程配置请求。
设备通过Topic/sys/${productKey}/${deviceName}/thing/config/get主动查询最新的配置信息。
接收到设备的请求后，物联网平台会返回最新的配置信息到Topic：/sys/${productKey}/${deviceName}/thing/config/get_reply。
设备端使用下发的配置文件链接，自行下载配置文件。
例如设备端C SDK 3.x提供回调函数cota_callback，处理配置文件的下载链接，完成更新。
说明
物联网平台下发的配置文件下载链接有效期为30分钟，设备端需要及时下载。