Risolvere i problemi di Azure SphereTroubleshoot Azure Sphere issues

In questo argomento vengono illustrati i passaggi per la risoluzione dei problemi seguenti:This topic provides troubleshooting steps for the following types of problems:

Problemi generali di connessione del dispositivoGeneral device connection problems

Un errore di connessione al dispositivo da un computer host può verificarsi per diversi motivi e può attivare uno dei diversi messaggi di errore, a seconda di quali strumenti o applicazioni si verificano.A failure to connect to the device from a host machine can occur for many reasons and may trigger any of several error messages, depending on which tools or applications encounter it. I messaggi di errore seguenti possono indicare una connessione non riuscita:The following error messages may indicate a failed connection:

  • 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 problem 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.

L'errore di connessione può verificarsi per uno di questi motivi:Failure to connect may occur for any of these reasons:

  • La lavagna non è connessa tramite USB al computer host.The board is not connected by USB to the host machine.

  • La scheda non è alimentata.The board is not powered.

  • Il dispositivo è attualmente occupato con l'applicazione di un aggiornamento del sistema operativo Azure Sphere.The device is currently busy applying an Azure Sphere OS update. Durante gli aggiornamenti del sistema operativo, il dispositivo potrebbe non rispondere.During OS updates, the device may fail to respond.

Per diagnosticare e risolvere il problema, iniziare con questi passaggi di base:To diagnose and resolve the problem, start with these basic steps:

  1. Verificare che il dispositivo sia connesso tramite USB al computer host.Ensure that the device is connected by USB to the host machine.

  2. Attendere qualche minuto.Wait a few minutes. Se l'aggiornamento del sistema operativo è in corso, il dispositivo torna nuovamente attivo al termine dell'aggiornamento.If OS update is progress, the device should again become responsive when the update completes.

  3. Se il dispositivo è connesso, premere il pulsante Reimposta sul dispositivo oppure disconnettersi e riconnettere il cavo USB.If the device is connected, press the Reset button on the device or disconnect and reconnect the USB cable. Attendere circa 10 secondi che venga riavviato il dispositivo e quindi provare a eseguire di nuovo il comando non riuscito.Wait ten seconds or so for the device to restart, and then try the failed command again.

  4. In Windows eseguire il comando azsphere Device Rescan-Attached .On Windows, run the azsphere device rescan-attached command. Questo comando esegue il ciclo di FTDI delle porte di tutti i dispositivi collegati e talvolta può aiutare a risolvere i problemi di connessione.This command power-cycles the FTDI ports of all attached devices and can sometimes help in connection issues.

Se nessuno di questi passaggi risolve il problema, vedere problemi specifici di Windows o problemi specifici di Linux per determinare se il problema potrebbe essere univoco per la piattaforma.If none of these steps solves the problem, see Windows-specific problems or Linux-specific problems to determine whether the issue might be unique to your platform.

Il dispositivo non rispondeDevice is unresponsive

Se il dispositivo viene visualizzato come "inattivo" o non risponde, il problema potrebbe essere la mancanza di potenza.If the device appears "dead" or unresponsive, the problem could be a lack of power.

Assicurarsi che l'orologio in tempo reale sia alimentato, tramite l'alimentatore da 3,3 V principale o una batteria a bottone.Make sure that the real-time clock (RTC) is powered, by either the main 3V3 power supply or a coin cell battery. Se il kit di sviluppo è compatibile con la scheda di sviluppo di riferimento MT3620, vedere il Manuale utente della scheda di sviluppo MT3620.If your dev kit is compatible with the MT3620 reference development board (RDB), see the MT3620 development board user guide for details. Se si usa un kit di sviluppo diverso, vedere la documentazione del produttore.If you're using a different dev kit, see the manufacturer's documentation.

Assicurarsi inoltre che la scheda stessa sia configurata correttamente.In addition, make sure that the board itself is properly configured. 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.For example, Seeed MT3620 Development Kits are shipped from the factory with a jumper header across pins 2 and 3 of J3, which powers the clock from the main power supply. Verificare che il connettore non sia stato spostato o rimosso.Check that the header has not been dislodged or removed.

Errori USBUSB errors

Se si verificano errori relativi a USB:If you encounter USB errors:

  1. Collegare il dispositivo a una porta USB diversa.Plug the device into a different USB port. Se l'errore si verifica quando il dispositivo è collegato a un hub USB, collegarlo invece a una porta del computer.If the error occurred when the device was plugged into a USB hub, plug it into a port on the machine instead.

  2. Se il problema si ripresenta, collegare il dispositivo a un hub USB alimentato.If the problem recurs, plug the device into a powered USB hub. In alcuni casi, le porte USB non forniscono la potenza necessaria per la scheda, per cui un hub può risolvere tale problema.In some cases, USB ports do not provide adequate power for the board, so a powered hub may solve the problem.

Connessioni eliminate o dispositivi mancantiDropped connections or missing devices

Se il computer riesce a connettersi al dispositivo Azure Sphere ma la connessione si interrompe spesso, può essersi verificato un conflitto nella subnet IP.If your computer can connect to the Azure Sphere device, but often drops the connection, you may have a conflict in the IP subnet.

Azure Sphere usa la subnet 192.168.35.*.Azure Sphere uses 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.If you have other software that uses the same subnet, either disable that software or limit the range of IP addresses that it uses. Attualmente non è possibile cambiare l'intervallo di indirizzi IP usato da Azure Sphere.Currently, you cannot change the range of IP addresses that Azure Sphere uses.

Se la subnet non è il problema, è possibile che si verifichi un problema correlato al driver FTDI usato in Windows.If the subnet is not the problem, you may have a problem related to the FTDI driver used on Windows. Problemi relativi ai driver possono causare la scomparsa saltuaria delle connessioni da PC a dispositivo oppure impedire al comando azsphere di trovare tutti i dispositivi collegati.Driver issues can cause PC-to-device connections to disappear intermittently, or can prevent the azsphere command from finding all attached devices. Eseguire il comando azsphere Device Rescan-Attached per eseguire il ciclo di FTDI delle porte di tutti i dispositivi collegati.Run the azsphere device rescan-attached command to power-cycle the FTDI ports of all attached devices.

Non è possibile applicare le funzionalità del dispositivoCannot apply device capabilities

Se vengono visualizzati errori quando si tenta di applicare una funzionalità del dispositivo a un dispositivo Azure Sphere, il problema potrebbe essere che il sistema operativo del dispositivo non è aggiornato.If you receive errors when you try to apply a device capability to an Azure Sphere device, the problem might be that the OS on your device is out of date. Questo problema può verificarsi se il dispositivo è stato offline per un periodo di tempo prolungato durante il quale Microsoft ha aggiornato le proprie chiavi interne.This problem can occur if the device has been offline for an extended period, during which Microsoft updated its internal keys. I seguenti errori sono sintomi di questo problema:The following errors are symptoms of this problem:

Il comando Enable-Development o azsphere Device Capability Update del dispositivo azsphere restituisce un errore simile al seguente:The azsphere device enable-development or azsphere device capability update command returns an error similar to the following:

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 download--Apply della funzionalità del dispositivo azsphere restituisce un errore simile al seguente:The azsphere device capability download --apply command returns an error similar to the following:

error: Could not apply device capability configuration to device.

Per risolvere il problema:To solve this problem:

Dopo che il dispositivo è stato aggiornato al sistema operativo più recente, sarà ancora possibile scaricare e applicare le funzionalità.After your device has updated to the latest OS, you should once again be able to download and apply capabilities.

Se non è possibile eseguire correttamente i passaggi per connettere il dispositivo a Internet:If you cannot successfully perform the steps to connect the device to the internet:

Problemi specifici di WindowsWindows-specific problems

Oltre ai problemi elencati nei problemi di connessione del dispositivo, è possibile che si verifichi un errore di connessione in Windows per i motivi seguenti:In addition to the issues listed in Device connection problems, failure to connect on Windows may occur for any of these reasons:

  • Il servizio di comunicazione del dispositivo Azure Sphere non è ancora avviato.The Azure Sphere Device Communication Service has not yet started.
  • L'adattatore TAP-Windows non è installato o non è configurato correttamente.The TAP-Windows adapter is not installed or is not configured correctly.

Per risolvere il problema da Windows, iniziare con questi passaggi di base:To resolve the problem from Windows, start with these basic steps:

  1. Verificare che il dispositivo sia connesso al PC tramite USB e disponga di energia.Make sure the device is connected to the PC by USB and has power.

  2. Riavviare il servizio di comunicazione del dispositivo di Azure Sphere.Restart the Azure Sphere Device Communication Service. Premere Start e digitare Services.Press Start and type Services. Fare clic con il pulsante destro del mouse su Azure Sphere Device Communication Service e scegliere Riavvia.Right-click the Azure Sphere Device Communication Service and select Restart.

  3. Se l'errore si ripete dopo il riavvio del servizio, utilizzare il pannello di controllo Visualizza connessioni di rete per verificare che la scheda esista e che sia configurata per l'utilizzo dell'indirizzo IP 192.168.35.1.If the error recurs after you restart the service, use the View Network Connections control panel to check that the adapter exists and is configured to use IP address 192.168.35.1. Per accedere a questo pannello di controllo, premere il pulsante Start e digitare "ncpa.cpl".To access this control panel, press Start and type "ncpa.cpl". Fare clic con il pulsante destro del mouse sul dispositivo Azure Sphere per visualizzarne le proprietà.Right-click on the Azure Sphere device to view its properties. Se Azure Sphere non è visibile o non ha l'indirizzo IP corretto, reinstallare Azure Sphere SDK.If Azure Sphere is not visible or does not have the correct IP address, reinstall the Azure Sphere SDK.

  4. Se il dispositivo è connesso, premere il pulsante Reimposta sul dispositivo.If the device is connected, press the Reset button on the device. Attendere circa 10 secondi che venga riavviato il dispositivo e quindi provare a eseguire di nuovo il comando non riuscito.Wait ten seconds or so for the device to restart, and then try the failed command again.

  5. Se l'errore si ripete, scollegare il dispositivo dalla porta USB, inserirlo nuovamente e attendere il riavvio.If the error recurs, unplug the device from the USB port, plug it in again, and wait for it to restart.

Se nessuno di questi passaggi risolve il problema, provare le soluzioni aggiuntive seguenti.If none of these steps solves the problem, try the additional solutions that follow.

Errore durante la creazione di quattro convertitori seriali USBFailure to create four USB serial converters

Dopo aver configurato una lavagna di sviluppo MT3620, verranno visualizzati quattro convertitori di serie USB in Gestione dispositivi.After you set up an MT3620 development board, you should see four USB serial converters in Device Manager. Se vengono visualizzati meno di quattro, è possibile che si verifichi un problema con il driver FTDI.If you see fewer than four, you may have a problem with the FTDI driver.

Nota

Se questa bacheca è stata usata in precedenza per lo sviluppo di RTApp, è possibile che vengano visualizzati tre convertitori anziché quattro.If this board has previously been used for RTApp development, you may see three converters instead of four. Si tratta di una situazione normale e non rappresenta un errore.This is normal and does not represent an error.

Se il driver FTDI non è installato correttamente, i convertitori potrebbero essere visualizzati nel percorso errato, ad esempio altri dispositivi, o potrebbero non essere visualizzati.If the FTDI driver is not correctly installed, the converters might appear in the wrong location, such as Other devices, or might not appear at all.

Per risolvere questo problema:To resolve this problem:

  1. Aprire Gestione dispositivi facendo clic Start e digitando "Gestione dispositivi".Open Device Manager by clicking Start and typing "Device Manager."

  2. In Controller USB (Universal Serial Bus) selezionare "USB Serial Converter A" (Convertitore seriale USB A).Under Universal Serial Bus controllers, select "USB Serial Converter A." Fare clic con il pulsante destro del mouse sul nome, scegliere Disinstalla dispositivo ed eliminare il driver se viene offerta la possibilità:Right-click the name, select Uninstall Device, and delete the driver if given the option:

    Disinstallare il dispositivo ed eliminare il driver

    Ripetere questo passaggio per i convertitori seriali USB da B a D.Repeat this step for "USB Serial Converter B" through "USB Serial Converter D."

  3. Scollegare la scheda di sviluppo dal PC e ricollegarla.Unplug your development board from your PC and plug it back in again. Dovrebbe essere visualizzato il dispositivo "MSFT MT3620 Std Interface" con un'icona di avviso triangolare, che indica che non sono disponibili driver."MSFT MT3620 Std Interface" should appear with a triangle warning icon, which indicates no driver is available.

  4. Fare clic con il pulsante destro del mouse su uno dei dispositivi "MSFT MT3620 Std Interface" e scegliere Aggiorna driver.Right-click on one of the "MSFT MT3620 Std Interface" devices and select Update driver. Scegliere "Cerca automaticamente un driver aggiornato".Choose "Search automatically for updated driver software." Con un aggiornamento dovrebbero essere corretti tutti.Updating one should fix them all. Verranno ora visualizzati quattro convertitori di serie USB nella sezione Universal Serial Bus Controllers.You should now see four USB serial converters in the Universal Serial Bus controllers section. Se non vengono visualizzati tutti e quattro i convertitori, ripetere questo passaggio per ogni convertitore.If all four converters do not appear, repeat this step for each converter.

Errore di installazione dei driver FTDIFailure to install FTDI drivers

I driver FTDI devono essere scaricati e installati automaticamente da Windows quando il dispositivo Azure Sphere viene collegato per la prima volta al computer.The FTDI drivers should be downloaded and installed automatically by Windows when your Azure Sphere device is first plugged in to your PC. Se i driver sono installati correttamente, verranno visualizzati quattro convertitori di serie USB elencati sotto i controller del bus seriale universale in Gestione dispositivi, come descritto in configurare il kit di sviluppo.If the drivers are installed correctly, you will see four USB Serial Converters listed under Universal Serial Bus controllers in Device Manager, as described in Set up your dev kit.

Windows 10, versione 2004, non cerca i driver.Windows 10, version 2004, does not search for the drivers. In questo caso, i driver non vengono scaricati e installati automaticamente e gli elementi seguenti verranno elencati in Gestione dispositivi:In this case, the drivers are not downloaded and installed automatically and you will see the following items listed in Device Manager:

MT3620 elementi elencati in Gestione dispositivi

Per installare i driver, scaricare manualmente il file eseguibile di installazione da FTDI ed eseguirlo.To install the drivers, manually download the setup executable from FTDI and run it.

Per le date di disponibilità e i numeri di build delle versioni di Windows 10, vedere informazioni sulla versione di Windows 10.For availability dates and build numbers of Windows 10 versions, see Windows 10 release information. Queste informazioni consentono di determinare se la versione di Windows 10 è precedente o successiva alla versione 2004.This information can help you determine whether your version of Windows 10 is earlier or later than version 2004.

Verificare la configurazione dell'adattatore TAP-WindowsCheck the TAP-Windows adapter configuration

Gli strumenti di Azure Sphere comunicano con le schede di sviluppo collegate tramite una rete IP su USB.Azure Sphere tools communicate with attached development boards by using an IP network over USB. Per questo motivo è necessario l'adattatore TAP-Windows di OpenVPN Technologies.This requires the TAP-Windows adapter from OpenVPN Technologies. La procedura di installazione di Azure Sphere SDK installa questo adattatore nel PC se non è già presente.The Azure Sphere SDK installation procedure installs this adapter on your PC if it is not already present.

Se tuttavia è già installata una versione diversa dell'adattatore TAP-Windows oppure se il dispositivo Azure Sphere non è connesso alla prima istanza dell'adattatore TAP-Windows, gli strumenti di Azure Sphere potrebbero non riuscire a connettersi al dispositivo.However, if a different version of the TAP-Windows adapter is already installed, or if the Azure Sphere device is not connected to the first instance of the TAP-Windows adapter, the Azure Sphere tools may fail to connect to your device.

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.To determine whether the problem is related to the TAP adapter, first find out how many TAP adapters are installed on your PC, and then modify the installation if necessary.

Per stabilire quanti adattatori TAP sono installati nel PC:To determine how many TAP adapters are installed on your PC:

  1. Aprire il Pannello di controllo.Open Control Panel.

  2. Nelle impostazioni di Windows selezionare Rete e Internet e quindi Modifica opzioni scheda.In Windows Settings, select Network & Internet, and then select Change Adapter Options. Dovrebbe essere visualizzato un solo adattatore TAP, come illustrato nello screenshot:You should see only one TAP adapter, as in the screenshot:

    Un solo adattatore TAP

    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.If you see more than one TAP adapter, or if you see only one TAP adapter but its name is not Azure Sphere, follow these steps to uninstall all TAP adapters and reinstall the SDK. Se non vengono visualizzati adattatori TAP, reinstallare l'SDK.If you see no TAP adapters, reinstall the SDK.

Per disinstallare gli adattatori TAP:To uninstall the TAP adapters:

  1. Fare clic sul pulsante Start e digitare "Gestione dispositivi".Click Start and type "Device Manager".

  2. In Gestione dispositivi aprire Schede di rete e selezionare l'adattatore TAP-Windows:In Device Manager, open Network Adapters and select TAP-Windows adapter:

    Gestione dispositivi con l'adattatore TAP

  3. Fare clic con il pulsante destro del mouse sull'adattatore TAP-Windows e scegliere Disinstalla dispositivo.Right-click TAP-Windows adapter and select Uninstall Device. Nella finestra di dialogo selezionare Elimina il software driver per il dispositivo, quindi fare clic su Disinstalla.In the dialog box, check Delete the driver software for this device, then click Uninstall.

  4. Aprire un prompt dei comandi come amministratore ed eseguire lo script del comando di installazione di PowerShell seguente:Open a command prompt as Administrator and run the following Powershell installer script:

   powershell -ExecutionPolicy RemoteSigned -File "%ProgramData%\Microsoft\Azure Sphere\TapDriverInstaller\TapDriverInstaller.ps1" Install
  1. Se l'installazione riesce, riavviare il servizio di comunicazione del dispositivo Azure Sphere:If the installation succeeds, restart the Azure Sphere Device Communication Service:

    net stop AzureSphereDeviceCommunicationService

    net start AzureSphereDeviceCommunicationService

  2. Reinstallare Azure Sphere SDK.Reinstall the Azure Sphere SDK.

Il dispositivo non rispondeDevice does not respond

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:One or more of the following errors from an azsphere command may indicate that the Azure Sphere Device Communication Service failed to start:

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

È possibile che il servizio non venga avviato dopo l'aggiornamento di Windows o nei casi in cui uno dei file di impostazioni JSON interni è stato danneggiato.The service may fail to start after Windows update or in cases where one of the internal JSON settings files has become corrupted.

Errore dopo l'aggiornamento di WindowsFailure after Windows Update

Questi errori possono verificarsi dopo l'aggiornamento di Windows nel PC.These errors can occur after you've updated Windows on your PC. A volte Windows Update disinstalla i driver FTDI necessari per il servizio di comunicazione.Sometimes Windows Update uninstalls the FTDI drivers required for the communication service.

Per risolvere il problema:To resolve the problem:

  1. Scollegare il dispositivo Azure Sphere da USB e ricollegarlo.Unplug the Azure Sphere device from USB and plug it in again. Quando si ricollega il dispositivo, dovrebbero reinstallarsi i driver corretti.Upon replugging the device, the correct drivers should reinstall.
  2. Se con lo scollegamento e il ricollegamento del dispositivo non si riesce a risolvere il problema, disinstallare e reinstallare Azure Sphere SDK.If unplugging and replugging the device fails to fix the problem, uninstall and reinstall the Azure Sphere SDK.

File JSONJSON file

Se Windows non è stato aggiornato di recente, l'errore potrebbe essere causato dal file restore.json usato per il servizio.If you have not recently updated Windows, the cause of the error might be the restore.json file that is used for the service.

Per risolvere questo problema:To resolve this problem:

  1. Salvare una copia del file seguente: Save a copy of the following file:

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

  2. Eliminare il file dal percorso originale.Delete the file from its original location.

  3. Arrestare e quindi riavviare il servizio di comunicazione del dispositivo di Azure Sphere:Stop and then restart the Azure Sphere Device Communication Service:

    net stop AzureSphereDeviceCommunicationService

    net start AzureSphereDeviceCommunicationService

Arresto anomalo di Windows durante il collegamento o lo scollegamento di un dispositivoWindows crashes when plugging or unplugging a device

La bacheca per sviluppatori di MT3620 dispone di un chip FT4232HQ FTDI (Technology Devices International), che facilita la comunicazione tra il dispositivo e il PC.The MT3620 developer board has a Future Technology Devices International (FTDI) FT4232HQ chip, which facilitates communication between the device and PC. Il driver FTDI ufficiale, il modello di driver combinato (CMD), contiene due driver: uno consente l'accesso tramite l'API D2XX e l'altro fornisce una porta COM virtuale (VCP) per lo stesso dispositivo.The official FTDI driver, Combined Driver Model (CMD), contains two drivers: one provides access through D2XX API, and the other provides a Virtual Com Port (VCP) for the same device. Entrambi i driver vengono installati per impostazione predefinita se il chip FTDI ha la modalità VCP abilitata.Both drivers are installed by default if the FTDI chip has VCP mode enabled. Questo potrebbe causare l'arresto anomalo di Windows quando il chip viene alimentato.This may cause Windows to crash when the chip is power cycled.

Per risolvere questo problema, è possibile disabilitare la modalità VCP per il chip FTDI.To resolve this problem, you can disable VCP mode for the FTDI chip. È necessario usare lo strumento FT_PROG per riprogrammare la EEPROM del chip FTDI.You'll need to use the FT_PROG tool to reprogram the FTDI chip's EEPROM.

  1. Per informazioni su come scaricare e installare questo strumento, vedere FTDI ft _ PROG Programming Tool .See FTDI FT_PROG programming tool to find out how to download and install this tool.

  2. Eseguire FT_PROG e trovare il dispositivo collegato, come descritto nell' _ applicazione ft PROG GUI.Run FT_PROG and find your attached device, as described in FT_PROG GUI application.

  3. Nella visualizzazione albero del dispositivo espandere la sezione hardware specifico.In the Device Tree view, expand the Hardware Specific section. Verranno visualizzate quattro porte.You should see four ports.

    FTProg quattro porte specifiche dell'hardware

  4. Selezionare la porta A e scegliere D2XX Direct anziché porta COM virtuale.Select Port A and choose D2XX Direct instead of Virtual Com Port.

    Selezionare la porta A e D2XX Direct

  5. Ripetere il passaggio precedente per la porta C e la porta D. la porta B dovrebbe essere già in modalità D2XX Direct.Repeat the previous step for Port C and Port D. Port B should be in the D2XX Direct mode already.

  6. Fare clic sull'icona programmi (sembra un fulmine) per passare alla modalità di programmazione.Click the Program Devices icon (looks like a lightning bolt) to enter programming mode.

    fare clic su programmi dispositivi

  7. Programmare l'EEPROM facendo clic sul pulsante programma e quindi attendere il completamento.Program the EEPROM by clicking the Program button and then wait for it to finish.

    dispositivi programma

  8. Scollegare il dispositivo dalla porta USB, quindi ricollegarlo per eseguire il ciclo di alimentazione del dispositivo e rendere effettive le modifiche.Unplug your device from the USB port, then replug it, to power-cycle the device and cause the change to take effect. In Windows Gestione dispositivi la sezione porte (com & LPT) dovrebbe ora visualizzare tre meno porte com.In Windows Device Manager, the Ports (COM & LPT) section should now show three fewer COM ports. Il numero di dispositivi del bus seriale universale deve rimanere invariato.The number of Universal Serial Bus devices should remain the same.

Connessione persa a dispositivi FTDI non Azure Sphere dopo l'abilitazione del debug RTAppLost connection to non-Azure Sphere FTDI devices after enabling RTApp debug

Alcuni Azure Sphere utenti hanno segnalato che non sono più in grado di comunicare con altri dispositivi FTDI collegati, non Azure Sphere dopo l'uso del comando azsphere device enable-Development--enablertcoredebugging per sviluppare ed eseguire il debug di RTAPPS dal computer host.Some Azure Sphere users have reported that they can no longer communicate with other attached, non-Azure Sphere FTDI devices after they use the azsphere device enable-development --enablertcoredebugging command to develop and debug RTApps from their host PC.

Se, ad esempio, si dispone di un dispositivo Azure Sphere e di un dispositivo FTDI diverso collegato al PC, è possibile che vengano visualizzati due controller seriale universali denominati "USB Serial Converter B" nei dispositivi Windows Gestione dispositivi prima di eseguire il comando.For example, if you have both an Azure Sphere device and a different FTDI device attached to your PC, you may see two Universal Serial Controllers named "USB Serial Converter B" devices in Windows Device Manager before running the command.

Gestione dispositivi con due convertitore seriale B

Dopo aver eseguito il comando, i dispositivi USB Serial Converter B scompaiono dalla sezione controller del bus seriale universale e vengono visualizzati due nuovi dispositivi nei dispositivi del bus seriale universale visualizzati in Gestione dispositivi.After executing the command, both USB Serial Converter B devices disappear from the Universal Serial Bus controller section and two new devices appear in the Universal Serial Bus devices display in Device Manager.

Gestione dispositivi due dispositivi USB

CausaCause

Questo problema si verifica perché il comando *azsphere device enable-Development--enablertcoredebugging installa un nuovo driver per la porta B del chip FTDI in MT3620; la porta diventa quindi MSFT MT3620 STD Interface.This problem occurs because the *azsphere device enable-development --enablertcoredebugging command installs a new driver for Port B of the FTDI chip on the MT3620; the port then becomes MSFT MT3620 Std Interface. Tuttavia, l'installazione di questo driver modifica inavvertitamente il driver per la porta B dell'altro dispositivo non Azure Sphere.However, installation of this driver inadvertently changes the driver for Port B of the other non-Azure Sphere device. A causa di una limitazione nella libreria sottostante, tutti i dispositivi FTDI con lo stesso VID (0x0403) e PID (0x6011) avranno sostituito il driver della porta B.Because of a limitation in the underlying library, all FTDI devices with the same VID (0x0403) and PID (0x6011) will have their Port B driver replaced.

SoluzioneSolution

Seguire questa procedura per ripristinare manualmente il driver per tutti i dispositivi non Azure Sphere alla versione precedente:Follow these steps to manually revert the driver for any non-Azure Sphere devices to its previous version:

  1. In Gestione dispositivi selezionare il dispositivo non Azure Sphere ("un altro FTDI Quad gz" nell'esempio), quindi fare clic con il pulsante destro del mouse e selezionare Aggiorna driver.In Device Manager, select the non-Azure Sphere device ("Another FTDI Quad GZ" in the example), then right-click and select Update driver.

  2. In Update drivers selezionare "Browse my computer for driver software".In Update Drivers, select "Browse my computer for driver software".

    Cerca driver nel computer

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

    Consenti selezione

  4. Selezionare il driver "USB Serial Converter B" dall'elenco e quindi fare clic su Avanti.Select "USB Serial Converter B" driver from the list, and then click Next.

    convertitore seriale USB b

  5. Nella finestra di conferma fare clic su Chiudi .Click Close in the confirmation window.

  6. Gestione dispositivi dovrebbe visualizzare la porta B per l'altro dispositivo FTDI come convertitore seriale USB B, che indica che usa il driver FTDI ufficiale.Device Manager should show Port B for the other FTDI device as USB Serial Converter B, which indicates that it uses the official FTDI driver. Il driver per MT3620 rimane l'interfaccia MSFT MT3620 standard.The driver for the MT3620 remains MSFT MT3620 Std Interface.

    La porta B è stata ripristinata

Informazioni aggiuntiveAdditional information

  • Se si collega un altro nuovo dispositivo FTDI non Azure Sphere dopo l'esecuzione del comando azsphere device enable-Development – enablertcoredebugging , a tale dispositivo verrà assegnato lo stesso Azure Sphere driver MT3620's nello stesso modo.If you plug in another new non-Azure Sphere FTDI device after running the azsphere device enable-development –enablertcoredebugging command, that device will be assigned the Azure Sphere MT3620's driver in the same manner. Ripetere i passaggi precedenti per ripristinare il driver FTDI ufficiale del dispositivo.Repeat the steps above to revert the device to the official FTDI driver.

  • Se si scollega e si inserisce nuovamente un dispositivo FTDI non Azure Sphere dopo averlo restituito al driver FTDI ufficiale, il dispositivo manterrà il driver FTDI ufficiale.If you unplug and re-plug a non-Azure Sphere FTDI device after you return it to the official FTDI driver, the device will keep the official FTDI driver.

  • Se si esegue di nuovo il comando Enable-Development-enablertcoredebugging del dispositivo azsphere dopo aver ripristinato il driver, il driver non Azure Sphere sarà nuovamente sostituito dal driver ed è necessario seguire la procedura descritta in soluzione per ripristinare il driver FTDI ufficiale.If you run the azsphere device enable-development –enablertcoredebugging command again after you revert the driver, the non-Azure Sphere FTDI device will once again have its driver replaced, and you'll need to follow the steps in Solution to revert to the official FTDI driver. Questo problema 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 – enablertcoredebugging .This occurs regardless of whether the non-Azure Sphere FTDI device is attached to the PC when the azsphere device enable-development –enablertcoredebugging command is run.

Comandi non riconosciutiCommands not recognized

Se viene visualizzato l'errore seguente quando si immette un comando azsphere, assicurarsi di usare un prompt dei comandi per gli sviluppatori di Azure Sphere:If you see the following error when you enter an azsphere command, ensure that you're using an Azure Sphere Developer Command Prompt:

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

In Windows il comando azsphere richiede l'uso di un Azure Sphere prompt dei comandi per gli sviluppatori, disponibile nel menu Start di Windows in Azure Sphere.On Windows, the azsphere command requires the use of an Azure Sphere Developer Command Prompt, which is available on the Windows Start menu under Azure Sphere.

Il programma di installazione si blocca al 60%Installer hangs at 60 percent

Il programma di installazione si blocca al 60% e si viene informati che il servizio di comunicazione del dispositivo non è stato avviato.The installer hangs at 60%, and you are told that the Device Communication Service has failed to start. Questo problema si verifica in genere quando l'installazione del driver TAP non riesce in modo strano, lasciando il sistema in uno stato indeterminato.This typically occurs when the TAP driver installation fails in a strange way, leaving the system in an indeterminate state.

Verificare che il problema sia il driver TAP:Confirm that the issue is the TAP driver:

  1. Aprire il Visualizzatore eventi Windows per controllare i log.Open the Windows Event Viewer to check the logs.

  2. Esaminare il registro applicazioni e il registro del servizio di comunicazione del dispositivo Azure Sphere per il messaggio di errore seguente:Look in the Application log and the Azure Sphere Device Communication Service log for the following error message:

    "SerialSlipToTun. TunInterfaceSetupException: errore di accesso alle impostazioni del registro di sistema---> System. Collections. Generic. KeyNotFoundException: il dispositivo tap TUN non è stato trovato---> System. Security. SecurityException: l'accesso richiesto al registro di sistema non è consentito"."SerialSlipToTun.TunInterfaceSetupException: Error access tun registry settings ---> System.Collections.Generic.KeyNotFoundException: Tun tap device not found ---> System.Security.SecurityException: Requested registry access is not allowed."

    Screenshot del Visualizzatore eventi di Windows.

  3. Quando si controlla il registro applicazioni , filtrare il log per evitare di visualizzare i molti messaggi non correlati.When checking the Application log, filter the log to avoid seeing the many unrelated messages. Nella scheda azione selezionare Filtro registro corrente.On the Action tab, select Filter Current Log.

  4. Selezionare la casella di controllo errore e selezionare AzureSphereDeviceCommunicationService per elencare solo i messaggi di errore del servizio di comunicazione Azure Sphere dispositivo.Select the Error checkbox and select AzureSphereDeviceCommunicationService to list only error messages from the Azure Sphere Device Communication Service.

    Screenshot della finestra di dialogo Filtra log corrente.

  5. Se non è possibile trovare l'errore nel registro applicazioni o nel log del servizio di comunicazione del dispositivo Azure Sphere , questo potrebbe non essere un problema di driver tap.If you cannot find the error in either the Application log or the Azure Sphere Device Communication Service log, then this may not be a TAP driver issue.

Per risolvere il problema del driver TAP, attenersi alla seguente procedura:To resolve the TAP driver issue, follow these steps:

  1. Passare al Centro rete e condivisione e selezionare Modifica impostazioni scheda.Go to the Network and Sharing Center and select Change adapter settings.

    Screenshot del centro di condivisione di rete.

  2. In connessioni di rete in Azure Sphere selezionare toccare-adattatore Windows V9 e aprire le relative proprietà.In Network Connections under Azure Sphere, select TAP-WIndows Adapter V9 and open its properties.

    Screenshot delle connessioni di rete.

  3. In proprietà Azure Sphere selezionare protocollo Internet versione 4 (TCP/IPv4) e quindi selezionare il pulsante proprietà per visualizzare le impostazioni del protocollo.In Azure Sphere Properties, select Internet Protocol Version 4 (TCP/IPv4) and then select the Properties button to view the protocol settings.

    Screenshot delle proprietà del Azure Sphere.

  4. Verificare che l' indirizzo IP sia impostato su 192.168.35.1 e che subnet mask sia impostato su 255.255.255.0.Ensure that IP address is set to 192.168.35.1 and Subnet mask is set to 255.255.255.0.

  5. Provare a eseguire di nuovo il programma di installazione.Try the installer again. Se ancora si blocca, provare a reimpostare le connessioni di rete.If it still hangs, try resetting your network connections. Per eseguire una reimpostazione, passare a Impostazioni > rete & > stato Internet e selezionare Reimposta rete nella parte inferiore della pagina.To do a reset, go to Settings > Network & Internet > Status and select Network reset near the bottom of the page.

    Tenere presente che la reimpostazione della rete Reimposta tutte le impostazioni di rete.Beware that resetting your network will reset all network settings.

Problemi specifici di LinuxLinux-specific problems

Nei sistemi Linux è necessario eseguire lo script azsphere_connect.sh ogni volta che si collega il dispositivo oppure quando lo si scollega e ricollega.On Linux systems, you need to run the azsphere_connect.sh script each time you plug in the device or unplug/replug it.

Se è stato eseguito lo script, è possibile che si verifichi un errore di connessione per i motivi seguenti:If you have run the script, failure to connect may occur for any of these reasons:

  • La scheda non è connessa tramite USB.The board is not connected by USB.

  • La scheda non è alimentata.The board is not powered.

Per risolvere il problema, iniziare con questi passaggi di base:To resolve the problem, start with these basic steps:

  1. Assicurarsi che il dispositivo sia connesso tramite USB.Ensure that the device is connected by USB.

  2. Eseguire lo script azsphere_connect.sh, se non è già stato fatto.Run the azsphere_connect.sh script, if you haven't already done so.

  3. Se il dispositivo è connesso, premere il pulsante Reimposta sul dispositivo.If the device is connected, press the Reset button on the device. Attendere circa 10 secondi che venga riavviato il dispositivo e quindi provare a eseguire di nuovo il comando non riuscito.Wait ten seconds or so for the device to restart, and then try the failed command again.

  4. Se l'errore si ripete, scollegare il dispositivo dalla porta USB, inserirlo nuovamente e attendere il riavvio.If the error recurs, unplug the device from the USB port, plug it in again, and wait for it to restart. Eseguire quindi lo script azsphere_connect.sh.Then run the azsphere_connect.sh script.

Non è possibile compilare o sottoporre a debug le applicazioni RTAppCannot compile or debug RTApps

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:If CMake reports errors finding the toolchains or openocd when you try to build or debug an RTApp, make sure that: