本文說明如何在 Azure RTOS NetX Duo 中建立 Azure IoT 中樞代理程式的裝置更新。 本文也為開發人員提供簡單的 API,以便在應用程式中整合裝置更新功能。 請參閱主要半導體評估板的範例,其中包含入門指南,以便您了解如何設定無線更新,並將其建置及部署至裝置。
如尚未擁有 Azure 訂用帳戶,請在開始之前先建立免費帳戶。
先決條件
- 存取 IoT 中樞執行個體。 我們建議您使用 S1 (標準) 層或更高的層級。
- 連結至 IoT 中樞的裝置更新執行個體和帳戶。 若先前尚未進行,請依循指南以建立及連結裝置更新帳戶。
開始吧
每個板子專屬範例 Azure 即時作業系統(RTOS)專案都包含程式代碼和文件,說明如何使用 IoT 中心的裝置更新功能。 您將會:
- 從 Azure RTOS 和裝置更新範例下載特定於板子的範例檔案。
- 從下載的範例中尋找文件資料夾。
- 依循文件步驟,了解如何準備 Azure 資源和帳戶,並註冊 IoT 裝置。
- 依循文件建置新的韌體映像,並匯入您電路板的清單。
- 將韌體映像和資訊清單發佈到 Device Update for IoT Hub。
- 下載專案,並在您的裝置上執行。
深入瞭解 Azure RTOS。
標記您的裝置
讓裝置應用程式從上一步繼續執行。
登入 Azure 入口網站並移至 IoT 中樞。
在左側窗格中,選取 [裝置]。 尋找您的 IoT 裝置,並前往裝置雙胞胎。
在裝置對應項中,將所有的現有裝置更新標記值設為 Null,以進行刪除。
將新的裝置更新標記值新增至根 JSON 物件,如下所示:
"tags": { "ADUGroup": "<CustomTagValue>" }
建立更新群組
移至頁面頂端的 [群組和部署] 索引標籤。
請按下 新增群組 以建立新的群組。
從清單中選取 IoT中樞 標籤和 裝置類別 。 接著選取 [建立群組]。
建立群組之後,您會看到更新合規性圖表和群組清單已更新。 更新合規性圖表顯示各種合規性狀態的裝置計數:最新的更新、有新的更新可用和更新進行中。 了解更新的合規性。
您應該會看到新建立的群組,以及新群組中裝置的任何可用更新。 如果有不符合群組裝置類別需求的裝置,它們會顯示在對應的無效群組中。 若要從此檢視將最佳的可用更新部署到新的使用者定義群組,請選取群組旁的 [部署]。
深入瞭解 如何新增標籤和建立更新群組。
部署新韌體
建立群組之後,您應該會看到裝置群組可用的新更新,包含 [最佳更新] 底下的更新連結。 您可能需要再次重新整理。 深入了解更新的合規要求。
透過選取群組名稱來選擇目標群組。 系統會將您導向至 [群組基本資料] 下方的群組詳細資料。
若要開始部署,請移至 [目前部署] 索引標籤。從 [可用更新] 區段選取所需更新旁的部署連結。 所指定群組的最佳可用更新會以最佳醒目提示來表示。
您可以設定您的部署立即啟動或在未來啟動。 然後選擇 [建立]。
小提示
根據預設,開始日期和時間比目前時間晚 24 小時。 如果您想要提早開始部署,請務必選取不同的日期和時間。
在 [部署詳細資料] 下方,[狀態] 會變成 [作用中]。 部署的更新會標示為 [(部署中)]。
檢視合規性圖表,以查看更新目前是否正在進行中。
成功更新裝置之後,您會看到合規性圖表和部署詳細資料已更新,以反映相同狀態。
監控更新部署
您現在已在 Azure RTOS 內嵌裝置上使用 IoT 中樞的裝置更新功能,成功完成端對端影像更新。
後續步驟
若要深入瞭解 Azure RTOS 及其如何使用 IoT 中樞,請參閱 Azure RTOS 網頁。