# Matter

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/matter/

_Benötigt Symcon >= 8.2_

> **Hinweis:** Die Matter-Integration befindet sich noch in der Entwicklung und wird mit der Version 8.2 veröffentlicht. Zurzeit wird Matter unter Windows nicht unterstützt.

> **Achtung:** Generell empfehlen wir die Matter-Integration nicht unter Docker zu verwenden, da es hier diverse Anforderungen und Einschränkungen gibt, die teilweise sehr technisch und spitzfindig sind. Für erfahrene Nutzer haben wir einen [Leitfaden](matter.md) zusammengestellt.

#### Einbindung in Symcon
Um Matter Geräte in Symcon einzubinden wird ein Matter Konfigurator benötigt. Dieser kann im Objektbaum über "+"->"Instanz" via Schnellfilter "Matter Konfigurator" hinzugefügt werden.

### Einrichtung
Um Matter Geräte mit Symcon zu verbinden gibt es 2 Möglichkeiten.
![Configurator](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/matter/90c61bc3f5-1790424938/configurator.png)
#### 1. Die Symcon Visualization App
Wenn das Gerät brandneu ist oder auf den Werkszustand zurückgesetzt wurde, kann es über die Symcon App dem Server hinzugefügt werden.
Hierfür muss der Matter Konfigurator geöffnet und über die Schaltfläche "Gerät koppeln" die Option "Koppeln über App" gewählt werden. Daraufhin kann die App geöffnet werden. Wenn die App mit dem Server verbunden ist, kann in den Einstellungen über den Menüpunkt Matter die Einrichtungsseite geöffnet werden. Über das Plus in der unteren rechten Ecke kann der Kopplungsvorgang des jeweiligen Betriebssystems gestartet werden. Nachdem der QR-Code gescannt oder der Kopplungscode manuell eingegeben wurde, wird das Gerät für den Symcon Server freigegeben. Wenn der Konfigurator signalisiert, dass das Gerät erfolgreich verbunden wurde, können die verfügbaren Instanzen erstellt werden.
![App setup](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/matter/6ed6d5d731-1790424938/app-setup.png)

#### 2. Teilen durch anderen Controller
Ist das Gerät bereits mit einem anderen Controller verbunden (IKEA DIRIGERA Hub, Aqara Hub M3, Google Nest Hub oder Apple Home Pod) kann über die jeweiligen Apps ein Kopplungscode generiert werden, um das Gerät für andere Systeme freizugeben. Im Konfigurator kann über die Schaltfläche "Gerät koppeln" die Option "Gerät hinzufügen" gewählt werden. In diesem Dialog kann der Kopplungscode eingetragen werden. Daraufhin wird das Gerät eingerichtet und die verfügbaren Instanzen können erstellt werden.

> **Hinweis:** Einige Geräte (etwa Shelly), die ohne das Einrichten durch einen Controller im selben Netzwerk wie der Symcon Server sind, können wie in Möglichkeit 2 beschrieben eingerichtet werden. Der Kopplungscode entspricht dem, der direkt auf Gerät unter dem Matter-QR gedruckt ist.

![Pairing](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/matter/9ae7dda649-1790424938/pairing.png)

### Konfigurator
Über den Konfigurator können die bereits hinzugefügten Geräte verwaltet werden.

#### Abonnements
In der Abonnement Spalte wird der Verbindungsstatus der einzelnen Knoten angezeigt. Durch einen Klick auf den Text kann ein Dialog geöffnet werden, der die vergangenen und die Aktuelle Verbindung und deren Zustand auflistet. Außerdem kann über die Schaltfläche "Abonnement erzwingen" eine neue Verbindung manuell aufgebaut werden. Dies ist nur in Ausnahmefällen notwendig, da die Wiederaufnahme von unterbrochenen Verbindungen automatisiert erfolgt.
![Subscription protocol](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/matter/46370747b1-1790424938/subscription-protocol.png)

#### Gerät Aktualisieren
Alle Informationen eines Gerätes können über einen Klick auf das runde Pfeil Symbol erneut abgerufen werden. Dies ist notwendig, wenn an einer eingebundenen Bridge (Hue Bridge, IKEA DIRIGERA) neue Geräte hinzugefügt wurden, die noch nicht im Konfigurator aufgelistet sind.

#### Erweiterte Informationen anzeigen
Über das "i" im Konfigurator kann ein Dialog angezeigt werden, der verschiedene Informationen über den Hauptknoten und die einzelnen Endpunkte anzeigt. Dazu gehört die Art der Verbindung (Ethernet, Wifi, Thread), die Software- und Hardwareversion sowie alle Controller mit denen das Gerät verbunden ist. Außerdem werden alle Cluster des gewählten Gerätes angezeigt.
![Node info](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/matter/33f8cc7c6a-1790424938/node-info.png)

#### Geräte entfernen
Über das "x" im Konfigurator kann die Verbindung mit dem Gerät getrennt werden.

### Matter Gerät Instanz
Ein Matter Gerät besteht aus einem oder mehreren Endpunkten. Für jeden Endpunkt wird eine Instanz des Typs "Matter Gerät" erstellt. Ein Endpunkt mehrere Cluster, welche die verschiedenen Funktionen eines Gerätes abbilden.
![Matter device](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/matter/a71b91e1e5-1790424938/matter-device.png)
Über die Schaltfläche "Unterstützte Cluster anzeigen" wird ein Dialog geöffnet, welcher die Cluster anzeigt über die der Endpunkt verfügt, und ob diese von Symcon unterstützt werden. Außerdem wird die "Feature Map" angezeigt, welche Aufschluss über den Funktionsumfang der einzelnen Cluster gibt.
Über "Werte aktualisierten" werden die einzelnen Werte des Gerätes ausgelesen und in die Variablen geschrieben.
Wenn ein Gerät die Funktion unterstützt, kann über die Schaltfläche "Gerät Identifizieren", eine Zeit festgelegt werden. Beim Bestätigen meldet sich das physikalische Gerät für die angegebene Dauer, beispielsweise über ein Blinken oder Summen.
Im unteren Bereich der Instanzkonfiguration werden alle schaltbaren Variablen angezeigt und können verändert werden.

### Batteriebetriebene Geräte
Einige batteriebetriebenen Geräte gelten als Intermittently Connected Devices (ICD). Diese Geräte können über einen längeren Zeitraum nicht verfügbar sein. Daher können sie von Symcon nicht zuverlässig abonniert werden. Die Werte der ICDs können trotzdem manuell aktualisiert werden, solange Symcon das Gerät erreichen kann. Auch wenn das Gerät mit Symcon gekoppelt ist, kann es sein, dass es im Konfigurator übergangsweise nicht angezeigt wird.

### Unterstützte Cluster
Es werden noch nicht alle Funktionen, welche die einzelnen Cluster bieten unterstützt.

- OnOff
- LevelControl
- ColorControl
- OccupancySensing
- TemperatureMeasurement
- RelativeHumidityMeasurement
- IlluminanceMeasurement
- Switch
- BooleanState
- Pm25ConcentrationMeasurement
- FanControl
- RvcCleanMode
- RvcOperationalState
- RvcRunMode
- ServiceArea
- AirQuality
- PowerSource
- DoorLock
- Thermostat
- HepaFilterMonitoring
- ElectricalEnergyMeasurement
- ElectricalPowerMeasurement
- WindowCovering
- Descriptor
- Identify

## Hinweis zur Verwendung von Matter unter Docker

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/matter/docker/

- Generell empfehlen wir die Matter-Integration nicht unter Docker zu verwenden, da es hier diverse Anforderungen und Einschränkungen gibt, die teilweise auch sehr technisch und spitzfindig sind.
- **Synology/QNAP NAS** haben einen zu alten Kernel, sodass dort Thread Geräte gar nicht, und LAN/WLAN Geräte nur im Host/MacVLAN Netzwerk-Modus laufen können.

Wenn Matter unter Docker verwendet werden soll, **muss** eine der beiden Voraussetzungen erfüllt sein:
   - Docker läuft im MacVLAN Netzwerk-Modus, sodass der Container eine eigene IP-Adresse im Netzwerk hat.
   - Docker läuft im Host Netzwerk-Modus. Der Host darf dabei kein Avahi installiert haben. Ansonsten gibt es Server-Collision Fehlermeldungen und die mDNS Netzwerkauflösung wird nicht zuverlässig sein, da zwei Avahi-Stacks parallel laufen.

Bei folgenden Einschränkungen funktioniert Matter trotzdem nicht zuverlässig:
- Docker im Bridge Netzwerk-Modus funktioniert gar nicht, da mDNS dadurch nicht verfügbar ist.
- Docker läuft zwar korrekt im Host Netzwerk-Modus, aber Avahi läuft ebenfalls auf dem Host. Dadurch läuft Avahi doppelt. Dies ist insbesondere bei **Synology/QNAP NAS** der Fall. Dadurch wird das Finden der Geräte über mDNS gestört und Geräte werden sporadisch nicht erreichbar bzw. unzuverlässig sein.
- Wenn der Kernel zu alt ist werden keine Router Announcements unterstützt. Dies ist insbesondere bei **Synology/QNAP NAS** der Fall. In diesem Fall funktioniert die Matter-Integration nur für LAN/WLAN Geräte und für Thread Geräte nur, wenn ein IPv6-DHCP-Server verfügbar ist, der alle Adressen/Routen korrekt an alle Geräte/Thread Border Router vergibt.
- Falsch oder nicht gesetzte Sysctl-Einstellungen. Darauf weist der Konfigurator auch entsprechend hin. Dadurch werden insbesondere die Router Announcements konfiguriert, sodass Thread Geräte zuverlässig funktionieren.

## Geräteliste

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/matter/geraeteliste/

_Benötigt Symcon >= 8.2_

### Matter over Thread
Wenn Matter Geräte über Thread angebunden werden sollen wird ein Thread Border Router (TBR) benötigt. Um ein "Matter over Thread" Gerät zu Symcon hinzufügen zu können müssen dem Betriebssystem (iOS oder Android) die Thread Credentials des TBR bekannt sein. Alternativ können angelernte Geräte über die App des Herstellers für Symcon freigegeben werden.
Die TBRs der folgenden Hersteller wurden getestet:

| Hersteller | Produkt                      |
| ---------- | ---------------------------- |
| IKEA       | DERIGERA Hub                 |
| Apple      | z.B. HomePod mini            |
| Google     | z.B. Google TV Streamer (4K) |
| Aeotec     | z.B. Smart Home Hub          |