Guida introduttiva: Configurare la rete e aggiornare il sistema operativo del dispositivo
Importante
Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).
Dopo aver eseguito la richiesta di diritti dal dispositivo Azure Sphere, configurarlo per la rete in modo che possa ricevere aggiornamenti cloud dal servizio di sicurezza di Azure Sphere e comunicare con i servizi, ad esempio con un hub IoT di Azure. Dopo aver configurato e abilitato la rete, il dispositivo può ricevere un aggiornamento del sistema operativo dal cloud.
Importante
Questo argomento descrive come connettere il dispositivo Azure Sphere a una rete Wi-Fi. 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.
Prerequisiti
- Installare Visual Studio Code per Windows o per Linux.
- Installare l'SDK per Windows o per Linux
- Guida introduttiva: Scegliere un tenant e richiedere il dispositivo
Configurare il Wi-Fi sul dispositivo Azure Sphere
Seguire questa procedura per configurare il Wi-Fi nel dispositivo Azure Sphere:
Connettere il dispositivo Azure Sphere al computer.
Aprire un'interfaccia della riga di comando usando PowerShell, il prompt dei comandi di Windows o la shell dei comandi linux.
Registrare l'indirizzo MAC del dispositivo se l'ambiente di rete lo richiede. Usare il comando seguente per ottenere l'indirizzo MAC e quindi registrarlo secondo la procedura per l'ambiente in uso:
azsphere device wifi show-status
Aggiungere la rete Wi-Fi nel dispositivo usando il comando azsphere device wifi add come segue:
azsphere device wifi add --ssid <SSID> --psk <EXAMPLEPSK>
Sostituire <SSID> con il nome della rete. I SSID distinguono tra maiuscole e minuscole. Se il SSID è nascosto, aggiungere
--targeted-scan
per provare comunque a connettersi. È possibile usare azsphere device wifi scan per ottenere un elenco di reti Wi-Fi disponibili.Sostituire <EXAMPLEPSK> con la chiave WPA/WPA2. I dispositivi Azure Sphere non supportano WEP. Per aggiungere una rete aperta, omettere
--psk
.Se l'SSID o la chiave di rete ha spazi incorporati o una e commerciale, racchiudere il SSID o la chiave tra virgolette singole. Se l'SSID o la chiave includono una virgoletta, usare una barra rovesciata per annullare le virgolette. Le barre rovesciate non devono essere precedute da un carattere di escape se fanno parte di un valore. Per altre informazioni, vedere Virgolette e caratteri di escape. Ad esempio:
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.
Usare il comando azsphere device wifi show-status per controllare lo stato della connessione:
azsphere device wifi show-status
Durante l'aggiornamento, il comando azsphere device wifi show-status potrebbe evidenziare temporaneamente uno stato di configurazione sconosciuto. Nell'esempio seguente mostra risultati corretti per una connessione sicura WPA2:
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- ----------------- SSID ConfigurationState ConnectionState SecurityState Frequency Mode KeyManagement WpaState IpAddress MacAddress =============================================================================================================================== <value> enabled connected psk 2412 station WPA2-PSK COMPLETED <value> <value> ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
Il comando azsphere device wifi supporta diverse opzioni aggiuntive. Digitare azsphere device wifi per un elenco completo oppure azsphere device wifi opzione --help per ottenere assistenza su un'opzione specifica.
Seguire questa procedura per configurare il Wi-Fi nel dispositivo Azure Sphere:
Connettere il dispositivo Azure Sphere al computer.
Espandere il nodo Dispositivo per il dispositivo a cui si è interessati.
Espandere il nodo Wi-Fi. Verrà visualizzata una schermata simile alla seguente:
Espandere il nodo con etichetta Disconnected (Disconnesso ) e dovrebbe essere visualizzato l'indirizzo MAC del dispositivo. Registrare l'indirizzo MAC del dispositivo se l'ambiente di rete lo richiede. Prendere nota del pulsante di aggiornamento a destra; sarà necessario per visualizzare le informazioni di connettività dopo la connessione a una rete.
Espandere il nodo Reti disponibili , se possibile. Passare il puntatore del mouse sulla rete a cui ci si vuole connettere e selezionare Connetti (questo viene visualizzato come + a destra del nodo). Se la rete richiede una chiave precondivisa (psk), digitare la password di rete nella casella di testo visualizzata e premere INVIO.
Tornare al nodo etichettato in precedenza Disconnesso, che dovrebbe ora leggere Connesso a: <rete>. Se viene ancora visualizzato Disconnesso dopo alcuni istanti, fare clic sul pulsante Aggiorna in questo nodo per visualizzare lo stato di connessione aggiornato del dispositivo.
Verranno visualizzate le informazioni seguenti:
- SSID
- Stato di configurazione
- Stato connessione
- Stato di sicurezza
- Frequenza
- Modalità
- Tipo di gestione delle chiavi
- Stato WPA
- Indirizzo IP
- Indirizzo MAC
Si tratta delle stesse informazioni segnalate dal comando dell'interfaccia della riga di comando azsphere device wifi show-status.
Dovrebbe essere visualizzata anche la rete a cui si è connessi nel nodo Reti salvate.
Seguire questa procedura per configurare il Wi-Fi nel dispositivo Azure Sphere:
Connettere il dispositivo Azure Sphere al computer.
Espandere il nodo Dispositivo per il dispositivo a cui si è interessati.
Espandere il nodo Wi-Fi. Verrà visualizzata una schermata simile alla seguente:
Espandere il nodo con etichetta Disconnected (Disconnesso ) e dovrebbe essere visualizzato l'indirizzo MAC del dispositivo. Registrare l'indirizzo MAC del dispositivo se l'ambiente di rete lo richiede. Prendere nota del pulsante di aggiornamento a destra; sarà necessario per visualizzare le informazioni di connettività dopo la connessione a una rete.
Espandere il nodo reti disponibili, se possibile. Fare clic con il pulsante destro del mouse sulla rete a cui connettersi e scegliere Connetti. Se la rete richiede una chiave precondivisa (PSK), digitare la password di rete nella casella di testo PSK e premere INVIO.
Tornare al nodo etichettato in precedenza Disconnesso, che dovrebbe ora leggere Connesso a: <rete>. Se viene ancora visualizzato Disconnesso dopo alcuni istanti, fare clic sul pulsante Aggiorna in questo nodo per visualizzare lo stato di connessione aggiornato del dispositivo.
Verranno visualizzate le informazioni seguenti:
- Indirizzo IP
- Stato di sicurezza
- Indirizzo MAC
- Stato WPA
- Modalità
- Frequenza
- Tipo di gestione delle chiavi
- Indica se è stata usata un'analisi mirata
Si tratta delle stesse informazioni segnalate dal comando dell'interfaccia della riga di comando azsphere device wifi show-status.
Dovrebbe essere visualizzata anche la rete a cui si è connessi nel nodo Reti salvate.
Abilitare o disabilitare le reti Wi-Fi
È possibile abilitare una rete Wi-Fi configurata usando il comando azsphere device wifi enable :
azsphere device wifi enable --id <ID>
Sostituire <ID con l'ID> della rete, che può essere ottenuto chiamando azsphere device wifi list.
È possibile disabilitare una rete Wi-Fi configurata usando il comando azsphere device wifi disable come indicato di seguito:
azsphere device wifi disable --id <ID>
Sostituire <ID con l'ID> della rete, che può essere ottenuto chiamando azsphere device wifi list.
Per abilitare una rete Wi-Fi configurata in Azure Sphere Explorer di Visual Studio Code:
Espandere il nodo Reti salvate.
Trovare una rete disabilitata; questi avranno un simbolo Wi-Fi a destra dei loro nomi.
Selezionare il simbolo Wi-Fi oppure fare clic con il pulsante destro del mouse sul nome della rete e quindi scegliere Abilita.
Per disabilitare una rete Wi-Fi configurata in Azure Sphere Explorer di Visual Studio Code:
Espandere il nodo Reti salvate.
Trovare una rete abilitata; questi avranno un simbolo Wi-Fi con una barra rovesciata attraverso di esso a destra dei loro nomi.
Selezionare il simbolo Wi-Fi disabilitato oppure fare clic con il pulsante destro del mouse sul nome della rete e quindi scegliere Disabilita.
Per abilitare una rete Wi-Fi configurata in Azure Sphere Explorer di Visual Studio:
Espandere il nodo Reti salvate.
Trovare una rete disabilitata; questi avranno un simbolo di connessione a destra dei nomi.
Selezionare il simbolo di connessione oppure fare clic con il pulsante destro del mouse sul nome della rete e quindi scegliere Abilita.
Per disabilitare una rete Wi-Fi configurata in Azure Sphere Explorer di Visual Studio Code:
Espandere il nodo Reti salvate.
Trovare una rete abilitata; questi avranno un simbolo di disconnessione a destra dei nomi.
Selezionare il simbolo di disconnessione oppure fare clic con il pulsante destro del mouse sul nome della rete e quindi scegliere Disabilita.
Dimenticare una rete Wi-Fi
È possibile dimenticare una rete Wi-Fi configurata usando il comando azsphere device wifi forget :
azsphere device wifi forget --id <ID>
Sostituire <ID con l'ID> della rete, che può essere ottenuto chiamando azsphere device wifi list.
Per dimenticare una rete Wi-Fi configurata in Azure Sphere Explorer di Visual Studio Code:
- Espandere il nodo Reti salvate.
- Fare clic con il pulsante destro del mouse sulla rete da dimenticare e quindi scegliere Dimentica.
Per dimenticare una rete Wi-Fi configurata in Azure Sphere Explorer di Visual Studio:
- Espandere il nodo Reti salvate.
- Fare clic con il pulsante destro del mouse sulla rete da dimenticare e quindi scegliere Dimentica.
Ricevere gli aggiornamenti del dispositivo
Il dispositivo Azure Sphere verifica la presenza di aggiornamenti del sistema operativo Azure Sphere e dell'applicazione a ogni avvio, durante la connessione iniziale a Internet e, successivamente, ogni 24 ore. Se sono disponibili aggiornamenti, il download e l'installazione possono richiedere fino a 15-20 minuti e potrebbero causare il riavvio del dispositivo.
Per controllare lo stato degli aggiornamenti, digitare il comando seguente:
azsphere device show-deployment-status
Se si dispone di un kit di sviluppo Seeed MT3620 precedente, può essere necessario aggiornarlo manualmente, come descritto in Aggiornare il sistema operativo in un kit di sviluppo precedente.
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.
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. 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.