Virtuelles Gerät

Geräte-SDK

Virtuelle Matter-Geräte eignen sich zum Entwickeln und Testen Matter-Lösungen und können über die Google Home app (GHA). Die Steuerung erfolgt über GHA und Google Assistant, genau wie physische Matter Geräte.

Für App-Entwickler und andere Nutzer, die ein virtuelles Matter-Gerät testen oder emulieren möchten, aber nicht die Ressourcen haben, um ein eigenes physisches oder virtuelles Matter-Gerät zu erstellen, bietet Google den Matter Virtual Device (MVD) an. MVD ist ein ein eigenständiges Linux- oder macOS-Desktoptool, das verschiedene virtueller Matter-Geräte und bietet eine grafische Benutzeroberfläche zur Steuerung und Anzeige des Status der virtuellen Matter Gerät.

Im Gegensatz zu einem physischen Matter-Gerät, MVD nicht auf Bluetooth® Low Energy (BLE) oder Thread® um eine Matter-Struktur zu verbinden. Stattdessen wird der Host Vorhandene WLAN-Verbindung auf einem Linux- oder macOS-Computer für die Inbetriebnahme.

Im Vergleich zu anderen Tools

Der MVD unterscheidet sich vom Virtual Device Controller (VDC) dadurch, dass es sich um eine eigenständige Lösung handelt, die ein virtuelles Gerät mit einer Benutzeroberfläche zur Steuerung kombiniert. Im Gegensatz dazu wird VDC verwendet, ein separates virtuelles Matter-Gerät zu steuern, z. B. dieses erstellen wir in der Matter Virtual Device Development Environment (MVD-DE).

Möglicherweise haben Sie bereits mit dem Codelab „MVD-DE“ gearbeitet. In dieser Codelab erstellen Sie eine einzige Art virtuelles Gerät – eine intelligente Glühbirne. In enthält das MVD-Objekt mehrere verschiedene virtuelle Geräte und verfügt über eine integrierte Benutzeroberfläche, über die sie ausgeführt und gesteuert werden können.

Unterstützte Geräte

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

MVD installieren

MVD wird auf 64-Bit-x86-Prozessormaschinen ausgeführt, auf denen Debian ausgeführt wird (11 oder höher), Ubuntu (20.04 oder höher) oder macOS.

Linux

MVD-Debian-Paket (.deb) herunterladen

Armor-ASCII-Signaturdatei (.asc) herunterladen

Führen Sie dann dpkg aus, um MVD zu installieren. Debian-Paket (.deb):

sudo dpkg -i mvd_1.4.0_amd64.deb

macOS

MVD (macOS x86)-dmg-Datei herunterladen

MVD (ARM64 M1)-dmg-Datei herunterladen

Doppelklicken Sie dann auf die Datei dmg, um die Installation zu öffnen. .

Um die Installation abzuschließen, klicke auf das mvd-Symbol und ziehe es nach unten dem Ordner Applications:

Portnutzung prüfen

Das Controllermodul in MVD verwendet den TCP-Port 33000 für RPC an das virtuelle Gerät gesendet wird. Wenn dieser Port also bereits von einem anderen auf Ihrem Computer speichern, sollten Sie diesen freigeben.

So stellen Sie fest, ob ein Prozess Port 33000 verwendet:

sudo fuser -v 33000/tcp

lsof -i:33000

Sie können jeden Prozess über den TCP-Port 33000 mit einem einzigen Befehl beenden:

sudo fuser -k 33000/tcp

lsof -ti:33000 | xargs kill

MVD ausführen

mvd

cd /Applications
open mvd.app

Gerät konfigurieren

Beim Start wird der Hauptbildschirm angezeigt, 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. und so weiter).
• Gerätename: Geben Sie dem Gerät einen nutzerfreundlichen Namen.
• Diskriminator: Mit dieser 12-Bit-Zahl wird zwischen mehreren Werbung für provisionspflichtige Geräte (Standard: 3840).
• Port Matter: Ein Port für Matter und Kommunikation über IP-Netzwerken. Matter verwendet standardmäßig den TCP/UDP-Port 5540. Sie können das virtuelle Gerät jedoch so konfigurieren, dass ein anderer Port verwendet wird, sofern dieser nicht von einem anderen Dienst verwendet wird.
• Anbieter-ID: Es wird nur die Testanbieter-ID 0xFFF1 unterstützt.
• Produkt-ID: Verwenden Sie nur die Produkt-IDs 0x8000 bis 0x801F. unterstützt werden.

Firewall konfigurieren

sudo iptables -L -n

sudo ufw disable

sudo ufw enable

Bediene dein Gerät

Nachdem das Gerät konfiguriert wurde, klicken Sie auf Gerät erstellen. Wenn das Gerät erstellt wurde, wird der Bildschirm Controller angezeigt. Je nach Gerätetyp ausgewählt haben, sehen Sie möglicherweise eines oder mehrere der folgenden Steuerelemente:

• An/Aus: Diese Option ist auf der Mehrheit der Geräte zu finden.
• Pegel: Eine Lampe kann beispielsweise einen Lautstärkeregler haben, um sie anzupassen. Helligkeit.
• Farbe: Diese Einstellung kann beispielsweise für eine Lampe mit Farbwechsel verwendet werden.
• Anwesenheit: Der Anwesenheitssensor bietet diese Einstellung, um den die den Status „Beschäftigt“ haben.

Alle virtuellen Geräte haben folgende Steuerelemente:

• QRCode: Zeigt den QR-Code an, der für die Inbetriebnahme verwendet wurde.
• Neu starten: Das virtuelle Gerät wird neu gestartet. Das Gerät ist nicht verbunden aus dem Netzwerk entfernt.
• Zurücksetzen: Das aktuelle Gerät wird auf die Werkseinstellungen zurückgesetzt und der gesamte Status wird gelöscht, einschließlich Inbetriebnahme, aktueller Steuerstatus usw.
• Löschen: Zerstört das Gerät und kehrt zum Bildschirm Gerät erstellen zurück.

Gerät in Betrieb nehmen

Das Gerät kann direkt nach seiner Erstellung in Betrieb genommen werden.

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 mit derselben VID/PID-Kombination enthalten, die du bei der Einrichtung deines virtuellen Geräts verwendet hast. Weitere Informationen finden Sie unter Weitere Informationen finden Sie im Leitfaden zur Projekterstellung.

• Sie benötigen einen Google Nest Hub, der Matter

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

• 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 GHA in Betrieb zu nehmen, klicken Sie auf QRCode, um zeigt den QR-Code des Geräts an und folge der Anleitung unter Matter koppeln wird erklärt, wie man ein Matter-Gerät mit der GHA Sie können das Gerät auch mit der Google Home Sample App for Matter

Weitere Informationen findest du in unserer Matter Primer von So funktioniert die Matter-Inbetriebnahme.

Gerät steuern

Nachdem Sie ein virtuelles Gerät in Betrieb genommen haben, können Sie es mit Google Home App oder Google Assistant verwenden, Stimme Sie haben dann folgende Möglichkeiten:

• Steuere das Gerät über GHA oder Assistant bei Überwachung von Statusänderungen aktiviert das virtuelle Gerät oder
• Bedienen Sie das Gerät über die Sample App for Matter während der Überwachung des Status Änderungen auf dem virtuellen Gerät oder
• Gerätestatus über MVD selbst steuern, während Monitoring von Statusänderungen in GHA oder Assistant

Mit dem Gerät testen

Zum Testen mit Assistant empfehlen wir die Verwendung einer Äußerung Simulator wie Google Home-Erweiterung für VS Code oder das Google Home-Plug-in für Android Studio.

Gerätedetails ansehen

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

• Name: Der Anzeigename des Geräts.
• Device Type: Der ausgewählte Gerätetyp.
• Diskriminator: Der aktuelle Gerätediskriminator.
• Vendor ID (Anbieter-ID): Die aktuelle Gerätehersteller-ID.
• Produkt-ID: Die aktuelle Produkt-ID des Geräts.
• RPC-Port: Der RPC-Port, über den das Gerät mit den Controllern kommuniziert (GUI).
• Matter-Port: Der Port, der vom aktuellen Gerät für Folgendes verwendet wird: IP-Netzwerk kommunizieren können.
• Sicherheitscode: Die PIN, mit der das Gerät über das Netzwerk in Betrieb genommen wird.
• Configuration Folder (Konfigurationsordner): Der Ordner, den das virtuelle Gerät speichert Konfiguration.
• Provisionsinformationen: Zeigt die Stoffe an, mit denen das Gerät verbunden ist, und Knoten-ID des Geräts in der Struktur.

Geräteprotokolle ansehen

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

Gerät anhalten

Klicken Sie auf Löschen, um das Gerät zu stoppen und zu zerstören.

App beenden

Durch das Schließen des Steuerfensters wird das Gerät zerstört und die MVD-Anwendung. Beim Starten über das Terminal können Sie Sie können die Anwendung auch beenden, indem Sie Ctrl-C im Terminal eingeben.

Hilfe

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

Wenn Sie rechts oben im Fenster auf die Hilfeschaltfläche help klicken, gelangen Sie zu dieser Seite.

Fehler melden

Wenn Sie der Meinung sind, dass Sie einen Fehler in der MVD gefunden haben, können Sie einen Fehler melden, indem Sie oben rechts im Fenster auf die Schaltfläche „Problem melden“ 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 bitte unser Feedback-Formular aus.

Das Formular kann über das Feedback- sentiment_satisfied-Schaltfläche im oder auf die Schaltfläche unten klicken.

Senden Sie uns Ihr Feedback.