ECO-DIM.05 dual dimmer not supported in ZHA?

johanl · January 19, 2025, 7:06pm

Ok, so I’m kinda new to the Zigbee integrations.

Let me check with you @Noir and @PrairieSnpr if my understanding of the above posts is correct:

The ZHA Device Handlers (aka Quircks) are a part of zigpy, which is the library for the ZHA component in Home Assistant.

On GitHub, I can see that in the dev branch, there is a quirck for the Ecodim 05:

github.com

zigpy/zha-device-handlers/blob/b7f2bc7a3becaf5c1d97d7420ff6fccc1d1e2785/zhaquirks/hzc/doubledimmerswitch.py

"""Quirk for EcoDim 05 two gang dimmer (e.g. HZC Smart Double Dimmer D686-ZG)."""

from zigpy.quirks import CustomCluster
from zigpy.quirks.v2 import QuirkBuilder
from zigpy.zcl.clusters.general import OnOff

from zhaquirks import NoReplyMixin


class HzcOnOff(NoReplyMixin, CustomCluster, OnOff):
    """HZC On Off Cluster."""

    void_input_commands = {cmd.id for cmd in OnOff.commands_by_name.values()}


(
    QuirkBuilder("EcoDim BV", "EcoDim-Zigbee 3.0")
    .replace_cluster_occurrences(HzcOnOff, replace_client_instances=False)
    .add_to_registry()
)

This Quirck is not present in the main branch (which is 300+ or so commits behind) and therefore not released into Home Assistant Core? Is this the reason why it does not work out of the box in my HA instance?

So therefore, if I would like to have it to work now, I have to create my own local quirck the way @PrairieSnpr supplied some code for?
And if so, is there any documentation on where to put/create this code?
Do I need to remove the current Zigbee device and pair it again or does a restart of ZHA will do the trick?