Supported adapters #

Zigbee2MQTT officially supports the following adapters:

Texas Instruments CC2531 #

• USB connected Zigbee adapter with PCB antenna.
• Cheap but not very powerful (+- $5), may not be powerfull enough for larger networks (20+ devices).
• Limited range, ~30m line of sight
• Requires additional hardware to be flashed (CC debugger and downloader cable)
• Coordinator firmware: Zigbee 1.2 (recommended) 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 with CC debugger or alternative flashing methods

Electrolama zig-a-zig-ah! (zzh!) #

• 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 #

• 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.

Texas Instruments CC2530 (optionally with a CC2591 or CC2592 RF frontend) #

• 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 (20+ devices).
• Good range, ~50-60m line of sight, sensitivity can be increased when used together with a CC2591 or CC2592
• Requires additional hardware to be flashed (CC debugger)
• Coordinator firmware: Zigbee 1.2 (recommended) 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
• Complete dongle preflashed (coordinator or router) can be bought on Tindie
• How to flash: see flashing section of How to create a CC2530 router or alternative flashing methods
• Connecting the CC2530

Texas Instruments CC2538 with CC2592 RF Amplifier #

• 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)
• Can be programmed via JTAG programmer or via software if proper bootloader enabled firmware is preloaded
• Coordinator firmware: Zigbee 3.0
• Bare module can be bought on AliExpress
• Complete dongle preflashed can be bought on Tindie
• How to flash via JTAG
• How to flash via SERIAL

Raspberry CC2538 HAT #

• Raspberry pinout compatible HAT with CC2538 and optional external antenna.
• Can be used to create a very compact and powerful hub that runs independently by your home automation hub
• 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)
• Can be programmed via JTAG programmer or via software if proper bootloader enabled firmware is preloaded
• Coordinator firmware: Zigbee 3.0
• Complete HAT preflashed can be bought on Tindie
• How to flash with JTAG
• How to flash via SERIAL

Texas Instruments LAUNCHXL-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.

Texas Instruments LAUNCHXL-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.
• Coordinator firmware: Recommend upgrading to latest deCONZ Zigbee Home Automation 1.2 coordinator firmware.
  • Note! There is no deCONZ Zigbee 3.0 coordinator firmware for ConBee or RaspBee as of yet.
• 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

ZiGate USB-TTL #

• USB connnected Zigbee adapter
• Hardware based on NXP JN516x ( JN5168 / JN5169 ) chip with open source ZiGate firmware from @fairecasoimeme
• 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: zigate