ZHA
Home Assistant's built-in Zigbee integration, based on zigpy.
software
also known as Zigbee Home Automation
Knowledge about ZHA
- Building a healthy Zigbee mesh: routers first, then battery devicesprocedure · unverified · Zigbee coverage and capacity come from routers. Add mains-powered routers before battery devices, pair end devices where they will live or through a nearby router, and know that some end devices never switch parents.
- Choosing a Zigbee coordinator: chip families, power amplifier and backup supportrecommendation · unverified · Zigbee2MQTT recommends zStack (Texas Instruments), EmberZNet (Silicon Labs) and deCONZ adapters; ZiGate is unmaintained and ZBOSS experimental. Prefer an adapter that supports coordinator backup.
- Choosing the Zigbee channel next to Wi-Fi (and what changing it costs)guide · unverified · Zigbee and Wi-Fi share 2.4 GHz. Pick the Zigbee channel before pairing devices: Zigbee2MQTT recommends ZLL channels 11, 15, 20 or 25. Changing the channel later may require re-pairing; changing the network key requires re-pairing everything.
- Tuya Zigbee devices in Zigbee2MQTT and ZHA: the _TZE fingerprint and the Tuya clusterguide · unverified · Many Tuya Zigbee devices send data over a custom manuSpecificTuya cluster using data points instead of standard Zigbee clusters. Zigbee2MQTT matches them by model ID plus manufacturer name (e.g. _TZE200_...); ZHA uses quirks built with TuyaQuirkBuilder.
- Tuya Zigbee devices: same model ID, different datapointswarning · unverified · Many Tuya Zigbee devices use the manufacturer-specific manuSpecificTuya cluster with Tuya datapoints (DPs) instead of standard Zigbee clusters, and share model IDs across different hardware. Support is per manufacturerName (e.g. _TZE200_...).
- Zigbee OTA firmware updates: slow, battery-hungry and not always an improvementprocedure · unverified · Zigbee2MQTT and ZHA can update device firmware over the air. Updates take 10–100 minutes in Zigbee2MQTT, battery devices need at least 70% charge, updates can change behavior, and downgrading is limited.
- Zigbee coordinator on a USB 3 port or next to an SSD: expect a weak, unstable networkwarning · unverified · USB 3 ports, SSDs, HDMI ports and Wi-Fi routers interfere with 2.4 GHz Zigbee. Put the coordinator on a USB extension cable, use a USB 2 port, and keep it away from these sources.
- Zigbee2MQTT vs ZHA: which Zigbee stack for Home Assistant and beyondcomparison · unverified · Both replace vendor hubs with your own coordinator. ZHA is built into Home Assistant; Zigbee2MQTT bridges devices to an MQTT broker and works with Home Assistant via MQTT discovery or with any other MQTT consumer.
Related
- alternative to: Zigbee2MQTT – Both run a Zigbee network from a coordinator; ZHA is built into Home Assistant, Zigbee2MQTT publishes to MQTT.
- alternative to (from): Zigbee2MQTT – Both run Zigbee networks without the Tuya hub.
- part of: Home Assistant