RedMatic: Zigbee-Paket installieren

Die Installation des ZigBee-Pakets in der RedMatic weicht vom üblichen Installationsprocedere für NodeRED-Pakete über die Palette ab. Es benötigt zusätzliche Binärmodule in der CCU, daher wird es wie nachstehend beschrieben installiert.

Das gilt auch bei einem späteren Update, bei welchem Du dieselbe Installations-Prozedur einhalten musst und nicht über „Palette verwalten“ gehen kannst. Anderenfalls erhältst Du seltsame Fehlermeldungen, dass Python auf der CCU nicht gefunden wurde:

gyp ERR! find Python
gyp ERR! find Python Python is not set from command line or npm configuration

Voraussetzungen

• Für diese Anleitung benötigst du einen ZigBee-Stick, welcher vom Typ Z-Stack oder ConBee sein kann. Z-Stack-Sticks sind beispielsweise ein CC253x oder auch ein aktuellerer mit CC2652*, wie der Slaesh-Stick oder das SONOFF USB Dongle Plus.
• Außerdem muss RedMatic bereits laufen. Wie Du RedMatic in einer RaspberryMatic installierst, kannst Du in diesem Artikel sehen.

Installation

Die Installation gelingt über das CCU*-Addon „RedMatic„, welches Du über die CCU-Systemsteuerung erreichst. Dort findest Du den Node „node-red-contrib-zigbee“ im Tab „Pakete“. Die Installation ist mit einem Knopfdruck auf „install“ erledigt.

Zum Aktualisierungszeitpunkt des Artikels ist RedMatic 7.2.1 und der ZigBee-Node in der Version 0.20.1 aktuell. Es gibt im git-Repo von hobbyquaker zwar bereits die Version 0.21, welche jedoch ein neueres RedMatic bedingt.

Nach einem Neustart von NodeRed stehen Dir die ZigBee-Nodes zur Verfügung.

Konfiguration

Die Konfiguration kannst Du wie von anderen Nodes gewohnt durchführen:

• Platziere einen ZigBee-Node auf das Arbeitsblatt.
• Gehe in die Einstellungen (Doppelklick auf den Node) und dort auf das Editierfeld „Neuen zigbee-shepard hinzufügen …„, um Deinen ZigBee-Stick zu konfigurieren. Die Einrichtung ist in der Dokumentation zum ZigBee-Node enthalten.
  • In dem Beispiel nutze ich einen ZigBee-Stick von Slaesh, der nach dem Verbinden mit der CCU* unter dem Pfad /dev/ttyUSB0 zu finden ist.
  • Die Datenflusssteuerung „rtscts“ muss für meinen Stick deaktiviert sein. Welchen Wert Dein Stick benötigt, solltest Du in der Dokumentation zum ZigBee-Stick finden. Ggf. stellst du den Parameter um, falls dein Stick nicht erkannt wird.
  • Die PAN-ID zur Identifizierung des Netzwerks sollte auch vom Default ffff auf einen kleineren Hex-Wert (Ziffern 0-9, Buchstaben a-f, bspw. c04b) gesetzt werden, da manche Sticks damit Probleme haben.
  • Ebenso solltest Du die 32-stellige Hex-Zahl networkKey ändern.

Nach der Einrichtung muss RedMatic zur Übernahme der Konfiguration neu gestartet werden.

Da ZigBee und WLAN sich das selbe Funk-Band teilen, können Störungen auftreten. Du kannst durch folgende Maßnahmen die Störungen minimieren.

Tipp Kanäle: Stelle Deinen WLAN-Router/AccessPoint fest auf einen der Kanäle 1, 6 oder 11. Damit sind in den verbleibenden Lücken die ZigBee-Kanäle 15, 20, 25 und 26 frei und können nur noch durch benachbarte WLAN-Stationen gestört werden.

Tipp Bandbreite: Stelle im WLAN-Router/AccessPoint die Kanalbreite von 40MHz auf 20MHz – die höhere Bandbreite lohnt nur selten und stört benachbarte Funkkanäle, denn es werden damit viele Kanäle blockiert.

Tipp USB-Verlängerung: Falls du einen RPi* verwendest, kannst Du dessen WLAN- und Bluetooth-Module deaktivieren. Am Besten betreibst du den ZigBee-Stick auch etwas entfernt vom RPi* mit einer USB-Verlängerung.

Test der Konfiguration

Für einen Test verwende ich einen ZigBee-Taster von Aqara, dessen Ausgabe ich mir per Debug-Node anzeigen lasse. Im Beispiel dauert das Anlernen einen Augenblick, da der Taster 10 Sekunden benötigt, um in den Anlernmodus zu gelangen.

Nach dem Anlernen an den ZigBee-Stick steht der Taster für Tests zur Verfügung – ein Tastendruck gibt das Event im Debug-Node aus.

Fazit

Das Anlernen geht unkompliziert, wenn man einen Z-Stack- oder ConBee-Stick verwendet. Beachten muss man lediglich, dass das ZigBee-Package nicht über die normale NodeRed-Installationsroutine installiert und aktualisiert wird.

Für Fragen oder Hinweise nutze gern die Kommentarfunktion oder die Kontaktdaten am Ende der Webseite.

Updates

• 31.01.2022: Hinweis PAN-ID und Version hinzugefügt