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.

Tabelle: Vergleich der virtuellen Matter-Geräte
MVD VDC MVD-DE (Codelab)
Matter-Gerät emulieren
Ein emuliertes Matter-Gerät steuern
Erforderlicher Entwicklungsaufwand
Herunterladen weniger als 100 MB 9 GB 20 GB

Unterstützte Geräte

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

unterstützt werden
Tabelle: Matter-Gerätetypen, die für MVD
Matter Gerätetyp Anwendungscluster Heimsystem-Typ
Einfacher Videoplayer 0x0006
0x0506
0x0509
Fernsehen
Farbtemperatur-Licht 0x0300
0x0008
0x0006
Leicht
Kontaktsensor 0x0045
Sensor
Dimmbares Licht 0x0008
0x0006
Leicht
Türschloss 0x0101
Sperren
Erweiterte Farbbeleuchtung 0x0300
0x0008
0x0006
Leicht
Lüfter 0x0202
0x0006
Lüfter
Durchflusssensor 0x0404
Sensor
Generischer Schalter 0x003b
Wechseln
Luftfeuchtigkeitssensor 0x0405
Sensor
Lichtsensor 0x0400
Sensor
Anwesenheitssensor 0x0406
Sensor
Ein-/Aus-Licht 0x0008
0x0006
Leicht
Ein-/Aus-Lichtschalter 0x0006
Wechseln
Ein-/Aus-Stecker 0x0008
0x0006
Steckdose
Drucksensor 0x0403
Sensor
Pumpe 0x0006
0x0200
0x0402
0x0403
0x0404
Wasserpumpe
Staubsaugerroboter 0x0054
0x0055
0x0061
Staubsauger
Raumklimaanlage 0x0006
0x0201
0x0202
Ac
Rauch- und Kohlenmonoxidmelder 0x005C
Rauch
Temperatursensor 0x0402
Sensor
Thermostat 0x0201
Thermostat
Fensterabdeckungen 0x0102
Jalousien

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:

macOS-Installation

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:

Linux

sudo fuser -v 33000/tcp

macOS

lsof -i:33000

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

Linux

sudo fuser -k 33000/tcp

macOS

lsof -ti:33000 | xargs kill

MVD ausführen

Linux

Führen Sie unter Linux MVD über Ihren Anwendungsordner oder über dem Terminal:

mvd

macOS

Öffnen Sie unter macOS MVD über das Launchpad oder führen Sie MVD über das Terminal aus:

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.

Konfiguration virtueller Geräte
Bildschirm

Firewall konfigurieren

Linux

Wenn auf Ihrem Computer eine Firewall ausgeführt wird, fahren Sie sie entweder herunter oder erlauben Sie eingehende TCP/UDP-Verbindungen am Port Matter.

So rufen Sie den aktuell aktiven netfilter auf: Firewallregeln:

sudo iptables -L -n

Wenn Sie `ufw` verwenden, kann es deaktiviert werden mit:

sudo ufw disable

Und es kann wieder aktiviert werden mit:

sudo ufw enable

macOS

So konfigurieren oder deaktivieren Sie die Firewall unter macOS:

  1. Öffnen Sie das Apple-Menü  und wähle Systemeinstellungen aus.
  2. Klicken Sie in der Liste in der Seitenleiste auf Netzwerk.
  3. Klicken Sie auf Firewall.
  4. Stellen Sie den Schalter für die Firewall auf Aus.

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.

Virtuelle Gerätesteuerung
Bildschirm

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  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“  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- -Schaltfläche im oder auf die Schaltfläche unten klicken.

Senden Sie uns Ihr Feedback.