Troubleshooting
Auf dieser Seite werden Hilfestellungen zu Problemen mit dem Matter Adapter / Matter Ökosystem gesammelt. Zusätzliche Hinweise sind auch auf der Troubleshooting Seite von matter.js dokumentiert. Der ioBroker Matter Adapter basiert auf der "matter.js" Bibliothek.
- Bitte überprüfe zuerst die Informationen auf der Seite Einleitung und wichtige Hinweise sowie die auf dieser Seite beschriebenen Hilfestellungen
- Prüfe, ob die neueste verfügbare Version installiert ist - oder wenn nicht, ob das Changelog der neueren Versionen als die installierte das aktuelle Problem löst und aktualisiere den Adapter.
- Überprüfe, ob ein offenes GitHub issues zu deinem Problem existiert. Wenn das Problem schon gemeldet wurde, reagiere im ersten Beitrag mit einen "Daumen hoch". Dies hilft, die Probleme zu priorisieren. „Me Too"- Kommentare ohne zusätzliche Informationen sind nicht erforderlich.
- Erstellen ein GitHub issue beim Adapter, wenn das Problem noch nicht existiert.
- Setze bei der Adapter Intanz das Loglevel auf "Debug" und aktiviere in den Einstellungen der Matter Instanz auf dem ersten Tab "Allgemein" die Option "Erweitertes Debug-Logging für das Matter-Protokoll aktivieren (nur sichtbar mit der Protokollebene „Debug“)". Hänge das Log (Logfile-Speicherort üblicherweise
/opt/iobroker/logs/...) als Textdateianhang an das github issue. Stelle bitte nicht nur die eigentliche Fehlermeldeung zur Verfügung, sondern stelle auch einige Minuten des Protokolls vor und nach dem Fehler bereit, um mehr Kontext zu erhalten. Beschreibe im issue so ausführlich wie möglich, was gemacht wurde als der Fehler entstanden ist und wie sich der Fehler genau äußert. Je detaillierte das Problem beschrieben ist, desto besser kann es analysiert werden.
Um IPv6 für den ioBroker Matter Adapter verwenden zu können, muss im LXC Container in Proxmox die Option "SLAAC" aktiviert werden.
Kurze Erklärung zum Thema SLAAC: https://www.elektronik-kompendium.de/sites/net/1902141.htm
Erfolgreich getestet mit Ubuntu 24.04, Debian 12 + Fritzbox 7530 mit DHCP + Defaulteinstellungen für "IPv6 Einstellungen"
Eine weitere englischsprachige Anleitung ist hier: https://github.com/project-chip/matter.js/blob/main/docs/TROUBLESHOOTING.md#ipv6-linux-system-details
Die folgenden Einstellungen für den ioBroker Host können helfen, wenn es Probleme in der Kommunikation zu Thread Geräten über einen Matter Hub (z.B. von Google oder Apple) gibt.
Bestimmt kann man das noch optimieren 😉 Aktive Netwerkschnittstelle: wlp0s20f3
/etc/sysctl.conf
- net.ipv6.conf.all.forwarding=0
- net.ipv6.conf.wlp0s20f3.forwarding=0
- net.ipv6.conf.wlp0s20f3.accept_ra=1
- net.ipv6.conf.wlp0s20f3.accept_ra_rt_info_max_plen=64
/etc/network/interfaces
-
iface wlp0s20f3 inet6 auto
-- accept_ra 2
Kontrolle der Einstellungen: (sudo voranstellen)
sysctl -n net.ipv6.conf.wlp0s20f3.forwarding
0
sysctl -n net.ipv6.conf.wlp0s20f3.accept_ra
2
sysctl -n net.ipv6.conf.wlp0s20f3.accept_ra_rt_info_max_plen
64
Ich sehe schon, das die Einträge nicht konsistent sind, habe aber immer mal wieder eine Einstellung geändert->reboot->Test, so läuft es jetzt aber.
In diesem Abschnitt wird gesammelt an welchen Stellen sich die verschiedenen Ökoysteme unterschiedlich verhalten
Generelle Informationen sind auch unter den folgenden Links zu finden:
- https://github.com/project-chip/matter.js/blob/main/docs/ECOSYSTEMS.md#pairing-and-usage-information
- https://github.com/project-chip/matter.js/blob/main/docs/TROUBLESHOOTING.md
- Google: Der Temperaturwert wird in der App auf 0.5° gerundet angezeigt
- Google: Nicht unterstützt
- Amazon: Nicht unterstützt
Der ioBroker Matter Adapter wird für Rolläden 0% = Rolladen geschlossen/unten (kein Licht kommt durch) 100% = Rolladen offen/oben (Licht kommt vollständig durch)
Wenn eine andere Logik benötigt wird, dann erzeuge vom entsprechenden Datenpunkt ein Alias. Mit rechtsklick kann der Alias bearbeitet werden und dort kann die Konvertierungsfunktion dazu verwendet werden die Behanghöhe zu invertieren, z.B. anstatt "val" wird "100-val" verwendet.
- Mit Alexa kann nur die Standard-Bridge auf einem Host verwendet werden. Mehrere Bridges zur Verwendung mit Alexa sind nur auf verschiedenen ioBroker Hosts möglich.
- Nach einem Matter Adapter restart oder ioBroker Host reboot kann es bis zu 10 - 15 Minuten dauern bis sich alle Controller wieder neu verbunden haben
- Wenn ein Ecosystem das Gerät als nicht verbunden anzeigt, insbesondere nach einem Neustart des Adapters, bedeutet dies in der Regel, dass der Controller sich noch nicht wieder mit dem Gerät verbunden hat. Dies kann einige Zeit dauern. Wenn die Verbindung nach ein paar Minuten nicht wiederhergestellt ist, überprüfe bitte die Verbindungsinformationen in der Benutzeroberfläche. Wenn ein Ökosystem überhaupt keine Verbindung herstellt, überprüfen bitte das ioBroker Log (ggf. Debug Loglevel aktivieren) und erstelle falls notwendig ein github issue.
- Hue Lampen: Wer Aliase nutzt die mit "Devices" (Geräte) angelegt wurden und diese dann als Matter Device/Bridge bereitstellt kann aktuell HUE Lampen nicht über die App des Matter Ökosystems ein oder ausschalten. Ursache ist, dass die "role" beim "ON" State der Hue-Lampe im Alias nicht gesetzt wird ( https://github.com/ioBroker/ioBroker.devices/issues/363) . Workaround bis zum fix: Entweder über den Alias-Manager für diesen State die "common.role" auf "switch.light" setzen oder direkt das Alias Objekt alias.0.xxx.HueLampe.ON bearbeiten und im Abschnitt "common" die Zeile "role" hinzufügen. "common": { "alias": { "id": "xxxx" }, ... "role": "switch.light", },
tbd