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

前提条件

设备端SDK已开启支持远程配置服务。

各语言SDK开发方法,请参见Link SDK文档。其中,使用设备端C 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,使设备端支持远程配置服务,请参见获取SDK

背景信息

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

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

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

功能说明

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

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

应用场景

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

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

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

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

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

远程配置
  1. 设备上线。

    设备端开发流程和代码示例,请参见Link SDK文档

    注意 开发设备端时,需配置设备端订阅推送配置信息的Topic:/sys/${productKey}/${deviceName}/thing/config/push
  2. 在物联网平台控制台中,编辑配置文件。
    1. 登录物联网平台控制台
    2. 实例概览页面,找到对应的实例,单击实例进入实例详情页面。
      实例概览
    3. 在左侧导航栏,选择监控运维 > 远程配置
    4. 选择产品,打开远程配置开关,单击编辑
      远程配置
    5. 配置模板下的编辑区,编写或粘贴JSON格式的配置信息。
      说明 产品配置模板适用于该产品下的所有设备。目前,不支持在物联网平台向单个设备推送配置文件。
    6. 编辑完成配置信息后,单击保存,然后单击确认
      完成保存后,您可手动将配置信息批量更新到该产品下的所有设备,设备可主动请求更新该配置信息。
  3. 单击批量更新,然后单击确认更新
    完成确认后,物联网平台会向该产品下的所有设备批量推送配置文件。

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

    说明
    • 批量更新频率限制:一小时内仅允许操作一次。
    • 如需停止批量更新设备配置信息,请关闭该产品的远程配置开关。关闭远程配置后,物联网平台将停止所有更新推送,并且拒绝设备的主动更新请求。
  4. 设备端接收物联网平台下发的配置文件下载链接后,自行更新配置。
    说明 物联网平台下发的配置文件下载链接有效期为30分钟,设备端需要及时下载。
  5. (可选)查看和管理配置文件版本。
    远程配置默认保存最近5次的修改记录。如果重新编辑并提交配置文件成功,上一版的配置信息将显示在下方的配置版本记录列表中。

    您可查看版本更新时间和配置内容,方便追溯。单击目标版本的查看,在弹出对话框中,查看该版本的配置内容。您可在对话框中,单击恢复至此版本,所选版本的内容会恢复至编辑区中。您可在编辑区修改内容,进行批量更新。

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

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

远程配置
  1. 设备上线。

    设备端开发流程和代码示例,请参见Link SDK文档

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