Which Zigbee hardware works, and what breaks

Knowledge base

Which Zigbee hardware works, and what breaks

Zigbee is a standard, but not every device sticks to it. Here is what actually goes wrong with off-the-shelf hardware, and what we catch for you.

8,413
Zigbee devices we recognise
527
Device brands in our library
11
Questions for a new device
0
Ports you have to open
Where it goes wrong

Where Zigbee goes wrong in practice

None of it is your fault, and all of it is known.

Adapter and firmware

A stick and the software around it have to match. One version out of step and nothing comes through, with no error that tells you why.

Brands that bend the rules

Tuya talks through a tunnel of its own. Aqara clings to the relay it first paired with. Neither is in the spec.

The room around it

USB 3.0 ports and 2.4 GHz wifi drown out Zigbee. Most dropouts start here, not in your devices.

Not every platform can do the same

Zigbee2MQTT, ZHA and deCONZ each expose different parts of the radio. That decides what we can do for you.

What we catch

Where the platform steps in

Two things are easy to mix up here. Your coordinator is the stick that runs your network; your devices are the sensors and valves hanging off it. We look at both, and everything below is running today.

1

Your coordinator: we check the brand and its firmware

When you connect a coordinator we read what it is and which firmware it runs, and we hold that against the combinations we know are broken.

Example: Zigbee2MQTT 1.37.0 with EmberZNet 7.4.2 does not connect. You get that answer at pairing time, with 7.4.1 as the way out.
2

Your devices: nothing gets in unasked

Nothing lands on your dashboard on its own. A device sits in quarantine, we ask it what it is, and you decide whether it gets in.

3

Your devices: brand behaviour is on the card

When we recognise a brand that behaves differently, the card says so before you go hunting.

A Tuya device is matched on the manufacturer code, not the model number: two devices sold as TS0601 can be entirely different products.
4

Your devices: 6,974 models in our library

Every device that joins through your coordinator is held against that library: what it can do, what it reports and how often. Anything we could not measure ourselves says so on the card. A borrowed value is never presented as a reading.

The list

Which Zigbee coordinators you can connect

Straight from the platform, so this list cannot go stale.

CoordinatorWhat we can doConnect it yourselfStatus
Home Assistant ZHAZHA inside Home Assistant, over its websocket API. Reports clusters as numbers.Full controlyesacceptance test running
Zigbee2MQTTAny stick Zigbee2MQTT supports: SONOFF ZBDongle-E and P, SLZB-06, ConBee III.Full controlyesacceptance test running
deCONZ / PhoscondeCONZ with a ConBee or RaspBee, over REST and websocket. Reports clusters as numbers.Not yet establishednot yetacceptance test running
Closed hub (observer)Tuya hub, Hue bridge, Aqara hub. Incoming messages only, no commands.Not yet establishednot yetacceptance test running

Missing your coordinator? Tell us which one you run and we will look at what it takes.

Before you blame the hardware

Where it usually goes wrong

Four things that solve most of it.

Put the stick on an extension cable

Half a metre away from your machine, and away from USB 3.0 ports and external drives. This alone fixes most dropouts.

Pair up close, then move it

Manufacturers underestimate pairing range. Pair next to the coordinator, then put the device where it belongs.

Add mains-powered devices

Anything on mains power relays traffic for the rest. Too few of them is the most common cause of a flaky network.

Do not switch channel lightly

Channels 15, 20 and 25 dodge wifi best, but changing channel forces every device to rejoin. On a big network that takes hours.

Bring your own Zigbee coordinator. Already running Zigbee2MQTT on your own stick? Connect it in four steps. Connect your coordinator

Your Zigbee coordinator is paired. Here is what comes next. Adding a device, approving it and knowing where it ends up. And what we watch for you after that. Add your first device

FAQ

Questions we get

Do I have to buy your hardware?

No. Standard Zigbee devices from any shop work, and so does your own coordinator. That is the whole point.

What if my device is not in your library?

It can still join. The card then shows exactly what the device told us about itself and marks what we could not look up, so you know what you are getting.

Does the platform fix a bad firmware combination for me?

No, and we will not pretend otherwise. We recognise it and tell you what to do about it. Flashing your own dongle stays your call.

Which platform gives me the most?

Zigbee2MQTT today. It exposes the most of the radio, which is why it is the first one we support end to end.

Connect your own coordinator

Already running Zigbee2MQTT? Download the bridge, get a pairing code and you are connected.

✓

Thank you!

We've received your request and will be in touch soon.

➤ Personal contact within 1 business day

➤ A proposal tailored to your situation