Azure Sphere verbinden met Wi-Fi

U kunt een Azure Sphere-apparaat configureren om verbinding te maken met internet via Wi-Fi met behulp van de CLI of de Azure Sphere SDK-toepassingsbibliotheken (Applibs).

Verificatiemethoden

De volgende verificatiemethoden worden ondersteund:

• WPA2
• EAP-TLS
• openen (geen wachtwoord)

Azure Sphere configureren voor Wi-Fi

U kunt uw Azure Sphere-apparaat configureren om verbinding te maken met een Wi-Fi-netwerk vanaf de opdrachtregel (CLI) of vanuit uw toepassing met behulp van de Azure Sphere SDK-toepassingsbibliotheken (Applibs).

Wi-Fi configuratie met behulp van de CLI

Als u Wi-Fi configuratie vanaf de opdrachtregel wilt beheren, gebruikt u de opdrachten az sphere device wifi CLI. De opdracht wifi toevoegen van het apparaat voegt bijvoorbeeld de details van een draadloos netwerk toe aan het apparaat.

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

Als u het geconfigureerde Wi-Fi netwerk wilt gebruiken, moet de netwerkinterface (wlan0) actief zijn. Gebruik de opdracht network list-interfaces van het apparaat om te bepalen of de interface actief is.

az sphere device network list-interfaces

Gebruik de opdracht apparaatnetwerk inschakelen om deze indien nodig te activeren.

az sphere device network enable --interface wlan0

Als u het geconfigureerde Wi-Fi netwerk wilt inschakelen, gebruikt u de opdracht wifi inschakelen van het apparaat.

az sphere device wifi enable --id <network id>

In het snelstartonderwerp Wi-Fi instellen op uw Azure Sphere-apparaat wordt beschreven hoe u Wi-Fi configureert op uw Azure Sphere-apparaat vanaf de opdrachtregel.

Als u EAP-TLS-verificatie gebruikt, raadpleegt u EAP-TLS-netwerk instellen vanuit CLI.

Wi-Fi configuratie met behulp van Applibs

Als u Wi-Fi wilt configureren, moet uw toepassing de api applibs wificonfig gebruiken.

Neem dit headerbestand op in uw toepassing:

#include <applibs/wificonfig.h>

Het toepassingsmanifest moet de mogelijkheid WifiConfig bevatten.

 "Capabilities": {
  "WifiConfig" : true
}

Gebruik de functie Networking_GetInterfaceConnectionStatus om te bepalen of de netwerkinterface actief is.

Networking_GetInterfaceConnectionStatus("wlan0", &currentInterfaceStatus);

Gebruik de functie Networking_SetInterfaceState om de netwerkinterface te activeren.

Networking_SetInterfaceState("wlan0", true);

Opmerking

Als beide netwerkinterfaces (wlan0 en eth0) actief en verbonden zijn, is de specifieke interface die het apparaat gebruikt voor communicatie niet-deterministisch. Als u wilt bepalen welke netwerkinterface op een bepaald moment wordt gebruikt, moet uw toepassing de functie Networking_SetInterfaceState() gebruiken om de gewenste interface expliciet in te schakelen en de andere interface uit te schakelen. Het voorbeeld van een dhcp-client-app op hoog niveau laat onder andere zien hoe u kunt schakelen tussen interfaces door een waarde toe te wijzen die een van de twee interfaces vertegenwoordigt aan een globale variabele.

Als u een geconfigureerd Wi-Fi netwerk vanuit uw toepassing wilt inschakelen, gebruikt u de functie WifiConfig_SetNetworkEnabled .

WifiConfig_SetNetworkEnabled(<network id>, true);

Zie Wi-Fi configureren in het veld voor suggesties voor het gebruik van de Applibs wificonfig-API om uw klanten in staat te stellen Wi-Fi te configureren voor uw producten die Azure Sphere bevatten.

In het onderwerp EAP-TLS-netwerk instellen in een app wordt beschreven hoe u een EAP-TLS-netwerk configureert in een Azure Sphere-toepassing op hoog niveau.

Monsters

Deze sectie bevat koppelingen naar voorbeeldtoepassingen die het gebruik van Wi-Fi functionaliteit op het Azure Sphere-platform demonstreren.

In het voorbeeld van WiFi_HighLevelApp ziet u het configureren van Wi-Fi netwerken in een toepassing op hoog niveau.

De dhcp-client-app op hoog niveau laat zien hoe u het huidige IP-adres kunt vernieuwen of vrijgeven dat de DHCP-server van het netwerk heeft toegewezen aan het MT3620-apparaat.

Opmerking

De volgende voorbeelden zijn afkomstig uit de Azure Sphere Gallery, een verzameling niet-onderhouden software- en hardwarevoorbeelden van Microsoft. Zie Azure Sphere Gallery voor meer informatie.

Het voorbeeld wifiConfigurationViaAppResource laat zien hoe u apparaatinstellingen Wi-Fi configureert met behulp van een ingesloten JSON-resourcebestand.

In het voorbeeld WifiConfigurationViaNfc ziet u hoe u apparaatinstellingen Wi-Fi configureert met behulp van NFC.

Het voorbeeld WifiConfigurationViaUart laat zien hoe u apparaatinstellingen Wi-Fi configureert met behulp van UART.