通過物聯網平臺提供的遠程配置功能,開發人員可在不用重啟設備或中斷設備運行的情況下,在線遠程更新設備的系統參數、網絡參數等配置信息。
前提條件
設備端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分鐘,設備端需要及時下載。