Tuya WHD02 in Home Assistant
Wall switches · Zigbee · Wall switch module
Zigbee device – see the note above on what ZHA needs for it.
Facts about this device
- Brand
- Tuya
- Model
- WHD02
- Device type
- Wall switches
- Radio
- Zigbee
- Power
- Mains powered
- Reports itself as
- ZG-301Z, AY301Z, _TZ3000_hktqahrq, _TZ3000_q6a3tepg, _TZ3000_skueekg3, _TZ3000_npzfdcof, _TZ3000_5ng23zjs, _TZ3000_rmjr4ufz, _TZ3000_v7gnj3ad, _TZ3000_3a9beq8a, _TZ3000_ark8nv4y, _TZ3000_mx3vgyea …
- Also sold as
- AOYAN AY301Z, HOBEIAN ZG-301Z, Tuya iHSW02, Tuya QS-zigbee-S08-16A-RF
- Zigbee2MQTT
- Device page on zigbee2mqtt.io
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.
- official Tuya Zigbee gateway – paired with a Tuya Zigbee gateway and controlled through the Tuya cloud with the Tuya integration.
- add-on Zigbee2MQTT – Zigbee2MQTT runs as an add-on and passes the device on to Home Assistant over MQTT.
Known problems and fixes
Open problems
- open Reported problem #3427
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 · 21 de julho de 2026
Signature: _TZ3000_46t1rvdu / TS0001
2 more quirks for this device
-
Quirk proposed, not merged yet
_TZ3000_fdxihpp7/TS0001zha-device-handlers · pull request #5188 · by @kugaevsky · 21 de julho de 2026 -
Quirk proposed, not merged yet
_TZ3000_fdxihpp7/TS000Fzha-device-handlers · pull request #5188 · by @kugaevsky · 21 de julho de 2026
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.