將 Azure 球體連線到 Wi-Fi
您可以設定 Azure 球體裝置，透過 Wi-Fi 使用 CLI 或 Azure 球體 SDK 應用程式庫 (Applibs) 連線到網際網路。
驗證方法
支援下列驗證方法：
- WPA2
- EAP-TLS
- 開啟 (沒有密碼)
為 Wi-Fi 設定 Azure 球體
您可以設定 Azure 球體裝置，從命令列 (CLI) 或使用 Azure 球體 SDK 應用程式庫 (應用程式) 連線到 Wi-Fi 網路。
使用 CLI Wi-Fi 設定
若要從命令列管理 Wi-Fi 設定，請使用 az 球形裝置 wifi CLI 命令。 例如， 裝置 wifi [新增 ] 命令會將無線網路的詳細資料新增至裝置。
az sphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"
若要使用設定的 Wi-Fi 網路，必須使用 wlan0) (網路介面。 使用 裝置網路清單介面 命令來判斷介面是否為使用中。
az sphere device network list-interfaces
如有需要，請使用 裝置網路啟用 命令來啟用它。
az sphere device network enable --interface wlan0
若要啟用設定的 Wi-Fi 網路，請使用 裝置 wifi 啟用 命令。
az sphere device wifi enable --id <network id>
在 Azure 球體裝置上設定 Wi-Fi 主題說明如何從命令列在 Azure 球體裝置上設定 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", ¤tInterfaceStatus);
若要啟用網路介面，請使用 Networking_SetInterfaceState 函數。
Networking_SetInterfaceState("wlan0", true);
注意
如果網路介面 (wlan0 和 eth0) 都處於作用中且已連線，則裝置用於通訊的特定介面是非不確定的。 如果您想要在任何指定時間控制要使用哪一個網路介面，您的應用程式必須使用 Networking_SetInterfaceState () 函數明確地開啟所要的介面，並關閉其他介面。 DHCP 用戶端高階應用程式範例示範如何將代表兩個介面之一的值指派給全域變數，藉此在介面之間切換。
若要從應用程式啟用已設定 Wi-Fi 網路，請使用 WifiConfig_SetNetworkEnabled 函數。
WifiConfig_SetNetworkEnabled(<network id>, true);
如需使用 Applibs wificonfig API 讓客戶為合併 Azure 球體的產品設定 Wi-Fi 的建議，請參閱在 欄位中 設定 Wi-Fi。
在 應用程式中設定 EAP-TLS 網路 主題說明如何在高階 Azure 球體應用程式中設定 EAP-TLS 網路。
樣品
本節包含示範在 Azure 球體平臺上使用 Wi-Fi 功能的範例應用程式連結。
WiFi_HighLevelApp範例示範在高階應用程式中設定 Wi-Fi 網路。
DHCP 用戶端高層級應用程式示範如何更新或釋出網路 DHCP 伺服器已指派給 MT3620 裝置的目前 IP 位址。
注意
下列範例來自 Azure 球體圖庫，這是來自 Microsoft 的未相關軟體和硬體範例集合。 如需詳細資訊，請參閱 Azure 球體圖庫。
WifiConfigurationViaAppResource範例示範如何使用內嵌 JSON 資源檔案設定裝置 Wi-Fi 設定。
WifiConfigurationViaNfc範例示範如何使用 NFC 設定裝置 Wi-Fi 設定。
WifiConfigurationViaUart範例示範如何使用 UART 設定裝置 Wi-Fi 設定。