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 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 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.

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 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.