Back to all devices

OXT SWTZ21 in Home Assistant

Wall switches · Zigbee · 1 gang switch module

Zigbee2MQTT Quirk proposed, not merged yet 3 open reports

Zigbee device – see the note above on what ZHA needs for it.

We have a detailed page on this device with compatibility ratings and prices. Details and compatibility

Facts about this device

Brand
OXT
Model
SWTZ21
Device type
Wall switches
Radio
Zigbee
Power
Mains powered
Same device as
Tuya TS0001_switch_module

How the device gets into Home Assistant

  • official ZHA – with a Zigbee coordinator and the ZHA integration; for all its functions it needs a custom quirk, see above. Integration
  • add-on Zigbee2MQTT – Zigbee2MQTT runs as an add-on and passes the device on to Home Assistant over MQTT. Integration · Source

Known problems and fixes

Open problems

  • open Upgrading Home Assistant may cause duplicate switch entities for smart relays, leading to confusion in automation. since February 5, 2026 · zha-device-handlers #4722
  • open TS0001 and TS0002 devices show zero power usage in Home Assistant due to a bug. Fixing this would enable accurate power measurement reporting for these devices. since October 15, 2024 · zha-device-handlers #3427

Requests for ZHA support

  • support requested A device support request is open, but the specific device details are missing. This entry seeks to add support for an unspecified Zigbee device. since May 25, 2026 · zha-device-handlers #5030

ZHA quirks for this device

Quirk proposed, not merged yet Recommended quirk

Proposed to ZHA and waiting for review – the maintainers check it before it becomes part of Home Assistant.

Adds: External switch type

Source: zha-device-handlers · pull request #5188 · by @kugaevsky · July 21, 2026
Signature: _TZ3000_tqlv4ug4 / TS0001

1 more quirk for this device

All quirks in the ZHA quirk database →

Alternatives

The same job from other makers – devices of the same type and radio that work with Home Assistant too.

Sources: Zigbee2MQTT, ZHA quirks, Z-Wave JS, the Matter certification database, Shelly, ESPHome, Tasmota, Tuya Local and the issue trackers on GitHub. Reports are assigned to a device by the identifiers they contain; the sentences come from the integration pages, where a language model writes them from the titles.

Scroll to Top