ioBroker.jb-iot

Matter-Bridge: stellt beliebige ioBroker-Datenpunkte als virtuelle Matter-Geräte bereit, damit sie lokal (ohne Cloud) über Amazon Alexa abgefragt und gesteuert werden können — z.B. "Alexa, wie warm ist der Kessel?" oder "Alexa, mach das Rollo in der Küche auf".

Funktionsprinzip

Der Adapter startet eine Matter-Bridge im lokalen Netzwerk (Port 5540). Jede in der Admin-Oberfläche konfigurierte Zeile wird als eigenständiges Matter-Gerät unter dieser Bridge angeboten. Nach einmaligem Koppeln in der Alexa-App erscheinen alle konfigurierten Geräte einzeln in Alexa.

Es gibt keine Abhängigkeit von AWS, einem Amazon-Developer-Account oder der ioBroker-Cloud — die gesamte Kommunikation läuft lokal über Matter/WLAN.

Voraussetzungen

• Node.js ≥ 20 auf dem System, auf dem ioBroker läuft
• Mindestens ein Matter-fähiger Echo als Hub im Haushalt (z.B. Echo Dot 3./5. Generation reicht für Matter-über-WLAN, Thread ist nicht nötig)
• Port 5540 muss im lokalen Netzwerk erreichbar sein (keine Firewall-Blockade)
• Das ioBroker-System und die Echo-Geräte müssen im selben LAN sein, ohne Client-Isolation (z.B. Gäste-WLAN mit AP-Isolation funktioniert nicht)
• mDNS/Multicast muss im Netzwerk funktionieren

Einrichtung

1. Adapter installieren und Instanz anlegen
2. In der Adapter-Konfiguration die gewünschten Geräte eintragen: Name, Gerätetyp, zugehörige(r) Datenpunkt(e)
3. Adapter starten/neu starten (jede Config-Änderung startet die Instanz automatisch neu und baut die Geräteliste neu auf)
4. Pairing-Code ablesen: entweder im Adapter-Log oder im Objekt jb-iot.X.info.pairingCode
5. In der Alexa-App: Gerät hinzufügen → Matter-Gerät → Pairing-Code eingeben (oder QR-Code über den Link in jb-iot.X.info.qrPairingCodeUrl verwenden)
6. Alle konfigurierten Geräte erscheinen einzeln in Alexa

Die Kopplung bleibt über Adapter-Neustarts hinweg erhalten (persistenter Storage im Adapter-Datenverzeichnis) — erneutes Pairing ist nur beim allerersten Setup nötig.

Unterstützte Gerätetypen

| Typ | Datenpunkte | Alexa-Beispiel | |---|---|---| | Schalter | 1 (An/Aus) | "Alexa, schalte X an" | | Dimmer | 1 (0-100%) | "Alexa, dimme X auf 50%" | | Rollo | 1 (0-100%, 0=offen, 100=geschlossen) | "Alexa, mach X auf/zu" | | Temperatursensor | 1 (Ist-Temperatur, read-only) | "Alexa, wie warm ist X?" | | Thermostat | 2 (Ist-Temperatur + optional Soll-Temperatur) | "Alexa, wie warm ist X?" / "Alexa, stelle X auf 21 Grad" |

Hinweis Rollo: Es wird angenommen, dass der zugrunde liegende ioBroker-Datenpunkt der üblichen Konvention 0=offen/100=geschlossen folgt. Falls der gebundene Adapter das umgekehrt handhabt, muss das aktuell im Zieladapter angepasst werden.

Bekanntes Risiko

Die Unterstützung von Thermostat- und Rollo-Gerätetypen mit Alexa als Matter-Controller ist in der matter.js-Dokumentation nicht abschließend bestätigt (Stand: Erstentwicklung dieses Adapters). Nach der Einrichtung sollte für jeden Typ mindestens ein Testgerät real mit Alexa durchgespielt werden. Schalter/Dimmer sind laut Dokumentation zuverlässig unterstützt.

Troubleshooting

• Bridge wird in der Alexa-App nicht gefunden: Port 5540 prüfen (Firewall), sicherstellen, dass keine Client-Isolation zwischen ioBroker-Host und Echo-Geräten besteht, mDNS/Multicast-Traffic prüfen.
• Werte werden nicht aktualisiert: Adapter-Log auf Warnungen zu subscribeForeignStatesAsync/setForeignStateAsync prüfen — vermutlich stimmt der konfigurierte Datenpunkt nicht oder der Ziel-Adapter läuft nicht.
• Erneutes Pairing nötig nach Neustart: Sicherstellen, dass das Adapter-Datenverzeichnis (und damit matter-storage/) nicht bei jedem Neustart gelöscht wird.