OXT SWTZ21 in Home Assistant

Wandschalter · Zigbee · 1 gang switch module

Zigbee2MQTT Quirk vorgeschlagen, noch nicht übernommen 3 offene Meldungen

Zigbee-Gerät – was ZHA dafür braucht, steht im Hinweis oben.

Zu diesem Gerät gibt es bei uns eine ausführliche Seite mit Kompatibilitätsbewertung und Preisen. Details und Kompatibilität

Hersteller: OXT
Modell: SWTZ21
Gerätetyp: Wandschalter
Funk: Zigbee
Stromversorgung: Netzbetrieb
Baugleich mit: Tuya TS0001_switch_module
Auch verkauft als: AVATTO ZBTS60-01, AVATTO ZWSM16-1, AVATTO ZWSM16-DC-1, Moes ZM-104-M, Moes ZM4LT1, Nous B6Z
Zigbee2MQTT: Geräteseite auf zigbee2mqtt.io

So kommt das Gerät in Home Assistant

offiziell ZHA – mit einem Zigbee-Koordinator und der ZHA-Integration; für alle Funktionen braucht es einen Custom Quirk, siehe oben. Integration
Add-on Zigbee2MQTT – Zigbee2MQTT läuft als Add-on und reicht das Gerät per MQTT an Home Assistant weiter. Integration · Quelle

Bekannte Probleme und Lösungen

Offene Probleme

offen Nach einem Upgrade werden bei Smart-Relais mehrere Duplikate angezeigt. Die Änderung würde diese Duplikate entfernen. seit 5. Februar 2026 · zha-device-handlers #4722
offen Der Stromverbrauch von Geräten wird falsch als 0 angezeigt. Die Korrektur würde die Strommessung in Home Assistant genauer darstellen. seit 15. Oktober 2024 · zha-device-handlers #3427

Anfragen an ZHA

Unterstützung angefragt Ein Antrag auf Unterstützung für ein unbekanntes Gerät, weitere Details fehlen. seit 25. Mai 2026 · zha-device-handlers #5030

ZHA-Quirks für dieses Gerät

Quirk vorgeschlagen, noch nicht übernommen Empfohlener Quirk

Für ZHA vorgeschlagen und in Prüfung – die Maintainer sehen ihn durch, bevor er Teil von Home Assistant wird.

Ergänzt: External switch type

Quelle: zha-device-handlers · Pull Request #5188 · von @kugaevsky · 21. Juli 2026
Signatur: _TZ3000_tqlv4ug4 / TS0001

1 weiterer Quirk für dieses Gerät

Quirk vorgeschlagen, noch nicht übernommen _TZ3000_prits6g4 / TS0001 zha-device-handlers · Pull Request #5188 · von @kugaevsky · 21. Juli 2026

Der Quirk ist noch nicht Teil von ZHA. Bis dahin kannst du ihn als Custom Quirk nutzen:

ZHA mitteilen, wo Custom Quirks liegen – in der configuration.yaml:
```
zha:
  custom_quirks_path: /config/custom_zha_quirks/
```
Diesen Ordner anlegen und den Quirk als .py-Datei darin speichern.
Home Assistant neu starten. War das Gerät schon gekoppelt, es neu konfigurieren oder entfernen und erneut koppeln, damit der Quirk greift.
Prüfen, ob es geklappt hat: Auf der Geräteseite steht der Quirk unter „Zigbee-Info“.

Ein Custom Quirk wurde von den ZHA-Maintainern nicht geprüft. Lösche die Datei, sobald der Quirk in einem Home-Assistant-Release enthalten ist – sonst hat die alte Kopie Vorrang.

Alle Quirks in der ZHA-Quirk-Datenbank →

Alternativen

Dieselbe Aufgabe von anderen Herstellern – Geräte desselben Typs und Funkstandards, die ebenfalls mit Home Assistant laufen.

Tuya TS0001_switch_module Wandschalter · Zigbee · 1 gang switch module Zigbee2MQTT Custom Quirk nötig 3 offene Meldungen Testbericht
Aqara SSM-U01 Wandschalter · Zigbee · Single switch module T1 (with neutral) Zigbee2MQTT ZHA-Quirk 2 offene Meldungen Testbericht
SONOFF ZBMINIR2 Wandschalter · Zigbee · Zigbee smart switch Zigbee2MQTT ZHA-Quirk 2 offene Meldungen Testbericht
AduroSmart 81849 Wandschalter · Zigbee · ERIA Built-in Dimmer Zigbee2MQTT Testbericht

Quellen: Zigbee2MQTT, ZHA-Quirks, Z-Wave JS, die Matter-Zertifizierungsdatenbank, Shelly, ESPHome, Tasmota, Tuya Local und die Issue-Tracker auf GitHub. Meldungen werden einem Gerät über die Kennungen zugeordnet, die sie enthalten; die Sätze stammen von den Integrationsseiten, wo ein Sprachmodell sie aus den Titeln schreibt.