[New device support]: Hue Tap Dial RDM002 9290035001

[xammmue]

Link

https://www.philips-hue.com/en-gb/p/hue-tap-switch/8719514440999

Database entry

{"id":45,"type":"EndDevice","ieeeAddr":"0x001788010d13248f","nwkAddr":8963,"manufId":4107,"manufName":"Signify Netherlands B.V.","powerSource":"Battery","modelId":"RDM002","epList":[1],"endpoints":{"1":{"profId":260,"epId":1,"devId":2096,"inClusterList":[0,1,3,64512,4096],"outClusterList":[25,0,3,4,6,8,5,4096],"clusters":{"genPowerCfg":{"attributes":{"61441":2667,"61442":2603,"61443":2714,"batteryPercentageRemaining":122}}},"binds":[{"cluster":6,"type":"endpoint","deviceIeeeAddress":"0x00212effff07ab97","endpointID":1},{"cluster":8,"type":"endpoint","deviceIeeeAddress":"0x00212effff07ab97","endpointID":1},{"cluster":64512,"type":"endpoint","deviceIeeeAddress":"0x00212effff07ab97","endpointID":1},{"cluster":1,"type":"endpoint","deviceIeeeAddress":"0x00212effff07ab97","endpointID":1}],"configuredReportings":[{"cluster":1,"attrId":33,"minRepIntval":3600,"maxRepIntval":62000,"repChange":0}],"meta":{}}},"appVersion":2,"stackVersion":1,"hwVersion":1,"dateCode":"20220316","swBuildId":"2.59.19","zclVersion":8,"interviewCompleted":true,"meta":{"configured":-289016272},"lastSeen":1656081001000,"defaultSendRequestWhen":"immediate"}

Comments

I already tried creating my own converter to be able to make the device usable. This made the interview process successful and the button presses seems to work as well.
I copied most of this from the hue dimmer switch which is probably also the reason why the buttons are labeled on, off, up and down.

I wasn't able to make the dial work properly, which is why I am writing here. I would probably need to use the correct converter but I don't feel comfortable just picking one and copy pasting it there.
Here are some logs of what happens when rotating:

Turning left "one click"

2022-06-24 16:49:45	Received Zigbee message from 'Hue Tap Dial 1', type 'commandStepWithOnOff', cluster 'genLevelCtrl', data '{"stepmode":1,"stepsize":8,"transtime":4}' from endpoint 1 with groupID null
2022-06-24 16:49:45	No converter available for '9290035001' with cluster 'genLevelCtrl' and type 'commandStepWithOnOff' and data '{"stepmode":1,"stepsize":8,"transtime":4}'
2022-06-24 16:49:45	Received Zigbee message from 'Hue Tap Dial 1', type 'commandHueNotification', cluster 'manuSpecificPhilips', data '{"button":20,"time":241,"type":1,"unknown1":3145984,"unknown2":255}' from endpoint 1 with groupID null

Turning left continuously:

2022-06-24 16:52:46	Received Zigbee message from 'Hue Tap Dial 1', type 'commandStepWithOnOff', cluster 'genLevelCtrl', data '{"stepmode":1,"stepsize":32,"transtime":4}' from endpoint 1 with groupID null
2022-06-24 16:52:46	No converter available for '9290035001' with cluster 'genLevelCtrl' and type 'commandStepWithOnOff' and data '{"stepmode":1,"stepsize":32,"transtime":4}'
2022-06-24 16:52:46	Received Zigbee message from 'Hue Tap Dial 1', type 'commandHueNotification', cluster 'manuSpecificPhilips', data '{"button":20,"time":181,"type":1,"unknown1":3145984,"unknown2":255}' from endpoint 1 with groupID null
2022-06-24 16:52:47	Received Zigbee message from 'Hue Tap Dial 1', type 'commandHueNotification', cluster 'manuSpecificPhilips', data '{"button":20,"time":134,"type":2,"unknown1":3145984,"unknown2":254}' from endpoint 1 with groupID null
2022-06-24 16:52:47	Received Zigbee message from 'Hue Tap Dial 1', type 'commandStepWithOnOff', cluster 'genLevelCtrl', data '{"stepmode":1,"stepsize":202,"transtime":5}' from endpoint 1 with groupID null
2022-06-24 16:52:47	No converter available for '9290035001' with cluster 'genLevelCtrl' and type 'commandStepWithOnOff' and data '{"stepmode":1,"stepsize":202,"transtime":5}'
2022-06-24 16:52:47	Received Zigbee message from 'Hue Tap Dial 1', type 'commandHueNotification', cluster 'manuSpecificPhilips', data '{"button":20,"time":179,"type":2,"unknown1":3145984,"unknown2":254}' from endpoint 1 with groupID null
2022-06-24 16:52:47	Received Zigbee message from 'Hue Tap Dial 1', type 'commandStepWithOnOff', cluster 'genLevelCtrl', data '{"stepmode":1,"stepsize":87,"transtime":5}' from endpoint 1 with groupID null
2022-06-24 16:52:47	No converter available for '9290035001' with cluster 'genLevelCtrl' and type 'commandStepWithOnOff' and data '{"stepmode":1,"stepsize":87,"transtime":5}'

Right "one click"

2022-06-24 16:53:05	Received Zigbee message from 'Hue Tap Dial 1', type 'commandStepWithOnOff', cluster 'genLevelCtrl', data '{"stepmode":1,"stepsize":8,"transtime":4}' from endpoint 1 with groupID null
2022-06-24 16:53:05	No converter available for '9290035001' with cluster 'genLevelCtrl' and type 'commandStepWithOnOff' and data '{"stepmode":1,"stepsize":8,"transtime":4}'
2022-06-24 16:53:05	Received Zigbee message from 'Hue Tap Dial 1', type 'commandHueNotification', cluster 'manuSpecificPhilips', data '{"button":20,"time":241,"type":1,"unknown1":3145984,"unknown2":255}' from endpoint 1 with groupID null

Right continuously:

2022-06-24 16:53:24	Received Zigbee message from 'Hue Tap Dial 1', type 'commandStepWithOnOff', cluster 'genLevelCtrl', data '{"stepmode":0,"stepsize":20,"transtime":4}' from endpoint 1 with groupID null
2022-06-24 16:53:24	No converter available for '9290035001' with cluster 'genLevelCtrl' and type 'commandStepWithOnOff' and data '{"stepmode":0,"stepsize":20,"transtime":4}'
2022-06-24 16:53:24	Received Zigbee message from 'Hue Tap Dial 1', type 'commandHueNotification', cluster 'manuSpecificPhilips', data '{"button":20,"time":45,"type":1,"unknown1":3145984,"unknown2":0}' from endpoint 1 with groupID null
2022-06-24 16:53:24	Received Zigbee message from 'Hue Tap Dial 1', type 'commandHueNotification', cluster 'manuSpecificPhilips', data '{"button":20,"time":181,"type":2,"unknown1":3145984,"unknown2":0}' from endpoint 1 with groupID null
2022-06-24 16:53:24	Received Zigbee message from 'Hue Tap Dial 1', type 'commandStepWithOnOff', cluster 'genLevelCtrl', data '{"stepmode":0,"stepsize":99,"transtime":5}' from endpoint 1 with groupID null
2022-06-24 16:53:24	No converter available for '9290035001' with cluster 'genLevelCtrl' and type 'commandStepWithOnOff' and data '{"stepmode":0,"stepsize":99,"transtime":5}'
2022-06-24 16:53:25	Received Zigbee message from 'Hue Tap Dial 1', type 'commandHueNotification', cluster 'manuSpecificPhilips', data '{"button":20,"time":227,"type":2,"unknown1":3145984,"unknown2":0}' from endpoint 1 with groupID null
2022-06-24 16:53:25	Received Zigbee message from 'Hue Tap Dial 1', type 'commandStepWithOnOff', cluster 'genLevelCtrl', data '{"stepmode":0,"stepsize":111,"transtime":5}' from endpoint 1 with groupID null
2022-06-24 16:53:25	No converter available for '9290035001' with cluster 'genLevelCtrl' and type 'commandStepWithOnOff' and data '{"stepmode":0,"stepsize":111,"transtime":5}'
2022-06-24 16:53:25	Received Zigbee message from 'Hue Tap Dial 1', type 'commandHueNotification', cluster 'manuSpecificPhilips', data '{"button":20,"time":227,"type":2,"unknown1":3145984,"unknown2":0}' from endpoint 1 with groupID null
2022-06-24 16:53:25	Received Zigbee message from 'Hue Tap Dial 1', type 'commandStepWithOnOff', cluster 'genLevelCtrl', data '{"stepmode":0,"stepsize":93,"transtime":5}' from endpoint 1 with groupID null
2022-06-24 16:53:25	No converter available for '9290035001' with cluster 'genLevelCtrl' and type 'commandStepWithOnOff' and data '{"stepmode":0,"stepsize":93,"transtime":5}'
2022-06-24 16:53:25	Received Zigbee message from 'Hue Tap Dial 1', type 'commandHueNotification', cluster 'manuSpecificPhilips', data '{"button":20,"time":106,"type":2,"unknown1":3145984,"unknown2":0}' from endpoint 1 with groupID null

External converter

const fz = require('zigbee-herdsman-converters/converters/fromZigbee');
const tz = require('zigbee-herdsman-converters/converters/toZigbee');
const exposes = require('zigbee-herdsman-converters/lib/exposes');
const reporting = require('zigbee-herdsman-converters/lib/reporting');
const extend = require('zigbee-herdsman-converters/lib/extend');
const e = exposes.presets;
const ea = exposes.access;

const definition = {
    zigbeeModel: ['RDM002', '9290035001'], // The model ID from: Device with modelID 'lumi.sens' is not supported.
    model: '9290035001', // Vendor model number, look on the device for a model number
    vendor: 'Signify Netherlands B.V.', // Vendor of the device (only used for documentation and startup logging)
    description: 'Hue tap dial', // Description of the device, copy from vendor site. (only used for documentation and startup logging)
    fromZigbee: [fz.ignore_command_on, fz.ignore_command_off, fz.ignore_command_step, fz.ignore_command_stop,
            fz.hue_dimmer_switch, fz.battery, fz.command_recall], // We will add this later
    toZigbee: [], // Should be empty, unless device can be controlled (e.g. lights, switches).
    exposes: [e.battery(), e.action(['on_press', 'on_hold', 'on_press_release', 'on_hold_release',
            'off_press', 'off_hold', 'off_press_release', 'off_hold_release', 'up_press', 'up_hold', 'up_press_release', 'up_hold_release',
            'down_press', 'down_hold', 'down_press_release', 'down_hold_release', 'recall_0', 'recall_1'])], // Defines what this device exposes, used for e.g. Home Assistant discovery and in the fro>
    configure: async (device, coordinatorEndpoint, logger) => {
        const endpoint = device.getEndpoint(1);
        await reporting.bind(endpoint, coordinatorEndpoint, ['genOnOff', 'genLevelCtrl', 'manuSpecificPhilips', 'genPowerCfg']);
        const options = {manufacturerCode: 0x100B, disableDefaultResponse: true};
        await endpoint.write('genBasic', {0x0031: {value: 0x000B, type: 0x19}}, options);
        await reporting.batteryPercentageRemaining(endpoint);
    }
};

module.exports = definition;

Supported color modes

No response

Color temperature range

No response

[vandalon]

Hey @xammmue, Did you make any progress on this one?

[xammmue]

Hi @vandalon ,
I didn't have much time to look further into the issue yet. I'd like to do so in case nobody has an idea and I have a bit more time to play around

What's missing right now is probably to properly map the turning action in some way to a processable state. But I couldn't find any other device having a rotary input like this one.
I thought about whether it should be a message/action containing how far the ring has been turned or multiple action for slow and fast turning but didn't come to a conclusion.
Second thing would probably be to have action 1 2 3 4 instead off up down etc but that would be more of a quality of life enhancement as the buttons working right now

I also hoped for some.idwas from @Koenkk but he didn't reply so far unfortunately.

[Koenkk]

@xammmue for the rotating part a new converter has to be created, you can use https://github.com/Koenkk/zigbee-herdsman-converters/blob/557a01445d7aa276592c844e2c84a27319d0d8da/converters/fromZigbee.js#L7051 as a starting point.

[mbirkes]

I'm new to this stuff here, but after digging and playing around, I have the attached external converter file working for my device. It uses a modified version of the hue_dimmer_switch converter to support the buttons 1-4 press/hold/release and the dial (button 20) step/spin up/down actions.

NOTE: my device actually has Model: 9290035003 printed on the unit (instead of 9290035001 in this issue title)

I also found it supports the genScenes binding to a group (like the hue dimmer) and existing command_recall, but I didn't really understand the point of exposing them since they coincide with the button presses. (the scenes are strange too, where instead of expected scenes/recall_0, 1, 2, or 3 you get recall_1, 0, 5, and 4)

const fz = require('zigbee-herdsman-converters/converters/fromZigbee');
const tz = require('zigbee-herdsman-converters/converters/toZigbee');
const exposes = require('zigbee-herdsman-converters/lib/exposes');
const reporting = require('zigbee-herdsman-converters/lib/reporting');
const extend = require('zigbee-herdsman-converters/lib/extend');
const ota = require('zigbee-herdsman-converters/lib/ota');
const globalStore = require('zigbee-herdsman-converters/lib/store');
const e = exposes.presets;
const ea = exposes.access;

const {
    precisionRound, mapNumberRange, isLegacyEnabled, toLocalISOString, numberWithinRange, hasAlreadyProcessedMessage,
    calibrateAndPrecisionRoundOptions, addActionGroup, postfixWithEndpointName, getKey,
    batteryVoltageToPercentage, getMetaValue,
} = require('zigbee-herdsman-converters/lib/utils');

const my_fz = {
    hue_tap_dial: {
        cluster: 'manuSpecificPhilips',
        type: 'commandHueNotification',
        options: [exposes.options.simulated_brightness()],
        convert: (model, msg, publish, options, meta) => {
            const buttonLookup = {1: 'button_1', 2: 'button_2', 3: 'button_3', 4: 'button_4', 20: 'dial'};
            const button = buttonLookup[msg.data['button']];
            const typeLookup = {0: 'press', 1: 'hold', 2: 'press_release', 3: 'hold_release'};
            const type = typeLookup[msg.data['type']];
            const dialTypeLookup = {1: 'step', 2: 'spin'};
            const dialType = dialTypeLookup[msg.data['type']];
            const directionLookup = {0: 'up', 255: 'down'};
            const direction = directionLookup[msg.data['unknown2']];
            const payload = {};

            if (button === 'dial'){
                payload.action = `${button}_${dialType}_${direction}`;
                // simulated brightness
                if (options.simulated_brightness) {
                    const opts = options.simulated_brightness;
                    const deltaOpts = typeof opts === 'object' && opts.hasOwnProperty('delta') ? opts.delta : 35;
                    const delta = direction === 'up' ? deltaOpts : deltaOpts * -1;
                    const brightness = globalStore.getValue(msg.endpoint, 'brightness', 255) + delta;
                    payload.brightness = numberWithinRange(brightness, 0, 255);
                    globalStore.putValue(msg.endpoint, 'brightness', payload.brightness);
                }
            }
            else
            {
                payload.action = `${button}_${type}`;
                // duration
                if (type === 'press') globalStore.putValue(msg.endpoint, 'press_start', Date.now());
                else if (type === 'hold' || type === 'hold_release') {
                    payload.action_duration = (Date.now() - globalStore.getValue(msg.endpoint, 'press_start')) / 1000;
                }
            }
            return payload;
        },
    },
};


const definition = {
    zigbeeModel: ['RDM002'], 
    model: '9290035003', 
    vendor: 'Philips', 
    description: 'Hue Tap Dial', 
    fromZigbee: [fz.ignore_command_step, my_fz.hue_tap_dial, fz.battery], 
    toZigbee: [], 
    exposes: [e.battery(), e.action(['button_1_press', 'button_1_press_release', 'button_1_hold', 'button_1_hold_release',
                                     'button_2_press', 'button_2_press_release', 'button_2_hold', 'button_2_hold_release',
                                     'button_3_press', 'button_3_press_release', 'button_3_hold', 'button_3_hold_release',
                                     'button_4_press', 'button_4_press_release', 'button_4_hold', 'button_4_hold_release',
                                     'dial_step_up', 'dial_spin_up', 'dial_step_down', 'dial_spin_down'])
    ], // Defines what this device exposes, used for e.g. Home Assistant discovery and in the frontend
    configure: async (device, coordinatorEndpoint, logger) => {
        const endpoint = device.getEndpoint(1);
        await reporting.bind(endpoint, coordinatorEndpoint, ['genOnOff', 'genLevelCtrl', 'manuSpecificPhilips', 'genPowerCfg']);
        const options = {manufacturerCode: 0x100B, disableDefaultResponse: true};
        await endpoint.write('genBasic', {0x0031: {value: 0x000B, type: 0x19}}, options);
        await reporting.batteryPercentageRemaining(endpoint);
    },
    ota: ota.zigbeeOTA,
};

module.exports = definition;

[big-ted]

@mbirkes that is working pretty well for me. I did notice that my UK white version of the dial is also 9290035001

[xammmue]

Also got something setup yesterday evening, but without the simulated brightness option as I am not really familiar with that

const fz = require('zigbee-herdsman-converters/converters/fromZigbee');
const tz = require('zigbee-herdsman-converters/converters/toZigbee');
const exposes = require('zigbee-herdsman-converters/lib/exposes');
const reporting = require('zigbee-herdsman-converters/lib/reporting');
const extend = require('zigbee-herdsman-converters/lib/extend');
const e = exposes.presets;
const ea = exposes.access;

const fzLocal = {
    hue_tap_dial: {
        cluster: 'manuSpecificPhilips',
        type: 'commandHueNotification',
        convert: (model, msg, publish, options, meta) => {
            const buttonLookup = {1: 'one', 2: 'two', 3: 'three', 4: 'four', 20: 'dial'};
            const button = buttonLookup[msg.data['button']];
            const typeLookup = {0: 'press', 1: 'hold', 2: 'press_release', 3: 'hold_release'};
            const type = typeLookup[msg.data['type']];
            const rotationDirection = {0: 'right', 255: 'left'}

            //rotation
            if ('dial' === button) {
                const direction = rotationDirection[msg.data['unknown2']]
                const time = msg.data['time'];
                let speed = 'slow'
                if(('left' === direction && 241 !== time) || ('right' === direction && 15 !== time)) {//rotate fast
                    speed = 'fast'
                }
                return {action: `rotate_${direction}_${speed}`}
            }

            return {action: `${button}_${type}`}

        },
    }
}

const definition = {
    zigbeeModel: ['RDM002', '9290035001'],
    model: '9290035001',
    vendor: 'Signify Netherlands B.V.',
    description: 'Hue tap dial',
    fromZigbee: [fz.ignore_command_step, fzLocal.hue_tap_dial, fz.battery],
    toZigbee: [],
    exposes: [e.battery(), e.action(['one_press', 'one_hold', 'one_press_release', 'one_hold_release',
            'four_press', 'four_hold', 'four_press_release', 'four_hold_release', 'two_press', 'two_hold', 'two_press_release', 'two_hold_release',
            'three_press', 'three_hold', 'three_press_release', 'three_hold_release', 'recall_0', 'recall_1'])],
    configure: async (device, coordinatorEndpoint, logger) => {
        const endpoint = device.getEndpoint(1);
        await reporting.bind(endpoint, coordinatorEndpoint, ['genOnOff', 'genLevelCtrl', 'manuSpecificPhilips', 'genPowerCfg']);
        const options = {manufacturerCode: 0x100B, disableDefaultResponse: true};
        await endpoint.write('genBasic', {0x0031: {value: 0x000B, type: 0x19}}, options);
        await reporting.batteryPercentageRemaining(endpoint);
    }
};

module.exports = definition;

[mbirkes]

Nice @xammmue . The speed is something I wish I had after I started actually using the device and HA triggers. Thanks! Beware of the recalls though, they are misleading. See my post.
The simulated brightness metadata in my post is present in the outgoing messages to describe the brightness steps, but I'm not sure how you use that in HA unless maybe by utilizing template triggers or something. I'm fairly new to the zigbee2mqtt integration and plumbing here.
I also could not understand how/why the genBasic data is set and/or consumed.

[Xander-V]

Good to read people are already testing with this nice HUE switch!
Mine seems to get correctly detected with your code snippet, but not functional yet.

[Koenkk]

@mbirkes is the converter you posted complete? Then I can add this for support out-of-the-box.

[xammmue]

@Koenkk I guess it would make sense to combine his and mine to have stimulated brightness and speed

[mbirkes]

I actually created another one if you guys want to check it out too. It handles additional speed variables. There is still one bug (included all of the previous ones), where if you spin VERY fast, the unknown2 variable jumps a couple of values and causes direction variable to be undefined. I haven't had time to fix this yet, but is fixable.

const tz = require('zigbee-herdsman-converters/converters/toZigbee');
const exposes = require('zigbee-herdsman-converters/lib/exposes');
const reporting = require('zigbee-herdsman-converters/lib/reporting');
const extend = require('zigbee-herdsman-converters/lib/extend');
const ota = require('zigbee-herdsman-converters/lib/ota');
const globalStore = require('zigbee-herdsman-converters/lib/store');
const e = exposes.presets;
const ea = exposes.access;

const {
    precisionRound, mapNumberRange, isLegacyEnabled, toLocalISOString, numberWithinRange, hasAlreadyProcessedMessage,
    calibrateAndPrecisionRoundOptions, addActionGroup, postfixWithEndpointName, getKey,
    batteryVoltageToPercentage, getMetaValue,
} = require('zigbee-herdsman-converters/lib/utils');

const my_fz = {
    hue_tap_dial: {
        cluster: 'manuSpecificPhilips',
        type: 'commandHueNotification',
        options: [exposes.options.simulated_brightness()],
        convert: (model, msg, publish, options, meta) => {
            const buttonLookup = {1: 'button_1', 2: 'button_2', 3: 'button_3', 4: 'button_4', 20: 'dial'};
            const button = buttonLookup[msg.data['button']];
            const typeLookup = {0: 'press', 1: 'hold', 2: 'press_release', 3: 'hold_release'};
            const type = typeLookup[msg.data['type']];
            const directionLookup = {0: 'right', 255: 'left'};
            const direction = directionLookup[msg.data['unknown2']];
            const time = msg.data['time'];
            const payload = {};

            if (button === 'dial'){
                const adjustedTime = direction === 'right' ? time : 256 - time;
                const dialType = 'rotate';                
                const speed = adjustedTime <= 15 ? 'step' : 
                        adjustedTime <= 60 ? 'slow' : 
                        adjustedTime <= 106 ? 'medium' : 'fast';
                payload.action = `${button}_${dialType}_${direction}_${speed}`;

                // simulated brightness
                if (options.simulated_brightness) {
                    const opts = options.simulated_brightness;
                    const deltaOpts = typeof opts === 'object' && opts.hasOwnProperty('delta') ? opts.delta : 35;
                    const delta = direction === 'right' ? deltaOpts : deltaOpts * -1;
                    const brightness = globalStore.getValue(msg.endpoint, 'brightness', 255) + delta;
                    payload.brightness = numberWithinRange(brightness, 0, 255);
                    globalStore.putValue(msg.endpoint, 'brightness', payload.brightness);
                }
            }
            else{
                payload.action = `${button}_${type}`;
                // duration
                if (type === 'press') globalStore.putValue(msg.endpoint, 'press_start', Date.now());
                else if (type === 'hold' || type === 'hold_release') {
                    payload.action_duration = (Date.now() - globalStore.getValue(msg.endpoint, 'press_start')) / 1000;
                }
            }
            return payload;
        },
    },
};


const definition = {
    zigbeeModel: ['RDM002'], 
    model: '9290035003', 
    vendor: 'Philips', 
    description: 'Hue Tap Dial', 
    fromZigbee: [fz.ignore_command_step, my_fz.hue_tap_dial, fz.battery], 
    toZigbee: [], 
    exposes: [e.battery(), e.action(['button_1_press', 'button_1_press_release', 'button_1_hold', 'button_1_hold_release',
                                     'button_2_press', 'button_2_press_release', 'button_2_hold', 'button_2_hold_release',
                                     'button_3_press', 'button_3_press_release', 'button_3_hold', 'button_3_hold_release',
                                     'button_4_press', 'button_4_press_release', 'button_4_hold', 'button_4_hold_release',
                                     'dial_rotate_right_step', 'dial_rotate_right_slow','dial_rotate_right_medium','dial_rotate_right_fast',
                                     'dial_rotate_left_step','dial_rotate_left_slow','dial_rotate_left_medium','dial_rotate_left_fast'])
    ], // Defines what this device exposes, used for e.g. Home Assistant discovery and in the frontend
    configure: async (device, coordinatorEndpoint, logger) => {
        const endpoint = device.getEndpoint(1);
        await reporting.bind(endpoint, coordinatorEndpoint, ['genOnOff', 'genLevelCtrl', 'manuSpecificPhilips', 'genPowerCfg']);
        const options = {manufacturerCode: 0x100B, disableDefaultResponse: true};
        await endpoint.write('genBasic', {0x0031: {value: 0x000B, type: 0x19}}, options);
        await reporting.batteryPercentageRemaining(endpoint);
    },
    ota: ota.zigbeeOTA,
};

module.exports = definition;

[mbirkes]

You could probably replace the direction line with the following. This is untested, only from memory. I remember the 'unknown2' value of 0 can become 1, 2, 3 ... etc if spun/flicked very fast (same with other direction 255, 254, 253...). Additionally, the 'time' data also changed (decreased) as the unknown2 value increased, which may give the speed value an unexpected speed with current converter code.

const direction = msg.data['unknown2'] < 10 ? 'right' : 'left'

[Xander-V]

@mbirkes is the converter you posted complete? Then I can add this for support out-of-the-box.

I combined the code and the remarks from @mbirkes into the following -for me- working converter.

Changed the left/right direction to 'right' for all values of unknown2 <127.

After playing around with the speed of the dial, I decided to removed the rotate_medium since it is almost impossible to repeatedly turn the dial at a certain speed that is consistently differentiated as "medium" or "fast". Most of the time it turned out to be a gamble so IMHO step/slow/medium covers it all.

Did not test with the simulated brightness part. I'll be happy to do some further testing.

Mine BTW is a black version with type number 9290035002. Maybe someone else can change this to also include a fingerprint and determine which one it actually is, but that's above my knowledge.

const fz = require('zigbee-herdsman-converters/converters/fromZigbee');
const tz = require('zigbee-herdsman-converters/converters/toZigbee');
const exposes = require('zigbee-herdsman-converters/lib/exposes');
const reporting = require('zigbee-herdsman-converters/lib/reporting');
const extend = require('zigbee-herdsman-converters/lib/extend');
const ota = require('zigbee-herdsman-converters/lib/ota');
const globalStore = require('zigbee-herdsman-converters/lib/store');
const e = exposes.presets;
const ea = exposes.access;

const {
    precisionRound, mapNumberRange, isLegacyEnabled, toLocalISOString, numberWithinRange, hasAlreadyProcessedMessage,
    calibrateAndPrecisionRoundOptions, addActionGroup, postfixWithEndpointName, getKey,
    batteryVoltageToPercentage, getMetaValue,
} = require('zigbee-herdsman-converters/lib/utils');

const my_fz = {
    hue_tap_dial: {
        cluster: 'manuSpecificPhilips',
        type: 'commandHueNotification',
        options: [exposes.options.simulated_brightness()],
        convert: (model, msg, publish, options, meta) => {
            const buttonLookup = {1: 'button_1', 2: 'button_2', 3: 'button_3', 4: 'button_4', 20: 'dial'};
            const button = buttonLookup[msg.data['button']];
            const typeLookup = {0: 'press', 1: 'hold', 2: 'press_release', 3: 'hold_release'};
            const type = typeLookup[msg.data['type']];
            const direction = msg.data['unknown2'] <127 ? 'right' : 'left';
            const time = msg.data['time'];
            const payload = {};

            if (button === 'dial'){
                const adjustedTime = direction === 'right' ? time : 256 - time;
                const dialType = 'rotate';                
                const speed = adjustedTime <= 25 ? 'step' : 
						adjustedTime <= 75 ? 'slow' : 'fast';
                payload.action = `${button}_${dialType}_${direction}_${speed}`;

                // simulated brightness
                if (options.simulated_brightness) {
                    const opts = options.simulated_brightness;
                    const deltaOpts = typeof opts === 'object' && opts.hasOwnProperty('delta') ? opts.delta : 35;
                    const delta = direction === 'right' ? deltaOpts : deltaOpts * -1;
                    const brightness = globalStore.getValue(msg.endpoint, 'brightness', 255) + delta;
                    payload.brightness = numberWithinRange(brightness, 0, 255);
                    globalStore.putValue(msg.endpoint, 'brightness', payload.brightness);
                }
            }
            else{
                payload.action = `${button}_${type}`;
                // duration
                if (type === 'press') globalStore.putValue(msg.endpoint, 'press_start', Date.now());
                else if (type === 'hold' || type === 'hold_release') {
                    payload.action_duration = (Date.now() - globalStore.getValue(msg.endpoint, 'press_start')) / 1000;
                }
            }
            return payload;
        },
    },
};


const definition = {
    zigbeeModel: ['RDM002'], 
    model: '8719514440937', 
    vendor: 'Philips', 
    description: 'Hue Tap dial switch', 
    fromZigbee: [fz.ignore_command_step, my_fz.hue_tap_dial, fz.battery], 
    toZigbee: [], 
    exposes: [e.battery(), e.action(['button_1_press', 'button_1_press_release', 'button_1_hold', 'button_1_hold_release',
                                     'button_2_press', 'button_2_press_release', 'button_2_hold', 'button_2_hold_release',
                                     'button_3_press', 'button_3_press_release', 'button_3_hold', 'button_3_hold_release',
                                     'button_4_press', 'button_4_press_release', 'button_4_hold', 'button_4_hold_release',
                                     'dial_rotate_left_step', 'dial_rotate_left_slow', 'dial_rotate_left_fast',
                                     'dial_rotate_right_step', 'dial_rotate_right_slow', 'dial_rotate_right_fast'])
    ], // Defines what this device exposes, used for e.g. Home Assistant discovery and in the frontend
    configure: async (device, coordinatorEndpoint, logger) => {
        const endpoint = device.getEndpoint(1);
        await reporting.bind(endpoint, coordinatorEndpoint, ['genOnOff', 'genLevelCtrl', 'manuSpecificPhilips', 'genPowerCfg']);
        const options = {manufacturerCode: 0x100B, disableDefaultResponse: true};
        await endpoint.write('genBasic', {0x0031: {value: 0x000B, type: 0x19}}, options);
        await reporting.batteryPercentageRemaining(endpoint);
    },
    ota: ota.zigbeeOTA,
};

module.exports = definition;