共用方式為

將 Azure Sphere 連線至 Wi-Fi

  • 發行項

重要

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

您可以使用 CLI 或 Azure Sphere SDK 應用程式連結庫 （Applibs） 設定 Azure Sphere 裝置，透過 Wi-Fi 連線到因特網。

驗證方法

支援下列驗證方法：

  • WPA2
  • EAP-TLS
  • open （無密碼）

設定適用於Wi-Fi的 Azure Sphere

您可以將 Azure Sphere 裝置設定為使用 Azure Sphere SDK 應用程式連結庫 （Applibs） 從命令行 （CLI） 或從您的應用程式連線到 Wi-Fi 網路。

使用 CLI 的 Wi-Fi 設定

若要從命令行管理Wi-Fi組態，請使用 azsphere device wifi CLI 命令。 例如， device wifi add 命令會將無線網路的詳細數據新增至裝置。


azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"

若要使用已設定的Wi-Fi網路，網路介面 （wlan0） 必須處於作用中狀態。 使用裝置網路清單介面命令來判斷介面是否為使用中。


azsphere device network list-interfaces

視需要使用 裝置網路 enable 命令加以啟用。


azsphere device network enable --interface wlan0

若要啟用設定的Wi-Fi網路，請使用 裝置wifi enable 命令。


azsphere device wifi enable --id <network id>

快速入門主題 ：在 Azure Sphere 裝置 上設定 Wi-Fi 說明如何從命令行設定 Azure Sphere 裝置上的 Wi-Fi。

或者，如果您使用 EAP-TLS 驗證，請參閱 從 CLI 設定 EAP-TLS 網路。

使用 Applibs 的 Wi-Fi 設定

若要設定Wi-Fi，您的應用程式必須使用 applibs wificonfig API。

在應用程式中包含此標頭檔案：

#include <applibs/wificonfig.h>

應用程式 指令清單 必須包含 WifiConfig 功能。

 "Capabilities": {
  "WifiConfig" : true
}

若要判斷網路介面是否為使用中，請使用 Networking_GetInterfaceConnectionStatus 函式。

Networking_GetInterfaceConnectionStatus("wlan0", &currentInterfaceStatus);

若要啟用網路介面，請使用 Networking_SetInterfaceState 函式。

Networking_SetInterfaceState("wlan0", true);

注意

如果兩個網路介面 （wlan0 和 eth0） 都作用中且已連線，則裝置將用於通訊的特定介面不具決定性。 如果您想要控制應用程式在任何指定時間使用哪一個網路介面，則必須使用 Networking_SetInterfaceState（） 函式來明確開啟所需的介面，並將另一個介面關閉。 DHCP 用戶端高階應用程式範例會示範其他事項，如何藉由將代表兩個介面之一的值指派給全域變數，在介面之間切換。

若要從您的應用程式啟用已設定的Wi-Fi網路，請使用 WifiConfig_SetNetworkEnabled 函式。

WifiConfig_SetNetworkEnabled(<network id>, true);

如需使用 Applibs wificonfig API 的建議，請參閱 在欄位中 設定 Wi-Fi，以讓客戶為納入 Azure Sphere 的產品設定 Wi-Fi。

在應用程式中設定 EAP-TLS 網路主題說明如何在高階 Azure Sphere 應用程式中設定 EAP-TLS 網路。

範例

本節包含範例應用程式的鏈接，示範如何在 Azure Sphere 平臺上使用 Wi-Fi 功能。

WiFi_HighLevelApp範例示範如何在高階應用程式中設定Wi-Fi網路。

DHCP 用戶端高階應用程式示範如何更新或釋放網路 DHCP 伺服器指派給 MT3620 裝置的目前 IP 位址。

注意

下列範例來自 Azure Sphere 資源庫，這是來自 Microsoft 的未協調軟體和硬體範例集合。 如需詳細資訊，請參閱 Azure Sphere 資源庫。

WifiConfigurationViaAppResource 範例示範如何使用內嵌的 JSON 資源文件來設定裝置 Wi-Fi 設定。

WifiConfigurationViaNfc 範例示範如何使用 NFC 設定裝置Wi-Fi 設定。

WifiConfigurationViaUart 範例示範如何使用 UART 設定裝置 Wi-Fi 設定。