Risolvere i problemi di Azure Sphere

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).

Ecco alcuni passaggi per la risoluzione dei problemi che possono verificarsi durante l'installazione e l'installazione.

Problemi di comunicazione dei dispositivi

Un errore di connessione al dispositivo da un computer host può verificarsi per molti motivi e può attivare uno dei diversi messaggi di errore, a seconda degli strumenti o delle applicazioni che lo rilevano. I messaggi di errore seguenti possono indicare una connessione non riuscita:

• An error occurred. Please check your device is connected and your PC has been configured correctly, then retry.
• Could not connect to the device. Check if your device is connected to the PC. The device may be unresponsive if it is applying an Azure Sphere operating system update; wait a few minutes and then retry. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.
• An unexpected issue occurred. Please try again; if the issue persists, please refer to aka.ms/azurespheresupport for troubleshooting suggestions and support.
• Failed to retrieve device ID from attached device: 'Could not connect to the device; please ensure it is attached.'
• Failed to establish communication with device after recovery.

Esistono tre componenti che possono causare problemi di comunicazione dei dispositivi: (1) l'interfaccia della riga di comando stessa; (2) il servizio di comunicazione dei dispositivi (DCS) che facilita la comunicazione con un dispositivo; e (3) il dispositivo.

Per isolare la causa, seguire questa procedura di diagnostica:

1. Verificare che sia possibile comunicare direttamente con il dispositivo. Passare a https://192.168.35.2/status in un Web browser. Ignorare e ignorare eventuali avvisi SSL presentati. L'output dovrebbe essere simile a: {"uptime":56} nella finestra del Web browser.

Nota

È anche possibile eseguire questo passaggio dalla riga di comando usando curl https://192.168.35.2/status --insecure.

Nota

È anche possibile eseguire questo passaggio da PowerShell (v6 o versione successiva). Invoke-WebRequest https://192.168.35.2/status -SkipCertificateCheck

2. Verificare che il servizio di comunicazione del dispositivo abbia rilevato un dispositivo. Passare a http://localhost:48938/api/service/devices in un Web browser e verificare che almeno un dispositivo sia visualizzato nell'output JSON.

Avviso

Il controller di dominio Linux è incluso solo nell'SDK versione 23.05 e successive. Seguire la procedura di risoluzione dei problemi legacy per SDK versioni 22.11 e precedenti.

Nota

È anche possibile eseguire questo passaggio da PowerShell tramite Invoke-WebRequest http://localhost:48938/api/service/devices.

Non è stato possibile comunicare direttamente con il dispositivo e il dispositivo non è stato rilevato dal controller di dominio

Se non è stato possibile stabilire una connessione con il dispositivo (passaggio 1) e il dispositivo non può essere rilevato dal controller di dominio (passaggio 2), è probabile che si verifichi un problema con la configurazione del dispositivo fisico.

In primo luogo, verificare che il dispositivo sia stato rilevato dal computer.

Da un terminale:

1. Eseguire sudo lsusb. Verificare che nell'output venga visualizzato Future Technology Devices International, Ltd FT4232H Quad HS USB-UART/FIFO IC .

Uso di una finestra di PowerShell:

1. Eseguire Get-PnpDevice -PresentOnly | Where-Object { $_. InstanceId -match '^USB' }. Verificare che l'interfaccia STD DI MSFT MT3620 venga visualizzata nell'output.

Se il comando precedente non restituisce l'output previsto, connettere il dispositivo a una porta USB diversa. Se il problema persiste, verificare che i jumper del dispositivo siano configurati correttamente. Ad esempio, i kit di sviluppo Seeed MT3620 vengono distribuiti dalla fabbrica con un connettore a ponticello sui pin 2 e 3 di J3, che alimenta l'orologio dall'alimentatore principale. Verificare che il connettore non sia stato spostato o rimosso.

Impossibile comunicare direttamente con il dispositivo, ma il dispositivo viene rilevato dal controller di dominio

Se non è stato possibile stabilire una connessione con il dispositivo (passaggio 1), ma il dispositivo è stato rilevato dal controller di dominio (passaggio 2), è probabile che il dispositivo o il servizio di comunicazione del dispositivo sia in uno stato non valido.

Se è stato appena connesso un dispositivo a Internet e il sistema operativo del dispositivo non è aggiornato, il dispositivo potrebbe applicare un aggiornamento del sistema operativo. È anche possibile che il dispositivo stia prendendo un aggiornamento del sistema operativo se il tempo coincide con una finestra di rilascio. Durante un aggiornamento del sistema operativo, non sarà possibile comunicare con un dispositivo.

Se si sospetta che il dispositivo sia aggiornato e/o che non sia connesso a Internet, l'opzione migliore successiva consiste nello scollegare e riconnettere il dispositivo al PC. In questo modo, dcs rinnova la connessione al dispositivo e il dispositivo viene reimpostato su uno stato iniziale.

Se non è possibile scollegare e riconnettere il dispositivo, l'opzione migliore successiva consiste nel riavviare il controller di dominio. Da un terminale:

1. Eseguire sudo azspheredctl restart. Verificare che il comando venga completato correttamente.
   1. Se il comando non riesce, eseguire sudo systemctl restart azsphered.

Se non è possibile scollegare e riconnettere il dispositivo, l'opzione migliore successiva consiste nel rilasciare un comando di ripetizione dell'analisi per il controller di dominio. Dopo aver ricevuto questo comando, dcs ciclo e reimposta il chip di interfaccia FTDI usato per comunicare con MT3620. Uso di una finestra di PowerShell:

1. Eseguire azsphere device rescan-attached

Eseguire di nuovo il comando che si è tentato inizialmente. Se il problema non viene ancora risolto, l'opzione migliore successiva consiste nel provare a riavviare il controller di dominio. Da una finestra di PowerShell a livello di amministratore:

1. Eseguire Restart-Service -Name AzureSphereDeviceCommunicationService. Verificare che il comando venga completato correttamente.

In alternativa, riavviare dcs usando un'interfaccia utente grafica.

1. Premere Start e immettere Servizi. Fare clic con il pulsante destro del mouse sul servizio di comunicazione dei dispositivi di Azure Sphere e scegliere Riavvia.

Eseguire di nuovo il comando che si è tentato inizialmente.

Se il comando continua ad avere esito negativo o azsphere device list-attached ha un output simile al seguente:

1 device attached:
--> Device ID: Cannot get device ID
  --> Is responsive: no
  --> IP address: 192.168.35.2
  --> Connection path: 213

Eseguire azsphere device recover

Può comunicare direttamente con il dispositivo e il dispositivo viene rilevato dal controller di dominio

Questo probabilmente indica un problema con l'interfaccia della riga di comando. Assicurarsi di avere la versione più recente dell'SDK.

Se si ha la versione più recente dell'SDK e il problema non è ancora risolto, pubblicare una domanda al forum di domande e risposte.

Connessioni eliminate o dispositivi mancanti

Se il computer riesce a connettersi al dispositivo Azure Sphere ma la connessione si interrompe spesso, può essersi verificato un conflitto nella subnet IP.

Azure Sphere usa la subnet 192.168.35.*. Se è presente altro software che usa questa stessa subnet, disabilitare tale software oppure limitare l'intervallo di indirizzi IP che usa. Attualmente non è possibile cambiare l'intervallo di indirizzi IP usato da Azure Sphere.

Impossibile applicare le funzionalità del dispositivo

Se si ricevono errori quando si tenta di applicare una funzionalità di dispositivo a un dispositivo Azure Sphere, il problema potrebbe essere che il sistema operativo nel dispositivo non è aggiornato. Questo problema può verificarsi se il dispositivo è stato offline per un periodo prolungato, durante il quale Microsoft ha aggiornato le chiavi interne. Gli errori seguenti sono sintomi di questo problema:

I comandi azsphere device enable-development o azsphere device enable-cloud-test restituiscono un errore simile al seguente:

error: The device did not accept the device capability configuration. Please check the Azure Sphere OS on your device is up-to-date using 'azsphere device show-deployment-status'.

Il comando azsphere device capability update restituisce un errore simile al seguente:

error: Could not apply device capability configuration to device.

Ciò è dovuto all'archivio chiavi attendibile nel dispositivo non aggiornato. Per risolvere questo problema, seguire le istruzioni riportate qui.

Errore durante la creazione di quattro convertitori seriali USB

Dopo aver configurato una scheda di sviluppo MT3620, verranno visualizzati quattro convertitori seriali USB in Gestione dispositivi. Se vengono visualizzati meno di quattro, potrebbe verificarsi un problema con il driver FTDI.

Nota

Se questa scheda è stata usata in precedenza per lo sviluppo rtapp, è possibile che vengano visualizzati tre convertitori anziché quattro. È normale e non rappresenta un errore.

Se il driver FTDI non è installato correttamente, i convertitori potrebbero apparire nella posizione errata, ad esempio Altri dispositivi o potrebbero non essere visualizzati affatto.

Per risolvere questo problema:

1. Per aprire Gestione dispositivi, fare clic su Start e immettere Gestione dispositivi.

2. In Controller del bus seriale universale selezionare Convertitore seriale USB A. Fare clic con il pulsante destro del mouse sul nome, selezionare Disinstalla dispositivo ed eliminare il driver, se specificato:

   

   Ripetere questo passaggio per il convertitore seriale USB B tramite USB Serial Converter D.

3. Scollegare la scheda di sviluppo dal PC e ricollegarla. Dovrebbe essere visualizzato il dispositivo "MSFT MT3620 Std Interface" con un'icona di avviso triangolare, che indica che non sono disponibili driver.

4. Fare clic con il pulsante destro del mouse su uno dei dispositivi MSFT MT3620 Std Interface e scegliere Aggiorna driver. Scegliere Cerca automaticamente il software driver aggiornato. L'aggiornamento di uno dovrebbe correggerli tutti. Ora dovrebbero essere visualizzati quattro convertitori seriali USB nella sezione Controller del bus seriale universale. Se non vengono visualizzati tutti e quattro i convertitori, ripetere questo passaggio per ogni convertitore.

Errore di installazione dei driver FTDI

I driver FTDI devono essere scaricati e installati automaticamente da Windows quando il dispositivo Azure Sphere è collegato per la prima volta al PC. Se i driver sono installati correttamente, verranno visualizzati quattro convertitori seriali USB elencati in Controller del bus seriale universale in Gestione dispositivi, come descritto in Configurare il kit di sviluppo.

Windows 10, versione 2004, non cerca i driver. In questo caso, i driver non vengono scaricati e installati automaticamente e verranno visualizzati gli elementi seguenti elencati in Gestione dispositivi:

Per installare i driver, scaricare manualmente i driver da Future Technology Devices International (FTDI). Scegliere il driver adatto alla versione di Windows (32 o 64 bit).

Per le date di disponibilità e i numeri di build delle versioni di Windows 10, vedi Informazioni sulla versione di Windows 10. Queste informazioni consentono di determinare se la versione di Windows 10 è precedente o successiva alla versione 2004.

Problemi di connessione causati dalla configurazione della scheda TAP-Windows

Gli strumenti di Azure Sphere comunicano con le schede di sviluppo collegate tramite una rete IP su USB. Per questo motivo è necessario l'adattatore TAP-Windows di OpenVPN Technologies. La procedura di installazione di Azure Sphere SDK installa questo adattatore nel PC se non è già presente.

Sono stati segnalati due tipi distinti di problemi con l'adattatore TAP-Windows:

• Se è già installata una versione diversa della scheda TAP-Windows o se il dispositivo Azure Sphere non è connesso alla prima istanza della scheda TAP-Windows, gli strumenti di Azure Sphere potrebbero non riuscire a connettersi al dispositivo.

• Se si usa la rete privata virtuale Cisco AnyConnect (VPN), la scheda TAP-Windows potrebbe apparire scollegata e la comunicazione del dispositivo potrebbe non funzionare. Ciò è dovuto al fatto che la VPN può reindirizzare il traffico lontano dall'indirizzo IP dell'adattatore TAP.

Verificare che il dispositivo Azure Sphere sia connesso all'adattatore TAP-Windows appropriato

Per verificare se il problema è legato all'adattatore TAP, stabilire prima di tutto quanti adattatori TAP sono installati nel PC e poi modificare l'installazione se necessario.

Per stabilire quanti adattatori TAP sono installati nel PC:

1. Aprire Impostazioni di Windows e selezionare il gruppo Rete e Internet .

2. In Impostazioni di rete avanzate selezionare Cambia opzioni scheda. Verrà visualizzato un solo adattatore TAP, come illustrato nello screenshot seguente:

   

   Se vengono visualizzati più adattatori TAP oppure se ne viene visualizzato uno solo ma non è denominato Azure Sphere, seguire questa procedura per disinstallare tutti gli adattatori TAP e reinstallare l'SDK. Se non vengono visualizzati adattatori TAP, reinstallare l'SDK.

Per disinstallare gli adattatori TAP:

1. Fare clic su Start e immettere Gestione dispositivi.

2. In Gestione dispositivi aprire Schede di rete e selezionare Scheda TAP-Windows:

   

3. Fare clic con il pulsante destro del mouse sulla scheda TAP-Windows e scegliere Disinstalla dispositivo. Nella finestra di dialogo selezionare Elimina il software driver per questo dispositivo, quindi fare clic su Disinstalla.

4. Aprire un prompt dei comandi come amministratore ed eseguire lo script del comando di installazione di PowerShell seguente:

    powershell -ExecutionPolicy RemoteSigned -File "%ProgramData%\Microsoft\Azure Sphere\TapDriverInstaller\TapDriverInstaller.ps1" Install
   

5. Se l'installazione riesce, riavviare il servizio di comunicazione del dispositivo Azure Sphere:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

6. Reinstallare Azure Sphere SDK.

Correggere lo stato scollegato quando si usa il client VPN Cisco AnyConnect

Quando si usa il client VPN Cisco AnyConnect, l'adattatore TAP-Windows potrebbe apparire scollegato e la comunicazione del dispositivo potrebbe non funzionare. È possibile risolvere il problema nel modo seguente:

1. Assicurarsi di disporre dei privilegi di amministratore nel computer.

2. Aprire Impostazioni di Windows e selezionare il gruppo Rete e Internet .

3. In Impostazioni di rete avanzate selezionare Cambia opzioni scheda.

4. Fare clic con il pulsante destro del mouse su Azure Sphere TAP-Windows Adapter V9 e scegliere Proprietà.

5. Nella scheda Rete individuare la voce Cisco AnyConnect Network Access Manager Filter Driver e deselezionare l'elemento.

   

6. Selezionare OK per salvare l'impostazione e uscire dalle proprietà.

7. Verificare che la comunicazione con il dispositivo Azure Sphere funzioni ora aprendo un prompt dei comandi e immettendo il azsphere device show-attached comando.

Il dispositivo non risponde

Uno o più errori tra quelli elencati di seguito, generati da un comando azsphere, potrebbero indicare che non è stato possibile avviare il servizio di comunicazione del dispositivo di Azure Sphere:

• warn: Device is not responding. Could not perform version check.​
• Device is not responding. Cannot get device ID.​
• error: Could not connect to the Azure Sphere Device Communication Service. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.​
• error: The device is not responding. The device may be unresponsive if it is applying an Azure Sphere operating system update; please retry in a few minutes.

Assicurarsi di aver eseguito i passaggi per la risoluzione dei problemi di comunicazione dei dispositivi.

Se il problema non è ancora stato risolto e il computer ha recentemente eseguito un aggiornamento di Windows, il servizio di comunicazione del dispositivo potrebbe non essere avviato dopo l'aggiornamento di Windows e nei casi in cui uno dei file di impostazioni JSON interni o del file di configurazione è danneggiato.

Errore dopo l'aggiornamento di Windows

Questi errori possono verificarsi dopo l'aggiornamento di Windows nel PC. A volte Windows Update disinstalla i driver FTDI necessari per il servizio di comunicazione.

Per risolvere il problema:

1. Scollegare il dispositivo Azure Sphere da USB e ricollegarlo. Quando si ricollega il dispositivo, dovrebbero reinstallarsi i driver corretti.
2. Se con lo scollegamento e il ricollegamento del dispositivo non si riesce a risolvere il problema, disinstallare e reinstallare Azure Sphere SDK.

File JSON

Se Windows non è stato aggiornato di recente, l'errore potrebbe essere causato dal file restore.json usato per il servizio.

Per risolvere questo problema:

1. Salvare una copia del file seguente:

   c:\windows\serviceprofiles\localservice\appdata\local\Azure Sphere Tools\restore.json

2. Eliminare il file dal percorso originale.

3. Arrestare e quindi riavviare il servizio di comunicazione del dispositivo di Azure Sphere:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

File di configurazione danneggiato

Se viene segnalato un errore quando si tenta di eseguire un comando, il file di configurazione danneggiato potrebbe impedire l'esecuzione corretta del dispositivo.

Per risolvere questo problema, eliminare il file di configurazione danneggiato che si trova in .azsphere\config in Windows o ~/.azsphere/config in Linux.

Windows si arresta in modo anomalo quando si collega o si scollega un dispositivo

La scheda per sviluppatori MT3620 ha un chip FTDI (Future Technology Devices International FT4232HQ), che facilita la comunicazione tra il dispositivo e il PC. Il driver FTDI ufficiale, Modello di driver combinato (CMD), contiene due driver: uno fornisce l'accesso tramite l'API D2XX e l'altro fornisce una porta VCP (Virtual Com Port) per lo stesso dispositivo. Entrambi i driver vengono installati per impostazione predefinita se il chip FTDI ha la modalità VCP abilitata. Questo può causare un arresto anomalo di Windows quando il chip viene alimentato.

Per risolvere questo problema, è possibile disabilitare la modalità VCP per il chip FTDI. È necessario usare lo strumento FT_PROG per riprogrammare la EEPROM del chip FTDI.

1. Per informazioni su come scaricare e installare questo strumento, vedere FTDI FT_PROG strumento di programmazione.

2. Eseguire FT_PROG e trovare il dispositivo collegato, come descritto in FT_PROG'applicazione GUI.

3. Nella visualizzazione Albero dei dispositivi espandere la sezione Hardware Specifico . Dovrebbero essere visualizzate quattro porte.

   

4. Selezionare Porta A e scegliere D2XX Direct invece della porta COM virtuale.

   

5. Ripetere il passaggio precedente per la porta C e la porta D. La porta B deve essere già in modalità D2XX Direct.

6. Selezionare l'icona Dispositivi programma (simile a un fulmine) per attivare la modalità di programmazione.

   

7. Selezionare Programma per programmare EEPROM, quindi attendere il completamento.

   

8. Scollegare il dispositivo dalla porta USB, quindi riconnetterlo al ciclo di alimentazione del dispositivo e rendere effettiva la modifica. In Windows Gestione dispositivi la sezione Porte (COM & LPT) dovrebbe ora mostrare tre porte COM minori. Il numero di dispositivi universali del bus seriale deve rimanere invariato.

Connessione persa ai dispositivi FTDI non Azure Sphere dopo l'abilitazione del debug RTApp

Alcuni utenti di Azure Sphere hanno segnalato che non possono più comunicare con altri dispositivi FTDI non Azure Sphere collegati dopo aver usato il comando azsphere device enable-development --enable-rt-core-debugging per sviluppare ed eseguire il debug di applicazioni RTApp dal PC host.

Ad esempio, se si dispone di un dispositivo Azure Sphere e di un dispositivo FTDI diverso collegato al PC, potrebbero essere visualizzati due controller seriali universali denominati convertitore seriale USB B in Windows Gestione dispositivi prima di eseguire il comando.

Dopo l'esecuzione del comando, entrambi i dispositivi USB Serial Converter B scompaiono dalla sezione Controller del bus seriale universale e due nuovi dispositivi vengono visualizzati nei dispositivi universali del bus seriale visualizzati in Gestione dispositivi.

Causa

Questo problema si verifica perché il comando azsphere device enable-development --enable-rt-core-debugging installa un nuovo driver per la porta B del chip FTDI nel chip MT3620, quindi la porta diventa MSFT MT3620 Std Interface. Tuttavia, l'installazione di questo driver modifica inavvertitamente il driver per la porta B dell'altro dispositivo non Azure Sphere. A causa di una limitazione nella libreria sottostante, tutti i dispositivi FTDI con lo stesso VID (0x0403) e PID (0x6011) avranno il driver della porta B sostituito.

Soluzione

Seguire questa procedura per ripristinare manualmente il driver per qualsiasi dispositivo non Azure Sphere alla versione precedente:

1. In Gestione dispositivi selezionare il dispositivo non Azure Sphere (Un altro dispositivo FTDI Quad GZ nell'esempio), quindi fare clic con il pulsante destro del mouse e selezionare Aggiorna driver.

2. In Aggiorna driver selezionare Sfoglia il computer per il software driver.

   

3. Selezionare Let me pick from a list of available drivers on my computer (Consenti selezione da un elenco di driver disponibili nel computer).

   

4. Selezionare driver B del convertitore seriale USB nell'elenco, quindi fare clic su Avanti.

   

5. Fare clic su Chiudi nella finestra di conferma.

6. Gestione dispositivi dovrebbe mostrare la porta B per l'altro dispositivo FTDI come convertitore seriale USB B, che indica che usa il driver FTDI ufficiale. Il driver per MT3620 rimane MSFT MT3620 Std Interface.

   

Informazioni aggiuntive

• Se si collega un altro nuovo dispositivo FTDI non Azure Sphere dopo aver eseguito il comando azsphere device enable-development --enable-rt-core-debugging , a tale dispositivo verrà assegnato il driver MT3620 di Azure Sphere nello stesso modo. Ripetere i passaggi precedenti per ripristinare il dispositivo al driver FTDI ufficiale.

• Se si scollega e si ricollega un dispositivo FTDI non Azure Sphere dopo averlo restituito al driver FTDI ufficiale, il dispositivo manterrà il driver FTDI ufficiale.

• Se si esegue di nuovo il comando azsphere device enable-development --enable-rt-core-debugging dopo aver ripristinato il driver, il dispositivo FTDI non Azure Sphere avrà nuovamente il driver sostituito e sarà necessario seguire la procedura descritta in Soluzione per ripristinare il driver FTDI ufficiale. Ciò si verifica indipendentemente dal fatto che il dispositivo FTDI non Azure Sphere sia collegato al PC quando viene eseguito il comando azsphere device enable-development --enable-rt-core-debugging .

Comandi non riconosciuti

Se viene visualizzato l'errore seguente quando si immette un comando azsphere, assicurarsi di usare PowerShell o un prompt dei comandi standard in Windows.

'azsphere' is not recognized as an internal or external command, operable program or batch file.

Il programma di installazione si blocca al 60%

Il programma di installazione si blocca al 60%, e viene indicato che il servizio di comunicazione del dispositivo non è stato avviato. Ciò si verifica in genere quando l'installazione del driver TAP non riesce in modo strano, lasciando il sistema in uno stato indeterminato.

Verificare che il problema sia il driver TAP

1. Aprire il Visualizzatore eventi di Windows per controllare i log.

2. Cercare il log applicazioni e il log del servizio di comunicazione del dispositivo di Azure Sphere per il messaggio di errore seguente:

   "SerialSlipToTun.TunInterfaceSetupException: Errore di accesso alle impostazioni del Registro di sistema ---> System.Collections.Generic.KeyNotFoundException: dispositivo di tocco Tun non trovato ---> System.Security.SecurityException: l'accesso al Registro di sistema richiesto non è consentito."

   

3. Quando si controlla il log applicazioni, filtrare il log per evitare di visualizzare i numerosi messaggi non correlati. Nella scheda Azione selezionare Filtra log corrente.

4. Selezionare Errore, quindi selezionare AzureSphereDeviceCommunicationService per elencare solo i messaggi di errore del servizio di comunicazione dei dispositivi di Azure Sphere.

   

5. Se non è possibile trovare l'errore nel log applicazioni o nel log del servizio di comunicazione dei dispositivi di Azure Sphere, potrebbe non trattarsi di un problema del driver TAP.

Per risolvere il problema del driver TAP, seguire questa procedura:

1. Passare al Centro connessioni di rete e condivisione e selezionare Modifica impostazioni scheda.

   

2. In Connessioni di rete in Azure Sphere selezionare TAP-WIndows Adapter V9 e aprire le relative proprietà.

   

3. In Proprietà di Azure Sphere selezionare Protocollo Internet versione 4 (TCP/IPv4), quindi selezionare Proprietà per visualizzare le impostazioni del protocollo.

   

4. Assicurarsi che l'indirizzo IP sia impostato su 192.168.35.1 e che la subnet mask sia impostata su 255.255.255.0.

5. Riprovare il programma di installazione. Se si blocca ancora, provare a reimpostare le connessioni di rete. Per eseguire una reimpostazione, passare a Impostazioni>Rete e stato Internet>e selezionare Reimpostazione rete nella parte inferiore della pagina.

   Importante

   La reimpostazione della rete reimposta tutte le impostazioni di rete.

Arrestare il servizio di comunicazione dei dispositivi di Azure Sphere

Se il programma di installazione si blocca, è possibile arrestare il servizio di comunicazione dei dispositivi di Azure Sphere usando il comando taskkill .

Seguire questa procedura:

1. Copiare il PID per AzureSphereDeviceCommunicationService.

   • Passare alla scheda Servizi di>Gestione attività e annotare il PID per il servizio AzureSphereDeviceCommunicationService o
   • Nella riga di comando digitare tasklist /fi "SERVICES eq AzureSphereDeviceCommunicationService*" e copiare il PID dall'output.

2. Digitare quanto segue nella riga di comando per terminare il servizio. Il comando taskkill termina il processo che corrisponde al numero ID del processo. L'opzione /f viene usata per terminare forzatamente il processo.

   taskkill /PID <DCS_PID> /f

3. Riprovare il programma di installazione.

Impossibile arrestare il servizio di comunicazione dei dispositivi di Azure Sphere

Quando si aggiorna un SDK di Azure Sphere esistente, potrebbe essere visualizzato un messaggio che indica che non è stato possibile arrestare il servizio "Servizio di comunicazione del dispositivo Azure Sphere" (AzureSphereDeviceCommunicationService). Verificare di disporre di privilegi sufficienti per arrestare i servizi di sistema." Se viene visualizzato questo messaggio, riavviare ed eseguire di nuovo il programma di installazione.

La comunicazione del dispositivo viene interrotta quando viene usato split tunneling

Quando un computer di sviluppo è connesso alla VPN aziendale e il split tunneling è disabilitato dalla configurazione VPN, il computer di sviluppo potrebbe non essere in grado di comunicare con il dispositivo Azure Sphere.

Per risolvere il problema, eseguire una delle operazioni seguenti:

• Disconnettersi dalla VPN aziendale e provare di nuovo la connessione al dispositivo Azure Sphere.
• Modificare la configurazione VPN per consentire il split tunneling.

I problemi di comunicazione possono anche essere causati dalla configurazione della scheda TAP-Windows. Vedere la sezione Problemi di connessione causati dalla risoluzione dei problemi di configurazione della scheda TAP-Windows.

Impossibile installare o disinstallare Azure Sphere SDK in Windows 11

Dopo l'aggiornamento a Windows 11, gli utenti non sono in grado di installare o disinstallare Azure Sphere SDK. Per risolvere questo problema, installare la versione più recente di Azure Sphere SDK per Windows. Dopo l'installazione dell'aggiornamento 21.07 2 o versione successiva, sarà possibile disinstallare l'SDK.

Non è possibile compilare o sottoporre a debug le applicazioni RTApp

Se CMake segnala errori durante la ricerca di toolchain o openocd quando si tenta di compilare o eseguire il debug di un'applicazione RTApp, assicurarsi di:

• È stata installata la toolchain GNU Arm Embedded per l'ambiente di sviluppo.
• È stato specificato il percorso corretto di openocd come descritto in Esercitazione: Creare un'applicazione con funzionalità in tempo reale.

Risoluzione dei problemi di comunicazione dei dispositivi pre-23.05

Avviso

Questi passaggi sono destinati agli utenti con SDK versione 22.11 o precedente. Verificare che la versione dell'SDK installata sia 22.11 o precedente eseguendo azsphere show-version.

Nei sistemi Linux che eseguono SDK versione 22.11 o precedente, lo script azsphere_connect.sh deve essere eseguito ogni volta che si collega il dispositivo o si scollega o si scollega. Lo script aggiorna le connessioni del dispositivo e genera un driver kernel che esegue il mapping del traffico di rete al dispositivo.

Se si verificano problemi di comunicazione, iniziare con questi passaggi di base:

1. Assicurarsi che il dispositivo sia connesso tramite USB.

2. Eseguire lo script azsphere_connect.sh , se non è già stato fatto.

3. Verificare che sia possibile comunicare direttamente con il dispositivo. Passare a https://192.168.35.2/status in un Web browser. Ignorare e ignorare eventuali avvisi SSL presentati. L'output dovrebbe essere simile a: {"uptime":56} nella finestra del Web browser.

Nota

È anche possibile eseguire questo passaggio dalla riga di comando usando curl https://192.168.35.2/status --insecure.

1. Se l'errore persiste, scollegare il dispositivo dalla porta USB, collegarlo di nuovo e attendere il riavvio. Eseguire quindi lo script di azsphere_connect.sh .

2. Se l'errore persiste, verificare che non ci siano conflitti di subnet con altri strumenti di rete.