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. 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. Aktivieren Sie die Entwickleroptionen und das USB-Debugging auf Ihrem Android.

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

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

  1. Android Debug Bridge einrichten
  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 Sie eine ähnliche Ausgabe wie unten sehen, sind die Matter-Module installiert: 
    com.google.android.gms.home [v222110900]
    Die Versionsnummer oben 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 ähnlich wie im folgenden Beispiel aussieht, 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. 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 aktiviert.
      5. Zurück zum Menü der obersten Ebene
      6. Tippen Sie auf „Entwickleroptionen“.
      7. Tippen Sie auf „Partnerprotokollierung“.
    • Die Funktion ist 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 Zwischenspeicher abgerufenen Daten umfassen in der Regel 20 bis 30 Minuten vergangene 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 Ihr 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 – Problembehebung

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. 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 aus der Android-Version von nRF Connect ist die VID/PID ab dem vierten Byte des Felds Service Data als 5A23FFFE aufgeführt. Dieser Wert gibt die VID 5A23 und die PID FFFE an – 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.

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, für die Commits aus dem stabilen Branch v1.0-branch verwendet wurden. In den Hinweisen zur öffentlichen Version 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 sie sich in einem Build befinden, der 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 Thread-Verbindungen 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 du ein Gerät mit einer Testanbieter-ID (VID) und einer Testprodukt-ID (PID) gekoppelt hast, es 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 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 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 Console-Projekt 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.