通过物联网平台提供的远程配置功能,开发人员可在不用重启设备或中断设备运行的情况下,在线远程更新设备的系统参数、网络参数等配置信息。
前提条件
设备端SDK已支持远程配置服务。设备主动请求配置信息和物联网平台推送配置信息的Topic及Alink数据格式说明,请参见远程配置。
背景信息
通常情况下,开发人员可通过推送升级包到设备端更新设备的配置信息(系统参数、网络参数、本地策略等)。此方法将加大设备固件版本的维护工作,且需要设备中断运行,才能完成更新。
为解决上述问题,物联网平台提供了远程配置更新功能,无需设备重启或中断运行,即可在线完成配置信息的更新。
远程配置功能是从产品维度修改设备配置,即从物联网平台上传的配置文件对所有设备生效,不可指定对单个设备生效。
功能说明
物联网平台远程配置功能支持:
开启或关闭产品的远程配置。
在线编辑配置文件,并管理版本。
从物联网平台推送配置文件,批量更新设备配置信息。
设备主动请求更新配置信息。
应用场景
远程配置使用分为两种场景:
物联网平台推送配置信息到设备端:您在物联网平台控制台批量推送配置信息给设备,设备接收后,修改本地配置文件。
设备主动请求配置信息:设备主动向物联网平台请求新的配置文件,并进行更新。
下文为您介绍上述场景的操作流程。
场景一:物联网平台推送配置信息给设备端
在物联网平台控制台,向某一产品下的所有设备批量推送配置文件。
设备上线。
设备端开发流程和代码示例,请参见Link SDK文档。
重要开发设备端时,需配置设备端订阅推送配置信息的Topic:
/sys/${productKey}/${deviceName}/thing/config/push
。在物联网平台控制台中,编辑配置文件。
单击批量更新,然后单击确认更新。
完成确认后,物联网平台会向该产品下的所有设备批量推送配置文件。
您单击批量更新后,如果物联网平台判断不是可信环境,会发起短信验证。当您完成短信验证后,物联网平台才会向设备下发配置文件。
重要从本次推送成功开始计时,同一产品下,1小时内不支持再次推送新的配置文件。
同一产品的同一配置文件,仅支持从物联网平台推送一次。即使后续重复本操作,也无法再次推送相同的配置文件。
如需停止批量更新设备配置信息,请关闭该产品的远程配置开关。关闭远程配置后,物联网平台将停止所有更新推送,并且拒绝设备的主动更新请求。
设备端接收物联网平台下发的配置文件下载链接后,自行更新配置。
说明物联网平台下发的配置文件下载链接有效期为30分钟,设备端需要及时下载。
(可选)查看和管理配置文件版本。
远程配置默认保存最近5次的修改记录。如果重新编辑并提交配置文件成功,上一版的配置信息将显示在下方的配置版本记录列表中。
您可查看版本更新时间和配置内容,方便追溯。单击目标版本的查看,在弹出对话框中,查看该版本的配置内容。您可在对话框中,单击恢复至此版本,所选版本的内容会恢复至编辑区中。您可在编辑区修改内容,进行批量更新。
场景二:设备主动请求配置信息
设备主动查询并更新配置信息流程图如下。
设备上线。
设备端开发流程和代码示例,请参见Link SDK文档。
说明开发设备端时,已配置设备端订阅物联网平台响应设备请求配置信息的Topic:
/sys/${productKey}/${deviceName}/thing/config/get_reply
。设备端使用接口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分钟,设备端需要及时下载。