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. Führen Sie die folgenden Schritte aus, um zu prüfen, ob Ihr Smartphone über die erforderlichen Module verfügt.

Android Debug Bridge einrichten

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

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

Matter-Module für Google Play-Dienste (GPS) prüfen

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

  1. Android Debug Bridge einrichten
  2. Verbinden Sie Ihr Android-Smartphone ü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, haben Sie die Matter-Module installiert: 
    com.google.android.gms.home [v222110900]
    Hinweis: Die oben genannte Versionsnummer kann von der Ihres Geräts 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 im folgenden Beispiel ähnlich aussieht, haben Sie die Thread-Module installiert: 
    com.google.android.gms.threadnetwork [v222106301]
    Hinweis: Die Versionsnummer auf Ihrem Gerät kann abweichen.

Sind die Module nicht aufgeführt, bedeutet das entweder:

  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 sind. Achte darauf, dass dein Gerät während dieses Zeitraums eingeschaltet ist und geladen wird, damit der Download nicht verzögert wird. 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.

Fuchsia Hub-Geräteprotokolle

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

  1. Sende eine E-Mail mit der Seriennummer und dem Modell deiner Geräte an deine Google-Technical Account Manager (TAM). Sie sind in kleinen Buchstaben unter dem Gerät zu finden.
  2. Sobald Sie auf der Zulassungsliste stehen, müssen Sie die Funktion so aktivieren:
    • Über den Hub:
      1. Wischen Sie vom oberen Displayrand nach unten.
      2. Tippen Sie auf das Symbol „Einstellungen“ .
      3. So finden Sie die Fuchsia-Version: Gehen Sie auf einem Google Nest Hub (2nd gen) zu Geräteinformationen > Technische Daten > Fuchsia-Version.
      4. Tippe siebenmal auf „Fuchsia-Version“. Dadurch werden die Entwickleroptionen aktiviert
      5. Zurück zum Menü der obersten Ebene
      6. Tippen Sie auf „Entwickleroptionen“.
      7. Tippe auf „Partner-Logging“.
    • Die Funktion ist für 24 Stunden aktiviert. Aktivieren Sie dann die Logging-Funktion ab Schritt 5 wieder.
  3. Rufen Sie die IP-Adresse des Hubs ab:
    • Gehen Sie im Hub mit einem Bildschirm so vor:
      1. Wischen Sie vom oberen Displayrand nach unten.
      2. Tippen Sie auf das Symbol „Einstellungen“ .
      3. So finden Sie die IP-Adresse des Geräts: Gehen Sie auf einem Nest Hub (2nd gen) zu Geräteinformationen > Technische Daten > IP-Adresse.
    • Über Google Home app (GHA) auf Ihrem Smartphone:
      1. Tippen Sie auf das Gerät, um die Seite mit den Gerätedetails aufzurufen.
      2. Tippe auf das Symbol „Einstellungen“ , um die Seite mit den Einstellungen aufzurufen.
      3. Suchen Sie die IP-Adresse des Geräts: Gehen Sie zu Geräteinformationen > Technische Daten > IP-Adresse.
  4. Wenn Sie Protokolle vom Hub abrufen möchten, senden 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 offen gehalten werden, aber aus dem Zwischenspeicher abgerufene Daten enthalten in der Regel 20 bis 30 Minuten zurückliegende Ereignisse.
      • Idealerweise werden die Protokolle mit dieser Methode direkt nach Abschluss eines Testverfahrens extrahiert, um sicherzustellen, dass der Zwischenspeicher Inhalte enthält, die für den Test relevant sind (ähnlich wie bei Android-Fehlerberichten).

Entfernen von Android-Protokollen deaktivieren

  • Aus Datenschutz- und Sicherheitsgründen sollte diese Funktion nur zu technischen Testzwecken verwendet werden.
  • Verwenden Sie diese Option nicht bei Produktionsgeräten oder Nutzern.
  • Vorgehensweise:
    1. Senden Sie die Google-Konten der Nutzer, deren Protokolle nicht entfernt wurden, an Ihr Google-TAM.
    2. Nachdem Sie bestätigt haben, dass Ihr Konto auf die Zulassungsliste gesetzt wurde, starten Sie Ihr Smartphone neu.

Bestätige die VID/PID deines Geräts

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

Fehlerbehebung bei Bluetooth Sniffer

Der VID/PID-Wert, den dein Gerät im Beaconing nutzt, 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 Kontrolltests verwendet werden, jedoch nicht in den folgenden Entwicklungsphasen:

Wenn Sie eine Bluetooth-Engineering-App wie nRF Connect for Mobile verwenden, können Sie die VID/PID des Beaconing-Geräts im Feld Dienstdaten sehen.

In diesem Screenshot aus der Android-Version von nRF Connect ist die VID/PID beginnend beim vierten Byte des Felds Service Data als 5A23FFFE aufgeführt. Dies weist auf die VID 5A23 und die PID FFFE hin – beide im Little-Endian-Format.

Die BLE-Anwendung zeigt die Werte in Little-Endian an, aber die VID-/PID-Werte, die Sie in Ihr Developer Console-Projekt eingeben, haben Big-Endian-Werte.

Überprüfe anhand der vom Bluetooth-Sniffer angezeigten Daten, ob die richtigen Werte und das richtige Format in dein Actions Console-Projekt eingegeben wurden.

Für die Werte im Beispiel-Screenshot wären die VID und die PID im 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 Zweig 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 überprüfen

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

  • Zertifizierungserklärung (Zertifizierungserklärung, CD).
  • Geräteattestierungszertifikat (Device Attestation Certificate, DAC) und zugehörige Zertifikatskette.

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

Matter-kompatiblen Hub prüfen

Der Matter-Hub muss einer der von Google unterstützten Hubs sein. Außerdem muss es sich auf einem Build befinden, der mit Matter kompatibel ist.

Einige Hubs sind auch Thread-Border-Router. Daher können Sie Thread-Geräte entwickeln und testen. Andere Hubs unterstützen nur WLAN- und Ethernet-Matter-Geräte, es sei denn, Sie haben einen anderen Border-Router in Ihrem Netzwerk, um Thread-Verbindungen zu aktivieren.

Der Hub-Build kann folgendermaßen überprüft werden: Finger vom oberen Rand nach unten schieben > Konfigurationsrad > Geräteinformationen > Technische Informationen > Chromecast-Firmwareversion

Fehler bei der Inbetriebnahme und Fehlermeldung „Google konnte nicht kontaktiert werden“

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

Fehler bei der Inbetriebnahme und Fehlermeldung „Gerät kann nicht erreicht werden“

Wenn bei der Inbetriebnahme eines Thread-Geräts weiterhin die Fehlermeldung "Gerät nicht erreichbar" angezeigt wird und du alle verfügbaren Fehlerbehebungsoptionen ausgeschöpft hast, solltest du die gespeicherten bevorzugten Thread-Anmeldedaten auf deinem Android-Smartphone löschen, um die Einrichtung unter Einstellungen > Apps > App-Apps > Google Play-Dienste > Speicher und Cache > Speicherplatz verwalten > ALLE DATEN LÖSCHEN zu ermöglichen.

Testen

Ein zugelassenes Gerät wird nicht in der Test-Suite angezeigt

Wenn du ein Gerät mit einer Testanbieter-ID (VID) und einer Testprodukt-ID (PID) gekoppelt hast, es aber beim Testen des Geräts mit der Test-Suite in Developer Console nicht angezeigt wird, wird dies wahrscheinlich durch die Verwendung derselben Test-VID- und PID-Kombination in mehreren Integrationen verursacht.

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

Wenn du überprüfen möchtest, ob das Gerät richtig gekoppelt ist, kannst du für die Hersteller- und Modellinformationen (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) eindeutige Werte in deiner Testfirmware festlegen.

Weitere Informationen finden Sie unter Geräteinformationen.

Wenn weiterhin Probleme auftreten

Wenn du alle hier genannten Schritte zur Fehlerbehebung durchgeführt hast, kannst du dein Problem immer noch nicht lösen.

In den Schritten zur Fehlerbehebung haben Sie wichtige Daten zu Ihrem Gerät, Ihrem Konsolenprojekt und Ihrer Umgebung erfasst. Sehen Sie mit diesen Daten auf der Supportseite nach, wie Sie Ihr Problem am besten mit der Community und dem Google Home-Supportteam teilen können.