Matter-Fehlerbehebung

Gebäude

Kompatibilität des Smartphones prüfen

Alle Android O (8.1, API-Level 27) und höher sind mit Matter kompatibel. Führen Sie die folgenden Schritte aus, um zu prüfen, ob Ihr Smartphone die erforderlichen Module hat.

Android Debug Bridge einrichten

Android Debug Bridge (adb) muss vor der Fehlerbehebung eingerichtet werden. So geht ihr dabei vor:

  1. Installieren Sie „adb“ auf Ihrem Computer.
  2. Aktivieren Sie die Entwickleroptionen und das USB-Debugging auf Ihrem Android.

Google Play-Dienste (GPS) Matter-Module bestätigen

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

  1. Richten Sie die Android Debug Bridge ein.
  2. Verbinden Sie Ihr Android über ein USB-Kabel mit Ihrem 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 sich von der Ihres Geräts unterscheiden.
  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 wie im folgenden Beispiel, sind die Thread-Module installiert: 
    com.google.android.gms.threadnetwork [v222106301]
     Die Versionsnummer auf Ihrem Gerät kann abweichen.

Wenn die Module nicht aufgeführt sind, liegt einer der folgenden Gründe vor:

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

Fuchsia-Hub-Geräteprotokolle

So aktivieren Sie einen Hub für den Abruf lokaler Protokolle:

  1. Senden Sie eine E-Mail mit der Seriennummer und dem Modell Ihrer Geräte an Ihre Google-Technical Account Manager (TAM). Sie finden sie in kleinen Buchstaben unter dem Gerät.
  2. Sobald Sie auf der Zulassungsliste stehen, müssen Sie die Funktion aktivieren:
    • Über den Hub:
      1. Wischen Sie vom oberen Displayrand nach unten.
      2. Tippe auf das Symbol für die Einstellungen .
      3. Fuchsia-Version ermitteln: Gehen Sie auf einem Google Nest Hub (2nd gen) zu Geräteinformationen > Technische Informationen > Fuchsia-Version.
      4. Tippen Sie siebenmal auf „Fuchsia-Version“. Dadurch werden die Entwickleroptionen aktiviert.
      5. Zurück zum Menü der obersten Ebene
      6. Tippen Sie auf „Entwickleroptionen“.
      7. Tippen Sie auf „Partnerprotokollierung“.
    • Die Funktion ist dann 24 Stunden lang aktiviert. Aktivieren Sie die Logging-Funktion dann ab Schritt 5 wieder.
  3. Rufen Sie die IP-Adresse Ihres Hubs ab:
    • Über den Hub, sofern er ein Display hat:
      1. Wischen Sie vom oberen Displayrand nach unten.
      2. Tippe auf das Symbol für die Einstellungen .
      3. IP-Adresse des Geräts ermitteln: Gehen Sie auf einem Nest Hub (2nd gen) zu Geräteinformationen > Technische Daten > IP-Adresse.
    • Über Google Home app (GHA) auf deinem Smartphone:
      1. Tippen Sie auf das Gerät, um die Seite mit den Gerätedetails aufzurufen.
      2. Tippe auf das Symbol für die Einstellungen , um die Seite „Einstellungen“ aufzurufen.
      3. IP-Adresse des Geräts finden: Gehen Sie zu Geräteinformationen > Technische Informationen > IP-Adresse.
  4. Wenn Sie Protokolle vom Hub abrufen möchten, stellen Sie von einem Computer im selben WLAN eine GET-HTTP-Anfrage an den Hub.
    • Notieren Sie sich den Port und den Pfad des Endpunkts: 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • Die Verbindung kann nur eine Minute lang geöffnet bleiben, aber die aus dem Puffer abgerufenen Daten umfassen in der Regel 20 bis 30 Minuten zurückliegende Ereignisse.
      • Idealerweise werden Protokolle mit dieser Methode direkt nach Abschluss eines Testverfahrens extrahiert, damit der Puffer für den Test relevante Inhalte enthält (ähnlich wie bei Android-Fehlerberichten).

Entfernen von Daten aus Android-Protokollen deaktivieren

  • Aus Datenschutz- und Sicherheitsgründen sollte diese Funktion nur zu technischen Testzwecken verwendet werden.
  • Verwenden Sie diese Option nicht für Produktionsgeräte oder ‑nutzer.
  • Schritte:
    1. Senden Sie die Google-Konten der Nutzer, deren Protokolle nicht entfernt wurden, an Ihre Google-TAM.
    2. Nachdem Sie bestätigt haben, dass Ihr Konto der Zulassungsliste hinzugefügt wurde, starten Sie Ihr Smartphone neu.

VID/PID des Geräts prüfen

Wenn Sie mit der Entwicklung Ihrer Integration mit Google beginnen möchten, müssen Sie ein Projekt und eine Integration in der Google Home Console erstellen.

Bluetooth-Sniffer – Fehlerbehebung

Der VID/PID-Wert, den Ihr Gerät sendet, muss mit der VID/PID übereinstimmen, die in Ihrem Google Home Developer Console-Projekt eingegeben wurde.

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

Mit einer Bluetooth-Entwicklungs-App wie nRF Connect for Mobile sehen Sie die VID/PID des Beaconing-Geräts im Feld Service Data (Dienstdaten).

In diesem Screenshot aus der Android-Version von nRF Connect ist die VID/PID ab dem vierten Byte des Felds Service Data als 5A23FFFE aufgeführt. Dies entspricht einer VID von 5A23 und einer PID von FFFE, beide im Little-Endian-Format.

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

Prüfen Sie, ob die richtigen Werte und das richtige Format in Ihr Actions Console-Projekt eingegeben wurden. Orientieren Sie sich dabei an den Angaben im Bluetooth-Sniffer.

Bei den Werten im Beispielscreenshot wären 235A und FEFF die VID und PID in Developer Console.

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

Google Matter-Hubs sind mit Matter 1.0 kompatibel und wurden mit Builds getestet, für die Commits aus dem stabilen Branch v1.0-branch verwendet wurden. In den Hinweisen zur öffentlichen Veröffentlichung finden Sie die Commits, die für jede neue Hub-Version empfohlen werden.

Kopplung

Anmeldedaten für Ihr Gerät bestätigen

Wenn Sie eine eigene von Alliance zugewiesene VID verwenden, müssen Sie die richtigen Anmeldedaten auf dem Gerät haben:

  • Zertifizierungserklärung (CD).
  • Das Zertifikat zur Geräteattestierung (Device Attestation Certificate, DAC) und die zugehörige Zertifikatskette.

Weitere Informationen finden Sie unter Matter-Gerätetestzertifikate erstellen.

Matter-kompatiblen Hub prüfen

Ihr Matter-Hub muss einer der von Google unterstützten Hubs sein. Außerdem muss es sich um eine Version handeln, die mit Matter kompatibel ist.

Einige Hubs sind auch Thread-Border-Router und ermöglichen so die Entwicklung und Prüfung von Thread-Geräten. Andere Hubs unterstützen nur WLAN- und Ethernet-Matter-Geräte, es sei denn, Sie haben einen anderen Border-Router in Ihrem Netzwerk, um die Thread-Verbindung zu ermöglichen.

So können Sie die Build-Version Ihres Hubs prüfen: Wischen Sie vom oberen Rand nach unten > Konfigurationsrad > Geräteinformationen > Technische Daten > Chromecast-Firmwareversion

Die Einrichtung schlägt mit der Fehlermeldung „Google konnte nicht kontaktiert werden“ fehl

Prüfe, ob du in der Developer Console eine Integration mit der richtigen VID/PID-Kombination erstellt hast. Weitere Informationen finden Sie unter Matter-Integration erstellen.

Die Inbetriebnahme schlägt mit der Fehlermeldung „Gerät kann nicht erreicht werden“ fehl

Wenn Sie bei der Inbetriebnahme eines Thread-Geräts immer wieder die Fehlermeldung „Gerät nicht erreichbar“ erhalten und alle verfügbaren Optionen zur Fehlerbehebung ausgeschöpft haben, können Sie die gespeicherten bevorzugten Thread-Anmeldedaten auf Ihrem Android-Smartphone löschen, um eine Neueinrichtung vorzunehmen. Gehen Sie dazu so vor: Einstellungen > Apps > App-Einstellungen > Google Play-Dienste > Speicher & Cache > Speicherplatz verwalten > ALLE DATEN LÖSCHEN.

Test

In Auftrag gegebenes Gerät wird in der Test Suite nicht angezeigt

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

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 Sie das richtige Gerät gekoppelt haben, können Sie die Informationen zum Hersteller und zum Modell (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät in Ihrer Testfirmware auf eindeutige Werte festlegen.

Weitere Informationen finden Sie unter Geräteinformationen.

Wenn weiterhin Probleme auftreten

Wenn das Problem nach der Durchführung aller hier beschriebenen Schritte zur Fehlerbehebung immer noch nicht behoben ist, ist das kein Problem.

Bei der Fehlerbehebung haben Sie wichtige Daten zu Ihrem Gerät, Ihrem Konsolenprojekt und Ihrer Umgebung erfasst. Anhand dieser Daten können Sie auf der Supportseite nachlesen, wie Sie Ihr Problem am besten der Community und dem Google Home-Supportteam mitteilen.