Zemismart ZMS-206 Zigbee2MQTT External Converter Setup Guide

Configuration Zigbee
, , ,
1

Overview

This post is a practical setup note for using the Zemismart ZMS-206 display switch with Home Assistant through Zigbee2MQTT.

Depending on your Zigbee2MQTT version and the device firmware, some ZMS-206 features may require an external converter. If your Zigbee2MQTT version already supports the device, you may not need this converter.

Official reference: Zigbee2MQTT external converters

Recommended method: add the converter in the Zigbee2MQTT UI

Recent Zigbee2MQTT versions can manage external converters from the web UI. Try this first before editing files manually.

  1. Open the Zigbee2MQTT web interface.
  2. Go to Settings -> Dev console -> External converters.
  3. Add/upload the ZMS-206 converter .js file.
  4. Restart Zigbee2MQTT.
  5. Open the ZMS-206 device page and check whether the expected exposes/entities appear.

Converter file used in this guide:
ZMS-206 Zigbee2MQTT external converter

Manual method: File Editor

Use this method if your Zigbee2MQTT UI does not show the external converters option.

1. Open File Editor

In current Home Assistant versions, this may be under Settings -> Apps or App Store. In older versions, it may appear as Supervisor -> Add-on Store.

  1. Search for File editor.
  2. Install and start it if you do not already have it.

image
image554Ă—367 30.9 KB

2. Create the external_converters folder

  1. Open File Editor.
  2. Go to your Zigbee2MQTT configuration folder.
    • Home Assistant add-on setups commonly use: homeassistant/zigbee2mqtt/
    • The important point is that the folder should be next to the Zigbee2MQTT configuration.yaml file.
  3. Create a folder named exactly:
external_converters

image
image554Ă—291 23.1 KB

3. Upload the converter file

Upload the ZMS-206 converter .js file into the external_converters folder.

For example:

homeassistant/zigbee2mqtt/external_converters/zms-206.js

Tip: renaming the file to a simple name such as zms-206.js makes it easier to check later.

image
image553Ă—283 20.5 KB

Converter file:
ZMS-206 Zigbee2MQTT external converter

4. Restart Zigbee2MQTT and verify

  1. Restart Zigbee2MQTT.
  2. Open the Zigbee2MQTT web interface.
  3. Open the ZMS-206 device page.
  4. Check whether the expected exposes/entities are shown.
  5. If the exposes are missing, try re-interviewing the device.

image
image553Ă—313 21.2 KB

image
image554Ă—384 28.2 KB

Troubleshooting

If the device is not recognized after restarting Zigbee2MQTT, please check:

  • The converter file is inside the correct external_converters folder.
  • The file extension is .js.
  • Zigbee2MQTT was restarted after adding the file.
  • Your Zigbee2MQTT version supports this external converter format.
  • The device was re-interviewed after adding the converter.

When asking for help, please include:

  • Home Assistant version
  • Zigbee2MQTT version
  • Coordinator model
  • Device model ID
  • Manufacturer ID
  • Firmware version, if available
  • A short Zigbee2MQTT log excerpt after restart

Notes

  • Exact exposed entities may vary by firmware and Zigbee2MQTT version.
  • If the device is already supported natively in your Zigbee2MQTT version, the converter may not be needed.
  • This guide is for Zigbee2MQTT. If you use ZHA, you may need a separate ZHA quirk instead.

Product reference

For model photos and specifications only: ZMS-206 product page

2

I don't think steps 1-3 are needed at all.
Z2M allows you to upload the external converter file directly in the settings page in the UI.

Only thing I'm unsure of is if it creates the external_converters folder by itself if it doesn't exist.

3

The term add-on has been removed several months ago now. Continuing to refer to add-ons will confuse your user base and cause more support calls. Also there no longer is an Add-on store.
I suggest an edit is needed to fix all this.

4

Thanks for catching that. You’re right: Home Assistant renamed add-ons to Apps starting with 2026.2, so the wording should be updated. I’ll replace “Supervisor → Add-on Store” with the current Apps/App Store terminology and adjust the steps accordingly to avoid confusing users.

1 Like
5

Thanks, good point. Both methods should work: users can add the external converter directly through the Zigbee2MQTT UI via Settings → Dev console → External converters, or manually place the file in the external_converters folder next to the Zigbee2MQTT configuration.yaml. I’ll update the guide to mention the UI method first, since it’s simpler, and keep the manual method as an alternative.

2 Likes
6

@zemismart thanks for this, i jsut added one into my wall today and had no out of the box support with Z2M

a few things to add i can confirm

7

Thanks for the testing and detailed notes!

Good catch regarding the .js suffix and fingerprint matching.
At the moment the device still requires manual converter setup in Z2M, but we’re actively working on improving native support and compatibility.

Really appreciate community contributions like this — especially for helping improve the HA/Z2M experience for everyone.

Looking forward to the PR

We believe low-power mmWave over Zigbee has huge potential for local-first smart homes.