Click the badge to import this Blueprint: (needs Home Assistant Core 2021.3 or higher)
Or import this Blueprint by using the Gist URL.
Main features
Use one of the 4 buttons on the dial switch, or the rotating dial to run self-defined actions.
The blueprint supports all the events that Zigbee2MQTT detects.
For instance:
Single press, press release, hold and hold release for all 4 buttons.
Dial rotations for both directions, either a small step, a slow turn or a fast turn.
Since the actions are fully self configurable, you could control any amount of entities you like in any way you like.
Prerequisites
You need to use Zigbee2MQTT for this blueprint.
Example automation YAML for controlling a light and its brightness:
Hi i downloaded you blueprint. And it works so far. i was wondering if you know how to adress the dial to a lightblub witch has on/off dimming and Temperature?
In my example code you see an action which changes the brightness percent of a light by turning the dial. I guess you could do the same for temperature. Of of the button could switch between ‘toggle brightness mode’ and ‘toggle temperature mode’ This mode could be stored in an input_select for instance.
Hello, I downloaded your great blueprint and played a bit around. Sadly i could not achieve the result I was looking for. I would so happy if someone could help me. I am new to the home assistant world and therefore i don´t know so much about yaml code…
Aim:
Toggle 4 different light groups with the 4 buttons (works)
dimming all 4 lightgroops with the dail if light are turned on (doesn´t wotk)
I managed to implement the dimming function through this code:
Sadly i can´t controll the dimming steps and therefore dimmingtransistion isn´t smooth. Also i would like to use a different yamlcode, which only dimms the last lightgroup that was turned on, when the dial is turned (but this ist not so important).
Hi. Many thanks for your blueprint! Is it possible to set a minimum brightness? I’m dimming my kitchen lights with a Sunricher Phasecut-Dimmer and have set a minimum brightness through the dimmer (which works with the push switches) but the Hue Tap Dial reduces brightness to 0.
“light.turn.on” in the automation offers a “brightness” value but has no impact on dimming down to 0. Thanks for your help!
Sure that’s possible, but you have to write the logic for that yourself.
The scope of this blueprint is purely to make it easy to have a certain button press to an action.
You could for instance define a script that runs based on turning the dial left.
The script then only dials down the brightness until a minimum is reached.
So you can perform any action you want with this blueprint, but you have to implement the logic for it yourself. It is thus a very ‘shallow’ and generic blueprint.
Thank you, that solved the problem with the dimming. I didn´t think this would work, becouse normaly this turns the lightbulb on, if the dail is turned (what i dont want). But with the If condition that the bulb has to be on so that this works ^^. I also found the solution for the dimming only one lamp.
parallel:
- if:
- condition: state
entity_id: light.light_bedroom_ceiling
state: "on"
- condition: state
entity_id: timer.timer_light_bedroom
state: active
then:
- service: light.turn_on
data:
entity_id: light.light_bedroom_ceiling
brightness_step_pct: -5
Just set a timer helper of 10s and it starts if one button is clicked. in this 10 sec you can adjust the light of one light group. Afterwards you can turn on another lightgroup + dimm it and the first lightgroups stays at the same brightness. Feel free to use it, if you want to
Many thanks freakshock. I’m not used with scripts and automations in home assistant but I found the following solution via automation directly. Works for me as I don’t need/require to specify the dim speed for slow/fast rotating and don’t won’t to turn on light with the dial.
When I trie to add it to my Zigbee network I ge these error messages:
Debug Received Zigbee message from '0x001788010d12d123a', type 'commandQueryNextImageRequest', cluster 'genOta', data '{"fieldControl":0,"fileVersion":33569555,"imageType":289,"manufacturerCode":4107}' from endpoint 1 with groupID 0
Warning Received message from unsupported device with Zigbee model 'RDM002' and manufacturer name 'Signify Netherlands B.V.'
Press the small reset button under the battery cover and Z2M automatically recognizes the tap dial when joining is allowed. Mine was always displayed as “offline” - changing the name helped to get in “online”. Pairing with 100% functionality (battery level recognized, action (press on buttons) recognized) and the orange flashing when the reset button is pressed was only possible with the latest FW 2.59.25 (mine had 2.59.19 - I did an OTA update through Z2M in the OTA-tab. Took about 20 minutes. Remove the tap dial and pair again). I had to remove/pair again several times after FW upgrade to get it working properly - a hard reset with mine (pressing reset button for about 10-12 seconds until a green/red light appears) helped in my case. As soon as Z2M recognizes action (press button shows a string as action) the blueprint works like a charm. Hope this helps
Thanks @Robi07 - I’m still getting the same messages, even after doing a hard reset as you described.
What are your other Zigbee settings - these are mine:
pan_id: 6754
channel: 20
It reports as model ‘RDM002’ - hope it’s not a new version.
And it looks like without the dial being properly paired, I cannot do an OTA firmware update either
I just realized that my Zigbee2MQTT add-on wasn’t up to date - I never got prompted to update beyond V1.18.1.
Following the instructions here got me updated to V1.28.2 and it’s all working fine now.
Thanks for posting your experience and tips @Robi07
I have managed to pair my device and upgrade the firmware to 2.59.25. But I cannot get the device to post any actions. Ant the battery level is showing just ?. I have availability disabled since I have a large number of devices. Not sure if that affects the functionality.
I have removed and repaired the device numerous times and restored it to factory settings multiple times.
Do you have any suggestions on what to do? Is your device still functioning correctly?
It looks like I have faulty devices. Here is my situation with 3 devices:
#1 cannot pair at al. I did a full reset by pressing the setup button for 10 seconds, as I did with other devices. But this device still cannot pair. When I briefly press the reset button to initiate pairing, it quickly cycles through the LED indicator’s green, red, and orange colors.
#2 paired and upgraded firmware successfully but does not display battery level, and it is not publishing actions.
I’ve only one device and it is still working flawlessly. But it took a lot time and nerves to get it run. My device started to work after the firmware upgrade and subsequent reset. Therefore unfortunately no more tips. However, the most stubborn part so far in my whole Z2M installation.
Some of these issues seem weird, indeed.
I have two of the TapDialSwitches and only one of them actually upgraded to the latest firmware version, the other one keeps checking without upgrading in Z2M
This is the same for my 2 IKEA buttons btw - I put it down to the battery level; but I’m not replacing a battery that’s at 70% or more just to get a firmware update that didn’t seem to make a difference.
First off i want to thank you for providing the blueprint for the Tap Dial.
The Button configuration work perfectly and i have no problems whatsoever.
Unfortunately i am not able to get the hang of the dial movement in combination in increasing/decreasing the volume of a media_player device.
I use the Tap dial for remotely controlling a bath music speaker and have different spotify playlists on the single and long tap buttons. The dial just invites the user to turn up the volume, but here is my main problem.
As far as i can see it, Zigbee2MQTT receives the slow-rotate movement from the Tap Dial as an event following an " "-Action (i guess it’s a sign, that the dial movement has stopped).
Currently i am trying my luck with the following YAML-Konfiguration for the rotation:
First off, i’ll get a Log-Error: “template value should be a string for dictionary value @ data[‘action’][1][‘choose’][20][‘sequence’][0][‘data’]. Got None”, which is not there, when i comment only this button-configuration action out. So i guess there is something wrong here (even though i’ve configured this part through the Automation-UI.
When i’m rotating the Dial nothing happens (which i guess is expected).
Did i do something wrong, or were anyone able to get this working (with volumes, brightnesses, et cetera)?
Any help is greatly appreciated.
Thanks in advance!
Requesting tip for implementing the scene rotation (for a Hue Zone) for each button click, just as in the Hue App. I have a idea on how to implement this with use of helpers in HA, but maybe there are some easier ways of solving it. For instance, I see that the Hue Zone is represented as light entity in HA, and it got attribute hue_scenes with all available scenes. But I can’t find what scene is currently active, so I can activate the next scene in the list when the button is pressed. Any tip on how this could be solved?
