概述
使用遠程配置功能,可在不用重啟設備或中斷設備運行情況下,在線遠程更新設備的系統參數、網絡參數等配置信息。本文使用MQTT.fx客戶端模擬設備,進行遠程配置兩種場景的演示。MQTT.fx接入物聯網平臺
官方文檔:遠程配置
與固件升級對比
很多場景下,開發者需要更新設備的配置信息,包括設備的系統參數、網絡參數、本地策略等。通常情況下,是通過固件升級更新設備的配置信息。但是,這將加大固件版本的維護工作,並且需要設備中斷運行以完成更新。為了解決上述問題,物聯網平臺提供遠程配置更新功能,設備無需重啟或中斷運行即可在線完成配置信息更新。
前提條件
- 已在物聯網平臺控制檯開通遠程配置服務。如果未開通,登錄物聯網平臺的控制檯,選擇監控運維 > 遠程配置,然後單擊開通服務。
- 設備端SDK已開啟支持遠程配置服務。(特指設備端C SDK)。需要在設備端SDK中定義 FEATURE_SERVICE_OTA_ENABLED = y。SDK提供接口linkkit_cota_init,用於初始化遠程配置(Config Over The Air,COTA)。
場景一:雲端推送配置信息給設備端
- 設備上線並訂閱推送配置信息的Topic:/sys/${productKey}/${deviceName}/thing/config/push
- 在控制檯上打開產品的遠程配置開關,並進行批量更新
- 設備端接收雲端下發的配置文件下載鏈接後,自行更新配置。
場景二:設備主動請求配置信息
- 設備端上線並訂閱雲端響應設備請求配置信息的Topic:/sys/${productKey}/${deviceName}/thing/config/get_reply
- 在物聯網平臺控制檯中,開啟遠程配置,編輯配置信息。詳細步驟請參見以上場景一的第2步,但是不進行批量更新。
- 設備通過Topic:/sys/${productKey}/${deviceName}/thing/config/get主動查詢最新的配置信息。格式請參考:請求數據格式
- 設備端接收雲端下發的配置文件下載鏈接後,自行更新配置。
說明
- 必須開啟產品的遠程配置功能後,才可以編輯配置信息。
- 切換為關閉狀態,即關閉該產品的遠程配置功能。
- 產品配置模板適用於該產品下的所有設備。目前,不支持在控制檯向單個設備推送配置文件。
- 遠程配置文件為JSON格式。物聯網平臺對配置內容沒有特殊要求,但系統會對提交的配置文件進行JSON格式校驗,避免錯誤格式引起配置異常。
- 配置文件最大支持64 KB。編輯框右上角將實時顯示當前文件的大小。超過64KB的配置文件無法提交。
- 批量更新頻率限制:一小時內僅允許操作一次 。
- 雲端下發的配置文件下載鏈接有效期為30分鐘,設備端需要及時下載。