Matter-Fehlerbehebung

Gebäude

Kompatibilität des Smartphones prüfen

Alle Geräte mit Android O (8.1, API-Level 27) und höher sind mit Matter kompatibel. Folgen Sie der Anleitung unten, um zu prüfen, ob Ihr Smartphone die erforderlichen Module hat.

Android Debug Bridge einrichten

Die Android Debug Bridge (adb) sollte vor der Fehlerbehebung eingerichtet werden. So gehts:

  1. Installiere „adb“ auf deinem Computer.
  2. Aktiviere die Entwickleroptionen und das USB-Debugging auf deinem Android-Smartphone.

Matter-Module der Google Play-Dienste prüfen

So prüfen Sie, ob Sie die Matter-Module Google Play services haben:

  1. Android Debug Bridge einrichten
  2. Verbinde dein Android-Smartphone über ein USB-Kabel mit deinem Computer.
  3. Führen Sie diesen Befehl in einem Terminal aus, um zu prüfen, ob die erforderlichen Matter-Module installiert sind: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
    Wenn die Ausgabe in etwa so aussieht, sind die Matter-Module installiert: 
    com.google.android.gms.home [v222110900]
     Die Versionsnummer oben kann von der auf deinem Gerät abweichen.
  4. Führen Sie diesen Befehl in einem Terminal aus, um zu prüfen, ob die erforderlichen Thread-Module installiert sind: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    Wenn die Ausgabe in etwa so aussieht, sind die Thread-Module installiert: 
    com.google.android.gms.threadnetwork [v222106301]
     Die Versionsnummer auf deinem Gerät kann abweichen.

Wenn die Module nicht aufgeführt sind, bedeutet das Folgendes:

  1. Du hast eine veraltete Android-Version. Es muss Android O (8.1) oder höher sein.
  2. Die Matter-Module wurden noch nicht heruntergeladen. Warten Sie mindestens 24 Stunden, bis sie heruntergeladen wurden. Achte darauf, dass dein Gerät während dieser Zeit eingeschaltet ist und geladen wird, damit sich der Download nicht verzögert. Wenn du die Module nicht innerhalb von 24 Stunden erhalten hast, kannst du versuchen, das Gerät auf die Werkseinstellungen zurückzusetzen, um den Download der Module zu erzwingen.

VID/PID des Geräts prüfen

Wenn du mit der Entwicklung deiner Integration mit Google beginnen möchtest, musst du in der Google Home Console ein Projekt und eine Integration erstellen.

Fehlerbehebung für Bluetooth-Sniffer

Der VID/PID-Wert, den dein Gerät sendet, muss mit der VID/PID übereinstimmen, die du in deinem Google Home Developer Console-Projekt eingegeben hast.

  • VIDs 0xFFF1–0xFFF4 sind für Tests reserviert. Sie können für grundlegende Inbetriebnahme- und Steuerungstests verwendet werden, aber nicht in den folgenden Entwicklungsphasen:

Mit einer Bluetooth-Engineering-App wie nRF Connect for Mobile können Sie die VID/PID des Beacon-Geräts im Feld Service Data sehen.

In diesem Screenshot der Android-Version von nRF Connect sehen Sie, dass die VID/PID ab dem vierten Byte des Felds Dienstdaten als 5A23FFFE aufgeführt ist. Dies weist auf eine VID von 5A23 und eine PID von FFFE hin, beide im Little-Endian-Format.

Die BLE-App zeigt die Werte im Little-Endian-Format an, die VID-/PID-Werte, die du in dein Developer Console-Projekt eingibst, sind jedoch im Big-Endian-Format.

Prüfen Sie anhand der Angaben des Bluetooth-Sniffers, ob die richtigen Werte und das richtige Format in Ihr Actions Console-Projekt eingegeben wurden.

Für die Werte im Beispiel-Screenshot wären die VID und PID in der Developer Console 235A bzw. FEFF.

Prüfen, ob Ihr Gerät mit einem kompatiblen Matter SDK-Zweig erstellt wurde

Google Matter-Hubs sind mit Matter 1.0 kompatibel und wurden mit Builds getestet, die Commits aus dem stabilen Branch v1.0-branch verwendet haben. In den öffentlichen Versionshinweisen finden Sie die spezifischen Commits, die für die Verwendung mit jedem neuen Hub-Release empfohlen werden.

Kopplung

Anmeldedaten für Ihr Gerät bestätigen

Wenn du deine eigene von Alliance zugewiesene VID verwendest, achte darauf, dass du die richtigen Anmeldedaten auf dem Gerät hast:

  • Zertifizierungserklärung (Certification Declaration, CD).
  • Device Attestation Certificate (DAC) und die zugehörige Zertifikatskette.

Weitere Informationen findest du unter Matter-Gerätetestzertifikate erstellen.

Matter-kompatiblen Hub prüfen

Dein Matter-Hub muss einer der von Google unterstützten Hubs sein. Außerdem muss es sich um einen Build handeln, der mit Matter kompatibel ist.

Einige Hubs sind auch Thread Border Router (TBR)s und ermöglichen es dir, Thread-Geräte zu entwickeln und zu testen. Andere Hubs unterstützen nur WLAN- und Ethernet-Geräte (Matter), es sei denn, du hast einen anderen border router in deinem Netzwerk, der Thread-Konnektivität ermöglicht.

Du kannst die Build-Version deines Hubs so prüfen: Wische mit dem Finger vom oberen Rand nach unten > Konfigurationsrad > Geräteinformationen > Technische Daten > Chromecast-Firmwareversion.

Die Inbetriebnahme schlägt mit der Fehlermeldung „Could not contact Google“ (Google konnte nicht kontaktiert werden) fehl.

Achte darauf, dass du in der Developer Console eine Integration mit der richtigen VID/PID-Kombination erstellt hast. Weitere Informationen findest du unter Matter-Integration erstellen.

Die Inbetriebnahme schlägt mit der Fehlermeldung „Gerät nicht erreichbar“ fehl.

Wenn du beim Einrichten eines Thread-Geräts immer wieder die Fehlermeldung „Gerät nicht erreichbar“ erhältst und alle verfügbaren Debug-Optionen ausgeschöpft hast, kannst du die gespeicherten bevorzugten Thread-Anmeldedaten auf deinem Android-Smartphone löschen, um eine saubere Einrichtung zu ermöglichen. Gehe dazu zu Einstellungen > Apps > Alle Apps > Google Play-Dienste > Speicher und Cache > Speicherplatz verwalten > ALLE DATEN LÖSCHEN.

Test

In Betrieb genommenes Gerät wird in der Test-Suite nicht angezeigt

Wenn du ein Gerät mit einer Test-Anbieter-ID (VID) und einer Test-Produkt-ID (PID) gekoppelt hast, es aber nicht angezeigt wird, wenn du versuchst, das Gerät mit der Test-Suite in Developer Console zu testen, liegt das wahrscheinlich daran, dass du dieselbe Kombination aus Test-VID und Test-PID für mehrere Integrationen verwendest.

Entfernen Sie zur Fehlerbehebung alle Testgeräte aus Developer Console und koppeln Sie das Gerät, das Sie testen möchten, noch einmal.

Um zu prüfen, ob du das richtige Gerät gekoppelt hast, kannst du die Hersteller- und Modellinformationen (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät in deiner Test-Firmware auf eindeutige Werte festlegen.

Weitere Informationen finden Sie unter Geräteinformationen.

Wenn weiterhin Probleme auftreten

Wenn das Problem nach allen Schritten zur Fehlerbehebung immer noch nicht behoben ist, ist das kein Problem.

In den Schritten zur Fehlerbehebung haben Sie wichtige Daten zu Ihrem Gerät, Ihrem Console-Projekt und Ihrer Umgebung erfasst. Mit diesen Daten kannst du auf der Supportseite nachlesen, wie du dein Problem am besten mit der Community und dem Google Home-Supportteam teilst.