01 / Short answer
Identify whether the product uses Tuya Wi-Fi or Zigbee, then name the gateway, cloud dependency and functions exposed to Home Assistant.
Tuya or Smart Life users considering Home Assistant
CHECKPOINT / 01
Tuya is a platform path, not a radio label
Tuya Smart and Smart Life can control Wi-Fi devices or Zigbee devices paired through a Tuya Gateway. Zigbee2MQTT and ZHA use local coordinators. The product page must state which hardware path the buyer is selecting.
CHECKPOINT / 02
Test the path users will buy
For a Zigbee SKU, test Tuya Gateway, Zigbee2MQTT and ZHA independently. Record gateway or coordinator, region, firmware, exposed entities, reset sequence and OTA behavior. A device normally joins one Zigbee network at a time.
- Cloud path: account and internet dependency visible.
- Local path: coordinator and device definition visible.
- Unsupported advanced feature: state it before the build starts.
FAILURE MODES
What usually goes wrong
- A Tuya Wi-Fi controller is described as a Zigbee product.
- Zigbee 3.0 is treated as proof of ZHA, Zigbee2MQTT and Tuya compatibility.
- Users are promised local control when the route requires Tuya cloud.
TECHNICAL BASIS / VERSION
Keep the decision current
This guide is maintained as a versioned technical record. Recheck the current protocol documentation and the exact product revision before using it in a production installation.
Confirm the selected voltage, light engine, driver, controller, firmware and installation conditions against the product record and project brief.
READING LIST
Reference points used for this guide
The page is rewritten for LumaCircuit readers. These references establish the original topic or technical context; they do not replace an exact product review or a LumaCircuit test record.
- Reference / localized technical tutorial
- Zigbee2MQTT documentation
