Matter-Umgebung für virtuelle Geräteentwicklung

Device SDK

Der Matter Virtual Device Development Environment (MVD-DE) ist ein Docker-Container, in dem Sie Ihre Matter Virtual Device (MVD) erstellen und mit der Virtual Device Controller (VDC)-Desktop-App eine grafische Benutzeroberfläche bereitstellen können, um den Status Ihrer virtuellen Matter-Geräte zu steuern und anzuzeigen. Die App bietet eine visuelle Darstellung Ihres virtuellen Geräts sowie die Steuerelemente für die vom Gerät unterstützten Matter-Cluster.

Die App verwendet einen RPC-Client, um mit dem RPC-Server des virtuellen Geräts zu kommunizieren. Dabei werden Anfragen gesendet, die Ihre Aktionen widerspiegeln (Ein-/Ausschalten, Dimmen, Aufhellen), und einmal pro Sekunde wird der Status abgefragt.

Unterstützte Geräte

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

Matter Gerätetyp Anwendungscluster Art des Smart-Home-Systems
Kontaktsensor Boolescher Status Sensor
Dimmbares Licht Ein/Aus
Steuerung der Lautstärke
Leicht
Erweiterte Farbleuchte Ein/Aus
Helligkeitsregelung
Farbeinstellungen
Leicht
Durchflusssensor Durchflussmessung Sensor
Luftfeuchtigkeitssensor Messung der relativen Luftfeuchtigkeit Sensor
Beleuchtungssensor Beleuchtungsmessung Sensor
Anwesenheitssensor Anwesenheitserkennung Sensor
Ein-/Aus-Lampe An/Aus Leicht
Steckdose Ein/Aus
Steuerung der Lautstärke
Outlet
Drucksensor Druckmessung Sensor
Lautsprecher Ein/Aus
Steuerung der Lautstärke
Lautsprecher
Wechseln An/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 es zu installieren:

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

Dieser Vorgang kann einige Minuten dauern.

Matter Virtual Device Development Environment 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 Starten des Containers sollten Sie eine Diagnoseausgabe sehen, gefolgt von einer Meldung, dass Ihre Containerkonfiguration korrekt ist, und schließlich der Container-Shell-Prompt:

    Environment looks good, you are ready to go!
    
  2. So erstellen Sie eine zweite Terminalsitzung:

    user@host> docker exec -it matter-container /bin/bash
    
  3. Starten Sie bei einem virtuellen Matter-Gerät nach dem Starten des Geräts VDC und übergeben Sie ihm das --s-Argument und den vom Gerät verwendeten IP-Port:

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

    Starten Sie VDC für ein physisches Gerät und übergeben Sie ihm das --d-Argument 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 mit dem localhost-Port 33000 verwendet.

Sobald die VDC eine Verbindung zu Ihrem Gerät herstellen kann, wird auf dem Bildschirm der Gerätestatus angezeigt:

Grafische Benutzeroberfläche des virtuellen Geräts

QR-Code des Geräts anzeigen

Die VDC kann auch verwendet werden, um den QR-Code im Rahmen der Geräteinbetriebnahme abzurufen. Klicken Sie neben dem Gerätebild auf das QR-Code-Symbol, um den QR-Code für dieses Gerät aufzurufen:

Virtueller Gerätecontroller mit dem QR-Code des Geräts

Mit diesem QR-Code können Sie Ihr Gerät in Betrieb nehmen.

Virtuelle Matter-Geräteentwicklungsumgebung beenden

Wenn Sie die MVD-DE beenden möchten, drücken Sie Strg + Q, während der Bildschirm der MVD-DE im Fokus ist, oder Strg + C in der Terminalsitzung, in der Sie die App gestartet haben.VDC

Feedback

Wenn du uns deine Meinung oder Feedback dazu mitteilen möchtest, wie wir die Nutzung von MVD-DE verbessern können, fülle bitte unser Feedback-Formular aus.

Feedback geben