Supported adapters #

Zigbee2MQTT officially supports the following adapters:

CC2531

USB connected Zigbee adapter with PCB antenna.
Cheap but not very powerful (+- $5), may not be powerfull enough for larger networks (30/40+ devices).
Limited range, ~30m line of sight
Requires CC debugger to be flashed
Coordinator firmware: Zigbee 1.2 and Zigbee 3.0
Router firmware: Zigbee 1.2, can be re-paired pressing the S2 button for 5 seconds.
Can be bought on AliExpress
How to flash or alternative flashing methods

CC2530

Serial connected Zigbee adapter with most of the times and external atenna.
Cheap but not very powerful (+- $10), may not be powerfull enough for larger networks (30/40+ devices).
Good range, ~50-60m line of sight, sensitivity can be increased when used together with a CC2591 or CC2592
Requires CC debugger to be flashed
Coordinator firmware: Zigbee 1.2 and Zigbee 3.0
Router firmware: Zigbee 1.2, can be re-paired if you power on/power off the device three times (power on, wait 2 seconds, power off, repeat this cycle three times)
Can be bought on e.g. AliExpress: CC2530, CC2530 + CC2591, GBAN GB2530
How to flash: see flashing section of How to create a CC2530 router or alternative flashing methods
Connecting the CC2530

CC2538

Serial connected Zigbee adapter with external antenna.
Cheap but needs specific PCBs to be used as coordinator (+- $5 bare chip)
Very powerful and capable to handle +150 devices directly connected.
Very good range, ~800m line of sight, sensitivity is due to the onboard CC2592 Power Amplifier (20db)
Requires JTAG programmer to be flashed
Coordinator firmware: Zigbee 3.0
Router firmware: not yet available.
Bare module can be bought on AliExpress
Complete dongle preflashed can be bought on Tindie
How to flash

zzh

Preferred over the Texas Instruments LAUNCHXL-CC26X2R1 and LAUNCHXL-CC1352P-2 due to smaller form factor and lower price. Uses the same chip as LAUNCHXL-CC26X2R1 (CC2652R).
USB connnected Zigbee adapter
Very powerful, will easily handle networks of 100+ devices.
Very good range (due to external antenna)
Can be bought on Tindie
Coordinator firmware: Zigbee 3.0 (use CC26X2R1_*.zip)
Flashing guide (requires no additional hardware to flash)
When migrating from another dongle (e.g. CC2531), make sure to modify your pan_id in your configuration, otherwise Zigbee2MQTT won’t start.

slaesh's CC2652RB stick

Preferred over the Texas Instruments LAUNCHXL-CC26X2R1 and LAUNCHXL-CC1352P-2 due to smaller form factor and lower price. Uses the same chip as LAUNCHXL-CC2652RB (CC2652RB).
USB connnected Zigbee adapter
Very powerful, will easily handle networks of 100+ devices.
Very good range (due to external antenna, SMA female connector)
Can be bought on Tindie
Coordinator firmware: Zigbee 3.0 (use CC2652RB_*.zip)
Flashing guide (requires no additional hardware to flash)
When migrating from another dongle (e.g. CC2531), make sure to modify your pan_id in your configuration, otherwise Zigbee2MQTT won’t start.
Requires at least Version 1.14.2

CC26X2R1

USB connected Zigbee adapter.
Expensive but very powerful ($40), will easily handle networks of 100+ devices.
Very good range
Only available as a development board, therefore it is quite large
Has an onboard flasher, no additional hardware required to flash
Coordinator firmware: Zigbee 3.0 (use CC26X2R1_*.zip)
Can be bought via Texas Instruments
Flash via UNIFLASH
When migrating from another dongle (e.g. CC2531), make sure to modify your pan_id in your configuration, otherwise Zigbee2MQTT won’t start.
Has UF.L connector for external antenna (requires resoldering a tiny capacitor (moving C14 to C24)) which could increase range even further.
This device has two serial devices built in. Make sure you put the right serial device in the configuration or use auto detect if you only have one Texas Instruments CC devices connected to your system.

CC1352P-2

USB connected Zigbee adapter.
Expensive but very powerful ($50), will easily handle networks of 100+ devices.
Very good range
Only benefit compared to the CC26X2R1 is that it is capable of sub-1GHz (for Zigbee2MQTT use-case this makes no difference)
Has SMA connector for external antenna (requires resoldering a tiny capacitor) which could increase range even further.
Only available as a development board, therefore it is quite large (it’s larger than the CC26X2R1)
Has an onboard flasher, no additional hardware required to flash
Coordinator firmware: Zigbee 3.0 (use CC1352P_2_*.zip)
Can be bought via Texas Instruments
Flash via UNIFLASH
When migrating from another dongle (e.g. CC2531), make sure to modify your pan_id in your configuration, otherwise Zigbee2MQTT won’t start.
This device has two serial devices built in. Make sure you put the right serial device in the configuration or use auto detect if you only have one Texas Instruments CC devices connected to your system.

Conbee II

USB connnected Zigbee adapter
Very powerful, will easily handle networks of 100+ devices.
Support is still experimental. (discussion)
In case you are getting the following error: Error: Failed to connect to the adapter (Error: SRSP - SYS - ping after 6000ms) set the following in your configuration.yaml.

serial:
  adapter: deconz

zigbee2mqtt.io