Matter-Integration testen

Die Google Home Developer Console bietet eine Seite Test, auf der Sie mithilfe der Google Home Test Suite Tests für Ihre Matter-Integration konfigurieren und ausführen können. Die Test Suite ist eine separate Anwendung, die in die Developer Console, das alle Integrationstests abwickelt.

Geräte mit der Anbieter-ID und der Produkt-ID der Integration müssen in Google Home app (GHA) für das Konto, das mit der Developer Console verwendet wird, in Betrieb genommen und verfügbar sein, damit sie getestet werden können. Siehe Matter koppeln .

Test Suite kann auf mehreren Geräten ausgeführt werden, die zu eine bestimmte Matter-Projektkonfiguration. Es ist sehr ist es wichtig, die Test Suite für deine Integration(en) auszuführen, um sicherzustellen, dass alles ordnungsgemäß funktioniert.

Auf der Seite Test gibt es Matter Integrationen, die abgeschlossen und bereit zum Testen sind unter Bereit zum Testen aufgeführt.

Matter getestete Integrationen sind aufgeführt in den Abschnitt Tested (Getestet) aus.

Art der Testpläne

Es gibt zwei Arten von Testplänen:

  • Testpläne für Entwicklungen dienen dazu, die Steuerung von Geräten mit Matter Sie können bearbeitet, aber nicht gesendet werden. für Matter-Zertifizierung.

  • Testpläne für die Zertifizierung sind speziell für die Matter-Zertifizierung vorgesehen und können nicht bearbeitet werden. Wenn Sie diese Option auswählen, wird eine neue Version Ihrer Matter-Integration.

Integrationsversionen

Wenn Sie einen Testplan für wird eine neue Version der Integration erstellt. Diese Nummerierung Version ist in allen Integrationslisten im Developer Console aufgeführt auf der Registerkarte Test an.

Neue Versionen werden niemals aus anderen nummerierten Versionen erstellt. Beispiel: Der Parameter Mit dem ersten Testplan, den du für eine Integration erstellst, wird Version v.1 dafür erstellt. Wenn Sie einen weiteren Testplan erstellen, wird dafür Version v.2 erstellt. Integration. Diese Version basiert jedoch nicht auf v.1. Stattdessen wird diese Version basiert auf der nicht versionierten Instanz der Integration, genau wie in v.1.

Die Version einer Integration steht für die nicht versionierte Instanz des Integration, die auf dem Tab Entwickeln verwaltet wird.

Mit anderen Worten: Auf Matter > Test in der Developer Console:

  • Wenn Sie für Version der Integration auf Testen klicken, wird eine neue Version erstellt. Die Versionsnummer ist eins höher als alle vorhandenen nummerierten Nummern. Versionen.
    • Wenn keine nummerierten Versionen vorhanden sind, wird Version v.1 erstellt.
    • Wenn Version v.1 vorhanden ist, wird Version v.2 erstellt. Wenn Version v.2 vorhanden ist, Version v.3 erstellt wird usw.
  • Wenn Sie auf Test klicken, um eine nummerierte Version der Integration (für z. B. v.1), wird keine neue Version erstellt. Stattdessen wird Version v.1 noch einmal getestet.

Weitere Informationen finden Sie unter Integration Versionsverwaltung.

Testplan erstellen

Integrationsversionen sind ein Snapshot einer Integration ohne Version. Das bedeutet, dass bei der Erstellung eines Testplans für die Zertifizierung und damit einer Integration müssen alle Metadaten im Zusammenhang mit dieser Integration die Informationen die Sie für die Einführung der Integration verwenden möchten.

Bevor Sie einen Testplan für die Zertifizierung erstellen, müssen Sie Folgendes getan haben:

  1. Sie haben ein Unternehmensprofil erstellt.
  2. Produktionsanbieter-ID eingegeben (VID) für die Integration.
  3. Konfigurierte Einrichtung und Branding

Wenn Sie nicht alle Schritte für Ihre Integration abgeschlossen haben, kann eine Integrationsversion, die für Zertifizierungstests erstellt wurde, nicht zertifiziert werden. Sie werden um eine neue Version zu erstellen, was bedeutet, den Test, das Field Trial und die Zertifizierung zu wiederholen Schritte.

Sie müssen auch eine neue Version erstellen und von vorn beginnen, wenn Sie Dein Branding aktualisieren, bevor eine Integrationsversion zertifiziert wird.

So erstellen Sie einen Testplan:

Zur Developer Console

  1. Klicken Sie in der Projektliste neben dem gewünschten Projekt auf Öffnen. mit denen Sie zusammenarbeiten können.

  2. Klicken Sie im Navigationsmenü links auf der Seite auf Matter > Testen.

  3. Klicken Sie für Version der Integration, die Sie testen möchten, auf Testen. Dieses Durch die Aktion wird eine neue Integrationsversion erstellt.

  4. Wählen Sie als Testtyp Entwicklungstest oder Zertifizierungstest aus. Neuen Testplan erstellen

    • Wählen Sie Zertifizierungstest aus, wenn Sie sich auf eine Zertifizierung im Google-System vorbereiten.
    • Ein Entwicklungstest kann nicht für die Zertifizierung verwendet werden.
  5. Klicken Sie auf Testen. Wenn Sie die Fehlermeldung Kein Gerät gefunden erhalten, wird ein Gerät Diese Integration wurde noch nicht in das Ökosystem in Auftrag gegeben. Weitere Informationen finden Sie unter Fehlerbehebung beim Koppeln.

  6. Geben Sie auf dem Bildschirm Test konfigurieren einen Namen für den Test ein und Wählen Sie in der Geräteliste die Geräte aus, die Sie testen möchten.

  7. Klicken Sie auf die Schaltfläche Weiter: Plan testen.

  8. Wählen Sie auf der Seite Testplan erstellen im Abschnitt Test Suites die Sie ausführen möchten.

Testplan erstellen

Wenn Sie die Test Suite schließen möchten, klicken Sie auf Zum Developer Center zurückkehren.

Testplan ausführen

Führen Sie im Test Suite auf der Seite Testplan erstellen folgende Schritte aus: Klicken Sie auf Run Test (Test ausführen). Die Seite Testumgebung wird angezeigt. Sie enthält den Status und Protokolle aller Tests.

Die Testergebnisse werden nach Abschluss der Tests angezeigt. Der Status der einzelnen Testsuiten wird daneben angezeigt („Bestanden“, „Fehlgeschlagen“).

Im Bereich Logs wird der Status jeder einzelnen Testausführung angezeigt.

Testergebnisse

Wenn Sie einen Testplan noch einmal testen möchten, klicken Sie auf der Seite Testumgebung auf Test wiederholen nachdem die Testausführung abgeschlossen ist.

Wenn Sie fertig sind:

Testergebnisse ansehen und interpretieren

Auf der Seite Testverlauf im Test Suite können Sie Folgendes aufrufen: Frühere Testergebnisse für einen Entwicklungsplan oder eine nicht eingereichte Zertifizierung Klicken Sie dazu unter Testpläne für den gewünschten Testplan auf Erneut testen. . Dadurch gelangen Sie zur Seite Testumgebung, auf der die Ergebnisse dieses Tests.

Testverlauf

Klicken Sie für einen eingereichten Zertifizierungsplan im Bereich Gespeichert für auf Ergebnisse. Zertifizierung, um den Bericht mit den Testergebnissen aufzurufen.

Die Testergebnisse können auch für eine Integrationsversion aus dem Test im Developer Console. Klicken Sie auf Anzeigen, um den Testverlauf einer auf dieser Seite aufgeführten Integrationsversion aufzurufen. Sie gelangen dann zur Seite Testverlauf im Test Suite.

Konsolenstatus

In der Testphase treten die folgenden Konsolenstatus auf:

Section Status Beschreibung Anforderung Der nächste Schritt
Bereit zum Testen Bereit Diese Version von integration kann getestet werden. Testen Sie diese Version der integration.
Getestet Bereit Diese Version von integration wurde getestet und kann für das Field Trial oder die Zertifizierung eingereicht wurden.

Die Version wurde getestet und gespeichert.

Alle fehlgeschlagenen Testläufe enthalten Begründungen, die Google prüfen muss.

Führen Sie den Test noch einmal durch, falls gewünscht.

Fehlerbehebung

In Auftrag gegebenes Gerät wird nicht in der Test-Suite 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.

Entferne alle Testgeräte von Developer Console und kopple sie, um das Problem zu beheben das Gerät, das Sie noch einmal testen möchten.

Um zu überprüfen, ob Sie das richtige Gerät gekoppelt haben, können Sie den Hersteller und Modellinformationen (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät eindeutige Werte in Ihrer Testfirmware.

Weitere Informationen finden Sie unter Geräteinformationen.

Bestätige die VID/PID deines Geräts.

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, für den das Gerät ein Beaconing durchführt, sollte mit der VID/PID übereinstimmen. in Ihr Developer Console-Projekt eingegeben.

  • VIDs 0xFFF10xFFF4 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-App für Entwickler, z. B. nRF Connect for Mobile Die VID/PID des Beacon-Geräts wird im Feld Dienstdaten angezeigt.

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 weist auf eine VID von 5A23 und eine PID von FFFE hin. beide im Little-Endian-Format.

Die BLE-App zeigt die Werte in Little-Endian an, aber die VID/PID-Werte Ihr Developer Console-Projekt in Big Endian läuft.

Überprüft, ob in euren Aktionen die richtigen Werte und das richtige Format eingegeben wurden. Konsolenprojekt basierend auf dem, was der Bluetooth-Sniffer anzeigt.

Für die Werte im Beispiel-Screenshot werden die VID und die PID im Feld Developer Console wäre 235A bzw. FEFF.