Das Interface Matter bindet Geräte des Smart-Home-Standards Matter an. Es arbeitet mit einem Matter-Server (Controller), den die Box selbst verwaltet oder der extern läuft. Geräte nehmen Sie über den Import-Dialog mit ihrem Pairing-Code auf. Für dieses Interface gibt es keine Dialog-Hilfe und keinen Release-Notes-Eintrag, die Beschreibung stammt allein aus dem Code.
Voraussetzungen
- Matter-Geräte, die im Netzwerk per IP erreichbar sind. Im Import ist nur die Aufnahme über das Netzwerk vorgesehen.
- Für den Modus Managed: auf der Box sind Node.js und das npm-Paket
matter-serverinstalliert. - Für den Modus External: ein laufender Matter-Server mit Host und Port.
- Das Interface kann nur einmal angelegt werden.
Einrichten
- Legen Sie ein Interface vom Typ Matter an und wählen Sie den Server-Modus.
- Speichern Sie das Interface.
- Starten Sie die Import-Funktion.
- Tragen Sie für ein neues Gerät den Pairing-Code ein (11-stelliger Code oder QR-Text beginnend mit
MT:). Lassen Sie das Feld leer, um nur schon aufgenommene Geräte anzuzeigen. - Wählen Sie die gewünschten Geräte und Endpunkte und bestätigen Sie den Import.
Die Aufnahme eines Geräts kann bis zu etwa 3 Minuten dauern.
Einstellungen
Die Bezeichnungen im Dialog sind nicht in den Oberflächentexten hinterlegt. Die Felder heissen im Code wie folgt.
| Feld | Bedeutung | Hinweis |
|---|---|---|
Server-Modus (serverMode) |
Wo der Matter-Server läuft | Managed (Node.js on this box): die Box startet, überwacht und beendet den Server. External: die Box verbindet sich nur. Standard: Managed |
Netzwerkadapter (nic) |
Adapter für den Matter-Verkehr | Nur im Modus Managed |
Speicherpfad (storagePath) |
Ablage der Matter-Daten des Servers | Leer: Standardordner der Installation, der bei Updates erhalten bleibt |
Host (host) |
Adresse des Matter-Servers | Standard 127.0.0.1. Im Modus External Pflicht |
Port (port) |
Port des Matter-Servers | Standard 5580 |
Server-Skript (serverScriptPath) |
Pfad zum Matter-Server-Programm | Leer: wird automatisch ermittelt. Nur bei abweichender Installation nötig |
Log-Level (logLevel) |
Umfang der Server-Logs | Standard warning |
Im Import:
| Feld | Bedeutung | Hinweis |
|---|---|---|
Pairing-Code (setupCode) |
Code des neuen Geräts | Wird nach der Nutzung geleert |
Nur Netzwerk (networkOnly) |
Nur Geräte im IP-Netz aufnehmen | Standard: an |
Controls erstellen (createControls) |
Legt zu jedem Endpunkt ein Licht-Control an | Standard: an |
Unterstützte Funktionen
Nach dem Code erkennt der Import je Endpunkt nur diese drei Funktionen:
- On/Off (Cluster OnOff): schaltbar.
- Level (Cluster Level Control): in Prozent dimmbar, 0–100 % werden auf den Matter-Bereich umgerechnet.
- Boolean State: nur lesbar, zeigt einen Ein/Aus-Zustand.
Mit aktivierter Option entsteht aus On/Off und Level ein Licht-Control, siehe Licht-Control.
Hinweise und Grenzen
- Andere Matter-Funktionen (z. B. Messwerte, Thermostate) werden nicht importiert.
- Das Interface sichert die Matter-Daten des Servers in der Box-Datenbank und stellt sie bei Bedarf wieder her.
- Siehe Interfaces ohne Datenpunkte und Datenpunkte im Überblick zum Umgang mit Channels.