远程配置

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

前提条件

设备端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,使设备端支持远程配置服务,请参见操作步骤

背景信息

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

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

说明

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

功能说明

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

  • 开启或关闭产品的远程配置。

  • 在线编辑配置文件,并管理版本。

  • 从物联网平台推送配置文件,批量更新设备配置信息。

  • 设备主动请求更新配置信息。

应用场景

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

  • 物联网平台推送配置信息到设备端:您在物联网平台控制台批量推送配置信息给设备,设备接收后,修改本地配置文件。

  • 设备主动请求配置信息:设备主动向物联网平台请求新的配置文件,并进行更新。

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

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

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

远程配置
  1. 设备上线。

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

    重要

    开发设备端时,需配置设备端订阅推送配置信息的Topic:/sys/${productKey}/${deviceName}/thing/config/push

  2. 在物联网平台控制台中,编辑配置文件。

    1. 登录物联网平台控制台

    2. 实例概览页面,选择目标环境,找到对应的实例,单击实例ID或备注名称。

      重要

      目前仅开通企业版实例服务的地域下,执行此步骤。其他地域,请跳过此步骤。地域及实例的支持说明,请参见实例概述

      实例概览
    3. 在左侧导航栏,选择监控运维 > 远程配置

    4. 选择产品,打开远程配置开关,单击编辑

      远程配置
    5. 配置模板下的编辑区,编写或粘贴JSON格式的配置信息。

      说明

      产品配置模板适用于该产品下的所有设备。目前,不支持在物联网平台向单个设备推送配置文件。

    6. 编辑完成配置信息后,单击保存,然后单击确认

      完成保存后,您可手动将配置信息批量更新到该产品下的所有设备,设备可主动请求更新该配置信息。

  3. 单击批量更新,然后单击确认更新

    完成确认后,物联网平台会向该产品下的所有设备批量推送配置文件。

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

    重要
    • 从本次推送成功开始计时,同一产品下,1小时内不支持再次推送新的配置文件。

    • 同一产品的同一配置文件,仅支持从物联网平台推送一次。即使后续重复本操作,也无法再次推送相同的配置文件。

    • 如需停止批量更新设备配置信息,请关闭该产品的远程配置开关。关闭远程配置后,物联网平台将停止所有更新推送,并且拒绝设备的主动更新请求。

  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分钟,设备端需要及时下载。