Problemen met Azure Sphere oplossen

Belangrijk

Dit is de Documentatie voor Azure Sphere (verouderd). Azure Sphere (verouderd) wordt op 27 september 2027 buiten gebruik gesteld en gebruikers moeten tegen deze tijd migreren naar Azure Sphere (geïntegreerd). Gebruik de versiekiezer boven de inhoudsweergave om de Documentatie van Azure Sphere (geïntegreerd) weer te geven.

Hier volgen enkele stappen voor het oplossen van problemen die kunnen optreden tijdens de installatie en installatie.

Problemen met apparaatcommunicatie

Een fout bij het maken van verbinding met het apparaat vanaf een hostcomputer kan om verschillende redenen optreden en kan verschillende foutberichten activeren, afhankelijk van de hulpprogramma's of toepassingen die het tegenkomen. De volgende foutberichten kunnen duiden op een mislukte verbinding:

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

Er zijn drie onderdelen die communicatieproblemen met apparaten kunnen veroorzaken: (1) de opdrachtregelinterface zelf; (2) de DCS (Device Communication Service) die de communicatie met een apparaat vergemakkelijkt; en (3) het apparaat.

Voer de volgende diagnostische stappen uit om de oorzaak te isoleren:

1. Controleer of u rechtstreeks met het apparaat kunt communiceren. Navigeer naar https://192.168.35.2/status in een webbrowser. Negeer en negeer eventuele gepresenteerde SSL-waarschuwingen. De uitvoer ziet er ongeveer als volgt uit: {"uptime":56} in het webbrowservenster.

Notitie

U kunt deze stap ook uitvoeren vanaf de opdrachtregel met behulp van curl https://192.168.35.2/status --insecure.

Notitie

U kunt deze stap ook uitvoeren vanuit PowerShell (v6 of hoger). Invoke-WebRequest https://192.168.35.2/status -SkipCertificateCheck

2. Controleer of de communicatieservice voor apparaten een apparaat heeft gedetecteerd. Navigeer naar http://localhost:48938/api/service/devices een webbrowser en controleer of ten minste één apparaat wordt weergegeven in de JSON-uitvoer.

Waarschuwing

De Linux DCS is alleen opgenomen in SDK-release 23.05 en hoger. Volg de verouderde stappen voor probleemoplossing voor SDK-versies 22.11 en eerder.

Notitie

U kunt deze stap ook uitvoeren vanuit PowerShell via Invoke-WebRequest http://localhost:48938/api/service/devices.

Kan niet rechtstreeks communiceren met het apparaat en het apparaat wordt niet gedetecteerd door de DCS

Als er geen verbinding kan worden gemaakt met het apparaat (stap 1) en het apparaat niet kan worden gedetecteerd door dcs (stap 2), is er waarschijnlijk een probleem met de configuratie van het fysieke apparaat.

Controleer eerst of het apparaat is gedetecteerd door de computer.

Vanuit een terminal:

1. Voer sudo lsusb uit. Controleer of Future Technology Devices International, Ltd FT4232H Quad HS USB-UART/FIFO IC wordt weergegeven in de uitvoer.

Een PowerShell-venster gebruiken:

1. Get-PnpDevice -PresentOnly uitvoeren | Where-Object { $_. InstanceId -match ^USB' }. Controleer of MSFT MT3620 Std Interface wordt weergegeven in de uitvoer.

Als de vorige opdracht de verwachte uitvoer niet retourneert, sluit u het apparaat aan op een andere USB-poort. Als dit het probleem nog steeds niet oplost, controleert u of het apparaat de jumpers correct heeft geconfigureerd. Seeed MT3620 Development Kits worden bijvoorbeeld verzonden vanuit de fabriek met een jumperheader over pinnen 2 en 3 van J3, die de klok van de hoofdvoeding aanlevert. Controleer of de header niet is losgekoppeld of verwijderd.

Kan niet rechtstreeks communiceren met het apparaat, maar het apparaat wordt gedetecteerd door de DCS

Als er geen verbinding kan worden gemaakt met het apparaat (stap 1), maar het apparaat is gedetecteerd door de DCS (stap 2), is het waarschijnlijk dat het apparaat of de apparaatcommunicatieservice een slechte status heeft.

Als u net een apparaat hebt verbonden met internet en het besturingssysteem van het apparaat verouderd is, kan het apparaat een update van het besturingssysteem toepassen. Er is ook een kleine kans dat het apparaat een update van het besturingssysteem neemt als de tijd samenvalt met een releasevenster. Tijdens een update van een besturingssysteem kunt u niet communiceren met een apparaat.

Als u vermoedt dat het apparaat up-to-date is en/of het apparaat niet is verbonden met internet, kunt u het beste het apparaat loskoppelen en opnieuw aansluiten op uw pc. Hierdoor moet de DCS de verbinding met het apparaat vernieuwen en wordt het apparaat opnieuw ingesteld op een initiële status.

Als u het apparaat niet loskoppelt en opnieuw aansluit, kunt u het beste de DCS opnieuw opstarten. Vanuit een terminal:

1. Voer sudo azspheredctl restart uit. Controleer of de opdracht is voltooid.
   1. Als de opdracht mislukt, voert u de opdracht uit sudo systemctl restart azsphered.

Als u het apparaat niet kunt loskoppelen en opnieuw verbinding kunt maken, kunt u het beste een opdracht voor opnieuw scannen voor de DCS uitgeven. Na ontvangst van deze opdracht wordt de FTDI-interfacechip die wordt gebruikt om te communiceren met de MT3620 opnieuw ingesteld en wordt de DCS opnieuw ingesteld. Een PowerShell-venster gebruiken:

1. Azsphere-apparaat opnieuw scannen-gekoppeld uitvoeren

Voer nu de opdracht die u in eerste instantie hebt geprobeerd opnieuw uit. Als het probleem nog steeds niet is opgelost, kunt u het beste proberen de DCS opnieuw op te starten. Vanuit een PowerShell-venster op beheerdersniveau:

1. Voer Restart-Service -Name AzureSphereDeviceCommunicationService uit. Controleer of de opdracht is voltooid.

U kunt de DCS ook opnieuw starten met behulp van een grafische gebruikersinterface.

1. Druk op Start en voer Services in. Klik met de rechtermuisknop op de Azure Sphere Device Communication Service en selecteer Opnieuw opstarten.

Voer nu de opdracht die u in eerste instantie hebt geprobeerd opnieuw uit.

Als de opdracht blijft mislukken of azsphere device list-attached uitvoer heeft die vergelijkbaar is met:

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

Azsphere-apparaat herstellen uitvoeren

Kan rechtstreeks communiceren met het apparaat en het apparaat wordt gedetecteerd door de DCS

Dit duidt waarschijnlijk op een probleem met de CLI. Zorg ervoor dat u de nieuwste versie van de SDK hebt.

Als u de nieuwste versie van de SDK hebt en uw probleem nog steeds niet is opgelost, plaatst u een vraag op het Q&A-forum.

Verbroken verbindingen of ontbrekende apparaten

Als uw computer verbinding kan maken met het Azure Sphere-apparaat, maar vaak de verbinding wegvalt, kan er een conflict optreden in het IP-subnet.

Azure Sphere maakt gebruik van subnet 192.168.35.*. Als u andere software hebt die gebruikmaakt van hetzelfde subnet, schakelt u deze software uit of beperkt u het bereik van IP-adressen dat wordt gebruikt. Op dit moment kunt u het bereik van IP-adressen die door Azure Sphere worden gebruikt, niet wijzigen.

Kan apparaatmogelijkheden niet toepassen

Als u fouten ontvangt wanneer u probeert een apparaatmogelijkheid toe te passen op een Azure Sphere-apparaat, kan het probleem zijn dat het besturingssysteem op uw apparaat verouderd is. Dit probleem kan optreden als het apparaat gedurende een langere periode offline is geweest, waarbij Microsoft de interne sleutels heeft bijgewerkt. De volgende fouten zijn symptomen van dit probleem:

De opdrachten azsphere device enable-development of azsphere device enable-cloud-test retourneren een fout die vergelijkbaar is met de volgende:

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

De opdracht azsphere device capability update retourneert een fout die vergelijkbaar is met de volgende:

error: Could not apply device capability configuration to device.

Dit komt doordat het vertrouwde sleutelarchief op het apparaat verouderd is. Volg de instructies hier om dit probleem op te lossen.

Kan geen vier USB-seriële conversieprogramma's maken

Nadat u een MT3620-ontwikkelbord hebt ingesteld, ziet u vier USB-seriële conversieprogramma's in Apparaatbeheer. Als u minder dan vier ziet, hebt u mogelijk een probleem met het FTDI-stuurprogramma.

Notitie

Als dit bord eerder is gebruikt voor RTApp-ontwikkeling, ziet u mogelijk drie conversieprogramma's in plaats van vier. Dit is normaal en vertegenwoordigt geen fout.

Als het FTDI-stuurprogramma niet correct is geïnstalleerd, worden de conversieprogramma's mogelijk op de verkeerde locatie weergegeven, zoals andere apparaten, of worden ze mogelijk helemaal niet weergegeven.

U kunt dit probleem als volgt oplossen:

1. Als u Apparaatbeheer wilt openen, klikt u op Start en voert u Apparaatbeheer in.

2. Selecteer onder Universal Serial Bus-controllers de optie USB Serial Converter A. Klik met de rechtermuisknop op de naam, selecteer Apparaat verwijderen en verwijder het stuurprogramma als u de optie krijgt:

   

   Herhaal deze stap voor USB Serial Converter B via USB Serial Converter D.

3. Koppel uw ontwikkelbord los van uw pc en sluit het opnieuw aan. "MSFT MT3620 Std Interface" moet worden weergegeven met een driehoek waarschuwingspictogram, wat aangeeft dat er geen stuurprogramma beschikbaar is.

4. Klik met de rechtermuisknop op een van de MSFT MT3620 Std Interface-apparaten en selecteer Stuurprogramma bijwerken. Kies Automatisch zoeken naar bijgewerkte stuurprogrammasoftware. Als u een update bijwerkt, moeten ze allemaal worden hersteld. U ziet nu vier USB-seriële conversieprogramma's in de sectie Universal Serial Bus-controllers. Als alle vier de conversieprogramma's niet worden weergegeven, herhaalt u deze stap voor elk conversieprogramma.

Kan GEEN FTDI-stuurprogramma's installeren

De FTDI-stuurprogramma's moeten automatisch door Windows worden gedownload en geïnstalleerd wanneer uw Azure Sphere-apparaat voor het eerst op uw pc is aangesloten. Als de stuurprogramma's correct zijn geïnstalleerd, ziet u vier USB-seriële conversieprogramma's vermeld onder Universal Serial Bus-controllers in Apparaatbeheer, zoals beschreven in Uw dev kit instellen.

Windows 10, versie 2004, zoekt niet naar de stuurprogramma's. In dit geval worden de stuurprogramma's niet automatisch gedownload en geïnstalleerd en ziet u de volgende items in Apparaatbeheer:

Als u de stuurprogramma's wilt installeren, downloadt u de stuurprogramma's handmatig van Future Technology Devices International (FTDI). Kies het stuurprogramma dat overeenkomt met uw Windows-installatie (32- of 64-bits).

Zie de releasegegevens van Windows 10 voor beschikbaarheidsdatums en buildnummers van Windows 10-versies. Met deze informatie kunt u bepalen of uw versie van Windows 10 ouder of hoger is dan versie 2004.

Verbindingsproblemen veroorzaakt door de configuratie van TAP-Windows-adapter

Azure Sphere-hulpprogramma's communiceren met gekoppelde ontwikkelborden met behulp van een IP-netwerk via USB. Hiervoor is de TAP-Windows-adapter van OpenVPN Technologies vereist. Met de installatieprocedure van de Azure Sphere SDK wordt deze adapter op uw pc geïnstalleerd als deze nog niet aanwezig is.

Er zijn twee verschillende typen problemen gemeld met de TAP-Windows-adapter:

• Als er al een andere versie van de TAP-Windows-adapter is geïnstalleerd of als het Azure Sphere-apparaat niet is verbonden met het eerste exemplaar van de TAP-Windows-adapter, kunnen de Azure Sphere-hulpprogramma's geen verbinding maken met uw apparaat.

• Als u het vpn (Virtual Private Network) van Cisco AnyConnect gebruikt, wordt uw TAP-Windows-adapter mogelijk niet aangesloten weergegeven en werkt de communicatie van het apparaat mogelijk niet. Dit komt doordat het VPN verkeer kan omleiden van het IP-adres van de TAP-adapter.

Zorg ervoor dat het Azure Sphere-apparaat is verbonden met de juiste TAP-Windows-adapter

Als u wilt bepalen of het probleem te maken heeft met de TAP-adapter, moet u eerst nagaan hoeveel TAP-adapters op uw pc zijn geïnstalleerd en wijzigt u de installatie indien nodig.

Om te bepalen hoeveel TAP-adapters op uw pc zijn geïnstalleerd:

1. Open Windows-instellingen en selecteer de netwerk- en internetgroep .

2. Selecteer Onder Geavanceerde netwerkinstellingen de optie Adapteropties wijzigen. U ziet slechts één TAP-adapter, zoals wordt weergegeven in de volgende schermopname:

   

   Als u meer dan één TAP-adapter ziet of als u slechts één TAP-adapter ziet, maar de naam niet Azure Sphere is, volgt u deze stappen om alle TAP-adapters te verwijderen en de SDK opnieuw te installeren. Als u geen TAP-adapters ziet, installeert u de SDK opnieuw.

De TAP-adapters verwijderen:

1. Klik op Start en voer Apparaatbeheer in.

2. Open in Apparaatbeheer netwerkadapters en selecteer TAP-Windows-adapter:

   

3. Klik met de rechtermuisknop op TAP-Windows-adapter en selecteer Apparaat verwijderen. Selecteer in het dialoogvenster De stuurprogrammasoftware voor dit apparaat verwijderen en klik vervolgens op Verwijderen.

4. Open een opdrachtprompt als Administrator en voer het volgende PowerShell-installatiescript uit:

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

5. Als de installatie is geslaagd, start u de Azure Sphere Device Communication Service opnieuw op:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

6. Installeer de Azure Sphere SDK opnieuw.

De niet-aangesloten status corrigeren bij het gebruik van Cisco AnyConnect VPN-client

Wanneer u Cisco AnyConnect VPN-client gebruikt, wordt de TAP-Windows-adapter mogelijk niet aangesloten weergegeven en werkt de apparaatcommunicatie mogelijk niet. U kunt het probleem als volgt oplossen:

1. Zorg ervoor dat u beheerdersbevoegdheden op uw computer hebt.

2. Open Windows-instellingen en selecteer de netwerk- en internetgroep .

3. Selecteer Onder Geavanceerde netwerkinstellingen de optie Adapteropties wijzigen.

4. Klik met de rechtermuisknop op Azure Sphere TAP-Windows Adapter V9 en selecteer Eigenschappen.

5. Zoek op het tabblad Netwerken de vermelding Filterstuurprogramma van Cisco AnyConnect Network Access Manager en wis het item.

   

6. Selecteer OK om de instelling op te slaan en de eigenschappen af te sluiten.

7. Controleer of de communicatie met uw Azure Sphere-apparaat nu werkt door een opdrachtprompt te openen en de opdracht in te azsphere device show-attached voeren.

Apparaat reageert niet

Een of meer van de volgende fouten van een azsphere-opdracht kunnen erop wijzen dat de Azure Sphere Device Communication Service niet kan worden gestart:

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

Zorg ervoor dat u de stappen voor het oplossen van problemen met apparaatcommunicatie hebt uitgevoerd.

Als uw probleem nog steeds niet is opgelost en uw computer onlangs een Windows-update heeft gemaakt, kan de communicatieservice van het apparaat niet worden gestart nadat Windows update is uitgevoerd en in gevallen waarin een van de interne JSON-instellingenbestanden of het configuratiebestand is beschadigd.

Fout na Windows Update

Deze fouten kunnen optreden nadat u Windows op uw pc hebt bijgewerkt. Soms verwijdert Windows Update de FTDI-stuurprogramma's die vereist zijn voor de communicatieservice.

Het probleem oplossen:

1. Koppel het Azure Sphere-apparaat los van USB en sluit het opnieuw aan. Bij het opnieuw aansluiten van het apparaat moeten de juiste stuurprogramma's opnieuw worden geïnstalleerd.
2. Als het probleem niet kan worden opgelost door het loskoppelen en opnieuw koppelen van het apparaat, verwijdert en installeert u de Azure Sphere SDK.

JSON-bestand

Als u Windows niet onlangs hebt bijgewerkt, kan de oorzaak van de fout het restore.json bestand zijn dat wordt gebruikt voor de service.

U kunt dit probleem als volgt oplossen:

1. Sla een kopie van het volgende bestand op:

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

2. Verwijder het bestand van de oorspronkelijke locatie.

3. Stop en start vervolgens de Azure Sphere Device Communication Service opnieuw op:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

Beschadigd configuratiebestand

Als er een fout wordt gemeld wanneer u een opdracht probeert uit te voeren, kan het beschadigde configuratiebestand verhinderen dat uw apparaat correct wordt uitgevoerd.

Verwijder het beschadigde configuratiebestand in .azsphere\config in Windows of ~/.azsphere/config op Linux om dit probleem op te lossen.

Windows loopt vast bij het aansluiten of loskoppelen van een apparaat

Het MT3620-ontwikkelaarsbord heeft een FTDI(Future Technology Devices International) FT4232HQ chip, die de communicatie tussen het apparaat en de pc vergemakkelijkt. Het officiële FTDI-stuurprogramma, Gecombineerde stuurprogrammamodel (CMD), bevat twee stuurprogramma's: één biedt toegang via D2XX API en de andere biedt een VCP (Virtual Com Port) voor hetzelfde apparaat. Beide stuurprogramma's worden standaard geïnstalleerd als de FTDI-chip de VCP-modus heeft ingeschakeld. Dit kan ertoe leiden dat Windows vastloopt wanneer de chip wordt gecyclusd.

U kunt dit probleem oplossen door de VCP-modus voor de FTDI-chip uit te schakelen. U moet het hulpprogramma FT_PROG gebruiken om de EEPROM van de FTDI-chip opnieuw te programmeren.

1. Zie ftdi FT_PROG programmeerprogramma voor meer informatie over het downloaden en installeren van dit hulpprogramma.

2. Voer FT_PROG uit en zoek het gekoppelde apparaat, zoals beschreven in FT_PROG GUI-toepassing.

3. Vouw in de weergave Apparaatstructuur de sectie Hardwarespecifiek uit. U ziet vier poorten.

   

4. Selecteer Poort A en kies D2XX Direct in plaats van virtuele com-poort.

   

5. Herhaal de vorige stap voor poort C en poort D. Poort B moet zich al in de D2XX Direct-modus bevinden.

6. Selecteer het pictogram Programmaapparaten (lijkt op een bliksemschicht) om de programmeermodus in te gaan.

   

7. Selecteer Programma om de EEPROM te programmeren en wacht tot deze is voltooid.

   

8. Koppel uw apparaat los van de USB-poort en sluit het opnieuw aan op de stroomcyclus van het apparaat en zorg ervoor dat de wijziging van kracht wordt. In Windows Apparaatbeheer moet in de sectie Poorten (COM & LPT) nu drie minder COM-poorten worden weergegeven. Het aantal Universal Serial Bus-apparaten moet hetzelfde blijven.

Verbinding met niet-Azure Sphere FTDI-apparaten is verbroken na het inschakelen van RTApp-foutopsporing

Sommige Azure Sphere-gebruikers hebben gemeld dat ze niet meer kunnen communiceren met andere gekoppelde, niet-Azure Sphere FTDI-apparaten nadat ze de opdracht azsphere device enable-development --enable-rt-core-debugging-foutopsporingsopdracht gebruiken om RTApps te ontwikkelen en fouten op te sporen vanaf hun host-pc.

Als u bijvoorbeeld zowel een Azure Sphere-apparaat als een ander FTDI-apparaat hebt gekoppeld aan uw pc, ziet u mogelijk twee Universele seriële controllers met de naam USB Serial Converter B-apparaten in Windows Apparaatbeheer voordat u de opdracht uitvoert.

Na het uitvoeren van de opdracht verdwijnen beide USB Serial Converter B-apparaten uit de sectie Universal Serial Bus-controller en worden er twee nieuwe apparaten weergegeven in de Universal Serial Bus-apparaten die worden weergegeven in Apparaatbeheer.

Oorzaak

Dit probleem treedt op omdat de opdracht azsphere device enable-development --enable-rt-core-debugging een nieuw stuurprogramma installeert voor poort B van de FTDI-chip op de MT3620; de poort wordt vervolgens MSFT MT3620 Std Interface. De installatie van dit stuurprogramma wijzigt echter per ongeluk het stuurprogramma voor poort B van het andere niet-Azure Sphere-apparaat. Vanwege een beperking in de onderliggende bibliotheek worden alle FTDI-apparaten met dezelfde VID (0x0403) en PID (0x6011) vervangen door het poort B-stuurprogramma.

Oplossing

Volg deze stappen om het stuurprogramma voor niet-Azure Sphere-apparaten handmatig terug te keren naar de vorige versie:

1. Selecteer in Apparaatbeheer het niet-Azure Sphere-apparaat (een andere FTDI Quad GZ in het voorbeeld), klik met de rechtermuisknop en selecteer Stuurprogramma bijwerken.

2. Selecteer In Stuurprogramma's bijwerken de optie Bladeren op mijn computer voor stuurprogrammasoftware.

   

3. Selecteer Laat me kiezen uit een lijst met beschikbare stuurprogramma's op mijn computer.

   

4. Selecteer het stuurprogramma USB Serial Converter B in de lijst en klik vervolgens op Volgende.

   

5. Klik op Sluiten in het bevestigingsvenster.

6. Apparaatbeheer moet Poort B voor het andere FTDI-apparaat weergeven als USB Serial Converter B, wat aangeeft dat het de officiële FTDI-stuurprogramma gebruikt. Het stuurprogramma voor de MT3620 blijft MSFT MT3620 Std Interface.

   

Aanvullende informatie

• Als u een ander nieuw niet-Azure Sphere FTDI-apparaat aansluit nadat u de opdracht azsphere device enable-development --enable-rt-core-foutopsporing hebt uitgevoerd, krijgt dat apparaat op dezelfde manier het stuurprogramma van Azure Sphere MT3620 toegewezen. Herhaal de bovenstaande stappen om het apparaat terug te keren naar het officiële FTDI-stuurprogramma.

• Als u een niet-Azure Sphere FTDI-apparaat loskoppelt en opnieuw aansluit nadat u het hebt teruggekoppeld naar het officiële FTDI-stuurprogramma, behoudt het apparaat het officiële FTDI-stuurprogramma.

• Als u de opdracht azsphere device enable-development --enable-rt-core-foutopsporing opnieuw uitvoert nadat u het stuurprogramma hebt teruggezet, wordt het niet-Azure Sphere FTDI-apparaat opnieuw vervangen door het stuurprogramma en moet u de stappen in Solution volgen om terug te keren naar het officiële FTDI-stuurprogramma. Dit gebeurt ongeacht of het niet-Azure Sphere FTDI-apparaat is gekoppeld aan de pc wanneer de opdracht azsphere device enable-development --enable-rt-core-debugging wordt uitgevoerd.

Opdrachten worden niet herkend

Als u de volgende fout ziet wanneer u een azsphere-opdracht invoert, controleert u of u PowerShell of een standaardopdrachtprompt in Windows gebruikt.

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

Het installatieprogramma loopt vast op 60 procent

Het installatieprogramma loopt vast om 60%, en u wordt verteld dat de Device Communication Service niet kan worden gestart. Dit gebeurt meestal wanneer de INSTALLATIE van het TAP-stuurprogramma op een vreemde manier mislukt, waardoor het systeem in een onbepaalde staat blijft.

Bevestig dat het probleem het TAP-stuurprogramma is

1. Open de Windows-Logboeken om de logboeken te controleren.

2. Kijk in het toepassingslogboek en het Azure Sphere Device Communication Service-logboek voor het volgende foutbericht:

   "SerialSlipToTun.TunInterfaceSetupException: Fout bij toegang tot registerinstellingen ---> System.Collections.Generic.KeyNotFoundException: Tun tap device not found ---> System.Security.SecurityException: Requested registry access is not allowed."

   

3. Wanneer u het toepassingslogboek controleert, filtert u het logboek om te voorkomen dat de vele niet-gerelateerde berichten worden weergegeven. Selecteer Huidig logboek filteren op het tabblad Actie.

4. Selecteer Fout en selecteer vervolgens AzureSphereDeviceCommunicationService om alleen foutberichten van de Azure Sphere Device Communication Service weer te geven.

   

5. Als u de fout niet kunt vinden in het toepassingslogboek of het Azure Sphere Device Communication Service-logboek, is dit mogelijk geen PROBLEEM met het TAP-stuurprogramma.

Voer de volgende stappen uit om het probleem met het TAP-stuurprogramma op te lossen:

1. Ga naar het netwerkcentrum en selecteer Adapterinstellingen wijzigen.

   

2. Selecteer IN Netwerkverbindingen onder Azure Sphere TAP-WIndows Adapter V9 en open de eigenschappen.

   

3. Selecteer in Azure Sphere-eigenschappen internetprotocolversie 4 (TCP/IPv4) en selecteer vervolgens Eigenschappen om de protocolinstellingen weer te geven.

   

4. Zorg ervoor dat het IP-adres is ingesteld op 192.168.35.1 en dat het subnetmasker is ingesteld op 255.255.255.0.

5. Probeer het installatieprogramma opnieuw. Als het nog steeds vastloopt, probeert u de netwerkverbindingen opnieuw in te stellen. Als u opnieuw wilt instellen, gaat u naar Netwerkinstellingen>en internetstatus> en selecteert u Netwerkherstel onderaan de pagina.

   Belangrijk

   Als u het netwerk opnieuw instelt, worden alle netwerkinstellingen opnieuw ingesteld.

De Azure Sphere Device Communication Service stoppen

Als het installatieprogramma vastloopt, kunt u de Azure Sphere Device Communication Service stoppen met behulp van de taskkill-opdracht .

Volg vervolgens deze stappen:

1. Kopieer de PID voor de AzureSphereDeviceCommunicationService.

   • Ga naar het tabblad Task Manager>Services en noteer de PID voor de Service AzureSphereDeviceCommunicationService of
   • Typ tasklist /fi "SERVICES eq AzureSphereDeviceCommunicationService*" en kopieer in de opdrachtregel de PID uit de uitvoer.

2. Typ het volgende in de opdrachtregel om de service te beëindigen. De taskkill-opdracht beëindigt het proces dat overeenkomt met het proces-id-nummer. De /f optie wordt gebruikt om het proces geforceerd te beëindigen.

   taskkill /PID <DCS_PID> /f

3. Probeer het installatieprogramma opnieuw.

Azure Sphere Device Communication Service kan niet worden gestopt

Wanneer u een bestaande Azure Sphere SDK bijwerkt, ziet u mogelijk een bericht met de tekst 'Service 'Azure Sphere Device Communication Service' (AzureSphereDeviceCommunicationService) kan niet worden gestopt. Controleer of u voldoende bevoegdheden hebt om systeemservices te stoppen." Als u dit bericht ontvangt, start u het installatieprogramma opnieuw op en voert u het opnieuw uit.

Apparaatcommunicatie is verbroken wanneer split tunneling wordt gebruikt

Wanneer een ontwikkelcomputer is verbonden met het bedrijfs-VPN en split tunneling is uitgeschakeld door de VPN-configuratie, kan de ontwikkelcomputer mogelijk niet communiceren met het Azure Sphere-apparaat.

Doe een van de volgende dingen om dit probleem op te lossen:

• Verbreek de verbinding met het bedrijfs-VPN en probeer de verbinding met het Azure Sphere-apparaat opnieuw uit te voeren.
• Wijzig de VPN-configuratie om split tunneling toe te staan.

Communicatieproblemen kunnen ook worden veroorzaakt door de TAP-Windows-adapterconfiguratie. Zie de sectie Verbindingsproblemen die worden veroorzaakt door de configuratie van TAP-Windows-adapter .

Azure Sphere SDK kan niet worden geïnstalleerd of verwijderd in Windows 11

Na een upgrade naar Windows 11 kunnen gebruikers de Azure Sphere SDK niet installeren of verwijderen. Installeer de nieuwste versie van de Azure Sphere SDK voor Windows om dit probleem op te lossen. Nadat u 21.07 Update 2 of hoger hebt geïnstalleerd, kunt u de SDK verwijderen.

Kan RTApps niet compileren of fouten opsporen

Als CMake fouten rapporteert bij het vinden van de hulpprogrammaketens of openocd wanneer u probeert een RTApp te bouwen of fouten op te sporen, controleert u of:

• U hebt de GNU Arm Embedded Toolchain geïnstalleerd voor uw ontwikkelomgeving.
• U hebt het juiste pad opgegeven naar openocd zoals beschreven in de zelfstudie: Een realtime geschikte toepassing bouwen.

Problemen met communicatie van apparaten vóór 23.05 oplossen

Waarschuwing

Deze stappen zijn bedoeld voor gebruikers met SDK-versie 22.11 of eerder. Controleer of de geïnstalleerde SDK-versie 22.11 of eerder is door azsphere show-version uit te voeren.

Op Linux-systemen met SDK-versie 22.11 of eerder moet het azsphere_connect.sh script worden uitgevoerd telkens wanneer u het apparaat aansluit of loskoppelt of opnieuw koppelt. Het script vernieuwt apparaatverbindingen en spaweert een kernelstuurprogramma dat netwerkverkeer toe wijst aan het apparaat.

Als u communicatieproblemen ondervindt, begint u met de volgende basisstappen:

1. Zorg ervoor dat het apparaat is aangesloten via USB.

2. Voer het azsphere_connect.sh-script uit als u dit nog niet hebt gedaan.

3. Controleer of u rechtstreeks met het apparaat kunt communiceren. Navigeer naar https://192.168.35.2/status in een webbrowser. Negeer en negeer eventuele gepresenteerde SSL-waarschuwingen. De uitvoer ziet er ongeveer als volgt uit: {"uptime":56} in het webbrowservenster.

Notitie

U kunt deze stap ook uitvoeren vanaf de opdrachtregel met behulp van curl https://192.168.35.2/status --insecure.

1. Als de fout zich blijft voordoen, koppelt u het apparaat los van de USB-poort, sluit u het opnieuw aan en wacht u totdat het opnieuw wordt opgestart. Voer vervolgens het azsphere_connect.sh script uit.

2. Als de fout zich blijft voordoen, controleert u of er geen subnetconflicten zijn met andere netwerkhulpprogramma's.