Tuya Zigbee sensors, TRVs, curtain motors and switches can usually run without the Tuya hub, directly on Zigbee2MQTT or Home Assistant's ZHA. The catch: many of them don't use standard Zigbee clusters.
What's different
- Standard Zigbee devices expose standard clusters (On/Off, Temperature Measurement, ...), and any coordinator understands them.
- Many Tuya devices (typically those with a manufacturer name starting
_TZE) instead tunnel everything through a custommanuSpecificTuyacluster carrying Tuya data points (DP IDs), the same concept as Tuya Wi-Fi DPS. - DP numbers are not unified: two devices with the same model ID can use different DPs.
Identifying a device
A Tuya Zigbee device has a generic model ID (e.g. TS0601) and a manufacturer name such as _TZE200_xxxxxxxx or _TZ3000_xxxxxxxx. Zigbee2MQTT therefore matches Tuya devices by a fingerprint of model ID + manufacturer name, not by model alone. When you look for support, search for the full manufacturer string from the device's interview, not the brand on the box, because the same device is sold under many brands.
If your device isn't supported yet
Zigbee2MQTT
- Create an external converter with a fingerprint for your model ID and manufacturer name.
- Enable debug logging and operate the device; note which DPs change.
- Map DPs to exposes with value converters.
- Contribute the definition back (or add a
whiteLabelentry if an identical device is already supported under another name).
ZHA
- Support comes from quirks in
zha-device-handlers, which translate non-standard behavior into standard clusters. For Tuya devices the project provides TuyaQuirkBuilder to map DPs.
Practical advice
- Before buying, check the Zigbee2MQTT or ZHA device lists for the exact manufacturer name, not only the product photo.
- Battery-powered Tuya sensors often report only on change or at long intervals; don't mistake that for a broken device.
- Mains-powered Zigbee devices usually act as routers; check the device page of your coordinator software for known limitations of the exact model.