Condividi tramite

Connettere Azure Sphere a Wi-Fi

  • Articolo

È possibile configurare un dispositivo Azure Sphere per la connessione a Internet tramite Wi-Fi utilizzando le librerie di applicazioni CLI o Azure Sphere SDK (Applibs).

Metodi di autenticazione

Sono supportati i metodi di autenticazione seguenti:

  • WPA2
  • EAP-TLS
  • apri (nessuna password)

Configurare Azure Sphere per Wi-Fi

Puoi configurare il dispositivo Azure Sphere per la connessione a una rete Wi-Fi dalla riga di comando (CLI) o dalla tua applicazione utilizzando le librerie di applicazioni azure sphere SDK (Applibs).

Wi-Fi configurazione utilizzando la configurazione CLI

Per gestire Wi-Fi configurazione dalla riga di comando, utilizzare i comandi wifi CLI del dispositivo az sphere. Ad esempio, il comando di aggiunta wi-fi del dispositivo aggiunge i dettagli di una rete wireless al dispositivo.


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

Per usare la rete Wi-Fi configurata, l'interfaccia di rete (wlan0) deve essere attiva. Utilizza il comando elenco-interfacce di rete del dispositivo per determinare se l'interfaccia è attiva.


az sphere device network list-interfaces

Usa il comando di abilitazione alla rete del dispositivo per attivarlo, se necessario.


az sphere device network enable --interface wlan0

Per abilitare la rete Wi-Fi configurata, utilizzare il comando di abilitazione Wifi dispositivo .


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

L'argomento Guida introduttiva Configurare Wi-Fi nel dispositivo Azure Sphere descrive come configurare Wi-Fi nel dispositivo Azure Sphere dalla riga di comando.

In alternativa, se si usa l'autenticazione EAP-TLS, vedere Configurare la rete EAP-TLS da CLI.

Wi-Fi configurazione utilizzando le applicazioni

Per configurare il Wi-Fi, l'applicazione deve utilizzare l'API wificonfig applicatabs.

Includere questo file di intestazione nell'applicazione:

#include <applibs/wificonfig.h>

Il manifesto dell'applicazione deve includere la funzionalità WifiConfig .

 "Capabilities": {
  "WifiConfig" : true
}

Per determinare se l'interfaccia di rete è attiva, usare la funzione Networking_GetInterfaceConnectionStatus .

Networking_GetInterfaceConnectionStatus("wlan0", &currentInterfaceStatus);

Per attivare l'interfaccia di rete, usare la funzione Networking_SetInterfaceState .

Networking_SetInterfaceState("wlan0", true);

Nota

Se entrambe le interfacce di rete (wlan0 ed eth0) sono attive e connesse, l'interfaccia specifica che il dispositivo utilizzerà per la comunicazione non è deterministica. Se si vuole controllare quale interfaccia di rete viene usata in un determinato momento, l'applicazione deve usare la funzione Networking_SetInterfaceState() per attivare in modo esplicito l'interfaccia desiderata e l'altra disattivarla. L'esempio di app di alto livello per il client DHCP mostra, tra le altre cose, come passare da un'interfaccia all'altra assegnando un valore che rappresenta una delle due interfacce a una variabile globale.

Per abilitare una rete Wi-Fi configurata dall'applicazione, usare la funzione WifiConfig_SetNetworkEnabled .

WifiConfig_SetNetworkEnabled(<network id>, true);

Vedi Configurare Wi-Fi nel campo per suggerimenti sull'uso dell'API Applibs wificonfig per consentire ai clienti di configurare Wi-Fi per i prodotti che incorporano Azure Sphere.

L'argomento Configurare la rete EAP-TLS in un'app descrive come configurare una rete EAP-TLS in un'applicazione Azure Sphere di alto livello.

Campioni

Questa sezione contiene collegamenti ad applicazioni di esempio che dimostrano l'uso delle funzionalità di Wi-Fi sulla piattaforma Azure Sphere.

Nell'esempio WiFi_HighLevelApp viene illustrato come configurare Wi-Fi reti in un'applicazione di alto livello.

L'app di alto livello client DHCP mostra come rinnovare o rilasciare l'indirizzo IP corrente assegnato dal server DHCP della rete al dispositivo MT3620.

Nota

I seguenti esempi provengono dalla Raccolta sfere di Azure, che è una raccolta di campioni hardware e software non mantenuti di Microsoft. Per ulteriori informazioni, vedi Raccolta sfere di Azure.

Nell'esempio WifiConfigurationViaAppResource viene illustrato come configurare le impostazioni di Wi-Fi dispositivo utilizzando un file di risorse JSON incorporato.

Nell'esempio WifiConfigurationViaNfc viene illustrato come configurare le impostazioni di Wi-Fi del dispositivo tramite NFC.

Nell'esempio WifiConfigurationViaUart viene illustrato come configurare le impostazioni di Wi-Fi del dispositivo tramite UART.