Łączenie usługi Azure Sphere z Wi-Fi
Możesz skonfigurować urządzenie Azure Sphere w celu łączenia się z Internetem za pośrednictwem Wi-Fi za pomocą interfejsu cli lub bibliotek aplikacji SDK platformy Azure Sphere (Applibs).
Metody uwierzytelniania
Obsługiwane są następujące metody uwierzytelniania:
- WPA2
- EAP-TLS
- open (bez hasła)
Konfigurowanie usługi Azure Sphere dla Wi-Fi
Możesz skonfigurować urządzenie Azure Sphere tak, aby łączyło się z siecią Wi-Fi z wiersza polecenia (CLI) lub aplikacji przy użyciu bibliotek aplikacji azure Sphere SDK ( Applibs).
Wi-Fi konfiguracji przy użyciu interfejsu
Aby zarządzać konfiguracją Wi-Fi z poziomu wiersza polecenia, użyj poleceń interfejsu CLI urządzenia az sphere. Na przykład polecenie dodaj urządzenie wifi dodaje szczegóły sieci bezprzewodowej do urządzenia.
az sphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"
Aby można było korzystać ze skonfigurowanej sieci Wi-Fi, interfejs sieciowy (wlan0) musi być aktywny. Aby ustalić, czy interfejs jest aktywny, użyj polecenia Interfejsy listy sieci urządzenia .
az sphere device network list-interfaces
Użyj polecenia Włącz sieć urządzenia , aby w razie potrzeby go aktywować.
az sphere device network enable --interface wlan0
Aby włączyć skonfigurowaną sieć Wi-Fi, użyj polecenia włącz wi-fi urządzenia .
az sphere device wifi enable --id <network id>
W temacie Szybki start Konfigurowanie Wi-Fi na urządzeniu Azure Sphere opisano sposób konfigurowania Wi-Fi na urządzeniu Azure Sphere z wiersza polecenia.
Jeśli używasz uwierzytelniania EAP-TLS, zobacz Konfigurowanie sieci EAP-TLS z poziomu interfejsu cli.
Wi-Fi konfiguracji przy użyciu aplikacji Applibs
Aby skonfigurować sieć Wi-Fi, aplikacja musi korzystać z interfejsu API wificonfig.
Uwzględnij ten plik nagłówka w aplikacji:
#include <applibs/wificonfig.h>
Manifest aplikacji musi zawierać funkcję WifiConfig.
"Capabilities": {
"WifiConfig" : true
}
Aby ustalić, czy interfejs sieci jest aktywny, użyj funkcji Networking_GetInterfaceConnectionStatus .
Networking_GetInterfaceConnectionStatus("wlan0", ¤tInterfaceStatus);
Aby aktywować interfejs sieciowym, użyj funkcji Networking_SetInterfaceState .
Networking_SetInterfaceState("wlan0", true);
Uwaga
Jeśli oba interfejsy sieciowe (wlan0 i eth0) są aktywne i połączone, konkretny interfejs używany przez urządzenie do komunikacji nie jest deterministyczny. Jeśli chcesz kontrolować, który interfejs sieciowy jest używany w danej chwili, aplikacja musi używać funkcji Networking_SetInterfaceState(), aby jawnie włączyć i wyłączyć odpowiedni interfejs. W przykładzie aplikacji klienta DHCP na wysokim poziomie pokazano między innymi, jak przełączać się między interfejsami, przypisując wartość reprezentującą jeden z dwóch interfejsów do zmiennej globalnej.
Aby włączyć skonfigurowaną sieć Wi-Fi z aplikacji, użyj funkcji WifiConfig_SetNetworkEnabled .
WifiConfig_SetNetworkEnabled(<network id>, true);
Zobacz Konfigurowanie Wi-Fi w polu , aby uzyskać sugestie dotyczące korzystania z interfejsu API wificonfig Applibs, aby umożliwić klientom skonfigurowanie Wi-Fi dla produktów, które zawierają usługę Azure Sphere.
W temacie Konfigurowanie sieci EAP-TLS w aplikacji opisano sposób konfigurowania sieci EAP-TLS w aplikacji Azure Sphere wysokiego poziomu.
Próbki
Ta sekcja zawiera linki do przykładowych aplikacji, które przedstawiają korzystanie z funkcji Wi-Fi na platformie Azure Sphere.
Przykład WiFi_HighLevelApp pokazuje konfigurowanie sieci Wi-Fi w aplikacji wysokiego poziomu.
Aplikacja wysokiego poziomu klienta DHCP pokazuje, jak odnowić lub zwolnić bieżący adres IP przypisany do urządzenia MT3620 przez serwer DHCP sieci.
Uwaga
Poniższe przykłady pochodzą z galerii Azure Sphere Gallery, która jest kolekcją nieupoczętowanych próbek oprogramowania i sprzętu firmy Microsoft. Aby uzyskać więcej informacji, zobacz Azure Sphere Gallery.
W przykładzie wifiConfigurationViaAppResource pokazano, jak skonfigurować ustawienia Wi-Fi urządzenia przy użyciu osadzonego pliku zasobów JSON.
W przykładzie wifiConfigurationViaNfc pokazano, jak skonfigurować ustawienia urządzenia Wi-Fi przy użyciu nfc.
W przykładzie wifiConfigurationViaUart pokazano, jak skonfigurować ustawienia Wi-Fi urządzenia przy użyciu UART.