Virtuelles Gerät

<ph type="x-smartling-placeholder"></ph> 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

MVD unterscheidet sich von der Virtual Device Controller (VDC) insofern, als ist eine eigenständige Lösung, die ein virtuelles Gerät mit einer Benutzeroberfläche für und es gesteuert. 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

<ph type="x-smartling-placeholder"></ph> MVD-Debian-Paket (.deb) herunterladen

<ph type="x-smartling-placeholder"></ph> 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

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 (Standardeinstellung: 3840).
• Port Matter: Ein Port für Matter und Kommunikation über IP-Netzwerken. 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

Gerät bedienen

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:

• Ein/Aus: Diese Option wird den meisten Geräten zugewiesen.
• Pegel: Eine Lampe kann beispielsweise einen Lautstärkeregler haben, den sie anpassen kann. 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. Das Gerät ist nicht verbunden aus dem Netzwerk entfernt.
• Zurücksetzen: Das aktuelle Gerät wird auf die Werkseinstellungen zurückgesetzt und alle Status gelöscht, einschließlich Inbetriebnahme, aktueller Kontrollstatus 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 enthalten die Sie bei der Einrichtung Ihres virtuellen Geräts verwendet haben. 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 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.

<ph type="x-smartling-placeholder"></ph> Senden Sie uns Ihr Feedback.