Virtuelles Gerät

Rechtsangelegenheit 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, die ein virtuelles Matter Gerät, aber nicht die Ressourcen, um selbst eins zu erstellen physisch oder virtuelles Matter-Gerät, Google bietet die 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

Das 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

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

Klicken Sie dann doppelt auf die Datei dmg, um das Installationsfenster 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

Der Hauptbildschirm wird beim Starten angezeigt und Sie können ein virtuelles Gerät konfigurieren:

• 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: Eine 12-Bit-Zahl, mit der zwischen mehreren abrechenbaren Geräteanzeigen unterschieden wird. (Standardeinstellung: 3840).
• Matter-Port: Ein Port für die Matter-Inbetriebnahme und Kommunikation über IP-Netzwerke. Matter verwendet standardmäßig den TCP/UDP-Port 5540, aber können Sie das virtuelle Gerät so konfigurieren, dass es ein anderes sofern sie von keinem 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. Nachdem das Gerät erstellt wurde, wird der Bildschirm Controller angezeigt. Je nach ausgewähltem Gerätetyp werden möglicherweise eines oder mehrere der folgenden Steuerelemente angezeigt:

• Ein/Aus: Diese Option wird den meisten Geräten zugewiesen.
• Pegel: Eine Lampe kann beispielsweise einen Lautstärkeregler haben, um sie anzupassen. Helligkeit.
• Farbe: Ein farbiges Licht kann beispielsweise über dieses Steuerelement verfügen.
• 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. Die Verbindung des Geräts zum Netzwerk wird kurz unterbrochen.
• 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: Das Gerät wird gelöscht und Sie kehren 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.
• Gerätetyp: 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 auf stdout angezeigt. Sie können Geräteprotokolle auch auf dem Tab Geräteprotokolle einsehen.

Gerät anhalten

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

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 auf die Hilfe-Schaltfläche help klicken, gelangen Sie auf diese Seite.

Fehler melden

Wenn Sie der Meinung sind, dass Sie einen Defekt im MVD festgestellt haben, können Sie Fehler melden, indem du auf das Problem sms_failed klickst oben rechts im Fenster.

Feedback geben

Hier können Sie uns mitteilen, was Ihnen an MVD gefällt oder wie damit wir Ihre Erfahrung mit dem Tool verbessern können, füllen Sie bitte unser Feedbackformular aus.

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

Senden Sie uns Ihr Feedback.