Configurare le impostazioni di reteConfigure networking

Dopo aver eseguito la richiesta di diritti dal dispositivo Azure Sphere, configurarlo per la rete in modo che possa ricevere aggiornamenti over-the-air (OTA) dal servizio di sicurezza di Azure Sphere e comunicare con i servizi, ad esempio con un hub IoT di Azure.After you claim your Azure Sphere device, configure it for networking so that it can receive over-the-air (OTA) updates from the Azure Sphere Security Service and communicate with services such as an Azure IoT Hub.

Prima di poter configurare la rete, è necessario:Before you can configure networking, you must:

Importante

Questo argomento descrive come connettere il dispositivo Azure Sphere a una rete Wi-Fi.This topic describes how to connect your Azure Sphere device to a Wi-Fi network. Se il dispositivo supporta un meccanismo di connessione in rete diverso e non supporta il Wi-Fi, connetterlo a Internet usando tale meccanismo e proseguire con Ricevere gli aggiornamenti del dispositivo.If your device supports a different networking mechanism and does not support Wi-Fi, connect it to the internet using that mechanism and proceed to Receive device update.

Configurare il Wi-Fi sul dispositivo Azure SphereSet up Wi-Fi on your Azure Sphere device

Seguire questa procedura per configurare il Wi-Fi nel dispositivo Azure Sphere:Follow these steps to configure Wi-Fi on your Azure Sphere device:

  1. Connettere la scheda Azure Sphere al computer tramite USB.Connect your Azure Sphere board to your PC over USB.

  2. Aprire un prompt dei comandi per gli sviluppatori di Azure Sphere.Open an Azure Sphere Developer Command Prompt.

  3. Registrare l'indirizzo MAC del dispositivo se l'ambiente di rete lo richiede.Register the device's MAC address if your network environment requires it. Usare il comando seguente per ottenere l'indirizzo MAC e quindi registrarlo secondo la procedura per l'ambiente in uso:Use the following command to get the MAC address, and then register it according to the procedure for your environment:

    azsphere device wifi show-status

  4. Aggiungere la rete Wi-Fi nel dispositivo usando il comando azsphere device wifi add come segue:Add your Wi-Fi network to the device by using the azsphere device wifi add command as follows:

    azsphere device wifi add --ssid <yourSSID> --psk <yourNetworkKey>

    Sostituire <yourSSID> con il nome della rete.Replace <yourSSID> with the name of your network. I SSID distinguono tra maiuscole e minuscole.Network SSIDs are case-sensitive. Se il SSID è nascosto, aggiungere --targeted-scan per provare comunque a connettersi.If the SSID is hidden, add --targeted-scan to try to connect to it anyway. È possibile usare azsphere device wifi scan per ottenere un elenco di reti Wi-Fi disponibili.You can use azsphere device wifi scan to get a list of available Wi-Fi networks.

    Sostituire <yourNetworkKey> con la chiave WPA/WPA2.Replace <yourNetworkKey> with your WPA/WPA2 key. I dispositivi Azure Sphere non supportano WEP.Azure Sphere devices do not support WEP. Per aggiungere una rete aperta, omettere --psk.To add an open network, omit --psk.

    Se l’SSID o la chiave di rete includono spazi, racchiudere l’SSID o la chiave tra virgolette.If your network SSID or key has embedded spaces, enclose the SSID or key in quotation marks. Se l’SSID o la chiave includono una virgoletta, usare una barra rovesciata per annullare le virgolette.If the SSID or key includes a quotation mark, use a backslash to escape the quotation mark. Le barre rovesciate non richiedono l'annullamento se fanno parte di un valore.Backslashes do not require escape if they are part of a value. Ad esempio:For example:

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

    La preparazione delle reti nella scheda in genere richiede diversi secondi, ma potrebbe richiedere più tempo, a seconda dell'ambiente di rete.It typically takes several seconds for networking to be ready on the board, but might take longer, depending on your network environment.

Nota

Il dispositivo Azure Sphere verifica la presenza di aggiornamenti software a ogni avvio, durante la connessione iniziale a Internet e, successivamente, ogni 24 ore.The Azure Sphere device checks for software updates each time it boots, when it initially connects to the internet, and at 24-hour intervals thereafter. Se è disponibile un aggiornamento del sistema operativo Azure Sphere, il download e l'installazione possono richiedere fino a 15 minuti e potrebbero causare il riavvio del dispositivo.If an Azure Sphere OS update is available, download and installation could take as much as 15 minutes and might cause the device to restart.

  1. Usare il comando azsphere device wifi show-status per controllare lo stato della connessione.Use the azsphere device wifi show-status command to check the status of the connection. Durante l'aggiornamento, il comando azsphere device wifi show-status potrebbe evidenziare temporaneamente uno stato di configurazione sconosciuto.During update, the azsphere device wifi show-status command may temporarily show an unknown configuration state. Nell'esempio seguente mostra risultati corretti per una connessione sicura WPA2:The following example shows successful results for a secure WPA2 connection:

    azsphere device wifi show-status
    
    SSID : NETGEAR21  
    Configuration state : enabled  
    Connection state : connected  
    Security state : psk  
    Frequency : 2442  
    Mode : station  
    Key management : WPA2-PSK  
    WPA State : COMPLETED  
    IP Address : 192.168.1.15  
    MAC Address : 52:cf:ff:3a:76:1b
    Command completed successfully in 00:00:01.3976308.
    

Il comando azsphere device wifi supporta diverse opzioni aggiuntive.The azsphere device wifi command supports several additional options. Digitare azsphere device wifi per un elenco completo, oppure azsphere device wifi option --help per ottenere assistenza su un’opzione specifica.Type azsphere device wifi for a complete list, or azsphere device wifi option --help for help on an individual option.

Se si verificano problemi di Wi-Fi, assicurarsi che la rete Wi-Fi utilizzi 802.11b/g/n; i dispositivi Azure Sphere non supportano 802.11a.If you encounter Wi-Fi problems, first ensure that your Wi-Fi network uses 802.11b/g/n; Azure Sphere devices do not support 802.11a.

Ricevere gli aggiornamenti del dispositivoReceive device update

Quando la connessione di rete è inizialmente disponibile, il dispositivo verifica la presenza di aggiornamenti over-the-air (OTA) per il sistema operativo Azure Sphere e per l'applicazione corrente (se presente).When networking initially becomes available, the device checks for over-the-air (OTA) updates for the Azure Sphere operating system (OS) and the current application (if one exists). Se sono disponibili aggiornamenti, il download viene completato entro 15-20 minuti.If updates are available, download should complete within 15-20 minutes.

Per controllare lo stato di aggiornamento, digitare il comando seguente in un prompt dei comandi per gli sviluppatori di Azure Sphere:To check on update status, type the following command in an Azure Sphere Developer Command Prompt:

azsphere device show-ota-status

Nota

L’aggiornamento del sistema operativo di Azure Sphere è un processo in più fasi che richiede meno di 15 minuti, ma può richiedere più tempo a seconda la connettività Internet.Azure Sphere OS update is a staged process over a period that may be less than 15 minutes but can be longer depending on the internet connectivity. Nel corso delle fasi, la scheda può essere utilizzata durante il download del successivo gruppo di aggiornamenti, ma durante l'aggiornamento la scheda potrebbe non rispondere per diversi minuti.Between stages, the board will appear functional while the next group of updates is downloaded, but during the update you should expect the board to be unresponsive for several minutes at a time.

Passaggi successiviNext Steps