Sie sind auf Seite 1von 3

bereit, das direkt die passenden Attribute vergibt, um dem zigbee2mqtt-Dienst

passende Anweisungen geben zu k�nnen und weitere Ger�te f�r die eigentlichen
Aktoren und Sensoren anzulegen:

set MQTT2_zigbee_pi attrTemplate zigbee2mqtt_bridge


Ist dieses angelegt, kann zigbee2mqtt mit set MQTT2_zigbee_pi permit_join true in
den Anlernmodus versetzt werden, anzulernende Ger�te m�ssen anschlie�end jeweils
nach Bedienungsanleitung in den Anlernmodus gebracht werden.

Vereinzeln der eigentlichen Ger�te


�ber das mit dem template vergebene bridgeRegexp-Attribut

attr MQTT2_zigbee_pi bridgeRegexp zigbee2mqtt/([A-Za-z0-9]*)[/]?.*:.* "zigbee_$1"


werden anschlie�end neue MQTT2_DEVICE-Ger�te automatisch angelegt, sobald ein
bisher unbekanntes Zigbee-Ger�t einen neuen Status (z.B. einen Me�wert) meldet. Um
zu erfragen, welche Ger�te dem zigbee-Deinst bekannt sind, kann via get
MQTT2_zigbee_pi devicelist true eine Liste abgefragt werden, die weitere
Informationen zu den bereits angelernten Ger�ten enth�lt. Ger�te, die nicht
automatisch etwas senden, kann man mit Hilfe des MQTT2_SERVER-Ger�ts einmalig
schalten, damit diese ihren Status bzw. das erfolgreiche Schalten zur�ckmelden,
Beispiel[8]:

set MQTT2_FHEM_Server publish zigbee2mqtt/0x90fd9ffffe0bcd51/set


{"state":"ON","brightness":60}
F�r Ger�tetypen, f�r die bereits templates vorhanden sind, ist es am einfachsten,
diese einmalig auf die Ger�te anzuwenden. Das Vorgehen entspricht dabei dem oben
f�r die Bridge beschriebenen. Daf�r wird immer vorausgesetzt, dass ein neues Device
mit autocreate (ggf. �ber die bridgeRegexp) angelegt wurde[9]

Beispiele:Define eines MQTT2-Devices als "Bridge"


Dann kann eine Art "Grund-Device" angelegt werden, das f�r die Ansteuerung des
eigentlichen Server-Dienstes genutzt wird, der bereits unmittelbar nach der
erfolgreichen Konfiguration von zigbee2mqtt zur Verf�gung steht. In der Regel
sollte dieses automatisch erstellt werden, wenn der zigbee2mqtt-Dienst (oder der
betreffende Rechner) neu gestartet wird (oder FHEM oder dort ein Sensor einen
Messwert sendet). Beispiel[7]:

defmod MQTT2_zigbee_pi MQTT2_DEVICE zigbee_pi


attr MQTT2_zigbee_pi IODev MQTT2_FHEM_Server
attr MQTT2_zigbee_pi readingList zigbee_pi:zigbee2mqtt/bridge/state:.* state\
zigbee_pi:zigbee2mqtt/0x90fd9ffffe65db16:.* { json2nameValue($EVENT, ) }\
zigbee_pi:zigbee2mqtt/0x90fd9ffffe0bcd51:.* { json2nameValue($EVENT, ) }\
zigbee_pi:zigbee2mqtt/bridge/log:.* { json2nameValue($EVENT, 'log_') }
attr MQTT2_zigbee_pi room MQTT2_DEVICE
F�r die Funktion einer zigbee2mqtt-Bridge steht ein templateDefine eines MQTT2-
Devices als "Bridge"
Dann kann eine Art "Grund-Device" angelegt werden, das f�r die Ansteuerung des
eigentlichen Server-Dienstes genutzt wird, der bereits unmittelbar nach der
erfolgreichen Konfiguration von zigbee2mqtt zur Verf�gung steht. In der Regel
sollte dieses automatisch erstellt werden, wenn der zigbee2mqtt-Dienst (oder der
betreffende Rechner) neu gestartet wird (oder FHEM oder dort ein Sensor einen
Messwert sendet). Beispiel[7]:

defmod MQTT2_zigbee_pi MQTT2_DEVICE zigbee_pi


attr MQTT2_zigbee_pi IODev MQTT2_FHEM_Server
attr MQTT2_zigbee_pi readingList zigbee_pi:zigbee2mqtt/bridge/state:.* state\
zigbee_pi:zigbee2mqtt/0x90fd9ffffe65db16:.* { json2nameValue($EVENT, ) }\
zigbee_pi:zigbee2mqtt/0x90fd9ffffe0bcd51:.* { json2nameValue($EVENT, ) }\
zigbee_pi:zigbee2mqtt/bridge/log:.* { json2nameValue($EVENT, 'log_') }
attr MQTT2_zigbee_pi room MQTT2_DEVICE
F�r die Funktion einer zigbee2mqtt-Bridge steht ein template

IKEA-Tradfri-Birne
Info green.png Wie w�hle ich nun das richtige Template f�r mein Leuchtmittel aus?
-> Es wird nicht zwischen einer Birne/Bulb/Lampe und einem LED-Controller
unterschieden sondern anhand der m�glichen Lichtdarstellung des Ger�tes:

light_dimmer: Das anzusteuernde Ger�te besitzt ausschlie�lich eine feste Lichtfarbe


welche gedimmt werden kann.
Farb�nderung mit r g b
xy: Farb�nderung mit x sowie y
hue: Farb�nderung mit hue und saturation
Warum diese Einteilung in "hex", "rgb", "xy" sowie "hue"? -> Zigbee2MQTT
unterst�tzt das �bermitteln aller dieser Werte, allerdings unterscheiden sich hier
die Ger�te. Manche "verstehen" nur z.B. Hex-Farb�nderungen, andere halt nur eine
Farb�nderung mit rgb-Werten. -> Aus diesem Grund muss an dieser Stelle probiert
werden mit welchem der 4 Templates sich die Farbver�nderung des Ger�tes steuern
l�sst!

HINWEIS: Templates f�r Farb�nderungen mithilfe von XY- sowie HUE-Werten wurden bis
heute nicht angelegt!

Beispiel eines dimmbaren Tradfri-Leuchtmittels

defmod IKEA_Bulb2 MQTT2_DEVICE


attr IKEA_Bulb2 IODev MQTT2_FHEM_Server
attr IKEA_Bulb2 icon light_control
attr IKEA_Bulb2 devStateIcon {zigbee2mqtt_devStateIcon255($name)}
attr IKEA_Bulb2 readingList zigbee_pi:zigbee2mqtt/0x90fd9ffffe0bcd51:.*
{ json2nameValue($EVENT) }
attr IKEA_Bulb2 setList on:noArg zigbee2mqtt/0x90fd9ffffe0bcd51/set {"state":"ON"}\
off:noArg zigbee2mqtt/0x90fd9ffffe0bcd51/set {"state":"OFF"}\
brightness:colorpicker,BRI,0,15,255 zigbee2mqtt/0x90fd9ffffe0bcd51/set
{"state":"on","$EVTPART0":"$EVTPART1"}
attr IKEA_Bulb2 webCmd toggle:on:off:brightness
attr IKEA_Bulb2 model L_02a_zigbee2mqtt_bulb
Kann man auch die Farbtemperatur einstellen, wird die setList wie folgt erweitert
oder das entsprechende template[10] anwendet:

...
color_temp:colorpicker,CT,250,1,454 zigbee2mqtt/0x90fd9ffffe0bcd51/set
{"$EVTPART0":"$EVTPART1"}
Die templates sind dabei in der Regel so gestaltet, dass eventuell mehr Optionen in
FHEMWEB erscheinen, als tats�chlich vorhanden oder erw�nscht sind. Da sich obige
einfarbige dimmbare Lampe durch Klicken auf das devStateIcon schalten l��t, ist f�r
die vollst�ndige Ansteuerung bereits dieses webCmd hinreichend:

attr IKEA_Bulb2 webCmd brightness


Temp/Hum. Sensor
tbd

light_cct: Das anzusteuernde Ger�t besitzt eine warmwei�e sowie kaltwei�e


Lichtfarbe welche ver�ndert sowie gedimmt werden kann.

light_rgb_xxx: Das anzusteuernde Ger�t besitzt die M�glichlichkeit einer farbigen


Lichtdarstellung (Rot, Gr�n, Blau) und kann gedimmt werden.

light_rgbw_xxx: Das anzusteuernde Ger�t besitzt die M�glichlichkeit einer farbigen


Lichtdarstellung (Rot, Gr�n, Blau) und besitzt eine warmwei�e ODER kaltwei�e
Lichtfarbe welche eingestellt sowie gedimmt werden kann.

light_rgbcct_xxx: Das anzusteuernde Ger�t besitzt die M�glichlichkeit einer


farbigen Lichtdarstellung (Rot, Gr�n, Blau) und besitzt eine warmwei�e UND
kaltwei�e Lichtfarbe welche ver�ndert sowie gedimmt werden kann.

xxx:
hex: Farb�nderung mit hex
rgb:
Motion Sensor
Als MQTT-Server wird hier mosquitto verwendet, als IO-Device wird daher ein
MQTT2_CLIENT-Ger�t definiert:

defmod mqtt2_client MQTT2_CLIENT 192.168.2.4:1883


attr mqtt2_client autocreate 1
attr mqtt2_client rawEvents zigbee2mqtt/GB_Bewegungsmelder:.*
attr mqtt2_client room test
attr mqtt2_client subscriptions #