After spending at least an hour or more running through the various threads regarding this 4-Gang switch, specifically the TS004F. I thought I would just put a concise rundown on how to get this working and the outcomes / limitations.
Firstly, the limitations:
This will not be configured as a 12 button switch. The only actions that are available once correctly configured are:
- Turn On button pressed
- Turn off button pressed
- Dim up button pressed
- Dim down button pressed
- Dim up continuously pressed
- Dim down continuously pressed
- Dim down released after long press
Configuration
Before proceeding, delete any instances of this device in your ZHA integration and ensure that your gateway is on the latest firmware version.
-
Create a folder on your HA instance config folder called custom_zha_quirks for instance
\\homeassistant\config\custom_zha_quirks -
Create a file in this new folder called ts004f.py and copy the latest content of the file:
-
In your config\configuration.yaml add the following lines:
zha:custom_quirks_path: /config/custom_zha_quirks/ -
Restart your HA instance
-
In the ZHA integration, add a new device, this will start the searching process
-
On the device, hold the BOTTOM LEFT button for 10+ seconds, until all four lights begin flashing
-
Wait for several seconds until ZHA discovers the device
Outcome
One point of confusion seems to be that no entities show up. This is expected. This device will add EVENTS not entities.
So you may not see any change from previous in the ZHA discovered device.
However, when you are creating automations etc, you will see the new events available:
As far as I know, at this point, this is the end result that we can expect.