Matter-Umgebung für virtuelle Geräteentwicklung

Geräte-SDK

Matter Virtual Device Development Environment (MVD-DE) ist ein Docker-Container, in dem du deine Matter Virtual Device (MVD) erstellen und die Virtual Device Controller (VDC)-Desktop-App verwenden kannst, um eine grafische Benutzeroberfläche zum Steuern und Anzeigen des Status deiner virtuellen Matter-Geräte bereitzustellen. Die Anwendung bietet eine visuelle Darstellung Ihres virtuellen Geräts sowie die Steuerelemente für die Matter-Cluster, die vom Gerät unterstützt werden.

Die Anwendung kommuniziert über einen RPC-Client mit dem RPC-Server des virtuellen Geräts, sendet Anfragen, die Ihre Aktionen widerspiegeln (Ein/Aus-Taste, Dimmen, Aufhellen) und ruft einmal pro Sekunde den Status ab.

Unterstützte Geräte

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

Matter Gerätetyp Anwendungscluster Heimsystem-Typ
Kontaktsensor Boolescher Status Sensor
Dimmbares Licht Ein/Aus
Levelsteuerung		 Leicht
Erweiterte Farbbeleuchtung Ein/Aus
Levelsteuerung
Farbeinstellungen		 Leicht
Durchflusssensor Flussmessung Sensor
Luftfeuchtigkeitssensor Messung der relativen Luftfeuchtigkeit Sensor
Beleuchtungssensor Messung der Beleuchtung Sensor
Anwesenheitssensor Anwesenheitserkennung Sensor
Ein-/Aus-Licht Ein/Aus Leicht
Steckdose Ein/Aus
Levelsteuerung		 Steckdose
Drucksensor Druckmessung Sensor
Lautsprecher Ein/Aus
Levelsteuerung		 Lautsprecher
Wechseln Ein/Aus Wechseln
Temperatursensor Temperaturmessung Sensor

Matter-Entwicklungsumgebung für virtuelle Geräte einrichten

MVD-DE ist ein vorkonfiguriertes Docker-Image, das auf Docker Hub verfügbar ist. Führen Sie folgenden Befehl aus, um sie zu installieren:

user@host> docker pull us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest

Dieser Vorgang kann einige Minuten dauern.

Virtuelle Matter-Geräteentwicklungsumgebung ausführen

  1. Starten Sie den Docker-Container:

    user@host> xhost local:1000
user@host> docker run -it --ipc=host --net=host -e DISPLAY --name matter-container us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest

    Nach dem Start des Containers sollten Sie eine Diagnoseausgabe sehen, gefolgt von einer Meldung, die bestätigt, dass Ihre Containerkonfiguration korrekt ist, und schließlich die Container-Shell-Eingabeaufforderung:

    Environment looks good, you are ready to go!

  2. Erstellen Sie eine zweite Terminalsitzungsinstanz:

    user@host> docker exec -it matter-container /bin/bash

  3. Wenn ein virtuelles Matter-Gerät ausgeführt wird, starten Sie VDC und übergeben Sie das Argument --s und den vom Gerät verwendeten IP-Port:

    $ electron main.js --s=localhost:33000

    Starten Sie bei einem physischen Gerät VDC und übergeben Sie das Argument --d gefolgt vom seriellen Port des Geräts:

    $ electron main.js --d=/dev/ttyUSB0

Wenn Sie VDC ohne Argumente starten, wird standardmäßig die Netzwerk-Socket-Option über den Localhost-Port 33000 verwendet.

Sobald VDC eine Verbindung zu deinem Gerät herstellen kann, wird ein Bildschirm mit dem Gerätestatus angezeigt:

Grafik der Benutzeroberfläche des virtuellen Geräts

QR-Code des Geräts anzeigen

Mit VDC kann auch der QR-Code im Rahmen des Geräte-Inbetriebnahmeablaufs abgerufen werden. Klicke auf das QR-Code-Symbol neben dem Gerätebild, um den QR-Code für dieses Gerät anzuzeigen:

Virtueller Gerätecontroller, der den QR-Code des Geräts anzeigt

Mit diesem QR-Code kannst du dein Gerät in Betrieb nehmen.

Matter-Umgebung für die virtuelle Geräteentwicklung beenden

Drücken Sie zum Beenden von MVD-DE Strg + Q, während der Bildschirm von VDC im Fokus ist, oder drücken Sie in der Terminalsitzung, in der Sie die App gestartet haben, Strg + C.

Feedback

Wenn Sie uns Feedback oder Verbesserungsvorschläge zu MVD-DE senden möchten, füllen Sie bitte unser Feedbackformular aus.

Feedback geben