共用方式為

Azure Sphere 的新功能

  • 發行項

重要

這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。

Azure Sphere 會持續更新。 功能版本 支援新功能，且可能包含 Azure Sphere OS、SDK 和/或服務的更新。 品質版本 只包含 Bug 修正和安全性更新，而且通常只能包含 Azure Sphere OS。 版本號碼通常為 year.month 格式，因此 22.04 會識別 2022 年 4 月的版本。

收到更新通知

當新版本發生時，我們會在 Azure 更新和 IoT 技術社群部落格上張貼通知。

接收更新

更新作業系統時，系統會自動從雲端下載到連線到因特網的 Azure Sphere 裝置。

若要確認附加裝置上已安裝的 OS 版本，請使用下列命令：

azsphere device show-os-version

SDK 更新和 Visual Studio / Visual Studio Code 擴充功能必須手動安裝 - 請參閱這些適用於 Windows 或 Linux 的指示。 若要檢查電腦上安裝的 SDK 版本，請使用下列命令：

azsphere show-version

零售評估版OS版本

零售評估計劃可在所有裝置更新OS前兩周對應用程式進行回溯相容性測試。 強烈建議所有生產使用者都使用此測試設備。 請參閱 設定裝置以進行OS評估 ，以瞭解如何參與。

報告弱點

Azure Sphere 鼓勵安全性研究人員搜尋任何弱點，並根據 MSRC 入口網站的Microsoft 協調弱點洩漏 原則 來回報這些弱點。 弱點報告可能包括透過 azure 賞金計劃Microsoft獎勵。 如需 Azure Sphere CVE 的一般資訊，請參閱 Azure Sphere CVE 。 您可以在 MSRC 安全性更新指南和本文的發行特定詳細數據中找到已發行之 CVE 的相關信息。

2024 年 9 月

2024年9月27日

在 2027 年 9 月宣佈淘汰 Azure Sphere （舊版） 服務介面

Azure Sphere （舊版） 介面，包括 Azure Sphere （舊版） API （也稱為 PAPI） 和 Azure Sphere （舊版） CLI （也稱為 azsphere），將於 2027 年 9 月 27 日淘汰。 從現在到 2027 年 9 月 27 日，Azure Sphere（舊版）將受到完全支援，而且您可以繼續使用 Azure Sphere （舊版） API 和 CLI 介面。 不過，在 2027 年 9 月 27 日之前，您必須移轉至 Azure Sphere（整合式），並開始在 Azure 入口網站 和 Azure CLI 中管理 Azure Sphere 裝置，而且您必須更新任何自定義自動化和應用程式，以使用 Azure Sphere （整合） API。

Azure Sphere（整合）支援所有 Azure Sphere（舊版）功能，並可讓您在管理 Azure Sphere 裝置時使用其他功能強大的 Azure 服務，包括Microsoft Entra ID、Azure 角色型訪問控制和 Azure 監視器。

如需淘汰以及如何移轉至 Azure Sphere （整合式）的詳細資訊，請參閱此 部落格文章。

2024 年 8 月

2024 年 8 月 19 日

服務 （舊版）：已淘汰邀請使用者 API

基於安全性考慮，我們已從 Azure Sphere（舊版）公用 API 中移除「邀請使用者」API。 CLI 命令 azsphere register-user會使用此 API，現在會產生錯誤訊息。 替代方法 應該用來註冊 Azure Sphere（舊版）使用者。

服務（整合式）：尋找裝置的新功能

您現在可以在可存取的所有目錄中搜尋裝置識別碼。 如果您有裝置的讀取器或更大的 Azure RBAC 許可權，搜尋結果會顯示裝置的連結，以及裝置的父裝置群組、產品和目錄。 如果您沒有讀者或更高的訪問許可權，搜尋將會傳回找不到裝置的錯誤。

有新的 Azure Sphere 資源庫專案可供使用，示範如何使用 MQTT-C 用戶端連結庫，透過 MQTT 將 Azure Sphere 裝置連線到 Azure 事件方格 命名空間。 此專案會使用 Azure Sphere 的 wolfSSL TLS 連結庫和 裝置驗證和證明 （DAA） 憑證機制，以安全、已驗證和證明的方式形成連線。

2024 年 7 月

2024 年 7 月 31 日

Azure Sphere 安全性服務會開始使用新的映像簽署憑證來簽署所有映像生產環境簽署的應用程式和功能。 由於生產裝置於 7 月 10 日在受信任金鑰存放區中收到新憑證（如下所示），因此不會對生產裝置造成任何影響。 在某些製造或開發案例中，有輕微的影響。

2024年7月10日

此版本包含 Azure Sphere 裝置受信任金鑰存放區的更新，這會導致所有裝置（不論裝置是否在零售或零售 Eval 摘要上），安裝此更新並重新啟動。 如需詳細資訊，請參閱部落格文章 Azure Sphere – 映射簽署憑證更新。

24.06 版的新功能

2024年6月25日

Azure Sphere 24.06 版本僅包含 Azure Sphere OS 中的錯誤修正;不包含更新的 SDK。 如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。

已修正 24.06 版本中的 Bug 和常見弱點

24.06 版本包含可緩解常見弱點和風險的更新（CVE）：

  • CVE-2023-52160

24.03 版的新功能

2024 年 3 月 26 日

Azure Sphere 24.03 版本現已推出，並包含下列元件：

  • Azure Sphere 正式運作（整合）
  • Azure Sphere OS 更新
  • 適用於 Windows 及 Linux 的 Azure Sphere SDK 更新
  • 適用於 Visual Studio 及 Visual Studio Code 的 Azure Sphere 延伸模組更新
  • 更新的範例

此版本中的亮點包括 Azure Sphere（整合式）、自定義憑證連線至 Azure IoT 的支援、適用於 Azure Sphere OS 的更新版本 cURL、安全性修正、Ubuntu 24.04 發行的 SDK 支援，以及 CMake 工具鏈的簡化。

Azure Sphere 正式運作（整合）

我們很高興宣佈，從今天開始，Azure Sphere 裝置的新管理介面 Azure Sphere（整合式）已正式推出以供生產環境使用。 Azure Sphere（整合式）現在是 Azure Sphere 服務的建議介面，且不再在 Azure 入口網站 中標示為 Preview。

使用 Azure Sphere（整合式），您可以直接在 azure CLI 的 Azure 入口網站 和 Azure Sphere 擴充功能中管理 Azure Sphere 裝置。 Azure Sphere（整合式）是以 Azure Resource Manager 平台為基礎的新 Azure Sphere（整合式）REST API 為基礎，內建支援其他功能強大的 Azure 服務，包括 Azure RBAC 和 Azure 監視器。

自公開預覽版以來的 Azure Sphere 更新：

  • 有新的 Azure RBAC 預先建置角色可供使用：Azure Sphere 擁有者。 Azure Sphere 擁有者角色可為 Azure Sphere 資源提供完整許可權，但與同時提供完整許可權的 Azure Sphere 參與者角色不同，Azure Sphere 擁有者角色也包含設定 Azure Sphere 資源的 Azure RBAC 存取權的能力。

  • 為了在檢視個別產品、裝置群組或裝置時更容易流覽，您現在可在更新的左側功能表中存取資源特定的概觀資訊、訪問控制、工作和屬性設定。

  • 當您需要採取動作時，您可以使用 Azure 監視器來收到警示，因為目錄 CA 憑證的兩年憑證卷。 如需詳細資訊，請參閱監視 Azure Sphere 車隊和裝置健康情況。

如果您尚未開始使用 Azure Sphere（整合式），建議您立即這麼做。

單次整合步驟可讓您在 Azure Sphere 中管理現有的 Azure Sphere（舊版）租使用者（整合式）。 整合租用戶之後，您可以使用 Azure Sphere（整合）或 Azure Sphere（舊版）來執行管理工作。 您可以從 Azure Sphere（整合）中的測試和開發活動開始，並繼續使用 Azure Sphere（舊版）進行生產管理工作流程，以暫存採用 Azure Sphere（整合式），直到您準備好完全移轉為止。 雖然 Azure Sphere（舊版）介面持續受到完整支援，但建議您移轉以充分利用 Azure Sphere（整合式）功能和未來的增強功能。

如需詳細資訊，請參閱 Azure Sphere（整合式）的部落格文章 已正式推出

24.03 OS 中的新功能和變更功能

Azure Sphere OS 的 24.03 版包含下列變更：

已修正 24.03 OS 版本中的 Bug 和常見弱點

Azure Sphere OS 中包含的 cURL 版本已從 7.69.1 版更新為 7.87.0。 24.03 OS 版本包含可減輕這些常見弱點和風險的更新（CVE）：

常見弱點和暴露程度 （CVE）
CVE-2022-27774 CVE-2022-27776
CVE-2022-32205 CVE-2022-32207
CVE-2022-32208 CVE-2022-32221
CVE-2022-35252 CVE-2022-35260
CVE-2022-43551 CVE-2022-43552
CVE-2023-23914 CVE-2023-23916
CVE-2023-27533 CVE-2023-27534
CVE-2023-27535 CVE-2023-27536
CVE-2023-27538 CVE-2023-27538
CVE-2023-28319CVE-2023-28320
CVE-2023-28321 CVE-2023-28322

支援使用自定義憑證連線至 Azure IoT 服務

Azure Sphere 裝置現在可以利用自定義憑證鏈結來連線到 Azure IoT 服務。 使用非 Azure Sphere 憑證鏈結對於具有憑證使用量額外組織需求的應用程式很有説明。 已更新與 Azure IoT 連線的指引，以進一步描述此使用案例。 任何使用 23.05 OS 所發行功能的 Beta API 版本的客戶，都應該下載最新的 SDK 並重新編譯其應用程式，以移轉至新的 API，並指出函式簽章已變更，以提升此功能的生產應用程式。

24.03 SDK 和 Visual Studio/Visual Studio Code 擴充功能中的新增和變更功能

Azure Sphere SDK 和 Visual Studio/Visual Studio Code 延伸模組的 24.03 版本包含下列變更：

Ubuntu 18.04 LTS 的終止支援

Ubuntu 18.04 現在已超出 Canonical 的長期標準支援安排。 因此，23.05 SDK 是支援此 OS 版本的最後一個 Azure Sphere SDK。 24.03 和未來的 SDK 不支援 Ubuntu 18.04。

已新增Ubuntu 24.04發行前版本的SDK支援

24.03 SDK 新增對Ubuntu24.04發行前版本的支援，並新增至現有的Ubuntu 20.04和22.04支援。 這是針對Ubuntu24.04的開發和測試用途，再發行給公眾。

CMake 工具鏈變更

在 SDK 23.05 版和更早版本中，Azure Sphere 應用程式所使用的目標 API 集合（sysroot）必須在CMakePresets.json和CMakeLists.txt檔案中指定，這在每次 SDK 發行之後都需要手動更新。

為了簡化此程式，以及簡化未來的更新， azsphere_configure_tools 已將 和 azsphere_configure_api CMakeLists.txt 項目設為不必要的和已被取代。 建置程式現在只會使用 CMakePresets.json 中的 AZURE_SPHERE_TARGET_API_SET 值作為目標 API 版本的真相來源。

根據預設，參數的值 AZURE_SPHERE_TARGET_API_SET 會設定為 CMakePresets.json 中的 「latest-lts」，這表示當 SDK 更新時，專案會自動以最新的 API 版本為目標。 如果您想要將 API 版本釘選到特定版本（例如，建置具有特定 OS 版本的製造產品應用程式時），您應該將 AZURE_SPHERE_TARGET_API_SET 參數設定為該版本。

現有的項目會繼續使用新的 SDK 進行編譯，不過警告訊息會通知使用者，他們可以移除已被取代CMakeLists.json專案。 根據 GitHub 範例建立的新專案需要 24.03 或更新版本的 SDK 和 VS/VS Code 延伸模組。

已更新 24.03 的範例

24.03 版本包含範例的下列變更：

Azure Sphere HTTPS cURL 多重範例的更新

先前的 Azure Sphere HTTPS cURL 多重範例已不再遵循目前建議的 cURL 最佳做法，您可以在這裡更詳細地看到。 雖然我們已保留與舊方法的相容性，但我們已更新範例，並建議 將最新的方法 納入您可能進行的任何軟體更新或新的開發工作。

使用適用於 Azure CLI 的 azure-sphere 擴充功能的範例更新

我們建議針對未來的開發工作使用現已正式運作的 Azure Sphere（整合式）介面。 範例自述檔案中的指示已更新，以在 Azure CLI 的 azure-sphere 擴充功能中使用命令。

Azure Sphere （整合） 公開預覽版本

2023 年 8 月 8 日

我們很高興宣佈 Azure Sphere 的公開預覽版（整合式），這是 Azure Sphere 服務的新管理介面，可透過 Azure Resource Manager 原生與 Azure 整合。

此 Azure Sphere（整合式）公開預覽包含：

  • Azure Sphere 安全性服務的新 REST API，與 Azure Resource Manager 整合
  • Azure 入口網站和 Azure CLI 整合
  • Azure 監視器整合
  • Azure RBAC 整合

請閱讀 本文 ，以深入瞭解安全性、可檢視性、可用性、簡化的支援存取，以及這些整合的其他優點。

在公開預覽期間，建議使用 Azure Sphere（整合）進行開發和測試。 最佳做法是，生產使用案例（例如在製造或作業工作流程期間）不應使用預覽產品。 因此，針對生產使用案例，我們建議您繼續使用現有的 Azure Sphere 安全性服務介面，現在稱為 Azure Sphere（舊版），該介面會繼續受到完整支援且正式推出。

若要深入瞭解 Azure Sphere（整合）和 Azure Sphere（舊版），包括如何開始使用，請參閱 本檔。

此版本沒有作業系統或 SDK 更新。 Azure Sphere （整合） 命令行工具是由新的 Azure CLI 擴充功能所提供，其需要使用與連線裝置互動的命令時，必須安裝 23.05 Azure Sphere SDK。

23.05 版的新功能

2023年10月26日

Azure Sphere 23.05 Update 1 版本包含下列適用於 Visual Studio 和 Visual Studio Code 的 Azure Sphere 擴充功能更新：

  • Azure Sphere （整合） 目錄管理的新快捷方式
  • 錯誤修正

它不包含更新的OS或SDK。

2023年6月20日

Azure Sphere 23.05 功能版本包含下列元件：

  • Azure Sphere OS 更新
  • 適用於 Windows 及 Linux 的 Azure Sphere SDK 更新
  • Visual Studio 和 Visual Studio Code 的 Azure Sphere 擴充功能更新

如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。 系統會提示您在下一次使用時安裝更新的 SDK，或者您現在可以加以安裝。 若要安裝最新的 SDK，請參閱 Windows 或 Linux 的安裝快速入門。

此版本中的亮點包括新的密碼編譯連結庫、預設 NTP 後援、Windows 上適用於 Azure IoT 連線的新 Beta API，使用您自己的憑證、更快速且增強的處理站測試、Linux 的多裝置支援、新的工具存放庫，以及剖析裝置記錄自助資源庫項目的畢業，以完全支持狀態。

23.05 OS 中的新功能和變更功能

Azure Sphere OS 的 23.05 版包含下列變更：

Microsoft管理的上架密碼編譯連結庫

在 23.05 版中，Azure Sphere 具有操作系統內建的密碼編譯連結庫。 透過我們與 wolfSSL 的合作關係，您現在可以在應用程式中呼叫 select wolfCrypt API，讓您執行 ECC 或 xChaCha 加密和解密、憑證產生和管理等作業，而不會產生 RAM 或快閃影響，以便將這些 API 建置到您的應用程式中。 相反地，您將會由 Azure Sphere OS 的內建連結庫提供服務，這些連結庫可透過Microsoft進行修補並保持在最新狀態。 這項新功能是我們產品生命週期的 ABI 兼容性承諾的一部分，您可以在其網站上檢視 wolfSSL 的長期 ABI 承諾，其中也提供如何使用這些 wolfCrypt API 的範例，例如 ECC。

擴充NTP強固性

如果Microsoft NTP 時間伺服器發生中斷，Azure Sphere 裝置現在會嘗試在嘗試多個區域Microsoft端點之後，嘗試後援到 NIST NTP 伺服器，除非自定義 NTP 正與自定義後援組態搭配使用。 這可藉由提供更多選項來同步處理雲端和其他伺服器的通訊，藉此擴充 Azure Sphere 裝置的連線能力強固性。 防火牆後方的 Azure Sphere 裝置系統管理員可以在這裡參考更新的 端點詳細數據。

Windows 上 Azure IoT 的第三方憑證支援 （Beta）

Azure Sphere 的 OS 包含 Azure IoT C SDK。 Windows 上此 OS 的新功能是預覽 API 作為 Beta 程式的一部分，以利用應用程式提供的憑證來連線到 Azure IoT，這些憑證不需要根植於 Azure Sphere 裝置中。 這可讓您使用根目錄到現有系統的憑證，輕鬆連線到 Azure IoT 資源。 這些 Beta API 目前已針對測試進行優化，但會更新以支援大規模生產作業。 如果您有這些 API 的意見反應，包括生產環境需求，請透過 AZSPPGSUP@microsoft.com與我們連絡。 新的 API 是AzureIoT_OverrideAzureSphereAuthCert和AzureIoT_OverrideAzureSphereAuthPrivateKey。

更新 RF 工具 OS 支援並改善工具效能

RF 工具已更新為包含：

  • 支援 Windows 和 Linux x86 平臺，包括多裝置。
  • 透過新的批處理 OS 呼叫，讀取和寫入 bufferbin 和 eFuse 資料的效能改善。
  • Python 連結庫，協助 Python 用戶開發自己的腳本和應用程式。

23.05 SDK 中的新功能和變更功能

Azure Sphere SDK 的 23.05 版包含下列變更：

Linux 多裝置支援

23.05 SDK 新增對Linux中多個並行連線 Azure Sphere 裝置的支援，使這項功能與 Windows 上現有的支援一致。 這與以Linux為基礎的製造案例特別相關。

此外，連接新裝置時不再需要呼叫 azsphere_connect.sh 腳本 - 現在會自動與現有的 Windows 支援同位連線。 請參閱 Linux SDK 安裝的更新檔。

新增Ubuntu 22.04 LTS的SDK支援

23.05 SDK 新增對Ubuntu22.04的支援，並新增至現有的Ubuntu18.04和20.04支援。 Linux SDK 安裝程式可以判斷您正在執行的 LTS 版本 Ubuntu，並下載或安裝適當的 SDK。

Ubuntu 18.04 LTS 的支援終止通知

Ubuntu 18.04 現在已超出 Canonical 的長期標準支援安排。 因此，23.05 SDK 將是支援此 OS 版本的最後一個 Azure Sphere SDK。 未來的 SDK 不支援 Ubuntu 18.04。

適用於 Visual Studio 的 23.05 新功能和已變更的功能，或適用於 Azure Sphere 的 Visual Studio Code 擴充功能

Azure Sphere Visual Studio 和 Visual Studio Code 延伸模組的 23.05 版本包含下列變更：

  • 已改善偵錯即時可用的應用程式和偵錯多個應用程式時的偵錯體驗。
  • 已更新 [新增專案] 範本。

新增工具 GitHub 存放庫

已引進新的 GitHub 存放庫 Azure Sphere 工具。 此存放庫將包含與製造、支援和診斷相關的其他正式支援工具。 製造資料夾已從 Samples 存放庫重新定位，將製造工具放在單一容易尋找的位置，同時減少範例存放庫的使用量。

Azure Sphere 範例、代碼段和資源庫專案的 23.05 版包含下列變更：

Azure Sphere 23.05 版包含已從資源庫畢業的剖析裝置記錄項目，現在已正式支持位於新 Azure Sphere 工具 存放庫中的專案。

23.02 版的新功能

2023年2月21日

Azure Sphere 23.02 版本僅包含 Azure Sphere OS 中的錯誤修正;不包含更新的 SDK。 如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。

修正 23.02 版本中的 Bug 與常見弱點

23.02 版本包含可避免下列常見弱點與漏洞 (CVE) 風險的更新。

  • CVE-2022-37434 zlib
  • CVE-2018-25032 zlib

Azure Sphere 範例、程式碼片段與資源庫專案的 23.02 版本包含下列變更：

單播 DNS 服務探索 資源庫專案 示範如何將 DNS-SD 查詢傳送至設定的 DNS 伺服器來執行 DNS 服務探索。 不同於多點傳送服務探索，此機制不僅可用於在執行階段動態開啟存取裝置防火牆中的本機端點，也可用於遠端端點。

22.11 版的新功能

2022年12月1日

Azure Sphere 22.11 功能版本包含下列元件：

如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。 系統會提示您在下一次使用時安裝更新的 SDK，或者您現在可以加以安裝。 若要安裝最新的 SDK，請參閱 Windows 或 Linux 的安裝快速入門：

此版本中的亮點包括新的 Malloc 版本、升級的 Azure IoT C SDK、DHCP 逾時減少，以及歐洲數據界限 Azure Sphere 支援的公開預覽。

Azure Sphere 安全性服務所使用的新映像簽署密鑰

Azure Sphere 安全性服務現在使用新的映像簽署密鑰。 我們的服務會使用這些金鑰來簽署任何新上傳的應用程式映像和新功能檔案（例如，在裝置上啟用開發模式時）。 22.11 作業系統是使用舊密鑰簽署，但未來的 OS 將會使用新的金鑰簽署。 Azure Sphere 裝置會繼續信任所有現有的密鑰。

針對使用新密鑰接受簽章的 Azure Sphere 裝置，2022 年 11 月 14 日推出受信任的金鑰存放區 （TKS） 更新。 生產裝置不需要用戶動作。 針對 Azure Sphere OS 不是最新狀態的特定製造、開發或現場服務案例，您可能需要採取額外的步驟，以確保裝置信任新簽署的映像 – 如需完整詳細數據，請參閱此 部落格文章 。

22.11 OS 中的新功能和變更功能

Azure Sphere OS 的 22.11 版包含下列變更：

新的 Malloc 版本

Azure Sphere OS 會繼續支持現有的 malloc 模型，而不需要對應用程式進行任何變更，而且對於所有先前建置的應用程式而言都是二進位回溯相容。 不過，新的應用程式指令清單選項可讓開發人員選擇加入 MallocVersion=2，其引進 MUSL v1.2.1+ malloc 模型 mallocng。 此 malloc 版本更有效率且更安全，且可大幅改善記憶體釋放。 根據預設，範例和教學課程已更新為使用此版本，建議您將其新增至任何正在開發的新應用程式。 在某些應用程式案例中，使用這個新的 malloc 版本時，尖峰記憶體使用量應該會較低。

已升級的 Azure IoT C SDK

我們已將 Azure IoT C SDK 更新為最新版本。 此 SDK 包含 Bug 修正和穩定性增強功能，且與舊版相容二進位。 所有現有的應用程式都將受益於 Azure Sphere OS 所管理的幕後改善。

DHCP 逾時減少

DHCP 重試逾時已從 10 秒縮減為 1 秒。 當裝置正在等候 DHCP 租用時，這項降低可改善電池耗用量，這預期會發生於某些網路組態和流量案例中。

22.11 SDK 中的新功能和變更功能

Azure Sphere SDK 的 22.11 版包含下列變更：

支援其他 CLI 命令輸出格式

為了持續努力將 JSON 輸出引入 CLI 命令，讓您更輕鬆地編寫腳本並加以自動化， azsphere image add 和 azsphere device show-os-version 已更新以支援 JSON 輸出。 如需目前支援多個輸出格式的命令清單，請參閱 支援的命令 。

Azure Sphere 範例、代碼段和資源庫專案的 22.11 版包含下列變更：

記錄至 Azure 範例專案

記錄至 Azure 範例專案示範如何使用 IoT 中樞 搭配 Azure 數據總管，以可調整和可查詢的方式擷取應用層級記錄。

PWM 音訊庫專案示範如何使用 MT3620 的硬體 PWM 周邊來產生音調音效，以搭配蜂鳴器或其他音訊產生裝置使用，這是常見的產品使用案例。

公開預覽：適用於歐洲數據界限的 Azure Sphere 支援

為了與 Microsoft 只在歐盟內部處理及儲存歐盟資料的任務保持一致 (請參閱 Microsoft Cloud 的歐盟資料界限 (英文))，Azure Sphere 安全性服務現可讓歐盟客戶視需要在歐盟內部處理及儲存映像檔案和裝置損毀傾印檔案。 新的「區域資料界限」設定是選用參數，可與 azsphere image 和 azsphere device-group 命令搭配使用。

如需詳細資訊，請參閱

我們邀請以歐盟為基礎的客戶試用這項新功能，並透過電子郵件提供任何意見反應給 AZSPPGSUP@microsoft.com。

22.11 版的新和修訂檔

文章 變更
Azure Sphere CLI 支援的輸出格式 已更新支援多個輸出格式的命令清單。

關於 22.10 品質版本

2022年10月25日

22.10 版只包含 Azure Sphere OS 中的錯誤修正;不包含更新的 SDK。 如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。

修正 22.10 版中的 Bug 和常見弱點

這個版本包含一般改善，可能會使某些裝置發生預期的兩次重新啟動。

22.10 版本不包含能減輕任何常見弱點與漏洞 (CVEs) 風險的更新。

22.09 版的新功能

2022 年 9 月 26 日

Azure Sphere 22.09 功能版本包含下列元件：

如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。 系統會提示您在下一次使用時安裝更新的 SDK，或者您現在可以加以安裝。 若要安裝最新的 SDK，請參閱 Windows 或 Linux 的安裝快速入門：

此版本中的亮點包括降低操作系統連線到雲端的冷開機時間，進而降低能源使用：遠端疑難解答和優化製造腳本的最佳做法指引。

22.09 OS 中的新功能和變更功能

Azure Sphere OS 的 22.09 版包含下列變更：

擴充的乙太網路 NIC 支援

Azure Sphere 現在支援 WIZnet W5500 10/100 乙太網路介面適配卡 進行因特網對向連線。 此硬體元件可以提升有線乙太網路應用程式的效能和市場可用性。

復原攻擊的安全性保護

作為針對回復攻擊的深度防禦的一部分，在 22.07 之前的舊版 Azure Sphere OS 復原和復原將會在已更新至 22.09 版本的裝置上無法使用。

裝置更新至 22.09 版本之後，將無法再執行 22.07 之前的 Azure Sphere OS 版本。 這表示在裝置收到 22.09 更新之後，將無法將裝置復原到舊版。 22.07 版本會成為最早可在裝置上安裝的版本。

22.09 SDK 中的新功能和變更功能

Azure Sphere SDK 的 22.09 版包含下列變更：

支援其他 CLI 命令輸出格式

其他 CLI 命令現在支援 JSON 輸出。 此輸出格式可讓您更輕鬆地編寫腳本，並針對 CLI 輸出進行自動化。 如需目前支援多個輸出格式的命令清單，請參閱 支援的命令 。

適用於 Visual Studio 的 22.09 新功能和已變更的功能，或適用於 Azure Sphere 的 Visual Studio Code 擴充功能

Azure Sphere Visual Studio 和 Visual Studio Code 延伸模組的 22.09 版本包含下列變更：

即時可用的應用程式的簡化設定

22.09 Azure Sphere 版本提供更簡單的設定程式，使用 vcpkg 成品來啟動開發環境，以建置即時可用的應用程式。 如需詳細資訊，請參閱 教學課程：建置即時可用的應用程式。

Azure Sphere 22.09 版包含下列範例、代碼段和資源庫項目的變更：

應用程式開發期間的自助疑難解答

get-support-data log 剖析 可讓您在應用程式開發期間進行疑難解答。 在本機連線到裝置時，請使用 azsphere get-support-data 從 Azure Sphere 裝置下載記錄、錯誤和狀態套件。 使用記錄剖析資源庫專案，將二進位記錄數據轉換成人類可讀取的格式，以檢視來自 Azure Sphere OS 的系統記錄事件。

製造工具 v1.0.0 版

我們已發佈 更新的製造工具。 這些工具可讓客戶以 Python PyPy 和 C# NuGet 套件的形式，將通常透過 CLI 存取的裝置 REST API 命令整合到其製造應用程式中。 也會提供 YAML OpenAPI 定義，讓客戶能夠透過 AutoRest 之類的工具，以自己選擇的語言產生自己的用戶端連結庫。

由於這些工具直接與已連結 Azure Sphere 裝置的 REST API 通訊，相較於針對 azsphere CLI 的腳本，許多命令可看到高達 5 倍的速度。

Azure Sphere 松鼠資源庫專案示範在 MT3620 晶片上執行較高層級的腳本語言。

22.09 版本中的新和修訂檔

文章 變更
支援的乙太網路卡和開發面板 主題已更新為WIZnet W5500型乙太網路控制器的支援。
教學課程：建置即時可用的應用程式 已更新為記錄 vcpkg 成品的選項，以自動安裝和設定 GNU Arm Embedded Toolchain。
遠端疑難解答的最佳做法 包含問題清單和流程圖的新主題，可協助您分級裝置問題。
Azure Sphere CLI 支援的輸出格式 已更新支援多個輸出格式的命令清單。

22.09 版的已知問題

使用 W5500 連線到有線網路時，如果網路纜線未連接，則 CLI 和內部 API 可能仍會回報為「啟動」介面。 這會在未來的OS版本中修正。

已修正 22.09 版本中的 Bug 和常見弱點

22.09 版本包含下列更新，可降低下列常見弱點和暴露程度（CVE）：

  • wolfSSL CVE-2022-34293

22.07 版的新功能

2022年7月26日

Azure Sphere 22.07 版本包含下列元件：

如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。 若要安裝最新的 SDK，請參閱 Windows 或 Linux 的安裝快速入門：

此版本中的亮點包括操作系統連線到雲端的時間減少，進而降低能源使用量、發佈生產就緒應用程式的最佳做法指引，以及發佈優化的製造腳本。

22.07 OS 中的新功能和變更功能

Azure Sphere OS 的 22.07 版包含：

  • OS 現在支援在永續性記憶體中快取 DAA（客戶）憑證。 這會導致冷開機時的能耗降低，並在冷開機或關閉電源后連線到雲端的時間減少。
  • OS 在 Applibs applications.h 中具有新的 API 函式Applications_GetOSVersion()，其會傳回包含目前 OS 版本的可列印字串。

22.07 SDK 中的新功能和變更功能

Azure Sphere SDK 的 22.07 版本包含下列變更。

支援單色 CLI 輸出

基於輔助功能考慮，Azure Sphere CLI 現在支援 單色輸出 。 您可以使用此命令來管理 Azure Sphere CLI 中訊息的色彩設定。 如果您開啟 no-color 參數，則會移除彩色訊息，且原始色彩的訊息前面會加上 DEBUG、 INFO、 WARNING或 ERROR。

從 ADAL 移轉至 MSAL 的 Azure Sphere 傳統 CLI 驗證

Azure Sphere 傳統 CLI 現在使用Microsoft驗證連結庫 （MSAL），而不是即將淘汰的 Active Directory 驗證連結庫 （ADAL）。 由於移轉至 MSAL，Azure Sphere 傳統 CLI 的使用方式沒有任何變更，而且不需要客戶動作。

支援其他輸出格式

下列 Azure Sphere CLI 命令現在支援 --output 或 -o 參數，以指定 CLI 輸出的格式。 如需目前支援多個輸出格式的命令清單，請參閱 支援的命令 。

22.07 Visual Studio 和 Visual Studio Code 擴充功能中的新增和變更功能

Visual Studio 和 Visual Studio Code 現在都支援 CMakePresets 。 CMakePresets.json檔案可讓您指定常見的設定、建置和測試選項，然後使用其他開發環境與開發人員共用。

22.07 版本包含下列範例、代碼段和資源庫項目的變更。

針對 Azure IoT 使用非封鎖 API 的範例更新

已更新 Azure IoT 和 ExternalMcuLowPower 範例，以避免使用 Azure IoT 的封鎖 API，而是改用非封鎖 API。 如果您的應用程式程式代碼使用 IoTHubDeviceClient_LL_CreateWithAzureSphereDeviceAuthProvisioning 建議您查看更新的範例，並考慮非封鎖 API 模式是否更符合您的需求。

製造範例

我們已發佈更新 的製造範例。 先前，製造範例會私下散發，但從此版本開始，範例將會保留在 GitHub 上。 為此，我們已發佈裝置 REST API（讓略過 CLI 直接與裝置的 REST API 通訊），以及 C# 和 Python 支援、範例應用程式和測試。 製造腳本會移植到使用這些 REST API。 這種直接使用裝置 REST API 可提升製造速度。 如需詳細資訊，請參閱 連線裝置的製造指南。

FTDI 介面指引和硬體設計的更新

我們已對 MT3620 硬體指導方針進行一些小幅變更，這些指導方針與 FTDI 程式設計與偵錯介面如何處理低功率模式的喚醒有關。 這可改善與 Avnet MT3620 V2 模組的相容性。 MT3620 程式設計和偵錯介面中已更新一些電壓值。 低功率 MCU 到雲端範例已更新以反映本指南，我們已針對低功率 MCU 發行新的硬體範例，以將低功率 MCU 發行至雲端硬體 v2.0 和 FTDI 介面板 v2.0，以反映此更新的指導方針。 FTDI 介面板 v2.0 更新也會為服務/偵錯、復原和 SWD 連接器新增雙重使用量。

Applications_GetOSVersion API 的新代碼段

新的 取得 Azure Sphere 裝置 OS 版本 示範如何在高階應用程式中取得 Azure Sphere 裝置 OS 版本。

22.07 版中的新增和修訂檔

文章 變更
使用 CMake 設定組建 已更新主題，以包含使用 Visual Studio 和 Visual Studio Code 設定CMakePresets.json的相關信息。
建置即時可用的應用程式 已更新主題以描述新的 CMake 組態和建置命令。
開發生產就緒應用程式的建議 提供最佳做法的新主題，可確認您的高階或即時 Azure Sphere 應用程式已準備好進行試驗或生產部署。
azsphere setting 提供命令詳細數據 azure setting 的新主題。
Azure Sphere CLI 支援的輸出格式 已更新支援多個輸出格式的命令清單。
Applications_GetOsVersion 函式 已新增新 API 函式的主題。
製造指南 已更新以反映 GitHub 上發佈的新製造範例。

22.07 版的已知問題

如果Wi-Fi網路介面已停用，然後重新啟動裝置，則當您執行 azsphere device network list-interfaces CLI 命令或使用 API 時 Networking_GetHardwareAddress ，會顯示介面硬體位址 （MAC 位址） 的任意值。 若要解決此問題，請重新啟用Wi-Fi介面，然後重新執行CLI命令或API，以接收正確的硬體位址。

已修正 22.07 版本中的 Bug 和常見弱點

  • 命令 azsphere tenant create 現在可在本機連結的 Azure Sphere 裝置可用時運作。 在 21.10 和更新版本中， 即使裝置已連線，也會回報錯誤。 修正程式現在會在建立租用戶時自動識別連結的裝置。

  • 22.07 版本包含下列更新，可降低下列常見弱點和暴露程度 （CVE）：

    • cURL CVE-2022-22576
    • cURL CVE-2022-27775
    • cURL CVE-2022-27778
    • cURL CVE-2022-27779
    • cURL CVE-2022-27780
    • cURL CVE-2022-27782
    • cURL CVE-2022-30115
    • CVE-2022-35821

關於 22.04 品質版本

2022年4月11日

22.04 版本包含升級至 Linux 核心 （5.10.103） 和 Azure Sphere OS 中的錯誤修正：不包含更新的 SDK。 如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。

已修正 22.04 版本中的 Bug 和常見弱點

22.04 版本包含更新，可因下列常見弱點和暴露而降低風險：

  • wolfSSL CVE-2022-25638
  • wolfSSL CVE-2022-25640
  • C-Ares CVE-2021-3672
  • Linux CVE-2022-0847 （“肮髒管道”）

新的資源庫專案 AzureFunctionApp_AzureSpherePublicAPI 示範如何在 Python Azure 函式應用程式中使用 Azure Sphere 公用 API。

22.04 版的新和修訂檔

文章 變更
停止 Azure Sphere 裝置通訊服務 已新增與安裝期間掛接安裝程式相關的疑難解答區段。
透過 Proxy 伺服器連線 Azure Sphere 已新增使用 MQTT 連線至 Azure IoT 中樞 的應用程式指令清單需求和資訊。
設定 Azure Sphere 的 Azure IoT 中樞 已更新，讓用戶體驗清楚且正確。
使用裝置布建服務設定 Azure Sphere 的 Azure IoT 中樞 已更新，讓用戶體驗清楚且正確。
設定適用於 Azure Sphere 的 Azure IoT Edge 已更新以釐清文字並符合 Azure UI。
設定要與 Azure Sphere 搭配使用的 Azure IoT Central 已更新，讓用戶體驗清楚且正確。
Azure Sphere OS 摘要
- 設定裝置以進行OS評估		 更新以釐清 Azure Sphere OS 在零售評估摘要中的部署方式。
製造指南 更新以釐清裝置製造程式所涉及的內容。
製造程序準備 新主題，提供有關執行處理站工作和雲端設定工作之前應該完成之工作的詳細數據。
處理月臺工作 為了清楚起見，已更新。 將準備工作移至新的 製造準備 主題。
雲端設定工作 為了清楚起見，已更新。 將準備工作移至新的 製造準備 主題。
RF 工具 已新增 RF 工具使用方式完成後的新區段，以描述使用 RF 工具完成之後要完成的工作。

關於 22.02 Update 1 版本

2022 年 3 月 17 日

Azure Sphere 22.02 Update 1 版本包含下列元件：

  • 適用於 Windows 及 Linux 的 Azure Sphere SDK 更新
  • 適用於 Visual Studio Code 的 Azure Sphere 延伸模組預覽更新版本

它不包含更新的 OS 或更新的 Visual Studio 擴充功能。

22.02 Update 1 SDK 中的更新

更新的 SDK 解決了與影響 API 集合 12 之 sys/socket.h 標頭 musl 64 位時間支援相關的技術社群 IoT 部落格上宣布的問題。 如果您已安裝 SDK 的原始 22.02 版，請安裝更新的版本。

提示

您可以使用 Azure Sphere CLI 命令 azsphere show-version 來判斷您擁有的 SDK 版本。 原始 22.02 SDK 的完整版本號碼為 22.02.3.34006;22.02 Update 1 SDK 的完整版本號碼為 22.02.3.41775。 請注意，Azure Sphere 傳統 CLI 只會以 22.02 格式顯示版本。

若要安裝最新的 SDK，請參閱 Windows 或 Linux 的安裝快速入門：

22.02 Update 1 Visual Studio Code 延伸模組中的更新

在 Linux 上，適用於 Azure Sphere 的 Visual Studio Code 擴充功能中的租使用者總管先前顯示錯誤。 更新的延伸模組會正確顯示結果。

22.02 Update 1 組建環境容器中的更新

Azure Sphere 組建環境容器已更新為 22.02 Update 1 SDK。

22.02 功能版本中的新功能

Azure Sphere 22.02 功能版本包含下列元件：

  • Azure Sphere OS 更新
  • 適用於 Windows 及 Linux 的 Azure Sphere SDK 更新
  • 適用於 Visual Studio 及 Visual Studio Code 的 Azure Sphere 延伸模組更新

如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。 若要安裝最新的 SDK，請參閱 Windows 或 Linux 的安裝快速入門：

另外還有更新 的範例、代碼段、資源庫專案，以及 檔更新。

重要

2022 年 3 月 8 日

22.02 SDK 的問題與 API 集合 12 中包含的 sys/socket.h 標頭和 musl 64 位時間支持 有關。 此問題將在即將更新的 SDK 中解決。 不需要進行OS變更，才能解決此問題。 不過，目前，如果您使用 sys/socket.h 中定義的 setsockopt（） 函式，就不應該使用 API 集合 12 來建置生產應用程式。 我們建議搭配 22.02 版本使用 API 集合 11。

這隻會影響以 22.02 版本建置的新編譯應用程式。 它 不會影響 ：

  • 現有的已編譯二進位檔或已部署的應用程式。
  • 使用最近 22.02 版以外的 SDK 所建置的應用程式。
  • 使用 22.02 SDK 建置的應用程式，但 使用 12 版以外的 API 集合。

22.02 OS 中的新功能和變更功能

Azure Sphere OS 的 22.02 版包含 Linux 核心 （5.10.70） 的升級，以及 DHCP 版本和更新的支援。

DHCP 版本和更新

Azure Sphere OS 現在支援透過新的 API 發行和更新 DHCP，讓高階應用程式可以控制其裝置 IP 租用。

新的 DHCP 範例 示範如何使用這些新的 API。

22.02 SDK 中的新功能和變更功能

Azure Sphere SDK 的 22.02 版包含對 Windows 11 的支援、64 位時間支援的更新、CLI 的默認記錄行為變更，以及 CLI 的驗證連結庫更新。

Windows 11 的支援

Azure Sphere 開發現在支援 Windows 11。 如果您使用 Windows 11， 請安裝 22.02（或更新版本）SDK。

64 位時間支援

22.02 SDK 版本更新支援高階應用程式的64位時間。 這會修正在 20.10 版本中支援 64 位時間所導入的非預期行為。

對值大小 time_t 沒有任何假設的應用程式程式代碼不會受到影響。 不過，明確或隱含預期 time_t 為32位的應用程式程式代碼必須改寫才能 time32_t 改用。

提示

為了確保應用程式在重建之後繼續如預期般運作，請檢查應用程式中的堆疊和堆積使用量，以及二進位大小。 它們可能會成長，因為 time_t 現在是8個字節，而不是4個字節。

如需詳細資訊，請參閱基底 API 主題的 C 類型time_t一節。

設定 Azure Sphere CLI 記錄

根據預設，Azure Sphere CLI 不會再將記錄檔寫入本機磁碟。 如需如何啟用和設定記錄的詳細資訊，請參閱 管理記錄檔 。

從 ADAL 移轉至 MSAL 的 Azure Sphere CLI 驗證

Azure Sphere CLI 現在使用Microsoft驗證連結庫 （MSAL），而不是即將淘汰的 Active Directory 驗證連結庫 （ADAL）。 由於移轉至 MSAL，Azure Sphere CLI 的使用方式沒有任何變更，而且不需要客戶採取任何動作。

Azure Sphere 傳統 CLI 仍會使用 ADAL，但在 2022 年 6 月 30 日 ADAL 淘汰日期之前更新。 我們繼續建議您 移轉至新的 Azure Sphere CLI。

22.02 for Visual Studio 中的新功能和已變更功能，或適用於 Azure Sphere 的 Visual Studio Code 擴充功能

除了 Visual Studio 2019 的現有擴充功能之外，現在還有適用於 Visual Studio 2022 的 Azure Sphere 擴充功能。 Visual Studio 2019 的最低支援版本現在是 16.11。

適用於 Azure Sphere 的 Visual Studio 和 Visual Studio Code 擴充功能現在提供這些功能：

  • 在 Azure Sphere Explorer 中設定 Wi-Fi。
  • 在 Azure Sphere Explorer 中檢視部署歷程記錄。
  • 在偵錯時，在Visual StudioCode中開啟反組譯碼檢視。

在 Azure Sphere Explorer 中設定 Wi-Fi

您現在可以 新增Wi-Fi網路、連線到它們、啟用或停用它們，並從 Azure Sphere Explorer 的圖形化介面中忘記它們。

檢視部署歷程記錄

您現在可以 使用 Azure Sphere Explorer 檢視指定裝置群組的所有部署 ，包括每個部署的日期和元件識別碼。

偵錯時開啟反組譯碼檢視

反組譯碼檢視提供原生程式代碼的低階檢視，並增強一般逐步調試程式。 Visual Studio Code 延伸模組中的這項變更現在提供與 Visual Studio 相同的反組譯程序體驗。

22.02 版的新和修訂檔

文章 變更
快速入門：設定網路功能並更新裝置OS 包含使用 Azure Sphere Explorer 設定 Wi-Fi 的指示。
在 Azure Sphere Explorer 中檢視裝置和租用戶資訊 已更新以包含新功能。
使用 GitHub Codespaces 建置和偵錯 使用 Visual Studio Code 開發使用 GitHub Codespaces 應用程式的新主題。
高階應用程式中的記憶體使用 已更新，以在命令提示字元中包含建立和執行記憶體監視批次腳本的指示。
偵錯高階應用程式 更新為包含開啟反組譯碼檢視的指示。
對即時可用的應用程式進行偵錯 更新為包含開啟反組譯碼檢視的指示。
偵錯合作夥伴應用程式 更新為包含開啟反組譯碼檢視的指示。
使用 CMake 設定組建 更新以描述具有多個根目錄之專案所需的新CMakeWorkspaceSettings.json檔案。
裝置身分識別和安全性 關於使用裝置標識碼的安全性考慮和建議最佳做法的新主題。
檢視部署歷程記錄 已更新為包含在 Azure Sphere Explorer 中檢視部署歷程記錄的指示。
管理記錄檔 使用 CLI 設定記錄的新主題。

已修正 22.02 版本中的錯誤

22.02 版包含下列錯誤修正：

  • WifiConfig_GetNetworkDiagnostics嘗試具有無效認證的WiFi連線之後傳回非預期的值。 修正程式會傳回正確的錯誤訊息。
  • 如果指定自定義 NTP 伺服器，NTP timesync 可能會變慢且不穩定。 修正會將自定義伺服器的 timesync 程式正規化。
  • 發生驅動程式錯誤時，使用乙太網路的裝置偶爾無法重新建立網路連線能力。 修正乙太網路網路介面驅動程式時，在這些情況下會更一致地重新建立網路連線。

22.02 版的已知問題

如果使用者未通過驗證，就會在 Azure Sphere CLI 中顯示錯誤訊息 No section: 'sphere' 。 若要解決此問題，請使用 azsphere login 命令向 Azure Sphere CLI 進行驗證。

關於 22.01 品質版本

Azure Sphere 未發行更新的 OS 或 SDK for 22.01。 如需詳細資訊，請參閱有關 22.01 版本取消的部落格文章。

22.01 的更新包括資源庫中的兩個新專案，以及檔更新。

注意

在上一個版本中，我們通知您，從 2022 年 4 月開始，會從 SDK 中移除 Azure Sphere 傳統 CLI。 其淘汰時程表已經延長。 我們打算在未來的日期淘汰傳統 CLI，但不是在 2022 年底之前。 我們仍建議您將 程式和腳本 移轉至 CLIv2。

OpenSourceProjectsSupportingExternalPeripherals 是開放原始碼項目清單，可搭配 Azure Sphere 和 MT3620 晶片使用外部硬體。

ToggleClassicCLI 提供適用於 Windows 和 Linux 的腳本，可讓您測試移除 Azure Sphere 傳統 CLI（然後加以還原）。 Azure Sphere 傳統 CLI 已由 CLIv2 取代，並將在未來日期從 Azure Sphere SDK 中移除。 這些腳本有助於識別您在傳統 CLI 上可能擁有的相依性。

22.01 版的新和修訂檔

文章 變更
針對 Azure Sphere 問題進行疑難解答 已新增錯誤訊息「無法停止 Azure Sphere 裝置通訊服務」的疑難解答步驟。
使用服務標籤來限制對 Azure Sphere 安全性服務的存取 如何使用 AzureSphere 服務標籤來允許或拒絕 Azure Sphere 安全性服務流量的新主題。
裝置功能和服務會話 新增了裝置取得功能的方式，以及您可以使用 fieldServicing 功能執行哪些動作的釐清。
Azure Sphere CVE 已新增有關我們參與 CVE 計劃 以及 Azure Sphere CVE 對客戶影響的釐清。
守護者模組 已更新連結、釐清整個主題的資訊，以及重新整理的章節。

關於 21.11 品質版本

Azure Sphere 未發行更新的 OS 或 SDK for 21.11。

21.11 的更新包括下列文件變更和其他次要編輯：

文章 變更
裝置功能和服務會話 釐清和修正何時需要功能，以及其允許的動作。
設定適用於 Azure Sphere 的 Azure IoT Edge 已更新為包含使用IoT Edge 1.2和IoT Edge 1.1的指示。
Azure Sphere CVE 已新增已發佈 Azure Sphere 常見弱點和暴露內容和時間的相關信息（CVE）。
處理月臺工作 已新增製造狀態和裝置功能的相關信息。
裝置 關於裝置功能的釐清和修正。
Azure Sphere CLI 概觀 關於裝置功能的釐清和修正。

21.10 功能版本中的新功能

Azure Sphere 21.10 功能版本包含下列元件：

  • Azure Sphere OS 更新
  • 適用於 Windows 及 Linux 的 Azure Sphere SDK 更新
  • 適用於 Visual Studio 及 Visual Studio Code 的 Azure Sphere 延伸模組更新

如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。 若要安裝 Visual Studio 和 Visual Studio Code 的最新 SDK 和擴充功能，請參閱 Windows 或 Linux 的安裝快速入門：

重要

從 2022 年 4 月開始，SDK 版本將不會包含 Azure Sphere 傳統 CLI。 傳統 CLI 於 2021 年 2 月標示為已淘汰。 如果您仍然相依於傳統 CLI，您必須 在 2022 年 4 月之前移轉程式和腳本 ，以避免中斷。

21.10 版本中的新功能和變更功能

21.10 版包含：

Web Proxy 支援

Azure Sphere 裝置現在可以透過 Proxy 伺服器連線到網路。 您可以使用 applibs 命令或 CLI 來設定 Proxy。 如需詳細資訊，請參閱 透過 Proxy 伺服器連接 Azure Sphere。

如需可用 CLI 命令的詳細資訊，請參閱 網路 Proxy。

wolfSSL 已更新為 4.8.1 版

Azure Sphere OS 現在包含 wolfSSL 4.8.1。 此更新提供 wolfSSL 的最新安全性修正和效能增強功能。 此外，新的 ABI 會透過 OS 公開，以防止某些 TLS 組態中的中間人攻擊。 在應用程式中使用 wolfSSL 時（如 wolfSSL 範例所示），建議您在適用時使用 wolfSSL_CTX_set_verify 來驗證主機。

請參閱在 wolfSSL 網站上使用 wolfSSL_CTX_set_verify 的詳細資訊。

在 Azure IoT 中樞 上自動驗證租使用者 CA 憑證

我們已更新如何使用 Azure Sphere 租使用者憑證設定 Azure IoT 中樞 和 DPS 的指導方針，以包含不需要擁有證明驗證步驟的簡化程式。 如需詳細資訊，請參閱設定 Azure Sphere 的 Azure IoT 中樞，以及使用裝置布建服務設定 Azure Sphere 的 Azure IoT 中樞。

支援租使用者重新命名

azsphere tenant update Azure Sphere CLI 命令可讓您重新命名現有的租使用者。 如需詳細資訊，請參閱租使用者 命令 參考主題。

指定Wi-Fi命令的輸出格式

azsphere device wifi命令現在支援 --output 或 -o 參數，以指定 CLI 輸出的格式。 如需詳細資訊，請參閱 支援的輸出格式。

在不需要Wi-Fi的情況下使用MT3620

我們已針對Wi-Fi暫時或永久不需要的案例，提供更新的軟體和硬體指引，示範如何在這類案例中降低耗電量並簡化硬體設計。 如需詳細資訊，請參閱 Wi-Fi連線 和 MT3620硬體附註 。

下列 Azure Sphere 範例 已針對 21.10 更新：

  • 已將額外的自述檔新增至 AzureIoT 範例 ，以示範如何新增 Web Proxy 支援。
  • HTTPS/cURL 範例已更新，以示範如何新增 Proxy 支援。

Azure Sphere 資源庫中的下列專案已針對 21.10 新增或更新：

  • Azure IoT 存放區和轉寄 會示範如何將遙測存放區和轉送功能新增至 AzureIoT 範例。
  • CO2_MonitorHealthySpaces示範如何整合 CO2 監視器與 IoT Central。
  • EAP-TLS_Solution 示範如何將 Azure Sphere 裝置連線到 EAP-TLS 網路。
  • SimpleFileSystem_RemoteDisk示範如何將文件系統支援新增至 Azure Sphere 專案。

21.10 版的新和修訂檔

文章 變更
透過 Proxy 伺服器連線 Azure Sphere 描述如何設定 Azure Sphere 裝置以透過 Proxy 伺服器連線到因特網的新主題。
設定 Azure Sphere 的 Azure IoT 中樞 已更新主題，以包含 Azure IoT 中樞 上租使用者 CA 憑證的自動和手動驗證資訊。
使用裝置布建服務設定 Azure Sphere 的 Azure IoT 中樞 已更新主題，以包含裝置布建服務上租使用者 CA 憑證的自動和手動驗證資訊。
更新現有的租使用者 已新增重新命名現有租用戶的相關信息。
MT3620 硬體注意事項 已更新以包含在特定案例中停用Wi-Fi的相關信息。
裝置 - 已新增 azsphere device network proxy 命令的資訊。
- 已更新命令的範例 azsphere device wifi 。
租使用者更新 已新增 azure sphere tenant update 命令的資訊。
Applibs 網路參考 已新增 Proxy 用戶端支援 API。

21.10 版的已知問題

使用 堆積記憶體配置追蹤 的 21.10 SDK 所建置的任何應用程式將無法建置，並出現下列錯誤：

azsphere_target_add_image_package收到未預期的要求來設定DEBUG_LIB：在選取的目標 API 集合中無法使用的 libmalloc。 請在CMakeLists.txt中選取第10版或更新版本。

若要修正錯誤，您需要對其中一個 SDK CMake 檔案進行小變更。 您必須是系統管理員，才能變更此檔案。

  • 在 Windows 上：C：\Program Files （x86）\Microsoft Azure Sphere SDK\CMakeFiles\AzureSphereToolchainBase.cmake
  • 在 Linux 上：/opt/azurespheresdk/CMakeFiles/AzureSphereToolchainBase.cmake

將 AzureSphereToolchainBase.cmake 行 13 修改為下列專案：

set(libmalloc_10_or_later "10" "11" )

下一版的 Azure Sphere SDK 中將會修正此問題。

  • 當您使用 azsphere tenant create 命令建立租使用者時，會報告錯誤。 這是因為未自動識別連結的 Azure Sphere 裝置。 若要修正此問題，您可以在執行 命令時提供裝置。 例如： azsphere tenant create --device <device-ID> --name <tenant-name> 。 未來的版本將會提供修正程式。

已修正 21.10 版本中的 Bug 和常見弱點

21.10 版本包含可減輕下列 CVE 的更新：

  • cURL CVE-2021-22922
  • cURL CVE-2021-22923
  • cURL CVE-2021-22925
  • cURL CVE-2021-22926
  • cURL CVE-2021-22946
  • cURL CVE-2021-22947
  • CVE-2021-41374
  • CVE-2021-41375
  • CVE-2021-42300
  • CVE-2021-41376

關於 21.09 品質版本

21.09 版本包含 Azure Sphere OS 的更新;不包含更新的 SDK。 如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。

Azure Sphere OS 的更新包括：

  • 已將Linux核心升級為5.10.60。
  • 防止停止響應的當機處理改善。
  • RS-485 實時驅動程序 示範如何在 MT3620 上使用 M4F 核心，以實作可靠的 RS-485 通訊與 A7 核心上的高階應用程式之間的通訊。

21.09 版的新和修訂檔

文章 變更
針對雲端和部署問題進行疑難解答 已新增與宣告裝置相關的疑難解答資訊。

關於 21.08 品質版本

21.08 版本包含 Azure Sphere OS 中的下列增強功能和錯誤修正：不包含更新的 SDK。

  • 安全性更新
  • 改善乙太網路支持的穩定性
  • 改善 I2C 裝置的穩定性

如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。

另外還有 新的 Azure Sphere 資源庫範例 和 檔更新。

已修正 21.08 版本中的 Bug 和常見弱點

21.08 版本包含更新，以減輕下列常見弱點和暴露情況（CVE）：

  • CVE-2021-22924
  • CVE-2021-36956

下列新的或更新的範例已新增至 Azure Sphere 資源庫、未對應的腳本、公用程式和函式的集合：

21.08 版的新和修訂檔

文章 變更
azsphere device 已針對 和--interface-name淘汰而更新的--cert-id參考主題。
Azure Sphere CLI 中的重要變更（淘汰功能） 描述已淘汰或即將從 Azure Sphere CLI 中移除之功能、命令或參數的新主題。

21.07 功能版本中的新功能

Azure Sphere 21.07 功能版本包含下列元件：

  • Azure Sphere OS 更新

  • 適用於 Windows 及 Linux 的 Azure Sphere SDK 更新

  • 適用於 Visual Studio 及 Visual Studio Code 的 Azure Sphere 延伸模組更新

還有更新 的範例、教學課程、資源庫專案和 檔更新。

如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。 系統會提示您在下一次使用時安裝更新的 SDK，或者您現在可以加以安裝。 若要安裝最新的 SDK，請參閱 Windows 或 Linux 的安裝快速入門：

重要

2021年9月30日

21.07 SDK for Windows 的 Update 2 現已推出。 此更新會修正安裝程序錯誤，以防止在升級至 Windows 11 之後卸載 Azure Sphere SDK。

2021年7月28日

21.07 SDK 的 Update 1 現已推出。 如果您已安裝舊版的 21.07 SDK，您可以重新安裝以取得更新的版本。 21.07 SDK 版本錯誤地從 Azure Sphere CLI 移除了一些已淘汰的參數。 21.07 Update 1 SDK 會針對回溯相容性目的，將這些已淘汰的參數恢復至 CLI。 如需詳細資訊，請參閱 Azure Sphere CLI 中的重要變更（淘汰功能）。

21.07 版中的新功能和已變更功能

21.07 版本包括改善時間同步處理的方式、在開發期間追蹤共用連結庫堆積記憶體使用量的能力，以及使用 Azure Active Directory 進行驗證的新方式。 此版本也包含 Visual Studio 和 Visual Studio Code 擴充功能中的一些偵錯改進、在 CLI 中擴充參數的支援--output，以及從 CLI 和公用 API （PAPI） 中的某些命令取得其他裝置資訊的能力。

時間同步變更

當主要時間伺服器失敗或無法連線時，21.07 版本中的時間同步處理程式已變更，以提供更健全的程式。 先前，如果時間同步重試導致時間同步無法完成，則相依於時間同步處理的服務可能無法啟動。 變更會新增後援機制，以取得精確的時間，讓時間同步重試不會無限期地繼續。

堆積記憶體配置追蹤

堆積記憶體配置追蹤功能可讓開發人員在開發應用程式期間，以方便的方式查看 Azure Sphere SDK 隨附連結庫的記憶體配置。 此功能新增了新的應用程式功能 HeapMemStats，以及新的 Azure Sphere SDK 連結庫 libmalloc。 此功能也包含 Azure Sphere CLI 命令 azsphere device app show-memory-stats 和 Visual Studio 擴充功能的變更。 透過這些變更，開發人員可以將 HeapMemStats 功能新增至其高階應用程式、將應用程式部署至已啟用開發功能的裝置，並使用 Visual Studio 的效能分析工具來檢視其應用程式所呼叫之 SDK 連結庫所使用的記憶體。

使用 Azure Active Directory 的驗證方法

Azure Sphere 公用 API （PAPI） 支援 Azure Active Directory （AAD） 中的多個使用者驗證和授權方法。

透過 Azure Active Directory， 應用程式令牌 可用來使用 服務主體或受控識別方法來驗證及授與使用者應用程式、服務或自動化工具對特定 Azure 資源的存取權。

現在使用 Azure Active Directory 支援下列驗證方法：

CLI 和 PAPI 命令的其他更新狀態詳細數據

Azure Sphere 公用 API 已擴充，以包含作業系統和更新狀態的其他裝置詳細數據。 您現在可以查看安裝在裝置上的系統操作系統版本、最新的可用OS版本、裝置上次更新的時間，以及上次檢查更新的裝置時間。 其他資訊有助於管理裝置的更新。

下列 Azure Sphere API 參考頁面會更詳細地說明 API 回應變更：

Command 描述
裝置 - 取得 取得裝置的詳細數據。
裝置 - 清單 取得宣告給指定租使用者的所有裝置。
裝置 - 群組中的清單 取得指派給指定裝置群組的所有裝置。
裝置 - 產品中的清單 取得屬於指定產品的所有裝置。

此外，Azure Sphere CLI 已更新為使用--query 參數或支援的輸出格式，在 、 azsphere device show和 azsphere device update 命令中包含azsphere device list這些額外的裝置詳細數據。 例如： azsphere device show --output json 。

適用於 Azure Sphere 的 Visual Studio 或 Visual Studio Code 擴充功能中的新增和變更功能

Visual Studio 和 Visual Studio Code 延伸模組包含偵錯目標的描述性名稱。 Visual Studio 延伸模組也包含堆積記憶體配置追蹤的支援。

偵錯目標的描述性名稱

Visual Studio 延伸模組現在會針對偵錯目標名稱使用項目名稱。 Visual Studio Code 延伸模組會顯示項目名稱，但可簡化描述性文字。

支援其他輸出格式

其他 Azure Sphere CLI 命令現在支援 --output 或 -o 參數，以指定 CLI 輸出的格式。 如需詳細資訊，請參閱 支援的命令。

新增和更新的命令和參數

命令的更新：

Command 描述
azsphere device network enable 在連接的裝置上啟用網路介面。
azsphere device network disable 停用連結裝置上的網路介面。

參數的更新：

參數 描述
azsphere device network show-diagnostics 參數 --id 會變更為 --network。
azsphere device network update-interface 參數 --interface-name 會變更為 --interface。
azsphere device certificate delete 參數 --cert-id 會變更為 --certificate。
azsphere device certificate show 參數 --cert-id 會變更為 --certificate。
azsphere tenant create 參數 --force 會變更為 --force-additional。
azsphere tenant create 參數 --disable-confirm-prompt 是新的;它會停用使用者確認提示。

注意

21.07 SDK 版本完全從 Azure Sphere CLI 移除此處所述的已淘汰參數。 21.07 Update 1 SDK 會針對回溯相容性目的，將這些已淘汰的參數恢復至 CLI。 如需詳細資訊，請參閱 Azure Sphere CLI 中的重要變更（淘汰功能）。

21.07 版中的新增和修訂檔

文章 變更
高階應用程式中的記憶體使用 已更新的主題，以包含堆積記憶體配置追蹤的討論。
在遠端主機上搭配安全殼層使用 Visual Studio Code （SSH） 描述如何透過安全殼層在遠端主機上建置和偵錯 Azure Sphere 應用程式的新主題。
使用 Azure Active Directory 的驗證方法 提供所支持驗證方法概觀的新主題。
使用 AAD 受控識別存取 Azure Sphere 公用 API 提供使用 AAD 受控識別存取 Azure Sphere 公用 API 的概觀和步驟的新主題。
使用 AAD 應用程式服務主體存取 Azure Sphere 公用 API 提供使用 AAD 服務主體存取 Azure Sphere 公用 API 的概觀和步驟的新主題。
使用您的 AAD 使用者身分識別存取 Azure Sphere 公用 API 提供使用 AAD 使用者身分識別存取 Azure Sphere 公用 API 的概觀和步驟的新主題。
支援的命令 已更新支援輸出格式的命令清單。
裝置 命令和參數描述和範例的更新。
tenant 參數描述和範例的更新。
角色 已更新的主題，因為參數的值 --role 不區分大小寫。

21.07 版包含已更新的記憶體使用量教學課程、Azure IoT 範例的更新，以及 Azure Sphere 資源庫中的三個新或更新專案。

已更新記憶體使用量教學課程

MemoryUsage 教學 課程 已更新，以示範 堆積記憶體配置追蹤。

已更新 Azure IoT 範例

我們已對 Azure IoT 範例進行一些次要調整，包括遵循此 IoT 中樞 用戶端最佳做法，將輪詢率IoTHubDeviceClient_LL_DoWork變更為每 100 毫秒，而不是每 1 次。 建議您在現有的應用程式中採用這項變更。

下列新的或更新的範例已新增至 Azure Sphere 資源庫、未對應的腳本、公用程式和函式的集合：

21.07 版的已知問題

新的更新狀態欄位不會以預設 CLI 輸出格式顯示

azsphere device list、 azsphere device show和 azsphere device update CLI 命令只會在使用 JSON 或其他支援的輸出格式時公開四個新的更新相關欄位;使用預設資料表格式時不會顯示新的欄位。 您可以使用 --query 自變數 來指定資料表輸出的其他欄位，但如果數據表太寬，裝置識別碼可能會截斷。 建議您減少數據表中的數據行數目，讓裝置標識碼不會遭到截斷。 例如： azsphere device show --query '{DeviceId:deviceId, LastAvailableOSVersion:lastAvailableOSVersion, LastInstalledOSVersion:lastInstalledOSVersion, LastOSUpdateUTC:lastOSUpdateUTC, LastUpdateRequestUTC:lastUpdateRequestUTC}' 。

已修正 21.07 版本中的 Bug 和常見弱點

21.07 版包含更新，可降低下列常見弱點和暴露程度（CVE）：

  • CVE-2021-26428

  • CVE-2021-26429

  • CVE-2021-26430

關於 21.06 品質版本

21.06 版本包含 Azure Sphere OS 中的錯誤修正;不包含更新的 SDK。 如果您的裝置已連線至網際網路，則裝置將會從雲端接收 OS 更新。

21.06 版的新和修訂檔

文章 變更
管理租使用者 建立、管理或尋找 Azure Sphere 租使用者的相關簡化內容
針對雲端和部署問題進行疑難解答 針對 OS更新 進行疑難解答一節和 針對部署更新 進行疑難解答一節中的新注意事項
使用 Azure Sphere CLI 登入 描述使用 CLI 的預設登入，以及如何使用瀏覽器登入的新主題。

Azure Sphere 資源庫已新增三個新的範例，這是未受管理腳本、公用程式和函式的集合：

  • WiFiConfigurationviaNfc 說明如何透過近距離通信 （NFC） 從手機設定WiFi認證。

  • TranslatorCognitiveServices 會示範如何使用 Azure Sphere 與 Azure 認知服務通訊，在此案例中翻譯文字。

  • Grove_16x2_RGB_LCD提供 LCD RGB 顯示器的驅動程式代碼。