Einleitung und wichtige Hinweise
Mit dem ioBroker Matter Adapter ist es möglich folgende Anwendungsfälle abzubilden:
- Matter-basierte Geräte können direkt mit ioBroker verknüpft und somit eingelesen / gesteuert werden
- Bereitstellung von mehreren ioBroker Geräten als eine Matter Bridge: Matter Bridges können mehrere Geräte enthalten und sind die einfachste Möglichkeit, ioBroker-Geräte in ein Matter-kompatibles Ökosystem zu integrieren.
- ioBroker stellt auf Basis von ioBroker-Geräten / ioBroker-States einzelne virtuelle Matter Geräte zur Verfügung, welche an einem Matter-kompatiblen Ökosystem angelernt werden können (Für Amazon Alexa sind zur Zeit nur Bridges möglich)
- Der Adapter kann NICHT via GitHub installiert werden: Der Adapter muss über das ioBroker Repository (stable bzw. latest) installiert werden
- Die Konfiguration für diesen Adapter ist nicht in nur einem zentralen Objekt enthalten, wie in anderen einfachen Adaptern. Das bedeutet, dass das Löschen von Instanzobjekten oder Objektbäumen zu einer fehlerhaften Konfiguration führen kann, und das der Adapter möglicherweise von Grund auf neu konfiguriert werden muss.
- Installieren den Adapter niemals neu, indem nur die Instanz gelöscht und wieder neu hinzugefügt wird, wenn verbundene Geräte (z. B. auf Controller) oder verbundene Controller (z. B. auf Bridges) erhalten bleiben sollen. Wenn die Instanz gelöscht wird, werden alle verbundenen Geräte gelöscht und müssen erneut verbunden werden.
-
Verwende ein ioBroker-Backup, um die Matter Konfiguration zu sichern und um die Matter Konfiguration wieder herzustellen. Falls eine Sicherung der Matter Konfiguration ohne Backup erstellt werden soll, muss der gesamten Objektbaum der Adapterinstanz (z.B.
matter.0) exportiert und bei Bedarf wieder importiert werden. Dies kann eine große Anzahl von Objekten sein, abhängig von der Anzahl der Geräte und Controllern, die verbunden waren. - Einige Objekte werden standardmäßig nicht angezeigt, da sie für den normalen Betrieb irrelevant sind. Wenn diese Objekte angezeigt werden sollen, muss der „Expertenmodus“ im ioBroker Admin aktiviert werden. Bei diesen Objekten geht es hauptsächlich um die „Speicher“-Objekte. Bitte nicht ändern, es sei denn, du weißt wirklich, was du machst!
- Google Nest-Produkte (z.B. Nest Hub (2. Generation) oder Nest Mini)
- Apple HomePod-Lautsprecher
- Amazon Echo-Geräte (z.B. Echo/Echo Dot Gen. 3,4,5 oder Echo Show)
- Samsung SmartThings Station
- Tuya Smart (SmartLife) app - keine Zusatzhardware nötig, aber Logik benötigt das Handy
- LG Thinq/TVs
- Home Assistant (Software)
- Flic (Wenn threadfähige Endgeräte eingebunden werden sollen, ist eine Hardware notwendig, welche einen Thread Boarder Router integriert hat)
Ob eure Hardware geeignet ist, könnt ihr z.B. hier nachschauen: https://matter-smarthome.de/diese-geraete-produkte-sind-kompatibel-mit-matter/
Die folgenden Systeme funktionieren aktuell nicht als Controller um iobroker Geräte oder Bridges zu nutzen:
- Aqara Hub M3
- Yandex
- Euer Netzwerk muss IPv6 aktiviert haben und keine VLANs oder Systeme haben die UDP Routing unterbinden! Das gilt vom Hub zu ioBroker Host zu Handy-Apps - also alle miteinander müssen im gleichen Netzsegment sein und IPv6 unterstützen. Ob Eure externe Internetanbindung IPv6 kann ist egal - es geht ausschliesslich um Euer internes Netzwerk.
- Wer Docker nutzt muss aktuell den "Host" mode für Netzwerk nutzen - ebenfalls wegen UDP.
- Proxmox LXC gehen nur wenn der Proxmox Host eine IPv6 Adresse hat, was im Normalfall nicht der Fall ist und damit IPv6 fehlt! Proxmox geht damit am einfachsten in einer VM die IPv6 hat.
- Der ioBroker Matter Adapter braucht ~160 MByte RAM und dies kann auch mit vielen Geräten oder Bridges mehr sein, sollte aber dann im Betrieb weitestgehend stabil sein.
- Ohne eine gültige ioBroker Assistenten- oder Fernzugriffs-Lizenz gelten folgende Limitierungen:
- Anlegen von nur einer Bridge mit bis zu 5 Geräten in dieser Bridge
- Anlegen von maximal 2 einzelnen Geräte
- Mit einer gültigen ioBroker Assistenten- oder FernzugriffsLizenz sind diese Limitierungen aufgehoben (mit der Ausnahme beim Alexa-Ökosystem, wo aktuell nur maximal eine Bridge pro Adapter-Instanz unterstützt wird)
- Um matterfähige Geräte direkt an den ioBroker Matter-Controller anlernen zu können wird idealerweise die ioBroker VISU App (Android oder Apple), eine ioBroker Assistenten- oder Fernzugriffs-Lizenz sowie ein eingerichteter "Cloud IoT-Verbindung" (iot) Adapter benötigt. Matterfähige Geräte, welche schon im IP-Netzwerk sind (z.B. weil Sie schon über ein anderes Ökosystem angelernt wurden), können alternativ direkt über die Controller UI im Adapter angelernt werden. Auch ein anlernen übr das BLE vom ioBroker Host ohne die VISU App kann in bestimmten Fällen funktionieren, ist aber nicht so einfach wie mit der VISU App.
- Wenn die iobroker Visu App für die Gerätekopplung verwenden wird, müssen mindestens folgende Versionen verwendet werden:
- ioBroker Visu App: v1.3.2
- iot Adapter: v3.4.4
- Eine Instanz des Adapters ist an einen Host (aka IP) gebunden. Mehrere Instanzen erfordern ein Multi-Host-Setup.
- Stelle sicher, dass IPv6 im Netzwerk aktiviert ist und der Host, auf dem dieser Adapter verwendet wird, eine IPv6-Adresse hat.
- Wenn LXC-Container in Proxmox verwendet werden, ist dies so gut wie nicht gegeben, da Proxmox-Hosts normalerweise nicht für IPv6 konfiguriert sind! Eine Lösung ist im Wiki beschrieben
- Stelle sicher, dass UDP-Pakete zwischen den Geräten, der mobilen App, den Hubs und dem Host, auf dem der Adapter verwendet wird, fließen können!
- Stellen vor allem sicher, dass keine VLANs verwendet werden, da UDP normalerweise nicht zwischen VLANs geroutet werden! Oder finden heraus, wie der Router konfigurieren werden muss, dass er dies zulässt (Fritz Box! funktioniert damit nicht!)
- Wenn ioBroker in einem Docker-Container verwendet wird, stelle sicher, dass der Host-Modus verwendet wird, damit UDP-Pakete zwischen den Containern und dem Host fließen können. Der Bridged-Netzwerkmodus funktioniert nicht mit UDP-Paketen!
Wichtig: Um mehr als 5 Bridged Devices oder zusätzliche separate Devices oder Bridges anlegen zu können, müuss eine ioBroker Assistenten- oder FernzugriffsLizenz vorhanden sein und die Zugangsdaten müssen in den Einstellungen vom Matter Adapter eintragen sein! Mit dem Erwerb einer Lizenz unterstütz du das ioBroker Team bei der Weiterentwicklung von ioBroker und Matter. Die Matter Controller-Nutzung ist nicht eingeschränkt.
- Die Bridges und Geräte, die der ioBroker Adapter zur Verfügung stellt, sind nicht offiziell von der Matter Organisation zertifiziert. Dies bedeutet, dass sie nur in Ökosystemen funktionieren, die es erlauben eine Verbindung mit nicht zertifizierten Geräten herzustellen.
- Für Google können zusätzliche Schritte notwendig sein - siehe https://github.com/project-chip/matter.js/blob/main/docs/ECOSYSTEMS.md#google-home-ecosystem
- Aqara Hub M3 und Yandex erlauben derzeit (ab November 2024) keine Kopplung von „nicht zertifizierten Geräten“!
- Jedes Ökosystem hat unterschiedliche Grenzwerte für Geräte pro Bridge und dergleichen. Wenn also eine große Anzahl von Geräten (es gibt Testergebnisse bis zu 64, die zumindest bei Apple, Google und - etwas seltsam - Amazon funktionieren sollten) in einer Bridge zu Problemen führt, versuche bitte, sie auf mehrere Bridges aufzuteilen.
- Für Alexa kann derzeit nur die „Default Bridge“ auf einem Host verwendet werden. Mehrere Bridges zur Verwendung mit Alexa sind nur auf verschiedenen Hosts möglich.
Voraussetzungen für die Verwendung von Matter-Geräten in ioBroker (auch bekannt als „Matter Controller“)
- Wenn Matter Thread basierte Geräte mit dem ioBroker Matter Controller verunden werden sollen, wird ein ein Thread Border Router (TBR) im Netzwerk benötigt. Unter https://github.com/project-chip/matter.js/blob/main/docs/ECOSYSTEMS.md stehen weitere Informationen über die Ökosysteme und deren Thread-Unterstützung zur Verfügung. Weitere Informationen über Thread und auch darüber, wie ein eigenen TBR hinzugefügt werden kann, sind unter https://github.com/project-chip/matter.js/blob/main/docs/USAGE_THREAD.md dokumentiert.
- Wenn ioBroker auf einem linuxbasierten Betriebssystem installiert ist und es Verbindungsprobleme mit Thread-basierte Matter Geräten gibt, optimiert bitte die IP-v6 Konfiguration mittels der Anleitung unter Troubleshooting
- Am einfachsten ist die Erstinbetriebnahme von Matter Geräten mit der „ioBroker Visu App“ möglich, welche das Bluetooth Low Energy (BLE) des Mobilgeräts nutzt. Alternativ kann auch das BLE Ihres ioBroker-Hosts verwendet werden, hier muss sich aber das Matter Gerät in der BLE-Reichweite des ioBroker Hosts befinden. Für die Nutzung der ioBroker Visu-App wird ein ioBroker Pro Account mit einer aktiven ioBroker Assistenten- oder Fernsteuerungslizenz benötigt.
Hinweis: Diese Kapitel ist noch eine lose Sammlung an Informationen und muss noch verfeinert werden
Verwendung des USB-Sticks https://www.adafruit.com/product/5199 und dort OpenThread Firmware drauf geflasht und dann in einer VM (geht auch mit nem eigenen Raspi oder so) OpenThread installiert. Anleitung dafür alles unter https://openthread.io/guides/border-router/raspberry-pi?hl=de
Es gibt auch Geräte wie https://store-eu.gl-inet.com/de/products/gl-s20-iot-gateway-thread-border-router oder den GL-S200 die das "out of the box" machen aber mit Import und so halt bei etwas über 100 EUR landen dafür aber idealerweise direkt funktionieren.
Aktuell ist die Verwendung von einem OTBR + ioBroker VISU App zum anlernen von Matter-over-Thread Geräten (noch) nicht möglich. In diesem Fall muss man die BLE Funktion im ioBroker Matter Controller (siehe Screenshot) / ioBroker Host verwenden und das Matter-over-Thread Gerät muss dann auch in der Nähe des ioBroker Hosts (der das BLE bereitstellt) sein.
