Share via

Azure 球體的新功能

  • 發行項

Azure 球體會持續更新。 功能版本 支援新功能，並且可能包含 Azure 球體作業系統、SDK 和/或服務的更新。 品質版本 僅包含錯誤修正和安全性更新，而且通常僅包含 Azure 球體作業系統。 版本號碼通常是 年.月 格式，因此 22.04 會識別 2022 年 4 月發行的版本。

收到更新通知

新發行發行時，我們會在 Azure 匯報 和 IoT 技術社群部落格張貼通知。 建議您訂閱 Azure 匯報 RSS 摘要，好讓您收到有關 Azure 球體的及時且必要的資訊。

接收更新

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

若要驗證附加裝置上已安裝的作業系統版本，請使用下列命令：

azsphere device show-os-version

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

azsphere show-version

零售評估 OS 版本

零售評估計劃會在所有裝置的操作系統更新前兩周，為應用程式啟用回溯相容性測試。 我們強烈建議所有生產使用者使用此測試設施。 請參閱 設定操作系統評估裝置 以瞭解如何參與。

報告弱點

Azure 球體鼓勵安全性研究者搜尋任何弱點，並根據 Microsoft 的協調 弱點揭露 原則向 MSRC 入口網站負責任回報。 弱點報告可能包含 透過 Microsoft Azure 賞金計劃的獎勵。 如需 Azure 球體 CVE 的一般資訊，請參閱 Azure 球體 CVE。 您可以在 MSRC 安全性更新指南 和本文的版本特定詳細數據中找到已發佈的 CVEs 相關信息。

24.03 版本的新增功能

2024 年 3 月 26 日

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

  • Azure 球體 (整合) 的一般可用性
  • 已更新 Azure 球體 OS
  • 已更新適用於 Windows 和 Linux 的 Azure 球體 SDK
  • 已更新 Visual Studio 和 Visual Studio Code 的 Azure 球體擴充功能
  • 已更新範例

此版本的重點包括 Azure 球體 (整合) 的一般可用性、支援自定義憑證以連線至 Azure IoT、Azure 球體 OS 的更新版 cURL、安全性修正、Ubuntu 24.04 發行前版本的 SDK 支援，以及 CMake 工具鏈的簡化。

Azure 球體 (整合) 的一般可用性

我們很高興地宣佈，Azure 球體 (整合式) 是 Azure 球體裝置的新管理介面，從今天開始通常可供生產使用。 Azure 球 (整合式) 現在已成為 Azure 球體服務的建議介面，且不再標示為 Azure 入口網站 中的預覽。

透過 Azure 球 (整合式) ，您可以直接在 Azure 入口網站 和 Azure CLI 的 Azure 球體擴充功能中管理 Azure 球體裝置。 Azure 球體 (整合式) 是以 Azure Resource Manager 平臺建置的新 Azure 球體 (整合) REST API 為基礎，它包含其他強大 Azure 服務的內建支援，包括 Azure RBAC 和 Azure 監視器。

自公開預覽以來，匯報 至 Azure 球 (整合) ：

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

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

  • 由於型錄 CA 憑證的兩年憑證卷，您可以使用 Azure 監視器在需要採取動作時收到通知。 如需詳細數據，請參 閱監視 Azure 球體機隊和裝置健康情況。。

如果您尚未開始使用 Azure 球 (整合) ，建議您立即使用。

一次性整合步驟可讓您在 Azure 球體 (整合) 中管理現有的 Azure 球體 (舊版) 租使用者。 整合租用戶之後，您可以使用 Azure 球體 (整合) 或 Azure 球體 (舊版) 來執行管理工作。 您可以從 Azure 球體 (整合) 中的測試和開發活動開始，同時繼續將 Azure 球體 (舊版) 用於生產管理工作流程，以分階段採用 Azure 球體 (整合式) ，直到您準備好完全移轉為止。 雖然 Azure 球 (仍會完全支援舊版) 介面，但我們建議移轉以充分利用 Azure 球體 (整合式) 功能和未來的增強功能。

如需詳細資訊，請參閱 Azure 球體 (整合) 一般可用的部落格文章

24.03 操作系統中的新功能和已變更的功能

Azure 球體作業系統 24.03 版包含下列變更：

修正 24.03 操作系統版本中的錯誤和常見弱點

Azure 球體作業系統中包含的 cURL 版本已從版本 7.69.1 更新至 7.87.0。 24.03 操作系統版本包含可降低這些常見弱點和暴露 (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-28319 - CVE-2023-28320
- CVE-2023-28321 - CVE-2023-28322

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

Azure 球體裝置現在可以使用自定義憑證鏈連線到 Azure IoT 服務。 使用非 Azure 球體憑證鏈，對於針對憑證使用方式有其他組織需求的應用程式很有説明。 已更新有關聯機至 Azure IoT 的 指導方針，以進一步描述此使用案例。 使用 23.05 操作系統所發行的此功能 Beta API 版本的客戶，都應該下載最新的 SDK 並重新編譯應用程式，以移轉到新的 API，並指出函數簽名已變更以促進此功能的生產應用。

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

Azure 球體 SDK 和 Visual Studio/Visual Studio Code 擴充功能的 24.03 版本包含下列變更：

Ubuntu 18.04 LTS 終止支援

Ubuntu 18.04 現在是 Canonical 長期標準支援安排之外。 因此，23.05 SDK 是最後一個支援此操作系統版本的 Azure 球體 SDK。 24.03 和未來的 SDK 將不支援 Ubuntu 18.04。

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

24.03 SDK 會新增發行前版本 Ubuntu 24.04 的支援，新增至現有的 Ubuntu 20.04 和 22.04 支援。 這是為了在公開發行Ubuntu24.04之前進行開發和測試之目的。

CMake 工具鏈變更

在 SDK 版本 23.05 和更舊版本中，Azure 球體應用程式使用的目標 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 版本釘選到特定版本 (例如，當您使用特定作業系統版本) 建立製造產品的應用程式時，您應該將參數設定 AZURE_SPHERE_TARGET_API_SET 為該版本。

現有的項目會繼續與新的 SDK 編譯，不過警告訊息會通知使用者，他們可以移除已取代CMakeLists.json專案。 根據 GitHub 樣本建立的新專案將需要 24.03 或更新版本的 SDK 和 VS/VS 程式代碼擴展名。

24.03 的更新範例

24.03 版本包含下列樣本變更：

匯報 到 Azure 球體 HTTPS cURL 多樣本

先前的 Azure 球體 HTTPS cURL 多樣本 已不再遵循目前建議的 cURL 最佳做法，請參閱 此處的更多詳細數據。 雖然我們維持了與舊方法的相容性，但我們已更新範例，並建議您在任何軟體更新或您可能正在開發的新開發工作中 納入最新方法 。

匯報 範例以使用 Azure CLI 的 azure 球形擴充功能

我們建議您使用目前一般可用的 Azure 球 (整合式) 介面來進行未來的開發工作。 範例 README 檔案中的指示已更新為使用 Azure CLI azure 球形擴展名中的命令。

Azure 球 (整合) 公開預覽版

2023 年 8 月 8 日

我們很高興宣佈 Azure 球體 (整合) 的公開預覽，這是 Azure 球體服務的新管理介面，透過 Azure Resource Manager 與 Azure 原生整合。

此 Azure 球 (整合式) 公開預覽包含：

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

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

在公開預覽期間，建議您使用 Azure 球體 (整合) 進行開發和測試。 最佳做法是，生產使用案例 (例如，在製造或營運工作流程期間，) 不應使用預覽產品。 因此對於生產使用案例，建議您繼續使用現有的 Azure 球體安全性服務介面，現在稱為 Azure 球體 (舊版) ，且持續獲得完整支援和一般使用。

若要深入瞭解 Azure 球體 (整合) 和 Azure 球體 (舊版) ，包括如何開始使用，請參閱 此檔。

此版本沒有作業系統或 SDK 更新。 Azure 球體 (整合式) 命令行工具是由新的 Azure CLI 擴充功能提供，此擴充功能在使用與連接的裝置互動的命令時，必須安裝 23.05 Azure 球體 SDK。

23.05 版本的新增功能

2023年10月26日

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

  • Azure 球體 (整合式) 型錄管理的新快捷鍵
  • 錯誤修正

它不包含更新的作業系統或 SDK。

2023年6月20日

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

  • 已更新 Azure 球體 OS
  • 已更新適用於 Windows 和 Linux 的 Azure 球體 SDK
  • 匯報 Visual Studio 和 Visual Studio Code 的 Azure 球體擴充功能

如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。 系統會提示您在下次使用時安裝更新的 SDK，或者您現在可以安裝它。 若要安裝最新的 SDK，請參閱 安裝適用於 Windows 或 Linux 的快速入門。

此版本的重點包括新的密碼編譯文檔庫、預設NTP後援、使用您自己的憑證在Windows上新增的 BETA API、更快且增強的原廠測試、Linux的多重裝置支援、新的工具存放庫，以及針對完全支持狀態的剖析裝置記錄檔自助圖庫專案的畢業典禮。

23.05 操作系統中的新功能和已變更的功能

Azure 球體作業系統 23.05 版包含下列變更：

Microsoft 管理的內建密碼編譯庫

在 23.05 版本中，Azure 球體已內建操作系統密碼編譯庫。 透過 我們與 wolfSSL 的合作關係，您現在可以在應用程式中呼叫選取的 wolfCrypt API，讓您執行 ECC 或 xChaCha 加密與解密、憑證產生與管理等等，而不會產生 RAM 或刷新影響，以建置到您的應用程式。 相反地，Azure 球體操作系統內建的文檔庫會為您提供服務，Microsoft 可以修補此文檔庫並保持在最新狀態。 這項新功能是產品生命週期之 ABI 兼容性承諾的一部分，您可以檢視 WolfSSL 在其網站上所承諾的長期 ABI，其中也提供如何使用這些 WolfCrypt API 的範例，例如 ECC。

擴展的 NTP 強固性

如果 Microsoft NTP 時間伺服器發生中斷，Azure 球體裝置在嘗試多個地區 Microsoft 端點之後，現在會嘗試回復到 NIST NTP 伺服器，除非自定義 NTP 正與自定義的後援設定搭配使用。 這可提供更多選項，讓 Azure 球體裝置能夠與雲端和其他伺服器進行通訊同步處理，藉此擴充其連線的強大功能。 防火牆後方 Azure 球體裝置的系統管理員可以在這裡參閱 更新的端點詳細數據。

Windows 上 Azure IoT (Beta) 的第三方憑證支援

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

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

RF 工具已更新為包含：

  • 支援 Windows 和 Linux x86 平臺，包括多重裝置。
  • 透過新的批處理作業系統通話，改善讀取和撰寫緩衝區和 eFuse 數據的效能。
  • Python 文件庫，協助 Python 用戶開發自己的腳本和應用程式。

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

Azure 球體 SDK 的 23.05 版本包括下列變更：

Linux 多重裝置支援

23.05 SDK 為 Linux 中多個同時連接的 Azure 球體裝置新增支援，使此功能符合 Windows 上的現有支援。 這與Linux型製造案例具有特殊相關性。

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

新增Ubuntu 22.04 LTS的SDK支援

23.05 SDK 為 Ubuntu 22.04 新增支援，並新增到現有的 Ubuntu 18.04 和 20.04 支援。 Linux SDK 安裝程式可以判斷您正在執行的 Ubuntu LTS 版本，並下載或安裝適當的 SDK。

Ubuntu 18.04 LTS 的終止支援通知

Ubuntu 18.04 現在是 Canonical 長期標準支援安排之外。 因此，23.05 SDK 將是最後一個支援此操作系統版本的 Azure 球體 SDK。 未來的 SDK 將不支援 Ubuntu 18.04。

Visual Studio 23.05 中的新功能和變更的功能或 Azure 球體的 Visual Studio Code 擴充功能

Azure 球體 Visual Studio 23.05 版本和 Visual Studio Code 擴充功能包含下列變更：

  • 已改善偵錯即時應用程式以及偵錯多個應用程式時的偵錯體驗。
  • 已更新新的項目範本。

新工具 GitHub 存放庫

已引進新的 GitHub 存放庫 Azure 球體工具。 此存放庫將包含與製造、支援及診斷相關的其他正式支援工具。 製造資料夾已從 [範例 存放庫] 重新配置，將製造工具放在單一易於尋找的位置，同時也減少範例存放庫的移動量。

Azure 球體樣本、程式代碼片段和圖庫專案的 23.05 版本包含下列變更：

Azure 球體的 23.05 版包含從圖庫中退出的剖析裝置記錄檔專案，現在是位於新 Azure 球體工具 存放庫中正式支持的專案。

23.02 版本的新增功能

2023年2月21日

Azure 球體 23.02 發行僅包含 Azure 球體 OS 中的錯誤修正;它不包含更新的 SDK。 如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。

修正 23.02 版本中的錯誤和常見弱點

23.02 版本包含可降低下列常見弱點和暴露 (CVE) 的更新：

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

Azure 球體樣本、程式代碼片段和圖庫專案的 23.02 版本包含下列變更：

Unicast DNS 服務探索 圖庫專案 示範如何透過傳送 DNS-SD 查詢到設定的 DNS 伺服器來執行 DNS 服務探索。 與多重廣播服務探索不同的是，此機制不僅可以用來動態開啟存取本機，也可以在運行時間以遠端方式開啟裝置防火牆的端點。

22.11 版本的新增功能

2022年12月1日

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

  • Azure 球體安全性服務所使用的影像簽署密鑰更新
  • 已更新 Azure 球體 OS
  • 已更新適用於 Windows 和 Linux 的 Azure 球體 SDK
  • 已更新 Visual Studio 和 Visual Studio Code 的 Azure 球體擴充功能

如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。 系統會提示您在下次使用時安裝更新的 SDK，或者您現在可以安裝它。 若要安裝最新的 SDK，請參閱安裝適用於 Windows 或 Linux 的快速入門：

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

Azure 球體安全性服務正在使用新的影像簽署密鑰

Azure 球體安全性服務現在使用新的影像簽署密鑰。 我們的服務會使用這些金鑰來簽署任何新上傳的應用程式影像和新功能檔案 (例如，在 裝置) 啟用開發模式 時。 22.11 操作系統是使用舊的按鍵來簽署，但是未來的 OS 會使用新按鍵來簽署。 Azure 球體裝置會持續信任所有現有的密鑰。

若要讓 Azure 球體裝置使用新按鍵接受簽章，信任的密鑰store (TKS) 更新已於 2022 年 11 月 14 日推出。 生產裝置不需要用戶動作。 針對 Azure 球體作業系統不是最新狀態的特定製造、開發或字段維護案例，您可能需要採取額外步驟，以確保裝置信任新簽署的影像 –如需完整詳細數據，請參閱這 篇部落格文章 。

22.11 作業系統中的新功能和已變更的功能

Azure 球體作業系統 22.11 版包含下列變更：

新馬略克版本

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

升級的 Azure IoT C SDK

我們已將 Azure IoT C SDK 更新為最新版本。 此 SDK 包含錯誤修正和穩定性增強功能，與舊版相容。 所有現有應用程式都受益於由 Azure 球體作業系統管理的幕後改良功能。

減少 DHCP 逾時

DHCP 重試逾時已從 10 減為 1。 這項縮減可改善裝置等待 DHCP 租賃時的電池使用量，預計會在某些網路設定和流量案例中發生。

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

Azure 球體 SDK 的 22.11 版本包含下列變更：

支援其他 CLI 命令輸出格式

為了持續努力將 JSON 輸出引入 CLI 命令，讓腳本和自動化變得更容易，新增 azsphere 圖像 和 azsphere 裝置 show-os-version 也已更新以支援 JSON 輸出。 如需目前支援多種輸出格式的命令清單，請參閱 支援的命令 。

Azure 球體樣本、程式代碼片段和圖庫專案的 22.11 版本包含下列變更：

記錄至 Azure 範例專案

[記錄至 Azure 範例] 專案示範如何與 Azure Data Explorer 同時使用 IoT 中樞，以可縮放和查詢的方式擷取應用程式層級記錄檔。

PWM 音頻圖庫專案示範如何使用 MT3620 的硬體 PWM 介面設備來產生音效，以搭配嗡嗡聲或其他產生音訊的裝置來使用，這是常見的產品使用案例。

公開預覽：Azure 球體支援歐洲數據邊界

為了符合 Microsoft 在歐盟專屬處理及儲存歐盟數據的任務 (請參閱 Microsoft 雲端) 的 歐盟數據邊界 ，Azure 球體安全服務現在可讓歐盟客戶視需要在歐盟內處理和儲存圖像檔和裝置損毀傾印檔案。 新的 區域數據邊界設定 是一個選用參數，可用於 azsphere 圖像 和 azsphere 裝置群組 命令。

如需詳細資訊，請參閱：

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

22.11 版本中的新文件和修訂檔

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

關於 22.10 品質版本

2022年10月25日

22.10 版本僅包含 Azure 球體 OS 中的錯誤修正;它不包含更新的 SDK。 如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。

修正 22.10 版本中的錯誤和常見弱點

此版本包含一般改良功能，可能會導致某些裝置預期會重新啟動。

22.10 版本不包含可降低任何常見弱點和暴露 (CVE) 的更新。

22.09 版本的新增功能

2022 年 9 月 26 日

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

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

如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。 系統會提示您在下次使用時安裝更新的 SDK，或者您現在可以安裝它。 若要安裝最新的 SDK，請參閱安裝適用於 Windows 或 Linux 的快速入門：

此版本的重點包括減少操作系統連線到雲端的冷開機時間，導致能源使用量降低;遠端疑難解答和優化製造腳本的最佳做法指導方針。

22.09 操作系統中的新功能和已變更的功能

Azure 球體作業系統 22.09 版包含下列變更：

擴充乙太網路 NIC 支援

Azure 球體現在支援 WIZnet W5500 10/100 乙太網路介面適配器，乙太網路介面可供 因特網聯機使用。 此硬體元件可以提高有線乙太網路應用程式的效能和市場可用性。

復原攻擊的安全性保護

在針對復原攻擊進行深度防禦時，在 22.07 之前的舊版 Azure 球體操作系統復原和復原將無法在已更新至 22.09 版本的裝置上使用。

裝置更新至 22.09 版本之後，將無法再執行早於 22.07 的 Azure 球體操作系統版本。 這表示您在收到 22.09 更新之後，將無法將裝置復原到先前的版本。 22.07 版本將會成為可安裝在裝置上的最早版本。

22.09 SDK 的新增和變更功能

Azure 球體 SDK 的 22.09 版本包含下列變更：

支援其他 CLI 命令輸出格式

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

Visual Studio 22.09 的新功能和變更的功能，或 Azure 球體 Visual Studio Code 擴充功能

Azure 球體 Visual Studio 22.09 版和 Visual Studio Code 擴充功能包含下列變更：

針對支援即時應用程式的簡化設定

22.09 Azure 球體發行提供更簡單的設定程式，使用 vcpkg 成品來啟動您的開發環境，以建置支援即時的應用程式。 如需詳細資訊，請參閱 教學課程：建立支持即時功能的應用程式。

Azure 球體 22.09 版包含下列範例、程式代碼片段和圖庫項目的變更：

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

get-support-data記錄剖析 可在應用程式開發期間啟用疑難解答的自助功能。 在本機連線到裝置時，使用 azsphere get-support-data 從 Azure 球體裝置下載記錄檔、錯誤和狀態套件。 使用記錄剖析圖庫專案，將二進位記錄數據轉換為人類可讀取的格式，以檢視 Azure 球體 OS 中系統記錄的事件。

製造工具 v1.0.0 發行版

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

當這些工具直接與附加 Azure 球體裝置的 REST API 通訊時，與針對 azsphere CLI 的腳本相比，許多命令最多可以看到 5x 的速度。

Azure 球體松鼠圖庫專案示範在 MT3620 晶片上執行更高層級的腳本語言。

22.09 版本中的新文件和修訂檔

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

22.09 版本中的已知問題

使用 W5500 連線到有線網路時，如果網路纜線已拔除，CLI 和內部 API 可能仍會將介面回報為「上線」。 我們會在未來的操作系統版本中修正此問題。

修正 22.09 版本中的錯誤和常見弱點

22.09 發行版包含下列更新，以降低下列常見弱點和暴露 (CVE) ：

  • wolfSSL CVE-2022-34293

22.07 版本的新增功能

2022年7月26日

Azure 球體 22.07 版本包含下列元件：

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

如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。 若要安裝最新的 SDK，請參閱安裝適用於 Windows 或 Linux 的快速入門：

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

22.07 操作系統中的新功能和已變更的功能

Azure 球體操作系統 22.07 版包含：

  • 操作系統現在支援在持續性儲存空間中快取 DAA (客戶) 憑證。 這會導致冷開機時耗電量降低，以及冷開機或電源關閉后，連線到雲端的時間減少。
  • 操作系統在 Applibs 應用程式中有新的 API 函Applications_GetOSVersion()數。h 會傳回包含目前作業系統版本的可列印字串。

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

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

支援單色 CLI 輸出

基於輔助功能考慮，Azure 球體 CLI 現在支援 單色輸出 。 您可以使用此命令來管理 Azure 球體 CLI 中郵件的色彩設定。 如果您啟用參數 no-color ，會移除寄件郵件，而原本的彩色郵件會以 DEBUG、 INFO、 WARNING或 ERROR等為前綴。

Azure 球體傳統 CLI 驗證從 ADAL 移轉到 MSAL

Azure 球體傳統 CLI 現在使用 Microsoft Authentication Library (MSAL) ，而非即將 淘汰之 ADAL) (Active Directory Authentication Library。 移轉到 MSAL 后，Azure 球體傳統 CLI 的使用方式並無任何變更，也不需要客戶採取任何動作。

支援其他輸出格式

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

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 上。 在此期間，我們發佈了 Device REST API (讓略過 CLI 直接與裝置的 REST API) 進行 C# 和 Python 支援、範例應用程式和測試通訊。 製造腳本會移轉到使用這些 REST API。 這種直接使用裝置 REST API 可提升製造速度。 如需詳細資訊，請參閱 連線裝置的製造指南。

匯報 至 FTDI 介面指導方針和硬體設計

我們針對 MT3620 硬體指導方針做了一些微微變更，與 FTDI 程式設計與偵錯介面處理如何從低電源模式喚醒有關。 這改善與 Avnet MT3620 V2 模組的相容性。 MT3620 程式設計和偵錯介面中已更新某些電阻值。 低功率 MCU 轉雲端範例已更新以反映此指導方針，而且我們已經針對雲端硬體 v2.0 和 FTDI 介面面板 v2.0 發行新硬體範例，以反映此更新指導方針。 FTDI 介面面板 v2.0 更新也新增了服務/偵錯、修復和 SWD 連接器的雙腳印。

Applications_GetOSVersion API 的新片段

新的 「取得 Azure 球體裝置 OS 版本 」示範如何在 High-Level 應用程式中取得 Azure 球體裝置 OS 版本。

22.07 發行版中的新文件和修訂檔

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

22.07 版本中的已知問題

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

修正 22.07 版本中的錯誤和常見弱點

  • 當本機連接的 Azure 球體裝置可用時，命令 azsphere tenant create 現在可以使用。 在 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 版本包含升級至 5.10.103 (Linux 核心，) 和 Azure 球體 OS 中的錯誤修正;它不包含更新的 SDK。 如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。

修正 22.04 版本中的錯誤和常見弱點

22.04 版本包含可降低下列常見弱點和暴露 (CVE) 的更新：

  • wolfSSL CVE-2022-25638
  • wolfSSL CVE-2022-25640
  • C-Ares CVE-2021-3672
  • Linux CVE-2022-0847 (“dirty pipe”)

新的圖庫專案 AzureFunctionApp_AzureSpherePublicAPI 示範如何在 Python Azure 函數應用程式中使用 Azure 球體公用 API。

22.04 版本中的新文件和修訂檔

文章 變化
停止 Azure 球體裝置通訊服務 新增了與安裝程式在安裝期間當機相關的疑難解答區段。
透過 Proxy 伺服器連接 Azure 球體 已新增使用 MQTT 連線至 Azure IoT 中樞 的應用程式指令清單需求和資訊。
設定 Azure 球體的 Azure IoT 中樞 更新以清楚且更正用戶體驗。
使用裝置布建服務設定 Azure 球體的 Azure IoT 中樞 更新以清楚且更正用戶體驗。
設定 Azure 球 IoT Edge 更新以釐清文字並符合 Azure UI。
設定 Azure IoT 中心以搭配 Azure 球體使用 更新以清楚且更正用戶體驗。
Azure 球體 OS 摘要
- 設定操作系統評估的裝置		 更新以釐清 Azure 球體 OS 在零售評估摘要中的部署方式。
製造指南 更新以釐清裝置製造程式所涉及的事項。
製造流程準備 新主題提供在執行出廠工作和雲端設定工作之前應完成之工作的詳細數據。
工廠樓層工作 為了清楚起見，已更新。 將準備工作移到新的 製造準備 主題。
雲端設定工作 為了清楚起見，已更新。 將準備工作移到新的 製造準備 主題。
RF 工具 新增一個區段「 RF 工具使用量完成後」，描述使用 RF 工具完成後要完成的工作。

關於 22.02 更新 1 版本

2022 年 3 月 17 日

Azure 球體 22.02 更新 1 版本包含下列元件：

  • 已更新適用於 Windows 和 Linux 的 Azure 球體 SDK
  • 已更新 Visual Studio Code的 Azure 球體擴充功能

它不包含更新的作業系統或更新的Visual Studio擴充功能。

匯報 22.02 更新 1 SDK

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

提示

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

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

22.02 更新 1 Visual Studio Code 擴充功能中的 匯報

在Linux上，Azure 球體 Visual Studio Code擴充功能中的租用戶總管先前顯示錯誤。 更新的擴充功能會正確顯示結果。

在 22.02 更新 1 組建環境容器中 匯報

Azure 球體組建環境容器已更新為 22.02 更新 1 SDK。

22.02 功能版本的新增功能

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

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

如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。 若要安裝最新的 SDK，請參閱安裝適用於 Windows 或 Linux 的快速入門：

也有更新的 樣本、程式代碼片段、圖庫專案，以及 檔更新。

重要

2022年3月08日

22.02 SDK 有與 API 集 12 中包含的 sys/socket.h 頁首和肌肉 64 位時間支持 相關的問題。 此問題將會在即將推出的 SDK 更新中解決。 不需要操作系統變更即可解決此問題。 不過，目前如果您使用的是 sys/socket.h 中定義的 setockopt () 函數，則不應該使用 API 集 12 來建立生產應用程式。 建議您在 22.02 版本中使用 API 集 11。

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

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

22.02 操作系統中的新功能和變更的功能

Azure 球體作業系統 22.02 版包括升級至 Linux 核心 (5.10.70) ，以及支援 DHCP 發行與續約。

DHCP 發行與續約

Azure 球體 OS 現在支援 DHCP 發行 ，並透過新的 API 更新 ，以便高層級應用程式可以控制其裝置 IP 租賃。

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

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

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

支援 Windows 11

Windows 11 現在支援 Azure 球體開發。 如果您使用的是 Windows 11，請 ) SDK 安裝 22.02 (或更新版本。

64 位時間支援

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

不假定值大小 time_t 的應用程式代碼不會受到影響。 不過，明確或隱含預期 time_t 為32位的應用程式代碼必須重新撰寫才能改用 time32_t 。

提示

為了確保您的應用程式在重建後仍能如預期般運作，請檢查應用程式中的堆疊和堆疊使用量，以及二進位大小。 它們可能會像現在8位元組而非4位元組一樣 time_t 成長。

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

設定 Azure 球體 CLI 記錄

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

Azure 球體 CLI 驗證從 ADAL 移轉到 MSAL

Azure 球體 CLI 現在使用 Microsoft Authentication Library (MSAL) ，而非已 淘汰的 ADAL) (Active Directory Authentication Library。 移轉到 MSAL 后，Azure 球體 CLI 的使用方式不會有任何變更，也不需要客戶採取任何動作。

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

Visual Studio 22.02 中的新功能和變更的功能，或 Azure 球體的 Visual Studio Code 擴充功能

除了 Visual Studio 2019 的現有擴充功能之外，現在還提供 Visual Studio 2022 的 Azure 球體擴 充功能。 Visual Studio 2019 的最低支援版本現在是 16.11。

Azure 球體的 Visual Studio 和 Visual Studio Code 擴充功能現在提供下列功能：

  • 在 Azure 球體總管中設定 Wi-Fi。
  • 在 Azure 球體總管中檢視部署歷程記錄。
  • 在偵錯時以 Visual Studio Code 開啟拆卸檢視。

在 Azure 球體總管中設定 Wi-Fi

您現在可以 新增 Wi-Fi 網路、連線到網路、啟用或停用網路，以及從 Azure 球體總管的圖形介面中忘記它們。

檢視部署歷程記錄

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

在偵錯時開啟拆卸檢視

拆解檢視提供您原生程式代碼的低等級檢視，並放大一般逐步偵錯程式。 此 Visual Studio Code 擴充功能的變更現在提供與 Visual Studio 相同的拆解體驗。

22.02 發行版中的新文件和修訂檔

文章 變化
快速入門：設定網路功能並更新裝置操作系統 包含使用 Azure 球體總管設定 Wi-Fi 的指示。
在 Azure 球體總管中檢視裝置和租用戶資訊 更新為包含新功能。
使用 GitHub 程式代碼區來建置和偵錯 使用 Visual Studio Code 開發 GitHub 程式代碼區應用程式的新主題。
在高階應用程式中使用記憶體 更新為在命令提示字元中包含建立及執行記憶體監視批處理腳本的指示。
偵錯高階應用程式 已更新為包含開啟拆解檢視的指示。
偵錯支援即時的應用程式 已更新為包含開啟拆解檢視的指示。
偵錯合作夥伴應用程式 已更新為包含開啟拆解檢視的指示。
使用 CMake 設定組建 更新以說明具有多個根源的專案所需的新CMakeWorkspaceSettings.json檔案。
裝置身分識別和安全性 關於安全性考慮的新主題，以及使用裝置標識碼的建議最佳做法。
檢視部署歷程記錄 更新為包含在 Azure 球體總管中檢視部署歷程記錄的指示。
管理記錄檔 使用 CLI 設定記錄的新主題。

修正 22.02 版本中的錯誤

22.02 版本包含下列錯誤修正：

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

22.02 版本中的已知問題

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

關於 22.01 品質版本

Azure 球體並未發行 22.01 的更新操作系統或 SDK。 如需詳細資訊，請參閱 22.01 版本取消的 部落格文章 。

22.01 的 匯報 包含圖庫中的兩個新專案，以及檔更新。

注意

在上一版中，我們通知您，從 2022 年 4 月開始，Azure 球體傳統 CLI 將從 SDK 中移除。 其淘汰時程表已延長。 我們預計在未來的日期淘汰 Classic CLI，但不會在 2022 年底之前淘汰。 我們繼續建議您將 程式和腳本移轉 到 CLIv2。

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

ToggleClassicCLI 提供適用於 Windows 和 Linux 的腳本，可讓您測試移除 Azure 球體傳統 CLI (，然後還原) 。 Azure 球體傳統 CLI 已由 CLIv2 取代，日後將會從 Azure 球體 SDK 中移除。 這些腳本可協助識別您可能在 Classic CLI 上的相依性。

22.01 版本中的新文件和修訂檔

文章 變化
疑難解答 Azure 球體問題 新增了「Azure 球體裝置通訊服務無法停止」錯誤訊息的疑難解答步驟。
使用服務標籤限制 Azure 球體安全性服務的存取權 關於如何使用 AzureSphere 服務標籤允許或拒絕 Azure 球體安全性服務流量的新主題。
裝置功能與維護會話 新增了有關裝置如何取得卡帕比特人的說明，以及您可以使用 功能變數Servicing 功能執行什麼動作。
Azure 球體 CVE 我們已進一步說明我們對 CVE 計劃的 參與，以及 Azure 球體 CVE 對客戶的影響。
監護人模組 更新連結、釐清整個主題的資訊，以及重新整理節。

關於 21.11 品質版本

Azure 球體並未發行 21.11 的更新操作系統或 SDK。

匯報 21.11 包含下列檔案變更及其他次要編輯：

文章 變化
裝置功能與維護會話 說明及修正功能需要的時機，以及允許哪些動作。
設定 Azure 球體的 Azure IoT Edge 更新為包含同時使用 IoT Edge 1.2 和 IoT Edge 1.1 的指示。
Azure 球體 CVE 已新增發佈 Azure 球體常見弱點和公開 (CVE) 之內容和時間的相關信息。
工廠樓層工作 新增有關製造狀態和裝置功能的資訊。
裝置 說明及修正裝置功能。
Azure 球體 CLI 概觀 說明及修正裝置功能。

21.10 功能版本的新增功能

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

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

如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。 若要安裝 Visual Studio 和 Visual Studio Code 的最新 SDK 和擴充功能，請參閱安裝適用於 Windows 或 Linux 的快速入門：

重要

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

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

21.10 發行包括：

Web Proxy 支援

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

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

wolfSSL 已更新為版本 4.8.1

Azure 球體 OS 現在包含 wolfSSL 4.8.1。 此更新帶來來自 wolfSSL 的最新安全性修正程式和效能增強功能。 此外，新的 ABI 會透過作業系統公開，以防止部分 TLS 設定中的中間人攻擊。 在應用程式中使用 wolfSSL 時， (如 wolfSSL 範例) 所示，建議您在適用時使用 wolfSSL_CTX_set_verify 它來驗證主機。

如需有關在 wolfSSL 網站上使用 wolfSSL_CTX_set_verify 的詳細資訊。

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

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

支援租使用者重新命名

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

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

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

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

針對暫時或永久不需要 Wi-Fi 的情況，我們已提供更新的軟硬體指導方針，說明如何降低耗電量並簡化此類案例中的硬體設計。 如需詳細資訊，請參閱 Wi-Fi連線 和 MT3620硬體筆記 。

下列 Azure 球體樣本 已更新為 21.10：

  • 已在 AzureIoT 範例 中新增其他已讀取專案，以顯示如何新增 Web Proxy 支援。
  • HTTPS/cURL 範例已更新，以顯示如何新增 Proxy 支援。

Azure 球體圖庫中的下列專案已針對 21.10 新增或更新：

21.10 發行版中的新文件和修訂檔

文章 變化
透過 Proxy 伺服器連接 Azure 球體 說明如何設定 Azure 球體裝置透過 Proxy 伺服器連線到因特網的新主題。
設定 Azure 球 Azure IoT 中樞 已更新主題，包含有關在 Azure IoT 中樞 上自動和手動驗證租使用者 CA 憑證的資訊。
使用裝置布建服務設定 Azure 球體的 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 球體 SDK\CMakeFiles\AzureSphereToolchainBase.cmake
  • 在 Linux 上：/opt/azurespheresdk/CMakeFiles/AzureSphereToolchainBase.cmake

將 AzureSphereToolchainBase.cmake 行 13 修改為下列內容：

set(libmalloc_10_or_later "10" "11" )

此問題將在下一版的 Azure 球體 SDK 中修正。

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

修正 21.10 版本中的錯誤和常見弱點

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 球體 OS 的更新;它不包含更新的 SDK。 如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。

匯報 到 Azure 球體作業系統，包括：

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

21.09 發行版中的新文件和修訂檔

文章 變化
雲端和部署問題的疑難解答 新增了與索賠裝置相關的疑難解答資訊。

關於 21.08 品質版本

21.08 發行版包含下列 Azure 球體作業系統中的增強功能和錯誤修正;它不包含更新的 SDK。

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

如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。

也有 新的 Azure 球體圖庫範例 和 檔更新。

修正 21.08 版本中的錯誤和常見弱點

21.08 發行版包含可降低下列常見弱點和暴露 (CVE) 的更新：

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

下列新範例或更新的範例已新增至 Azure 球體圖庫，這是未相關腳本、公用程式和函數的集合：

21.08 發行版中的新文件和修訂檔

文章 變化
azsphere 裝置 針對淘汰--cert-id--interface-name和更新的參考主題。
(Azure 球體 CLI 中淘汰功能) 的重要變更 描述已停用或即將從 Azure 球體 CLI 淘汰或移除之功能、命令或參數的新主題。

21.07 功能版本的新增功能

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

  • 已更新 Azure 球體 OS

  • 已更新適用於 Windows 和 Linux 的 Azure 球體 SDK

  • 已更新 Visual Studio 和 Visual Studio Code 的 Azure 球體擴充功能

也有更新的 範例、教學課程、圖庫專案和 檔更新。

如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。 系統會提示您在下次使用時安裝更新的 SDK，或者您現在可以安裝它。 若要安裝最新的 SDK，請參閱安裝適用於 Windows 或 Linux 的快速入門：

重要

2021年9月30日

Windows 版 21.07 SDK 的更新 2 現已推出。 此更新修正了安裝程式錯誤，此錯誤會在升級至 Windows 11 之後防止卸載 Azure 球體 SDK。

2021年7月28日

21.07 SDK 的更新 1 現已推出。 如果您已安裝 21.07 SDK 的舊版，您可以重新安裝以取得更新的版本。 21.07 SDK 版本不正確地移除 Azure 球體 CLI 的部分已淘汰參數。 21.07 Update 1 SDK 會將這些已淘汰的參數恢復為 CLI，以供回溯相容性之用。 如需詳細資訊，請 參閱 (Azure 球體 CLI 中淘汰功能) 的重要變更。

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

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

時間同步變更

21.07 版本中的同步處理程式已變更，以便在主要時間伺服器失敗或無法到達時提供更健全的程式。 先前，如果時間同步處理嘗試使時間同步處理無法完成，則需相依於完成時間同步處理的服務可能無法啟動。 這項變更新增了可取得正確時間的後援機制，讓時間同步處理的重述不會無限期地繼續。

堆處理記憶體配置追蹤

堆處理記憶體配置追蹤功能可讓開發人員在開發應用程式期間，方便查看 Azure 球體 SDK 隨附之文檔庫的記憶體配置。 此功能新增了新的應用程式功能 HeapMemStats，以及新的 Azure 球體 SDK 文檔庫 libmalloc。 此功能也包含 Azure 球體 CLI 命令 azsphere 裝置應用程式 show-memory-stats 和 Visual Studio 擴充功能的輸出變更。 透過這些變更，開發人員可以將 HeapMemStats 功能新增至高階應用程式、將應用程式部署到具有開發功能的裝置，以及使用 Visual Studio 的 Performance Profiler 來檢視由其應用程式調用的 SDK 文件庫所使用的記憶體。

使用 Azure Active Directory 的驗證方法

Azure 球體公用 API (PAPI) 支援 Azure Active Directory (AAD) 中的多種使用者驗證和授權方法。

透過 Azure Active Directory，應用程式 令牌 可用來驗證並授與使用者應用程式、服務或自動化工具中特定 Azure 資源的存取權，方法 是使用服務主體或受管理的身分識別方法進行驗證。

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

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

Azure 球體公用 API 已擴充，以包含有關作業系統和更新狀態的其他裝置詳細數據。 您現在可以看到裝置上安裝的系統操作系統版本、最新的可用作業系統版本、裝置上次更新的時間，以及裝置上次檢查更新的時間。 其他信息對於管理裝置的更新很有説明。

下列 Azure 球體 API 參考頁面將更詳細地說明 API 回應變更：

命令 描述
裝置 - 取得 取得裝置的詳細數據。
裝置 - 清單 取得所有向指定租使用者提出要求的裝置。
裝置 - 群組中的清單 取得指派給指定裝置群組的所有裝置。
裝置 - 產品清單 取得所有屬於指定產品的裝置。

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

Visual Studio 的新功能和變更的功能，或 Azure 球體的 Visual Studio Code 擴充功能

Visual Studio 和 Visual Studio Code 擴充功能包含更多偵錯目標的描述性名稱。 Visual Studio 擴充功能也包含堆 記憶體配置追蹤的支援。

針對偵錯目標提供更多描述性名稱

Visual Studio 擴充功能現在會針對偵錯目標名稱使用項目名稱。 Visual Studio Code 擴展名會如往常般顯示項目名稱，但簡化了描述文字。

支援其他輸出格式

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

新增及更新的命令和參數

匯報 命令：

命令 描述
azsphere 裝置網路啟用 啟用連接裝置上的網路介面。
azsphere 裝置網路停用 停用附加裝置上的網路介面。

匯報 參數：

參數 描述
azsphere 裝置網路顯示診斷 參數 --id 隨即變更為 --network。
azsphere 裝置網路更新介面 參數 --interface-name 隨即變更為 --interface。
azsphere 裝置憑證刪除 參數 --cert-id 隨即變更為 --certificate。
azsphere 裝置憑證顯示 參數 --cert-id 隨即變更為 --certificate。
azsphere 租使用者建立 參數 --force 隨即變更為 --force-additional。
azsphere 租使用者建立 參數 --disable-confirm-prompt 是新的，它會停用使用者確認提示。

注意

21.07 SDK 版本錯誤地完全從 Azure 球體 CLI 移除此處提及的已停用參數。 21.07 Update 1 SDK 會將這些已淘汰的參數恢復為 CLI，以供回溯相容性之用。 如需詳細資訊，請 參閱 (Azure 球體 CLI 中淘汰功能) 的重要變更。

21.07 發行版中的新文件和修訂檔

文章 變化
在高階應用程式中使用記憶體 已更新主題以包含堆 處理記憶體配置追蹤的討論。
在遠端主機上搭配安全殼層 (SSH) 使用 Visual Studio Code 說明如何透過安全殼層在遠端主機建立和偵錯 Azure 球體應用程式的新主題。
使用 Azure Active Directory 的驗證方法 提供支持驗證方法概觀的新主題。
使用 AAD 管理身分識別存取 Azure 球體公用 API 提供使用 AAD 受管理身分識別存取 Azure 球體公用 API 概觀和步驟的新主題。
使用 AAD 應用程式服務主體存取 Azure 球體公用 API 提供使用 AAD 服務主體存取 Azure 球體公用 API 概觀和步驟的新主題。
使用 AAD 使用者身分識別存取 Azure 球體公用 API 提供使用 AAD 使用者身分識別存取 Azure 球體公用 API 概觀和步驟的新主題。
支援的命令 更新支援輸出格式的命令清單。
裝置 匯報 至命令和參數描述和範例。
租戶 匯報 參數描述和範例。
作用 更新的主題為參數的 --role 值不區分大小寫。

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

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

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

已更新 Azure IoT 範例

我們針對 Azure IoT 範例做了一些小修飾，包括遵循此 IoT 中樞 用戶端最佳作法，將投票速率IoTHubDeviceClient_LL_DoWork變更為每 100ms，而不是每 1 1 次。 我們建議您在現有的應用程式中採用此變更。

下列新範例或更新的範例已新增至 Azure 球體圖庫，這是未相關腳本、公用程式和函數的集合：

21.07 版本中的已知問題

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

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

修正 21.07 版本中的錯誤和常見弱點

21.07 發行版包含可降低下列常見弱點和暴露 (CVE) 的更新：

  • CVE-2021-26428

  • CVE-2021-26429

  • CVE-2021-26430

關於 21.06 品質版本

21.06 發行版包含 Azure 球體 OS 的錯誤修正;它不包含更新的 SDK。 如果您的裝置已連線到因特網，則會從雲端接收更新的操作系統。

21.06 版本中的新文件和修訂檔

文章 變化
管理租使用者 簡化有關建立、管理或尋找 Azure 球體租用戶的內容
雲端和部署問題的疑難解答 New notes in the Troubleshoot OS updates section and the Troubleshoot deployment updates section
使用 Azure 球體 CLI 登入 描述 CLI 預設登入以及如何使用瀏覽器登入的新主題。

三個新範例已新增至 Azure 球體圖庫，這是未建立相關腳本、公用程式和函數的集合：