Complete Guide to Adding Zemismart Zigbee Screen Switch ZMS-206 to Home Assistant via ZHA (with Converter Tool)

–Add device

  1. After the Zigbee device _TZE204_wwaeqnrfTS0601 is connected to HA, it does not support four-way independent control by default. It is necessary to customize ZHAQuirk to achieve independent access to each switch.
  2. Enable ZHA (ZigbeeHomeAutomation) integration in HomeAssistant and confirm that the device has joined HA through the Zigbee gateway.

–Install necessary add-ons

  1. Install the necessary add-ons Advanced SSH & Web Terminal and File editor in the add-on store. Open the add-on store and search for Advanced SSH & Web Terminal and File editor.
  2. After installing Advanced SSH & Web Terminal, turn off the protection mode and set the ssh password in the configuration. After configuration, click Start

The preparation of Advanced SSH & Web Terminal is now complete.
5. Install File editor, then click Display in the sidebar, and then click Start.

—Install configuration file

  1. Open the File editor, create a new folder named: zha_quirks, and then upload the provided “switch_customization.py” file to the zha_quirks directory. After uploading, add a new configuration in the “configuration.yaml” file
    zha:
    enable_quirks: true
    custom_quirks_path: /config/zha_quirks

  2. After configuration, restart homeassistant to load Quirk
    After completing file placement and path configuration, restart HomeAssistant, re-add the device or restart the added device
    ZHA will recognize it as 4 independent light entities, such as:

<light.tze204_wwaeqnrf_ts0601_deng_guang
light.tze204_wwaeqnrf_ts0601_deng_guang_2
light.tze204_wwaeqnrf_ts0601_deng_guang_3
light.tze204_wwaeqnrf_ts0601_deng_guang_4>

At this time, four switches can be controlled

But the modified name of each switch cannot be synchronized to the device.

–Install custom components to synchronize entity names to devices

  1. Install the “zha_namehook” custom component
    8.1 Open the “custom_components” folder through the File editor and upload the provided ‘zha_namehook’ file.
    8.2 Configure configuration.yaml and add a new line “zha_namehook:” to the file. The purpose of configuring this line is to set
    up the automatic start of the name modification monitoring plug-in

8.3 After restarting homeassistant, new components appear in the integration

  1. Modify the zha source code to allow the sending of string type data. To modify the zha source code, you need to enter docker and must use the previously installed Advanced SSH & Web Terminal.
    -Open Advanced SSH & Web Terminal and execute ‘docker exec -it homeassistant bash’
    -Enter ‘cd /usr/local/lib/python3.13/site-packages/zhaquirks/tuya/mcu’
    -Enter ls to display the current files, and you will see a file named init.py

After the modification is completed, restart HA

  1. Modify the switch name
    -Enter HA entity settings and name the 4 light entities separately, such as:
    ight.tze204_wwaeqnrf_ts0601_deng_guang ->living room lamps
    light.tze204_wwaeqnrf_ts0601_deng_guang_2 ->room
    light.tze204_wwaeqnrf_ts0601_deng_guang_3 ->smart
    light.tze204_wwaeqnrf_ts0601_deng_guang_4 ->zemismart

-hanamehook component will automatically detect name changes and send them to the hardware device via DP

The file link is here:https://drive.google.com/drive/folders/1f2V50kujRQSj6CbSlTVunVxVK_Yb6eZa?usp=drive_link

can I use same quirks for _TZE284_xibaabmu device?

@zemismart I assume this will also work for the ZMS-208 as they look to be essentially the same switch?

Hi @zemismart, for some reason my config is not picking up the firmware update on zha.

I have the following (with ident added):

zha:
  database_path: /config/zigbee.db
  enable_quirks: true
  custom_quirks_path: /config/zha_quirks/

File location:

BTW I also have ZHA :toolbox: Toolkit installed.

Any ideas?

Update: I was able to fix when notice that /config has a symlink to /homeassistant. Therefore /config is really /homeassistant folder

Placed file under:

/homeassistant/zha_quirks

Now file is loading, confirmed by adding a logging on file as:

logging.getLogger("zhaquirks").warning("🔥 switch_customization quirk file imported")

I was able to see log on settings → system → logs → Home Assistant Core

image

Now, seems device is not loading updated firmware:

  • Tried delete and re-add on Zigbee network with no luck
  • Noticed that TS0601 by _TZE284_lnyz4a6v is not on switch_customization.py so I have also added it

Any help is appreciated

You can directly modify the quirk if only the _TZE284_xibaabmu model ID differs, but note that minor underlying protocol variations may cause the modified quirk to fail even with the ID updated.

(“_TZE204_wwaeqnrf”, “TS0601”),
(“_TZE200_l04vddle”, “TS0601”),
(“_TZE200_mexisfik”, “TS0601”),
(“_TZE284_xibaabmu”, “TS0601”),
Here are a few configurations for your reference.

Thanks for your question!
Yes, the ZMS-208 is essentially the same switch hardware-wise, so the configuration should work. However, to ensure full compatibility, could you please provide us with the specific TZE model ID of your ZMS-208 device?

Hi @zemismart,

I have the same device and i am having the same issue… TZE Model ID is as you mentioned earlier (“_TZE284_xibaabmu”, “TS0601”), I tried adding this to the file but I am not getting the switches to show up. Please see screenshots.

  • Tried delete and re-add on Zigbee network with no luck

Any help is appreciated

hi, when did you purchase the switch?
for some reason this switch cannot connect to HA for now.
but we are trying to solve the problem.

kindly try this document
https://drive.google.com/drive/folders/1cmmimZd447nL0HtqeD6G7NM17bvjUVme?usp=sharing

I have the device Zemismart Zigbee 4 gangs model "_TZE28C1000000_y4jqpry8" can it work with this? Do you have something else?
And also, is there a way to change the color/backlight from the HA?

Thanks for the report!

We’re already following up with you through our support channel(aliespress), and the case has been passed to our technical team for further investigation.

The HA/Z2M ecosystem can require device-specific handling in some cases, so we’ll spend some time checking compatibility and possible implementation options.

Thanks for your patience — we’ll share updates once we have progress.

Hi - I've just received a _TZE28C1000000_xibaabmu 4 gang switch from Zemismart online, but cannot get the namehook via ZHA to work correctly - I've been through the full process, and I believe that the issue might be the Quirk. Can you confirm if the ZMS-206 quirk in this link is correct?

hi, let me check then get back to you.

Is everything working normally except for the inability to change the name?

Yes - everything is operational except for the naming on the switch.

you can use the updated file.

@cossiecostin Did it work with the file Zemismart sent you? I ask because I run my entire network on ZHA and wouldn't want to migrate to Zigbee2MQTT just to get this device working.

And I understand that the most important feature of this device is the names; if that doesn't work, the switch becomes useless. I don't know how complex it is to have a version that is 100% compatible with ZHA.