Zigbee2mqtt addon für OpenCCU

[Matten Matten]

Zigbee2mqtt als addon für deine CCU

zigbee2mqtt addon 2.13.0.png (15.16 KiB) 459 mal betrachtet

Info: Voraussetzung CCU benötigt Internet Zugang!
Info: Voraussetzung ist ein MQTT Broker.
auch OpenCCU sollte nicht zu alt sein (NodeMinVersion:V22.2.0)

Das installieren passiert einfach unter "Zusatzsoftware"

entpackte zip als tar.gz auswählen und installieren.png (7.65 KiB) 451 mal betrachtet

Ablauf: wenn sich das addon in seine Struktur installiert hat, wird auch ein automatisches Update auf die neuste Version durchgeführt.

Ein Neustart der CCU ist nicht nötig.

Beim ersten Start des addons wird beim öffnen des Webinterface (unter "Systemsteuerung") eine Konfigurations Seite geöffnet(onboarding). Dort können mqtt Verbindung, topic, so wie die Auswahl des Koordinator eingerichtet und gespeichert werden.

Dann muss ein Neustart unter "Zusatzsoftware" gemacht werden.
Und das Webinterface ist über "Systemsteuerung" erreichbar


Zigbee2MQTT watchdog:
(Dokumentation für den Watchdog)
Der interne Zigbee2MQTT watchdog ist integriert und kann unter "/usr/local/addons/zigbee2mqtt/watchdog" angepasst werden
aktuelle Konfiguration des Watchdog ist wie Folgt:

Code: Alles auswählen

Z2M_WATCHDOG=0.1,0.5,0.5,0.5,0.5,0.5,1,5,30,60

CuxDeamon:
Info: Wer CuxD nutzt muss in der CuxD "Setup" den passenden TTY Port mit :NC eintragen und speichern

Code: Alles auswählen

TTYASSIGN=ttyACM0:NC

oder

Code: Alles auswählen

TTYASSIGN=ttyUSB0:NC

🧱 aktive Firewall:
Info: wer die Firewall auf der RM aktiv hat sollte folgenden Port für das z2m Webinterface eintragen

Code: Alles auswählen

8080;

🧳 z2m Update:
Ein Update von Zigbee2MQTT wird über ein Webinterface ausgeführt.
Erreichbar unter "Zusatzsoftware->Herunterladen"

deinstallieren:
Das deinstallieren von zigbee2mqtt, passiert ganz einfach über den Deinstallieren Button unter Zusatzsoftware.


Downloadbereich:

Bitte hier im Forum Rückmeldung geben ob alles funktioniert!
(Wenn zu viele Downloads, aber zu wenig Rückmeldung entsteht wird das Addon nur noch via PN verfügbar sein.)

Fertige Addon Datei:
ZIP downloaden und entpacken, so das die tar.gz zu sehen ist, dann auf die CCU hochladen & installieren

zigbee2mqtt addon V2.13.0 and Update to latest ZIP.zip

(15.58 MiB) 22-mal heruntergeladen

Achtung: vor der Installation wird die node Version geprüft! wenn auf Original CCU oder eine zu alte OpenCCU Software installiert wird, dann erscheint folgende Fehlermeldung & das addon wird nicht installiert.

node Fehler.png (9.95 KiB) 455 mal betrachtet

Update Historie

• V2.13.0 - OpenCCU-node.js Pfad integriert, node Prüfung vor Installation des addons, z2m auf aktuelle Version angepasst(V2.13.0), onboarding aktualisiert

• V2.4.5 - jetzt wird vor Addon-start geprüft ob bei der ersten Installation erfolgreich die Updates installiert wurden.

• V2.4.4 - internen Zigbee2MQTT watchdog integriert damit bei einem Abbruch von MQTT oder einem Ethernet Funk Modul das addon nicht sofort stoppt, "Neue addon Version" Hinweis hinzugefügt, Updater verbessert & angepasst, Versionszweige hinzugefügt | 140-mal heruntergeladen

• V2.4.3 - addon config Seite überarbeitet, jetzt mit Status Anzeige ob addon läuft | 67-mal heruntergeladen

• V2.4.2 - addon Start mit mqtt Prüfung host & port werden aus der yaml zum prüfen geladen, mit Ausnahme beim onboarding

• V2.4.1 - onboarding überarbeitet - Weiterleitung über richtigen Host, Update Script verbessert, addon Version jetzt unterm Logo

• V2.4.0 - First Release

[frankdrebin]

Hat auf Anhieb geklappt, vielen Dank.
Raspberrymatic 3.83.6.20250824 rpi3
Raspberry 3B+
z-stack USB-Stick slaesh cc2652rb

[volbuss]

Ich bin begeistert, hat bei mir auch gleich funktioniert mit einem "usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus".
Raspi 3+ mit Raspberrymatic und CCU-Jack als Addon.
Danke vielmals dafür.

[DGMA]

Hat alles wunderbar funktioniert. Vielen Dank.

Hardware:

• CCU3

• ConBee II USB Stick

• Aqara Taster - Modell WXKG11LM

Software:

• Raspberrymatic 3.83.6.20250824 rpi3

• RedMatic 7.3.5

• Aedes MQTT Broker v0.51.3

• zigbee2mqtt v2.6.1

[rr745]

Perfekt. Hast Du mal wieder toll hinbekommen....
Inst auf Raspberry III mit Sonoff Stick funzt.

Neustart war allerdings notwendig.

Vielen Dank.

[Matten Matten]

...Neustart war allerdings notwendig...

Was funktionierte denn nicht ohne ein Neustart?

Wenn das addon nicht von allein anläuft, kann man mittels restart Button unter Zusatzsoftware triggern.

[rr745]

...Neustart war allerdings notwendig...

Was funktionierte denn nicht ohne ein Neustart?
Wenn das addon nicht von allein anläuft, kann man mittels restart Button unter Zusatzsoftware triggern.

>Wenn das addon nicht von allein anläuft, kann man mittels restart Button unter Zusatzsoftware triggern.

Ja -das hatte ich auch versucht.
Nun hab ich allerdings nicht lange suchen wollen. Wie lautet der Satz: Reboot tut gut.
Danach startete auch Zigbee2mqtt ohne zu murren.

[volbuss]

Bei mir hat sich nach dem Ausfüllen der "Konfigurations Seite" und folgendem Aufrufen der "FrontendSeit" diese mit "http://localhost:8080" geöffnet. Mit der richtigen IP ging es natürlich.

[Matten Matten]

Ja diese Weiterleitung auf den "localhost" wird seitens zigbee2mqtt ausgeführt. Ist nicht optimal nach dem onboarding. Vielleicht wird das seitens der Entwickler noch behoben.

[optism]

Hi,

ich editiere meinen vorigen Beitrag, der nur die Frage nach der Datei enthielt.

Meine Fragen sind hinfällig, alles funktioniert wunderbar. Für andere die genauso blöd sind: Man muss auch einen (z.B. den aus Mattens addon) MQTT-Broker installieren - dann klappts auch und ist wirklich einfach plug&play.
Mein erstes zigbee-device arbeitet jetzt erfolgreich!

Pi3b, Raspimatic, alles aktuelle Versionen

TipTop und vielen Dank!


Die Installation bzw. Inbetriebnahme klappt bei mir noch nicht vollständig, mehrere Probleme.

Im log von z2m schlägt die Verbindung zum mqtt-server fehl:

z2m: Logging to console (silenced), file (filename: log.log)
[2025-10-02 17:40:48] info: z2m: Starting Zigbee2MQTT version 2.6.2 (commit #4d247f3a)
[2025-10-02 17:40:48] info: z2m: Starting zigbee-herdsman (6.1.5)
[2025-10-02 17:40:48] info: zh:adapter:discovery: Matched adapter: {"path":"/dev/ttyUSB0","manufacturer":"ITead","serialNumber":"643c1385c574ef119977c88c8fcc3fa0","pnpId":"usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_643c1385c574ef119977c88c8fcc3fa0-if00-port0","vendorId":"10c4","productId":"ea60"} => zstack: 4
[2025-10-02 17:40:48] info: zh:zstack:znp: Opening SerialPort with {"path":"/dev/ttyUSB0","baudRate":115200,"rtscts":false,"autoOpen":false}
[2025-10-02 17:40:48] info: zh:zstack:znp: Serialport opened
[2025-10-02 17:41:15] info: zh:controller: Wrote coordinator backup to '/usr/local/addons/zigbee2mqtt/zigbee2mqtt/node_modules/zigbee2mqtt/data/coordinator_backup.json'
[2025-10-02 17:41:15] info: z2m: zigbee-herdsman started (reset)
[2025-10-02 17:41:15] info: z2m: Coordinator firmware version: '{"meta":{"maintrel":1,"majorrel":2,"minorrel":7,"product":1,"revision":20210708,"transportrev":2},"type":"ZStack3x0"}'
[2025-10-02 17:41:15] info: z2m: Currently 0 devices are joined.
[2025-10-02 17:41:15] info: z2m: Connecting to MQTT server at mqtt://127.0.0.1:1883
[2025-10-02 17:41:16] error: z2m: MQTT failed to connect, exiting... (connect ECONNREFUSED 127.0.0.1:1883)
[2025-10-02 17:41:16] info: z2m: Stopping zigbee-herdsman...
[2025-10-02 17:41:26] info: zh:controller: Wrote coordinator backup to '/usr/local/addons/zigbee2mqtt/zigbee2mqtt/node_modules/zigbee2mqtt/data/coordinator_backup.json'
[2025-10-02 17:41:26] info: zh:zstack:znp: closing
[2025-10-02 17:41:26] info: zh:zstack:znp: Port closed
[2025-10-02 17:41:26] info: z2m: Stopped zigbee-herdsman

Eingerichtet wurde das Ganze wie beschrieben ein Sonoff (3.0 dongle plus) stick hängt dran.

Das Frontend öffnet sich ebenfalls nicht, obwohl konfiguriert - connection refused. Könnte aber auch Folgefehler sein. Andere Ports habe ich bereits probiert.
Hier noch meine s2m-config:
homeassistant:
enabled: false
frontend:
enabled: true
port: 8080
mqtt:
base_topic: zigbee2mqtt
server: mqtt://127.0.0.1:1883
keepalive: 30
reject_unauthorized: true
version: 4
client_id: zigbee2mqtt_addon
advanced:
log_output:
- file
log_symlink_current: true
network_key:
XYZ
pan_id: XYZ
ext_pan_id:
XYZ
log_level: info
channel: 11
onboarding: true
version: 4
serial:
port: /dev/ttyUSB0
adapter: zstack
baudrate: 115200
rtscts: false

Hardware ist ein pi3b mit raspimatic, alle Versionen aktuell.

Muss ich evtl. vorher noch etwas einrichten, damit der stick funktioniert? Habe noch nie mit zigbee gespielt, ich hoffe, jemand hat eine Idee.

Danke!