Matter-Fehlerbehebung

Wird erstellt

Kompatibilität des Smartphones überprüfen

Alle Geräte der Kategorie Android O (8.1, API-Level 27) und höher sind mit Matter kompatibel. Befolge die folgenden Schritte, um zu prüfen, ob dein 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. Aktiviere auf deinem Android-Smartphone die Entwickleroptionen und die USB-Debugging-Funktion.

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

So kannst du prüfen, ob die Google Play services Matter-Module vorhanden sind:

  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 eine Ausgabe ähnlich der folgenden angezeigt wird, sind die Matter-Module installiert: 
    com.google.android.gms.home [v222110900]
    Beachten Sie, dass sich die oben genannte Versionsnummer von der Versionsnummer Ihres Geräts unterscheiden kann.
  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 eine Ausgabe wie im folgenden Beispiel angezeigt wird, 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, bedeutet das, dass

  1. Du hast eine veraltete Android-Version. Der Wert muss mindestens Android O (8.1) sein.
  2. Die Matter-Module wurden noch nicht heruntergeladen. Warten Sie mindestens 24 Stunden, bis sie heruntergeladen sind. Das Gerät muss eingeschaltet sein und aufgeladen werden, damit sich der Download nicht verzögert. Wenn Sie die Module nicht innerhalb von 24 Stunden erhalten haben, können Sie versuchen, das Gerät auf die Werkseinstellungen zurückzusetzen, um das Herunterladen der Module zu erzwingen.

Geräteprotokolle für den Fuchsia-Hub

So aktivieren Sie einen Hub für den lokalen Logabruf:

  1. Sende eine E-Mail mit der Seriennummer und dem Modell deiner Geräte an deine Technical Account Manager (TAM) von Google. Sie finden sie in kleinen Buchstaben unter dem Gerät.
  2. Sobald Sie auf die Zulassungsliste gesetzt wurden, müssen Sie das Feature so aktivieren:
    • Über den Hub:
      1. Wischen Sie vom oberen Displayrand nach unten.
      2. Tippe auf das Symbol „Einstellungen“
      3. So finden Sie die Fuchsia-Version: Rufen Sie auf einem Google Nest Hub (2nd gen) Geräteinformationen > Technische Daten > Fuchsia-Version auf.
      4. Tippen Sie siebenmal auf „Fuchsia-Version“. Dadurch werden die Entwickleroptionen
      5. Zurück zum Menü der obersten Ebene
      6. Tippen Sie auf „Entwickleroptionen“.
      7. Tippe auf „Partner-Logging“.
    • Die Funktion ist 24 Stunden lang aktiviert. Aktivieren Sie anschließend die Logging-Funktion ab Schritt 5 wieder.
  3. Rufen Sie die IP-Adresse Ihres Hubs ab:
    • Falls ein Bildschirm über den Hub angezeigt wird, gehen Sie so vor:
      1. Wischen Sie vom oberen Displayrand nach unten.
      2. Tippe auf das Symbol „Einstellungen“
      3. Ermitteln Sie die IP-Adresse des Geräts: Rufen Sie auf einem Nest Hub (2nd gen) Geräteinformationen > Technische Daten > IP-Adresse auf.
    • Ü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 „Einstellungen“ , um die Seite „Einstellungen“ aufzurufen.
      3. Die IP-Adresse des Geräts finden Sie unter Geräteinformationen > Technische Daten > IP-Adresse.
  4. Um Protokolle vom Hub abzurufen, 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 geöffnet bleiben, aber die aus dem Zwischenspeicher abgerufenen Daten umfassen in der Regel 20 bis 30 Minuten vergangene Ereignisse.
      • Im Idealfall werden Protokolle mit dieser Methode direkt nach Abschluss eines Testverfahrens extrahiert, um sicherzustellen, dass der Zwischenspeicher für den Test relevante Inhalte enthält (ä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 für Produktionsgeräte oder -nutzer.
  • Schritte:
    1. Senden Sie die Google-Konten der Nutzer mit nicht entfernten Protokollen 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 ein Projekt und eine Einbindung in der Google Home Console erstellen.

Fehlerbehebung bei Bluetooth Sniffer

Der VID/PID-Wert, den Ihr Gerät per Beacon sendet, sollte mit der VID/PID übereinstimmen, die Sie in Ihrem Google Home Developer Console-Projekt eingegeben haben.

  • VIDs 0xFFF1 — 0xFFF4 sind für Tests reserviert. Sie können für grundlegende Inbetriebnahme- und Kontrolltests verwendet werden. In den folgenden Entwicklungsphasen können sie jedoch nicht verwendet werden:

Wenn Sie eine Bluetooth-App für Techniker wie nRF Connect for Mobile verwenden, können Sie die VID/PID des Beacon-Geräts im Feld Dienstdaten 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. Dieser Wert gibt die VID 5A23 und die PID FFFE an – beide im Little-Endian-Format.

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

Prüfe anhand der Anzeige des Bluetooth-Sniffers, ob die Werte und das Format in deinem Actions Console-Projekt korrekt eingegeben wurden.

Für die Werte im Beispielscreenshot würden die VID und die PID in Developer Console 235A bzw. FEFF sein.

Prüfen, ob das 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. Unter Öffentliche Versionshinweise 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 auf dem Gerät die richtigen Anmeldedaten vorhanden sind:

  • Zertifizierungserklärung.
  • Device Attestation Certificate (DAC) und seine Zertifikatskette

Weitere Informationen findest du unter Matter-Testzertifikate erstellen.

Matter-kompatiblen Hub prüfen

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

Einige Hubs sind auch Thread-Border-Router und ermöglichen es Ihnen damit, Thread-Geräte zu entwickeln und zu 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 ermöglichen.

Sie können Ihren Hub-Build überprüfen, indem Sie den Finger vom oberen Rand nach unten bewegen > Konfigurationsrad > Geräteinformationen > Technische Informationen > Chromecast-Firmwareversion.

Die Inbetriebnahme schlägt mit der Fehlermeldung „Keine Kontaktaufnahme mit Google“ fehl

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

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

Wenn du bei der Inbetriebnahme eines Thread-Geräts die Fehlermeldung „Gerät nicht erreichbar“ erhältst und alle verfügbaren Fehlerbehebungsoptionen ausgeschöpft hast, solltest du die gespeicherten bevorzugten Thread-Anmeldedaten auf deinem Android-Smartphone löschen, um eine saubere Einrichtung zu gewährleisten. Rufe dazu Einstellungen > Apps > App-Apps > Google Play-Dienste > Speicher und Cache > Speicherplatz verwalten > ALLE DATEN LÖSCHEN auf.

Testen

In Auftrag gegebenes 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, diese aber nicht angezeigt wird, wenn du versuchst, das Gerät mit der Test Suite in Developer Console zu testen, wird dies wahrscheinlich durch die Verwendung derselben Test-VID und -PID-Kombination für mehrere Integrationen verursacht.

Entfernen Sie zur Fehlerbehebung alle Testgeräte aus Developer Console und koppeln Sie das zu testende Gerät noch einmal.

Um zu prüfen, ob Sie die richtige Kopplung durchgeführt haben, können Sie die Hersteller- und Modellinformationen (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät in Ihrer Testfirmware auf eindeutige Werte setzen.

Weitere Informationen finden Sie unter Geräteinformationen.

Wenn immer noch Probleme auftreten

Wenn Sie alle Schritte zur Fehlerbehebung durchgeführt haben und das Problem weiterhin besteht, ist das kein Problem.

In den Schritten zur Fehlerbehebung hast du wichtige Daten zu deinem Gerät, deinem Konsolenprojekt und deiner Umgebung erfasst. Mit diesen Daten kannst du auf der Supportseite nachsehen, wie du dein Problem am besten mit der Community und dem Google Home-Supportteam teilen kannst.