Zigbee rotary knob?

Hardware
1

I purchased a rotary knob device to see what I might be able to do with it (light dimmer / volume control / ?) but it isn’t exposing anything controls to ZHA.

I do get log events, like:

 Rotary Switch Toggle event was fired
 
 2:39:15 PM - 19 seconds ago
 
 Rotary Switch Step event was fired with parameters: {'step_mode': <StepMode.Up: 0>, 'step_size': 49, 'transition_time': 2, 'options_mask': None, 'options_override': None}
 
 2:39:08 PM - 26 seconds ago
 
 Rotary Switch Step event was fired with parameters: {'step_mode': <StepMode.Down: 1>, 'step_size': 13, 'transition_time': 1, 'options_mask': None, 'options_override': None}
 
 2:39:06 PM - 28 seconds ago
 
 Rotary Switch Step event was fired with parameters: {'step_mode': <StepMode.Down: 1>, 'step_size': 37, 'transition_time': 2, 'options_mask': None, 'options_override': None}
 
 2:39:05 PM - 29 seconds ago

but even there I can’t see all switch pushes, any long presses or distinguish double click events.

The switch is identifying as:

TS004F by _TZ3000_402vrq2i
Quirk: zhaquirks.tuya.ts004f.TuyaSmartRemote004F

So far, I’m happy in ZHA land, but if I made the dive into Zigbee2MQTT am I likely to get any more functionality out of this device there?

I already have mosquitto setup with some custom MQTT sensors feeding in to HA through it - not sure what steps are next to try to connect devices that way?

2

Adding the line to MODELS INFO as shown here: [BUG] TS004F device incorrect quirk? · Issue #3604 · zigpy/zha-device-handlers · GitHub

did slightly change what’s in the logbook, but still no useable controls I can find.

Rotary Switch Remote Button Short Press - Button event was fired

2:55:43 PM - Now

Rotary Switch Step event was fired with parameters: {'step_mode': <StepMode.Up: 0>, 'step_size': 13, 'transition_time': 1, 'options_mask': None, 'options_override': None}

2:55:40 PM - 3 seconds ago

Rotary Switch Step event was fired with parameters: {'step_mode': <StepMode.Up: 0>, 'step_size': 25, 'transition_time': 1, 'options_mask': None, 'options_override': None}

2:55:38 PM - 5 seconds ago

Rotary Switch Step event was fired with parameters: {'step_mode': <StepMode.Up: 0>, 'step_size': 85, 'transition_time': 3, 'options_mask': None, 'options_override': None}

2:55:38 PM - 6 seconds ago

Rotary Switch Step event was fired with parameters: {'step_mode': <StepMode.Down: 1>, 'step_size': 37, 'transition_time': 2, 'options_mask': None, 'options_override': None}

2:55:36 PM - 7 seconds ago

Rotary Switch Step event was fired with parameters: {'step_mode': <StepMode.Down: 1>, 'step_size': 85, 'transition_time': 3, 'options_mask': None, 'options_override': None}

2:55:36 PM - 8 seconds ago
3

Not sure about this, probably varies between devices.
I have two Hue TapDialSwitches in my Z2M and rotation is working fine.

This is what the device shows after I turn the know one notch clockwise - which would either increase the volume of my media players or the brightness of some lights, depending on which button I pressed just before turning the knob:

image
image309×294 9.6 KB

Some values change so fast so fast, though, that I can’t capture them in a screenshot, e.g. ‘Action step size’.

And here are the corresponding log entries in the Z2M log file:

|[2025-06-12 12:57:26] info: |z2m:mqtt: MQTT publish: topic 'zigbee2mqtt/Hue_TapDialSwitch_01', payload '{action:brightness_step_up,action_direction:null,action_step_size:8,action_time:null,action_transition_time:0.04,action_type:null,battery:100,brightness:null,linkquality:81,update:{installed_version:33574183,latest_version:33574183,state:idle},update_available:false}'|
|---|---|
|[2025-06-12 12:57:26] info: |z2m:mqtt: MQTT publish: topic 'zigbee2mqtt/Hue_TapDialSwitch_01/action', payload 'brightness_step_up'|
|[2025-06-12 12:57:26] info: |z2m:mqtt: MQTT publish: topic 'zigbee2mqtt/Hue_TapDialSwitch_01', payload '{action:dial_rotate_right_step,action_direction:right,action_step_size:null,action_time:15,action_type:step,battery:100,brightness:null,linkquality:75,update:{installed_version:33574183,latest_version:33574183,state:idle},update_available:false}'|
|[2025-06-12 12:57:26] info: |z2m:mqtt: MQTT publish: topic 'zigbee2mqtt/Hue_TapDialSwitch_01/action', payload 'dial_rotate_right_step'|
1 Like
4

Have you searched the blueprints exchange section of this forum?

I’m pretty sure there’s a couple of blueprints for this device, including info on how to enable multi click mode (if memory serves me well)

1 Like
5

That’s a great point - saw this one thread with a blueprint for the device:
[Resume] TS004F - Smart Knob ZigBee2MQTT & ZHA - Configuration / Zigbee - Home Assistant Community

1 Like
6

It’s a little weird, that blueprint requires a light - but you can switch between light control and other control with a triple click, so I’ve got it doing that light and media volume. Oh, and I had to edit the manufacturer string to match mine… went ahead and translated the Italian to English while I was in there… Edit an imported blueprint