Behandeln von Problemen mit Azure Sphere

Im Folgenden finden Sie einige Schritte zur Problembehandlung bei Problemen, die während der Installation und Einrichtung auftreten können.

Gerätekommunikationsprobleme

Ein Fehler beim Herstellen einer Verbindung mit dem Gerät von einem Hostcomputer kann aus vielen Gründen auftreten und kann eine von mehreren Fehlermeldungen auslösen, je nachdem, welche Tools oder Anwendungen darauf stoßen. Die folgenden Fehlermeldungen können auf einen Verbindungsfehler hinweisen:

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

Es gibt drei Komponenten, die Zu Problemen bei der Gerätekommunikation führen können: (1) die Befehlszeilenschnittstelle selbst; (2) den Gerätekommunikationsdienst (Device Communication Service, DCS), der die Kommunikation mit einem Gerät erleichtert; und (3) das Gerät.

Führen Sie die folgenden Diagnoseschritte aus, um die Ursache zu isolieren:

1. Vergewissern Sie sich, dass Sie direkt mit dem Gerät kommunizieren können. Navigieren Sie in einem Webbrowser zu https://192.168.35.2/status . Ignorieren und schließen Sie alle angezeigten SSL-Warnungen. Es sollte eine Ausgabe ähnlich der folgenden angezeigt werden: {"uptime":56} im Webbrowserfenster.

Hinweis

Sie können diesen Schritt auch über die Befehlszeile mit curl https://192.168.35.2/status --insecureausführen.

Hinweis

Sie können diesen Schritt auch über PowerShell (v6 oder höher) Invoke-WebRequest https://192.168.35.2/status -SkipCertificateCheckausführen.

2. Vergewissern Sie sich, dass der Gerätekommunikationsdienst ein Gerät erkannt hat. Navigieren Sie in einem Webbrowser zu , http://localhost:48938/api/service/devices und vergewissern Sie sich, dass mindestens ein Gerät in der JSON-Ausgabe angezeigt wird.

Warnung

Der Linux-DCS ist nur im SDK-Release 23.05 und höher enthalten. Führen Sie die Legacy-Schritte zur Problembehandlung für SDK-Versionen 22.11 und früher aus.

Hinweis

Sie können diesen Schritt auch über Invoke-WebRequest http://localhost:48938/api/service/devicesPowerShell ausführen.

Die direkte Kommunikation mit dem Gerät konnte nicht möglich sein, und das Gerät wird vom DCS nicht erkannt.

Wenn keine Verbindung mit dem Gerät hergestellt werden konnte (Schritt 1), und das Gerät vom DCS (Schritt 2) nicht erkannt werden kann, liegt wahrscheinlich ein Problem mit der Konfiguration des physischen Geräts vor.

Überprüfen Sie zunächst, ob das Gerät vom Computer erkannt wurde.

Über ein Terminal:

1. Führen Sie sudo lsusb aus. Vergewissern Sie sich , dass Future Technology Devices International, Ltd FT4232H Quad HS USB-UART/FIFO IC in der Ausgabe angezeigt wird.

Verwenden eines PowerShell-Fensters:

1. Führen Sie Get-PnpDevice -PresentOnly | Where-Object { $_aus. InstanceId -match '^USB' }. Vergewissern Sie sich, dass MSFT MT3620 Std Interface in der Ausgabe angezeigt wird.

Wenn der vorherige Befehl nicht die erwartete Ausgabe zurückgibt, schließen Sie das Gerät an einen anderen USB-Anschluss an. Wenn das Problem dadurch immer noch nicht behoben wird, überprüfen Sie, ob die Jumper des Geräts ordnungsgemäß konfiguriert sind. Seeed MT3620 Development Kits werden beispielsweise ab Werk mit einem Jumperheader über die Pins 2 und 3 von J3 geliefert, der die Uhr aus dem Standard Netzteil antreibt. Überprüfen Sie, ob der Header nicht entfernt oder entfernt wurde.

Es konnte nicht direkt mit dem Gerät kommunizieren, aber das Gerät wird vom DCS erkannt .

Wenn keine Verbindung mit dem Gerät hergestellt werden konnte (Schritt 1), aber das Gerät vom DCS (Schritt 2) erkannt wurde, befindet sich das Gerät oder der Gerätekommunikationsdienst wahrscheinlich in einem fehlerhaften Zustand.

Wenn Sie gerade ein Gerät mit dem Internet verbunden haben und das Betriebssystem des Geräts veraltet ist, wendet das Gerät möglicherweise ein Betriebssystemupdate an. Es besteht auch eine geringe Chance, dass das Gerät ein Betriebssystemupdate nimmt, wenn die Zeit in einem Releasefenster zusammenfällt. Während eines Betriebssystemupdates können Sie nicht mit einem Gerät kommunizieren.

Wenn Sie vermuten, dass das Gerät auf dem neuesten Stand ist und/oder nicht mit dem Internet verbunden ist, besteht die nächstbeste Option darin, das Gerät zu trennen und erneut mit Ihrem PC zu verbinden. Dies sollte dazu führen, dass der DCS seine Verbindung mit dem Gerät erneuert und das Gerät auf einen ursprünglichen Zustand zurückgesetzt wird.

Wenn Sie das Gerät nicht trennen und erneut verbinden können, besteht die nächstbeste Option darin, den DCS neu zu starten. Über ein Terminal:

1. Führen Sie aus sudo azspheredctl restart. Vergewissern Sie sich, dass der Befehl erfolgreich abgeschlossen wurde.
   1. Wenn der Befehl fehlschlägt, führen Sie aus sudo systemctl restart azsphered.

Wenn Sie das Gerät nicht trennen und erneut verbinden können, besteht die nächstbeste Option darin, einen Befehl zum erneuten Scannen für den DCS ausstellen. Nach Dem Empfang dieses Befehls wird der DCS den FTDI-Schnittstellenchip für die Kommunikation mit dem MT3620 durchlaufen und zurückgesetzt. Verwenden eines PowerShell-Fensters:

1. Ausführen des Befehls az sphere device rescan-attached

Führen Sie nun den Befehl erneut aus, den Sie ursprünglich versucht haben. Wenn das Problem immer noch nicht behoben ist, besteht die nächstbeste Option darin, den DCS neu zu starten. In einem PowerShell-Fenster auf Administratorebene:

1. Führen Sie aus Restart-Service -Name AzureSphereDeviceCommunicationService. Vergewissern Sie sich, dass der Befehl erfolgreich abgeschlossen wurde.

Alternativ können Sie den DCS mithilfe einer grafischen Benutzeroberfläche neu starten.

1. Drücken Sie Start , und geben Sie Dienste ein. Klicken Sie mit der rechten Maustaste auf den Azure Sphere Device Communication Service , und wählen Sie Neu starten aus.

Führen Sie nun den Befehl erneut aus, den Sie ursprünglich versucht haben.

Wenn der Befehl weiterhin fehlschlägt oder az sphere device list-attached eine Ausgabe wie folgt aufweist:

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

Ausführen az sphere device recover

Kann direkt mit dem Gerät kommunizieren, und das Gerät wird vom DCS erkannt

Dies deutet wahrscheinlich auf ein Problem mit der CLI hin. Stellen Sie sicher, dass Sie über die neueste Version des SDK verfügen.

Wenn Sie über die neueste Version des SDK verfügen und Ihr Problem immer noch nicht behoben ist, stellen Sie eine Frage im Q&A-Forum.

Unterbrochene Verbindungen oder fehlende Geräte

Wenn Ihr Computer eine Verbindung mit dem Azure Sphere-Gerät herstellen kann, die Verbindung aber häufig getrennt wird, liegt möglicherweise ein Konflikt im IP-Subnetz vor.

Azure Sphere verwendet das Subnetz 192.168.35.*. Wenn Sie über andere Software verfügen, die dasselbe Subnetz verwendet, deaktivieren Sie diese Software, oder beschränken Sie den bereich der verwendeten IP-Adressen. Derzeit können Sie den von Azure Sphere verwendeten IP-Adressbereich nicht ändern.

Gerätefunktionen können nicht angewendet werden

Wenn Beim Versuch, eine Gerätefunktion auf ein Azure Sphere-Gerät anzuwenden, Fehler angezeigt werden, besteht das Problem möglicherweise darin, dass das Betriebssystem auf Ihrem Gerät veraltet ist. Dieses Problem kann auftreten, wenn das Gerät für einen längeren Zeitraum offline war, während dessen Microsoft seine internen Schlüssel aktualisiert hat. Die folgenden Fehler sind Symptome dieses Problems:

Die Befehle az sphere device enable-development oder az sphere device enable-cloud-test geben einen Fehler ähnlich dem folgenden zurück:

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

Der Befehl az sphere device capability update gibt einen Fehler ähnlich dem folgenden zurück:

error: Could not apply device capability configuration to device.

Dies liegt daran, dass der vertrauenswürdige Keystore auf dem Gerät veraltet ist. Um dieses Problem zu lösen, folgen Sie den Anweisungen hier.

Fehler beim Erstellen von vier seriellen USB-Konvertern

Nachdem Sie ein MT3620-Entwicklungsboard eingerichtet haben, sollten vier serielle USB-Konverter in Geräte-Manager angezeigt werden. Wenn weniger als vier angezeigt werden, liegt möglicherweise ein Problem mit dem FTDI-Treiber vor.

Hinweis

Wenn dieses Board zuvor für die RTApp-Entwicklung verwendet wurde, sehen Sie möglicherweise drei Konverter anstelle von vier. Dies ist normal und stellt keinen Fehler dar.

Wenn der FTDI-Treiber nicht ordnungsgemäß installiert ist, werden die Konverter möglicherweise am falschen Ort angezeigt, z. B. Andere Geräte, oder werden überhaupt nicht angezeigt.

So beheben Sie dieses Problem:

1. Klicken Sie zum Öffnen Geräte-Manager auf Start, und geben Sie Geräte-Manager ein.

2. Wählen Sie unter Universal Serial Bus-Controller die Option USB Serial Converter A aus. Klicken Sie mit der rechten Maustaste auf den Namen, wählen Sie Gerät deinstallieren aus, und löschen Sie den Treiber, wenn die Option angegeben ist:

   

   Wiederholen Sie diesen Schritt für usb Serial Converter B bis USB Serial Converter D.

3. Trennen Sie das Entwicklungsboard von Ihrem PC, und schließen Sie es wieder an. "MSFT MT3620 Std Interface" sollte mit einem Dreieckswarnsymbol angezeigt werden, das angibt, dass kein Treiber verfügbar ist.

4. Klicken Sie mit der rechten Maustaste auf eines der MSFT MT3620 Std Interface-Geräte, und wählen Sie Treiber aktualisieren aus. Wählen Sie Search automatisch für aktualisierte Treibersoftware aus. Wenn Sie eine aktualisieren, sollten sie alle behoben werden. Im Abschnitt Universal Serial Bus-Controller sollten nun vier serielle USB-Konverter angezeigt werden. Wenn nicht alle vier Konverter angezeigt werden, wiederholen Sie diesen Schritt für jeden Konverter.

Fehler beim Installieren von FTDI-Treibern

Die FTDI-Treiber sollten automatisch von Windows heruntergeladen und installiert werden, wenn Ihr Azure Sphere-Gerät zum ersten Mal an Ihren PC angeschlossen ist. Wenn die Treiber ordnungsgemäß installiert sind, werden vier serielle USB-Konverter unter Universal Serial Bus-Controller in Geräte-Manager aufgeführt, wie unter Einrichten Ihres Dev Kits beschrieben.

Windows 10, Version 2004, sucht nicht nach den Treibern. In diesem Fall werden die Treiber nicht automatisch heruntergeladen und installiert, und die folgenden Elemente werden in Geräte-Manager aufgeführt:

Um die Treiber zu installieren, laden Sie die Treiber manuell von Future Technology Devices International (FTDI) herunter. Wählen Sie den Treiber aus, der Ihrer Windows-Installation entspricht (32- oder 64-Bit).

Verfügbarkeitsdaten und Buildnummern von Windows 10 Versionen finden Sie unter Windows 10 Releaseinformationen. Anhand dieser Informationen können Sie ermitteln, ob Ihre Version von Windows 10 früher oder höher als Version 2004 ist.

Verbindungsprobleme, die durch TAP-Windows Adapterkonfiguration verursacht werden

Azure Sphere-Tools kommunizieren mit angeschlossenen Entwicklungsboards über ein IP-Netzwerk über USB. Dies erfordert den TAP-Windows Adapter von OpenVPN Technologies. Der Azure Sphere SDK-Installationsvorgang installiert diesen Adapter auf Ihrem PC, sofern er noch nicht vorhanden ist.

Es wurden zwei verschiedene Arten von Problemen mit dem TAP-Windows-Adapter gemeldet:

• Wenn bereits eine andere Version des TAP-Windows-Adapters installiert ist oder das Azure Sphere-Gerät nicht mit dem ersten instance des TAP-Windows Adapters verbunden ist, können die Azure Sphere-Tools möglicherweise keine Verbindung mit Ihrem Gerät herstellen.

• Wenn Sie das Cisco AnyConnect-VPN (Virtual Private Network) verwenden, scheint Ihr TAP-Windows Adapter möglicherweise nicht angeschlossen zu sein, und die Gerätekommunikation funktioniert möglicherweise nicht. Dies liegt daran, dass das VPN Datenverkehr von der IP-Adresse des TAP-Adapters weg umleiten kann.

Stellen Sie sicher, dass das Azure Sphere-Gerät mit dem entsprechenden TAP-Windows Adapter verbunden ist.

Um zu ermitteln, ob das Problem mit dem TAP-Adapter zusammenhängt, ermitteln Sie zunächst, wie viele TAP-Adapter auf Ihrem PC installiert sind, und ändern Sie dann die Installation bei Bedarf.

So bestimmen Sie, wie viele TAP-Adapter auf Ihrem PC installiert sind:

1. Öffnen Sie Windows-Einstellungen, und wählen Sie die Gruppe Netzwerk & Internet aus.

2. Wählen Sie unter Erweiterte Netzwerkeinstellungen die Option Adapteroptionen ändern aus. Es sollte nur ein TAP-Adapter angezeigt werden, wie im folgenden Screenshot gezeigt:

   

   Wenn mehrere TAP-Adapter angezeigt werden oder nur ein TAP-Adapter angezeigt wird, dessen Name aber nicht Azure Sphere lautet, führen Sie die folgenden Schritte aus, um alle TAP-Adapter zu deinstallieren und das SDK neu zu installieren. Wenn keine TAP-Adapter angezeigt werden, installieren Sie das SDK neu.

So deinstallieren Sie die TAP-Adapter:

1. Klicken Sie auf Start, und geben Sie Geräte-Manager ein.

2. Öffnen Sie Geräte-Manager Netzwerkadapter, und wählen Sie TAP-Windows-Adapter aus:

   

3. Klicken Sie mit der rechten Maustaste auf TAP-Windows-Adapter , und wählen Sie Gerät deinstallieren aus. Wählen Sie im Dialogfeld Die Treibersoftware für dieses Gerät löschen aus, und klicken Sie dann auf Deinstallieren.

4. Öffnen Sie eine Eingabeaufforderung als Administrator, und führen Sie das folgende PowerShell-Installationsskript aus:

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

5. Wenn die Installation erfolgreich ist, starten Sie den Azure Sphere Device Communication Service neu:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

6. Installieren Sie das Azure Sphere SDK neu.

Korrigieren des Nichtverbindungszustands bei Verwendung des Cisco AnyConnect VPN-Clients

Wenn Sie den Cisco AnyConnect VPN-Client verwenden, wird der TAP-Windows Adapter möglicherweise nicht angeschlossen angezeigt, und die Gerätekommunikation funktioniert möglicherweise nicht. Sie können das Problem wie folgt beheben:

1. Stellen Sie sicher, dass Sie über Administratorrechte auf Ihrem Computer verfügen.

2. Öffnen Sie Windows-Einstellungen, und wählen Sie die Gruppe Netzwerk & Internet aus.

3. Wählen Sie unter Erweiterte Netzwerkeinstellungen die Option Adapteroptionen ändern aus.

4. Klicken Sie mit der rechten Maustaste auf Azure Sphere TAP-Windows Adapter V9 , und wählen Sie Eigenschaften aus.

5. Suchen Sie auf der Registerkarte Netzwerk den Eintrag Cisco AnyConnect Network Access Manager Filter Driver , und deaktivieren Sie das Element.

   

6. Wählen Sie OK aus, um die Einstellung zu speichern und die Eigenschaften zu beenden.

7. Überprüfen Sie, ob die Kommunikation mit Ihrem Azure Sphere-Gerät jetzt funktioniert, indem Sie eine Eingabeaufforderung öffnen und den az sphere device show-attached Befehl eingeben.

Gerät reagiert nicht

Mindestens einer der folgenden Fehler eines azsphere-Befehls kann darauf hindeuten, dass der Azure Sphere Device Communication Service nicht gestartet werden konnte:

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

Stellen Sie sicher, dass Sie die Schritte zur Problembehandlung für die Gerätekommunikation ausgeführt haben.

Wenn Ihr Problem immer noch nicht behoben ist und Ihr Computer kürzlich ein Windows-Update durchgeführt hat, kann der Gerätekommunikationsdienst nach dem Windows-Update und in Fällen, in denen eine der internen JSON-Einstellungsdateien oder die Konfigurationsdatei beschädigt wurde, möglicherweise nicht mehr gestartet werden.

Fehler nach Windows Update

Diese Fehler können auftreten, nachdem Sie Windows auf Ihrem PC aktualisiert haben. Manchmal deinstalliert Windows Update die für den Kommunikationsdienst erforderlichen FTDI-Treiber.

So beheben Sie das Problem:

1. Trennen Sie das Azure Sphere-Gerät vom USB-Gerät, und schließen Sie es erneut an. Nach dem erneuten Trennen des Geräts sollten die richtigen Treiber neu installiert werden.
2. Wenn das Problem beim Trennen und erneuten Trennen des Geräts nicht behoben werden kann, deinstallieren Sie das Azure Sphere SDK, und installieren Sie es erneut.

JSON-Datei

Wenn Sie Windows nicht kürzlich aktualisiert haben, kann die Ursache des Fehlers die restore.json Datei sein, die für den Dienst verwendet wird.

So beheben Sie dieses Problem:

1. Speichern Sie eine Kopie der folgenden Datei:

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

2. Löschen Sie die Datei am ursprünglichen Speicherort.

3. Beenden Sie den Azure Sphere Device Communication Service, und starten Sie ihn neu:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

Beschädigte Konfigurationsdatei

Wenn beim Versuch, einen Befehl auszuführen, ein Fehler gemeldet wird, verhindert die beschädigte Konfigurationsdatei möglicherweise, dass Ihr Gerät ordnungsgemäß ausgeführt wird.

Um dieses Problem zu beheben, löschen Sie die beschädigte Konfigurationsdatei in .azsphere\config unter Windows oder ~/.azsphere/config unter Linux.

Windows stürzt beim Anschließen oder Trennen eines Geräts ab

Das MT3620-Entwicklerboard verfügt über einen FTDI-FT4232HQ-Chip (Future Technology Devices International), der die Kommunikation zwischen dem Gerät und dem PC erleichtert. Der offizielle FTDI-Treiber, Combined Driver Model (CMD), enthält zwei Treiber: einer bietet Zugriff über die D2XX-API und der andere einen virtuellen Com-Port (VCP) für dasselbe Gerät. Beide Treiber werden standardmäßig installiert, wenn auf dem FTDI-Chip der VCP-Modus aktiviert ist. Dies kann dazu führen, dass Windows abstürzt, wenn der Chip eingeschalten wird.

Um dieses Problem zu beheben, können Sie den VCP-Modus für den FTDI-Chip deaktivieren. Sie müssen das FT_PROG Tool verwenden, um die EEPROM des FTDI-Chips neu zu programmieren.

1. Informationen zum Herunterladen und Installieren dieses Tools finden Sie unter FTDI FT_PROG-Programmiertool .

2. Führen Sie FT_PROG aus, und suchen Sie ihr angeschlossenes Gerät, wie unter FT_PROG GUI-Anwendung beschrieben.

3. Erweitern Sie in der Ansicht Gerätestruktur den Abschnitt Hardwarespezifisch . Es sollten vier Ports angezeigt werden.

   

4. Wählen Sie Port A und dann D2XX Direct anstelle von Virtual Com Port aus.

   

5. Wiederholen Sie den vorherigen Schritt für Port C und Port D. Port B sollte sich bereits im D2XX Direct-Modus befinden.

6. Wählen Sie das Symbol Programmgeräte (ähnelt einem Blitz), um in den Programmiermodus zu wechseln.

   

7. Wählen Sie Programm aus, um das EEPROM zu programmieren, und warten Sie dann, bis der Vorgang abgeschlossen ist.

   

8. Trennen Sie ihr Gerät vom USB-Anschluss, schließen Sie es dann erneut an, um das Gerät einzuschalten, und lassen Sie die Änderung wirksam werden. In Windows Geräte-Manager sollte der Abschnitt Ports (COM & LPT) jetzt drei COM-Ports weniger anzeigen. Die Anzahl der Universal Serial Bus-Geräte sollte unverändert bleiben.

Verbindung mit NICHT-Azure Sphere FTDI-Geräten nach aktivierung des RTApp-Debugs unterbrochen

Einige Azure Sphere-Benutzer haben berichtet, dass sie nicht mehr mit anderen angefügten FTDI-Geräten kommunizieren können, nachdem sie den Befehl az sphere device enable-development --enable-rt-core-debugging zum Entwickeln und Debuggen von RTApps auf ihrem Host-PC verwendet haben.

Wenn Sie z. B. sowohl ein Azure Sphere-Gerät als auch ein anderes FTDI-Gerät an Ihren PC angeschlossen haben, sehen Sie möglicherweise zwei universelle serielle Controller mit dem Namen USB Serial Converter B-Geräte in Windows Geräte-Manager, bevor Sie den Befehl ausführen.

Nach dem Ausführen des Befehls verschwinden beide Usb Serial Converter B-Geräte aus dem Abschnitt Universal Serial Bus Controller, und zwei neue Geräte werden in der Anzeige von Universal Serial Bus-Geräten in Geräte-Manager angezeigt.

Ursache

Dieses Problem tritt auf, weil der Befehl az sphere device enable-development --enable-rt-core-debugging einen neuen Treiber für Port B des FTDI-Chips auf dem MT3620 installiert. Der Port wird dann zu MSFT MT3620 Std Interface. Bei der Installation dieses Treibers wird jedoch versehentlich der Treiber für Port B des anderen Nicht-Azure Sphere-Geräts geändert. Aufgrund einer Einschränkung in der zugrunde liegenden Bibliothek wird der Port B-Treiber für alle FTDI-Geräte mit derselben VID (0x0403) und PID (0x6011) ersetzt.

Lösung

Führen Sie die folgenden Schritte aus, um den Treiber für alle Nicht-Azure Sphere-Geräte manuell auf die vorherige Version zu rückgängig machen:

1. Wählen Sie in Geräte-Manager das Nicht-Azure Sphere-Gerät aus (im Beispiel ein weiteres FTDI Quad GZ), klicken Sie dann mit der rechten Maustaste, und wählen Sie Treiber aktualisieren aus.

2. Wählen Sie unter Treiber aktualisieren die Option Computer nach Treibersoftware durchsuchen aus.

   

3. Wählen Sie Aus einer Liste der verfügbaren Treiber auf meinem Computer auswählen aus.

   

4. Wählen Sie den Usb Serial Converter B-Treiber aus der Liste aus, und klicken Sie dann auf Weiter.

   

5. Klicken Sie im Bestätigungsfenster auf Schließen .

6. Geräte-Manager sollte Port B für das andere FTDI-Gerät als serieller USB-Konverter B anzeigen, was angibt, dass der offizielle FTDI-Treiber verwendet wird. Der Treiber für das MT3620 bleibt MSFT MT3620 Std Interface.

   

Weitere Informationen

• Wenn Sie nach dem Ausführen des Befehls azsphere device enable-development --enable-rt-core-debugging ein weiteres Nicht-Azure Sphere FTDI-Gerät anschließen, wird diesem Gerät auf die gleiche Weise der Azure Sphere MT3620-Treiber zugewiesen. Wiederholen Sie die obigen Schritte, um das Gerät an den offiziellen FTDI-Treiber zu rückgängig machen.

• Wenn Sie ein Nicht-Azure Sphere FTDI-Gerät trennen und erneut anschließen, nachdem Sie es an den offiziellen FTDI-Treiber zurückgegeben haben, behält das Gerät den offiziellen FTDI-Treiber bei.

• Wenn Sie den Befehl az sphere device enable-development --enable-rt-core-debugging erneut ausführen, nachdem Sie den Treiber rückgängig machen, wird der Treiber für das Nicht-Azure Sphere FTDI-Gerät erneut ersetzt, und Sie müssen die Schritte unter Lösung zum rückgängig machen zum offiziellen FTDI-Treiber ausführen. Dies geschieht unabhängig davon, ob das Nicht-Azure Sphere FTDI-Gerät an den PC angefügt ist, wenn der Befehl az sphere device enable-development --enable-rt-core-debugging ausgeführt wird.

Befehle nicht erkannt

Wenn beim Eingeben eines azsphere-Befehls der folgende Fehler angezeigt wird, stellen Sie sicher, dass Sie PowerShell oder eine Standardeingabeaufforderung unter Windows verwenden.

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

Installationsprogramm hängt bei 60 Prozent

Das Installationsprogramm hängt bei 60 %, und Sie werden informiert, dass der Device Communication Service nicht gestartet werden konnte. Dies tritt in der Regel auf, wenn die Installation des TAP-Treibers auf ungewöhnliche Weise fehlschlägt und das System in einem unbestimmten Zustand bleibt.

Vergewissern Sie sich, dass das Problem der TAP-Treiber ist.

1. Öffnen Sie die Windows-Ereignisanzeige, um die Protokolle zu überprüfen.

2. Suchen Sie im Anwendungsprotokoll und im Azure Sphere Device Communication Service-Protokoll nach der folgenden Fehlermeldung:

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

   

3. Filtern Sie beim Überprüfen des Anwendungsprotokolls das Protokoll, um zu vermeiden, dass die vielen nicht verbundenen Nachrichten angezeigt werden. Wählen Sie auf der Registerkarte Aktion die Option Aktuelles Protokoll filtern aus.

4. Wählen Sie Fehler und dann AzureSphereDeviceCommunicationService aus, um nur Fehlermeldungen vom Azure Sphere Device Communication Service aufzulisten.

   

5. Wenn Sie den Fehler weder im Anwendungsprotokoll noch im Azure Sphere Device Communication Service-Protokoll finden, ist dies möglicherweise kein TAP-Treiberproblem.

Führen Sie die folgenden Schritte aus, um das TAP-Treiberproblem zu beheben:

1. Wechseln Sie zum Netzwerk- und Freigabecenter, und wählen Sie Adaptereinstellungen ändern aus.

   

2. Wählen Sie unter Netzwerk Connections unter Azure Sphere die Option TAP-WIndows Adapter V9 aus, und öffnen Sie die zugehörigen Eigenschaften.

   

3. Wählen Sie unter Azure Sphere-Eigenschaften die Option Internetprotokoll Version 4 (TCP/IPv4) und dann Eigenschaften aus, um die Protokolleinstellungen anzuzeigen.

   

4. Stellen Sie sicher, dass die IP-Adresse auf 192.168.35.1 und die Subnetzmaske auf 255.255.255.0 festgelegt ist.

5. Versuchen Sie es erneut mit dem Installationsprogramm. Wenn es weiterhin hängt, versuchen Sie, Ihre Netzwerkverbindungen zurückzusetzen. Wechseln Sie zum Zurücksetzen zu Einstellungen>Netzwerk & Internetstatus>, und wählen Sie unten auf der Seite Netzwerkzurücksetzung aus.

   Wichtig

   Wenn Sie Ihr Netzwerk zurücksetzen, werden alle Netzwerkeinstellungen zurückgesetzt.

Beenden des Azure Sphere Device Communication Service

Wenn das Installationsprogramm hängt, können Sie den Azure Sphere Device Communication Service mit dem Befehl taskkill beenden.

Führen Sie die folgenden Schritte aus:

1. Kopieren Sie die PID für AzureSphereDeviceCommunicationService.

   • Wechseln Sie zur Registerkarte Task-Manager-Dienste>, und notieren Sie sich die PID für den Dienst AzureSphereDeviceCommunicationService, oder
   • Geben Sie in der Befehlszeile die PID aus der Ausgabe ein tasklist /fi "SERVICES eq AzureSphereDeviceCommunicationService*" , und kopieren Sie sie.

2. Geben Sie Folgendes in die Befehlszeile ein, um den Dienst zu beenden. Der Taskkill-Befehl beendet den Prozess, der der Prozess-ID-Nummer entspricht. Die /f Option wird verwendet, um den Prozess erzwungen zu beenden.

   taskkill /PID <DCS_PID> /f

3. Versuchen Sie es erneut mit dem Installationsprogramm.

Azure Sphere Device Communication Service kann nicht beendet werden

Beim Upgrade eines vorhandenen Azure Sphere SDK wird möglicherweise die Meldung "Der Dienst 'Azure Sphere Device Communication Service' (AzureSphereDeviceCommunicationService) konnte nicht beendet werden. Vergewissern Sie sich, dass Sie über ausreichende Berechtigungen zum Beenden von Systemdiensten verfügen." Wenn Sie diese Meldung erhalten, starten Sie das Installationsprogramm neu, und führen Sie es erneut aus.

Die Gerätekommunikation ist unterbrochen, wenn geteiltes Tunneling verwendet wird

Wenn ein Entwicklungscomputer mit dem Unternehmens-VPN verbunden ist und split tunneling durch die VPN-Konfiguration deaktiviert wird, kann der Entwicklungscomputer möglicherweise nicht mit dem Azure Sphere-Gerät kommunizieren.

Führen Sie einen der folgenden Schritte aus, um dieses Problem zu beheben:

• Trennen Sie die Verbindung mit dem Unternehmens-VPN, und versuchen Sie erneut, die Verbindung mit dem Azure Sphere-Gerät herzustellen.
• Ändern Sie die VPN-Konfiguration, um geteiltes Tunneling zuzulassen.

Kommunikationsprobleme können auch durch die konfiguration des TAP-Windows Adapters verursacht werden. Weitere Informationen finden Sie im Abschnitt Problembehandlung für TAP-Windows Adapterkonfiguration verursachte Verbindungsprobleme .

Installieren oder Deinstallieren des Azure Sphere SDK auf Windows 11 nicht möglich

Nach dem Upgrade auf Windows 11 können Benutzer das Azure Sphere SDK nicht installieren oder deinstallieren. Installieren Sie zum Beheben dieses Problems die neueste Version des Azure Sphere SDK für Windows. Nach der Installation von Update 21.07 oder höher können Sie das SDK deinstallieren.

Kompilieren oder Debuggen von RTApps nicht möglich

Wenn CMake Fehler beim Finden der Toolkette meldet oder openocd wenn Sie versuchen, eine RTApp zu erstellen oder zu debuggen, stellen Sie Folgendes sicher:

• Sie haben die GNU Arm Embedded Toolchain für Ihre Entwicklungsumgebung installiert.
• Sie haben den richtigen Pfad zu openocd angegeben, wie unter Tutorial: Erstellen einer echtzeitfähigen Anwendung beschrieben.

Behandeln von Problemen bei der Gerätekommunikation vor 23.05

Warnung

Diese Schritte gelten für Benutzer mit SDK-Version 22.11 oder früher. Überprüfen Sie, ob die installierte SDK-Version 22.11 oder früher ist, indem Sie azsphere show-version ausführen.

Auf Linux-Systemen, auf denen die SDK-Version 22.11 oder früher ausgeführt wird, muss das azsphere_connect.sh-Skript jedes Mal ausgeführt werden, wenn Sie das Gerät anschließen oder es trennen oder erneut trennen. Das Skript aktualisiert Geräteverbindungen und erzeugt einen Kerneltreiber, der dem Gerät Netzwerkdatenverkehr zuordnet.

Wenn Kommunikationsprobleme auftreten, beginnen Sie mit den folgenden grundlegenden Schritten:

1. Stellen Sie sicher, dass das Gerät über USB verbunden ist.

2. Führen Sie das azsphere_connect.sh-Skript aus, sofern noch nicht geschehen.

3. Vergewissern Sie sich, dass Sie direkt mit dem Gerät kommunizieren können. Navigieren Sie in einem Webbrowser zu https://192.168.35.2/status . Ignorieren und schließen Sie alle angezeigten SSL-Warnungen. Es sollte eine Ausgabe ähnlich der folgenden angezeigt werden: {"uptime":56} im Webbrowserfenster.

Hinweis

Sie können diesen Schritt auch über die Befehlszeile mit curl https://192.168.35.2/status --insecureausführen.

1. Wenn der Fehler weiterhin auftritt, trennen Sie das Gerät vom USB-Anschluss, schließen Sie es erneut an, und warten Sie, bis es neu gestartet wird. Führen Sie dann das azsphere_connect.sh-Skript aus.

2. Wenn der Fehler weiterhin auftritt, stellen Sie sicher, dass keine Subnetzkonflikte mit anderen Netzwerktools vorliegen.