Matter-Umgebung für virtuelle Geräteentwicklung

Geräte-SDK

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

Die App verwendet einen RPC-Client, um mit dem RPC-Server des virtuellen Geräts zu kommunizieren. Sie sendet Anfragen, die Ihre Aktionen widerspiegeln (Schalter ein-/ausschalten, dimmen, aufhellen) und einmal pro Sekunde abfragen, um den Status abzurufen.

Unterstützte Geräte

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

Matter Gerätetyp Anwendungscluster Art des Heim-Ökosystems
Kontaktsensor Boolescher Status Sensor
Dimmbares Licht Ein/Aus-
Pegelsteuerung
Leicht
Erweitertes Farblicht Ein/Aus
Pegelregler
Farbsteuerung
Leicht
Durchflusssensor Flussmessung Sensor
Luftfeuchtigkeitssensor Messung der relativen Luftfeuchtigkeit Sensor
Beleuchtungssensor Messung der Beleuchtung Sensor
Anwesenheitssensor Anwesenheitserkennung Sensor
An-/Aus-Licht Ein/Aus Leicht
Steckdose Ein/Aus-
Pegelsteuerung
Steckdose
Drucksensor Druckmessung Sensor
Lautsprecher Ein/Aus-
Pegelsteuerung
Lautsprecher
Wechseln Ein/Aus Wechseln
Temperatursensor Temperaturmessung Sensor

Entwicklungsumgebung für virtuelle Matter-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.

Entwicklungsumgebung für virtuelle Matter-Geräte 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
    

    Nachdem Sie den Container gestartet haben, sollten Sie Diagnosemeldungen sehen, gefolgt von einer Meldung, die bestätigt, dass Ihre Containerkonfiguration korrekt ist, und schließlich der 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, indem Sie das Argument --s und den vom Gerät verwendeten IP-Port übergeben:

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

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

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

Wenn Sie VDC starten, ohne Argumente anzugeben, wird standardmäßig die Netzwerk-Socket-Option mit dem Localhost-Port 33000 verwendet.

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

Grafische Benutzeroberfläche des virtuellen Geräts

QR-Code des Geräts anzeigen

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

Virtuelle Gerätesteuerung, die den QR-Code des Geräts anzeigt

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

Entwicklungsumgebung für virtuelle Matter-Geräte beenden

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

Feedback

Wenn Sie uns Feedback geben oder uns mitteilen möchten, wie wir Ihre Erfahrung mit MVD-DE verbessern können, füllen Sie bitte unser Feedbackformular aus.

Feedback geben