在物联网平台控制台,使用远程配置功能,可在不用重启设备或中断设备运行情况下,在线远程更新设备的系统参数、网络参数等配置信息。

前提条件

  • 已在物联网平台控制台开通远程配置服务。如果未开通,登录物联网平台的控制台,选择监控运维 > 远程配置,然后单击开通服务
  • 设备端SDK已开启支持远程配置服务。需要在设备端SDK中定义 FEATURE_SERVICE_OTA_ENABLED = y,SDK提供接口linkkit_cota_init来初始化远程配置(Config Over The Air,COTA)。

远程配置说明

很多场景下,开发者需要更新设备的配置信息,包括设备的系统参数、网络参数、本地策略等。通常情况下,是通过固件升级的方式更新设备的配置信息。但是,这将加大固件版本的维护工作,并且需要设备中断运行以完成更新。为了解决上述问题,物联网平台提供了远程配置更新的功能,设备无需重启或中断运行即可在线完成配置信息的更新。

物联网平台提供的远程配置功能,支持:

  • 开启/关闭远程配置。
  • 在线编辑配置文件,并管理版本。
  • 批量更新设备配置信息。
  • 设备主动请求更新配置信息。

远程配置流程图如下:



远程配置大致分为三部分:

  • 生成配置文件:您在物联网平台控制台编辑并保存配置信息。
  • 推送配置文件:您在物联网平台控制台批量推送配置信息给设备。设备接收后,修改本地配置文件。
  • 设备主动请求配置信息:设备主动向云端请求新的配置文件,并进行更新。

远程配置操作流程

远程配置使用分为两种场景,一种是云端推送配置信息给设备端,一种是设备端主动请求配置信息。根据场景的不同,远程配置的步骤也有所区别。

场景一:云端推送配置信息给设备端

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

  1. 设备上线,并订阅推送配置信息的Topic /sys/${productKey}/${deviceName}/thing/config/push
  2. 在物联网平台控制台中,编辑配置文件。
    1. 登录物联网平台的控制台,选择监控运维 > 远程控制
    2. 选择产品,打开远程配置开关。

      说明
      • 必须开启产品的远程配置功能后,才可以编辑配置信息。
      • 切换为关闭状态,即关闭该产品的远程配置功能。
      • 产品配置模板适用于该产品下的所有设备。目前,不支持在控制台向单个设备推送配置文件。
    3. 单击编辑,然后在配置模板下的编辑区,编写或粘贴JSON格式的配置信息。

      说明
      • 远程配置文件为JSON格式。物联网平台对配置内容没有特殊要求,但系统会对提交的配置文件进行JSON格式校验,避免错误格式引起配置异常。
      • 配置文件最大支持64 KB。编辑框右上角将实时显示当前文件的大小。超过64KB的配置文件无法提交。
    4. 编辑完成配置信息后,单击保存,将生成正式的配置文件。设备可主动请求更新该配置信息。

  3. 向设备批量推送配置文件。单击批量更新,物联网平台会向该产品下的所有设备批量推送配置文件。

    您单击批量更新后,如果系统判断不是可信环境,会发起短信验证。您需完成短信验证后,系统才会向设备下发配置文件。



    说明
    • 批量更新频率限制:一小时内仅允许操作一次 。
    • 如果您希望停止批量推送更新,关闭该产品的远程配置开关。关闭远程配置后,系统将停止所有更新推送,并且拒绝设备主动请求更新。
  4. 设备端接收云端下发的配置信息后,自动更新配置。

查看和管理配置文件版本:

远程配置默认保存最近5次的配置修改记录。重新编辑并提交配置文件后,上一次的配置版本信息将显示在版本记录列表中。您可以查看版本更新时间和配置内容,方便追溯。

单击查看,将显示该版本的配置内容。再单击恢复至此版本,将所选版本的内容恢复至编辑区中,您可以编辑修改内容,然后批量更新。



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

在一些场景中,设备需要主动查询配置信息。可按如下步骤进行远程配置:

  1. 设备端订阅Topic /sys/${productKey}/${deviceName}/thing/config/get_reply
  2. 在物联网平台控制台中开启远程配置。详细步骤请参见场景一的开启远程配置操作描述
  3. 设备端用户使用接口linkkit_invoke_cota_get_config来触发远程配置请求。
  4. 设备通过Topic /sys/${productKey}/${deviceName}/thing/config/get主动查询最新的配置信息。
  5. 接收到设备的请求后,云端会返回最新的配置信息到设备中。
  6. 设备端用户在回调函数cota_callback中,处理远程配置下发的配置文件。