Virtuelles Gerät

Matter ; Home APIs

Virtuelle Matter-Geräte eignen sich gut für die Entwicklung und das Testen von Matter-Lösungen und können wie physische Matter-Geräte mit Google Home app (GHA) in Betrieb genommen und mit GHA und Google Assistant gesteuert werden.

App-Entwickler und andere, die ein virtuelles Matter-Gerät testen oder emulieren müssen, aber nicht die Ressourcen haben, ein eigenes physisches oder virtuelles Matter-Gerät zu entwickeln, können das Matter Virtual Device (MVD) von Google nutzen. MVD ist ein schlankes, eigenständiges Linux- oder macOS-Desktop-Tool, das verschiedene Arten von virtuellen Matter-Geräten simuliert und eine grafische Benutzeroberfläche zum Steuern und Anzeigen der Status des virtuellen Matter-Geräts bietet.

Im Gegensatz zu einem physischen Matter-Gerät ist für MVD keine Bluetooth® Low Energy-Verbindung (BLE) oder Thread® erforderlich, um einem Matter-Netzwerk beizutreten. Stattdessen nutzt es die bestehende WLAN-Netzwerkverbindung des Host-Rechners (Linux oder macOS) zur Inbetriebnahme.

Im Vergleich zu anderen Tools

Der MVD unterscheidet sich vom Virtual Device Controller (VDC) dadurch, dass er eine in sich geschlossene Lösung darstellt, die ein virtuelles Gerät mit einer Benutzeroberfläche zur Steuerung dieses Geräts kombiniert. Im Gegensatz dazu wird das VDC verwendet, um ein separates virtuelles Matter-Gerät zu steuern.

Das MVD enthält mehrere verschiedene vorgefertigte virtuelle Geräte und eine integrierte Benutzeroberfläche, über die sie ausgeführt und gesteuert werden können.

Unterstützte Geräte

Der MVD unterstützt die folgenden Matter Gerätetypen:

MVD installieren

MVD wird auf 64‑Bit-x86-Prozessormaschinen mit Debian (13 Trixie oder höher), Ubuntu (20.04 Noble Numbat oder höher) oder macOS ausgeführt.

Linux

MVD-Debian-Paket (.deb) herunterladen

Laden Sie die Datei mit der Signatur „armored-ASCII“ (.asc) herunter

Führen Sie anschließend dpkg aus, um das MVD Debian (.deb)-Paket zu installieren:

sudo dpkg -i mvd_1.7.0_amd64.deb

macOS

Laden Sie die MVD (macOS x86) DMG-Datei herunter

Laden Sie die MVD (ARM64 M1) DMG-Datei herunter

Doppelklicken Sie anschließend auf die Datei dmg, um das Installationsfenster zu öffnen.

Um die Installation abzuschließen, wählen Sie das Symbol mvd aus und ziehen Sie es in den Ordner Applications:

Portnutzung prüfen

Das Controller-Modul in MVD verwendet den TCP-Port 33000 für RPC-Aufrufe an das virtuelle Gerät. Falls dieser Port bereits von einem anderen Prozess auf Ihrem Computer verwendet wird, stellen Sie sicher, dass er freigegeben wird.

Um zu prüfen, ob ein Prozess Port 33000 verwendet:

sudo fuser -v 33000/tcp

lsof -i:33000

Sie können jeden Prozess, der den TCP-Port 33000 verwendet, mit einem einzigen Befehl beenden:

sudo fuser -k 33000/tcp

lsof -ti:33000 | xargs kill

MVD ausführen

mvd

cd /Applications
open mvd.app

Konfigurieren Sie Ihr Gerät

Beim Start erscheint der Hauptbildschirm, auf dem Sie ein virtuelles Gerät konfigurieren können:

• Gerätetyp: Wählen Sie den Gerätetyp aus, z. B. „Lampe“, „Schalter“ oder „Sensor“.
• Gerätename: Geben Sie dem Gerät einen benutzerfreundlichen Namen.
• Discriminator (Unterscheidungsmerkmal): Eine 12-Bit-Zahl, die zur Unterscheidung zwischen mehreren Anzeigen für provisionsfähige Geräte verwendet wird. (Standard: 3840)
• Matter Port: Ein Port für die Matter-Inbetriebnahme und die Kommunikation über IP-Netzwerke. Matter verwendet standardmäßig den TCP/UDP-Port 5540. Du kannst das virtuelle Gerät aber so konfigurieren, dass es einen anderen Port verwendet, sofern dieser nicht von einem anderen Dienst verwendet wird.
• Anbieter-ID: Es wird nur die Testanbieter-ID 0xFFF1 unterstützt.
• Produkt-ID: Es werden nur Testprodukt-IDs von 0x8000 bis 0x801F unterstützt.

Firewall konfigurieren

sudo iptables -L -n

sudo ufw disable

sudo ufw enable

Starten Sie Ihr Gerät

Wenn das Gerät konfiguriert ist, klicken Sie auf Gerät erstellen. Wenn das Gerät erstellt wird, erscheint der Bildschirm Controller. Je nach Gerätetyp werden Ihnen möglicherweise eines oder mehrere der folgenden Steuerelemente angezeigt:

• Ein/Aus: Bei den meisten Geräten üblich.
• Stufe: Eine Lampe kann beispielsweise einen Schieberegler für die Helligkeit haben.
• Farbe: Beispielsweise könnte eine Farbleuchte diese Steuerung haben.
• Belegung: Der Belegungssensor bietet diese Steuerung, um den belegten oder unbelegten Zustand zu simulieren.

Alle virtuellen Geräte haben die folgenden Steuerelemente:

• QRCode: Zeigt den für die Inbetriebnahme verwendeten QR‑Code an.
• Reboot: Startet das virtuelle Gerät neu. Das Gerät wird kurz vom Netzwerk getrennt.
• Zurücksetzen: Das aktuelle Gerät wird auf die Werkseinstellungen zurückgesetzt und alle Statusinformationen werden gelöscht, einschließlich der Inbetriebnahme, des aktuellen Steuerungsstatus usw.
• Löschen: Das Gerät wird gelöscht und Sie kehren zum Bildschirm Gerät erstellen zurück.

Herstellerspezifische Merkmale

Herstellerspezifische (MS) Merkmale werden von den Home APIs für Android unterstützt und bieten zusätzliche Funktionen über die Standardmerkmale in Matter hinaus. Um ein Gerät mit einem MS-Merkmal zu testen, können Sie mit MVD mit den Merkmalen im Abschnitt Custom Clusters interagieren (siehe Abbildung oben).

Gerät einrichten

Das Gerät kann in Betrieb genommen werden, sobald es erstellt wurde.

Für die Inbetriebnahme des Geräts müssen einige Voraussetzungen erfüllt sein:

• Sie müssen ein Projekt in Google Home Developer Console haben. Dieses Projekt muss eine Matter-Integration enthalten, die dieselbe VID/PID-Kombination aufweist wie diejenige, die Sie beim Einrichten Ihres virtuellen Geräts verwendet haben. Weitere Informationen finden Sie in der Anleitung zum Erstellen von Projekten.

• Du benötigst einen Google Nest Hub, der Matter unterstützt.

• Sie benötigen ein Android-Smartphone mit Android 8.1 oder höher und GHA.

• Das Android-Smartphone muss mit demselben WLAN wie der Hub verbunden sein.

• Der Hostcomputer muss mit dem WLAN verbunden sein.

Um das Gerät mit dem GHA in Betrieb zu nehmen, klicken Sie auf QRCode, um den QR-Code des Geräts anzuzeigen, und folgen Sie dann den Anweisungen unter Kopieren eines Matter-Geräts, in denen erklärt wird, wie ein Matter-Gerät mit dem GHA verbunden wird. Sie können das Gerät auch mit dem Google Home Sample App for Matter in Betrieb nehmen.

Matter Weitere Informationen zur Funktionsweise der Matter-Inbetriebnahme

Gerät steuern

Nachdem Sie ein virtuelles Gerät in Betrieb genommen haben, können Sie es über die Google Home App oder Google Assistant per Sprachbefehl steuern. Du hast folgende Möglichkeiten:

• Das Gerät über GHA oder Assistant steuern und gleichzeitig Statusänderungen auf dem virtuellen Gerät überwachen.
• Steuere das Gerät über Sample App for Matter und beobachte gleichzeitig Statusänderungen auf dem virtuellen Gerät.
• Gerätestatus über MVD steuern und Statusänderungen in GHA oder Assistant beobachten.

Mit dem Gerät testen

Zum Testen mit Assistant empfehlen wir die Verwendung eines Äußerungssimulators wie Google Home Extension für VS Code oder Google Home Plugin für Android Studio.

Gerätedetails ansehen

Auf dem Bildschirm Gerätedetails werden detaillierte Geräteinformationen angezeigt:

• Name: Der dem Gerät zugewiesene Benutzername.
• Gerätetyp: Der ausgewählte Gerätetyp.
• Diskriminator: Der aktuelle Gerätediskriminator.
• Vendor ID: Die aktuelle Geräte-Vendor-ID.
• Produkt-ID: Die aktuelle Produkt-ID des Geräts.
• RPC-Port: Der RPC-Port, über den das Gerät mit Controllern (GUI) kommuniziert.
• Matter Port: Der Port, der vom aktuellen Gerät zur Kommunikation über das IP-Netzwerk verwendet wird.
• Sicherheitscode: Die PIN, die zum Inbetriebnehmen des Geräts über das Netzwerk verwendet wird.
• Konfigurationsordner: Der Ordner, in dem das virtuelle Gerät die Konfiguration speichert.
• Inbetriebnahmedaten: Hier werden die Fabrics angezeigt, denen das Gerät beigetreten ist, sowie die Knoten-ID des Geräts im Fabric.

Geräte-Logs ansehen

Wenn Sie MVD über das Terminal gestartet haben, wird die Logausgabe auf stdout angezeigt. Sie können sich die Gerätelogs auch auf dem Tab Gerätelogs ansehen.

Gerät stoppen

Klicken Sie auf Löschen, um das Gerät zu beenden und zu löschen.

App beenden

Wenn Sie das Steuerungsfenster schließen, wird das Gerät zerstört und die MVD-Anwendung beendet. Wenn Sie die Anwendung über das Terminal gestartet haben, können Sie sie auch beenden, indem Sie Strg + C in das Terminal eingeben.

Hilfe

Wenn Sie Hilfe zu MVD benötigen, einen Fehler melden oder eine neue Funktion anfordern möchten, wenden Sie sich an Ihren Google-Supportkontakt.

Wenn Sie oben rechts im Fenster auf die Schaltfläche „Hilfe“ help klicken, werden Sie zu dieser Seite weitergeleitet.

Fehler melden

Wenn Sie einen Fehler in MVD gefunden haben, können Sie ihn melden, indem Sie oben rechts im Fenster auf die Schaltfläche „Problem“ sms_failed klicken.

Feedback geben

Wenn Sie uns mitteilen möchten, was Ihnen an MVD gefällt oder wie wir das Tool verbessern können, füllen Sie unser Feedback-Formular aus.

Das Formular kann über die Schaltfläche „Feedback“ sentiment_satisfied oben rechts im Fenster oder über die Schaltfläche unten aufgerufen werden.

Feedback geben

Sie können auch über die Umfrage Feedback geben, die unten eingeblendet wird, wenn Sie MVD verwenden.