Einbindung von Matter Geräten in ioBroker (Tab "Controller")

Hierunter kommen alle Infos, wie man ein Gerät auf den verschiedenen Plattform zur Kommisionierung freigibt (wenn bereits gepaired) oder ein Gerät grundlegend neu kommisioniert.

Unverknüpftes Matter Gerät mit ioBroker Matter Controller verbinden

Um ein unverknüpftes Matter Gerät (Gerät ist entweder neu oder auf die Werkseinstellungen zurückgesetzt) am ioBroker Matter Controller anzulernen müssen folgende Schritte durchgeführt werden

Vorraussetzungen:

• ioBroker VISU App ist installiert
• ioBroker Assistenten Lizenz ist vorhanden und in der ioBroker VISU App konfiguriert
• ioBroker iot Adapter ist installiert und konfiguriert
• Siehe auch https://github.com/ioBroker/ioBroker.matter/wiki/Einleitung-und-wichtige-Hinweise#iobroker

Anleitung

• ioBroker VISU App starten und im Burger Menü "Matter" auswählen
• Auswahl "Nein, das Gerät ist neu." betätigen
• Matter-Instanz wählen (in der Regel matter.0) und Button "Gerät hinzufügen" auswählen
• Matter QR-Code am Matter Gerät scannen oder Kopplungscode vom Matter Gerät manuell eingeben
• Einrichtungsdialog am Handy bis zur Fertigstellung weiter befolgen
• Nach erfolgreicher Bestätigung in der Handy App ist das Gerät im ioBroker Controller jetzt sichtbar

Geräte erkennen und koppeln

Damit Geräte automatisch erkannt werden können, müssen folgende Bedingungen erfüllt sein:

• Das Gerät muss erfolgreich mit dem Matter Ökosystem verbunden sein, z.B. Google Home, Alexa, Apple, ...
• In der App des Matter Ökosystems muss der „Commission Modus“ für das Gerät geöffnet werden. Dies ist der Modus, wo der QR Code und Kopplungscode für das jeweilige Gerät angezeigt wird (siehe Beispielhaft der Abschnitt "Kopplungscode / QR Code ermitteln in Google Home")

Geräte per Pairing-Code oder QR-Code hinzufügen

Über dieses Menü wird ein Matter Gerät, welches bereits mit einem Matter fähgiem Ökosytem verbunden ist (z.B. Google Home) mit dem ioBroker Matter Controller verbunden. Die Kopplung erfolgt über die manuelle Eingabe des Kopplungscode oder scannen des QR-Codes.

Kopplungscode / QR Code

Um das bereits verknüpfte Matter Gerät mit dem ioBroker Matter Controller zu verbinden, wird der Kopplungscode / QR Code benötigt, welcher durch die Hersteller App vom Matter Ökosystem (z.B. Google Home) bereit gestellt wird. Der Kopplungscode / QR Code, welcher auf dem Matter Gerät aufgedruckt ist, kann hier nicht verwendet werden.

Kopplungscode / QR Code ermitteln in Google Home

• Öffne die App "Google Home"
• Tab "Einstellungen"
• Klicke auf das Gerät, welches mit dem ioBroker Matter Controller verbunden werden soll
• Klicke auf "Verknüpfte Matter-Apps und -Dienste"
• Klicke auf "Apps & Dienste verknüpfen"
• Wähle "Kopplungscode verwenden" oder "Per QR-Code teilen"
• Kopplungscode oder QR-Code im ioBroker Matter Controller Popup eingeben
• Das Matter Gerät wird jetzt im ioBroker Matter Controller hinzugefügt und als Node + Device angezeigt

Usage information

TBD

Wording: Node vs Device

TBD

Using the Matter Controller

TBD

Pairing nodes

TBD

Overview of the nodes and devices (UI)

TBD

Overview of the devices (Objects)

TBD

Verwendung der ioBroker Geräte kompatiblen States

Dies ist der Standardmodus für alle unterstützten Gerätetypen, zu denen ioBroker einen passenden eigenen Gerätetyp hat. In diesem Fall ist die Funktionalität abstrahiert, wie sie in ioBroker definiert ist und wie sie für viele andere Adapterzustände abgebildet wird. Die abgebildete Funktionalität ist auf das beschränkt, was ioBroker für den Gerätetyp definiert und sollte alle normalen Operationen ermöglichen.

Wenn zusätzliche gerätespezifische Funktionen oder Einstellungen benötigt werden, können diese durch das Freischalten der „Application Cluster States“ für diesen Knoten oder dieses Gerät zugänglich gemacht werden.

Verwendung der "Application Cluster states" (müssen seperat aktiviert werden!)

Hinweis: Nur für fortgeschrittene Anwender!

Manchmal kann es praktisch sein, auch weitere interne Details des Geräts zu sehen oder auf spezifische Funktionen des Geräts zuzugreifen. In diesem Fall können die „Application Cluster States“ für den Knoten oder das Gerät aktiviert werden. Dies ermöglicht z. B. die Einstellung der Empfindlichkeit eines Bewegungssensors. Wenn sie für einen Knoten (der dann für alle Geräte gilt, die von diesem Knoten ausgestellt werden) oder ein Gerät aktiviert sind, sehen Sie eine Menge zusätzlicher Zustände im Ordner data eines Objekts.

Die Details sind durch den Application Cluster strukturiert und in Attribute (Datenzustände) und Befehle unterteilt. Die genaue Bedeutung, die Einheiten und die zulässigen Werte und Bereiche für die Daten können dem Dokument „Matter Application Specification“ entnommen werden. Wenn Befehle als „Button“ dargestellt werden, kann die Aktion durch einfaches Setzen eines booleschen Wertes für den Status ausgelöst werden. Die meisten Befehle benötigen jedoch mehr Daten (diese sind „json“-Strings) und erfordern, dass ein JSON-String mit allen Befehlsfeldern bereitgestellt wird. Die genaue Definition der Befehlsfelder kann dem Dokument „Matter Application Specification“ entnommen werden.

Verwendung der "System Cluster states" (müssen seperat aktiviert werden!)

Hinweis: Nur für Experten! In allen normalen Anwendungsfällen sollten die System-Cluster-States nicht verwenden müssen. Die System-Cluster-States werden nur in besonderen Fällen und zur Fehlersuche oder zur eingehenden Untersuchung der Matter-Cluster-Daten benötigt. Wenn diese States aktiviert werden, werden eine Menge zusätzlicher Zustände angezeigt, welche für den normalen Betrieb nicht benötigt werden. Jegliche Änderungen an den beschreibbaren Zuständen können die Funktionalität der Geräte beeinträchtigen. Verwenden diese States also nur, wenn du weißt, was du tust!