Supported adapters #

Overview #

Zigbee2MQTT officially supports the following adapters:

Picture	Name	Description	Firmware	Guides	Buy
	Electrolama zig-a-zig-ah! (zzh!) (recommended)	USB connected adapter with external antenna based on CC2652R chip	Coordinator Router	Flashing	Tindie
	Slaesh's CC2652RB stick (recommended)	USB connected adapter with external antenna, currently long shipping times. Based on CC2652RB chip	Coordinator Router	Flashing	Slae.sh
	Tube's CC2652P2 USB Coordinator	Open source hardware CC2652P based USB connected adapter with external antenna and USB extension cable</a>	Coordinator Router	Flashing	Tube's ZB Store
	Tube's Zigbee Gateways (CC2652P2 variant)	Open source hardware CC2652P and ESP32 based Zigbee to Ethernet Coordinator</a>	Coordinator	Flashing	Tube's ZB Store
	Texas Instruments CC2531	USB connected Zigbee adapter with PCB antenna	Coordinator Router	Flashing	AliExpress
	Texas Instruments CC2530	Serial connected adapter with external antenna optionally with CC2591 or CC2592 RF frontend	Coordinator Router	Flashing Connecting	AliExpress GBAN Tindie RF ZU USB
	Texas Instruments CC2538 PCB	Serial connected adapter with CC2592 RF Amplifier	Coordinator	Flashing	AliExpress Tindie
	Texas Instruments CC2538 HAT	Raspberry pinout compatible HAT with CC2538 and optional external antenna	Coordinator	Flashing	Tindie
	Gio-dot Z-Bee Duo with CC2652P	3 in 1 adapter: USB Stick, PI Zero Hat, Ser2net, with external antenna and 3D printed case	Coordinator Router	Flashing	Tindie
	cod.m Zigbee CC2652P RPi Module	Raspberry Pi GPIO module with CC2652P and integrated power amplifier (+20dBm)	Coordinator Router	Flashing	cod.m Shop
	Egony Stick V4 (Ebyte ver.)	Powerful CC2652P Zigbee USB dongle and Raspberry Pi GPIO module	Coordinator Router	Description Flashing	Contact
	Egony Stick V4 (RFSTAR ver.)	Powerful CC2652P Zigbee USB dongle and Raspberry Pi GPIO module	Coordinator Router	Description Flashing	Contact
	Texas Instruments LAUNCHXL-CC26X2R1	USB connected development kit, based on CC2652R chip	Coordinator Router	Flashing	Texas Instruments
	Texas Instruments LAUNCHXL-CC1352P-2	USB connected development kit, based on CC1352P chip	Coordinator Router	Flashing	Texas Instruments
	ConBee II (experimental)	USB connected adapter	Coordinator	Flashing	Phoscon
	ZiGate USB-TTL (experimental)	USB connected adapter based on NXP JN516x (JN5168/JN5169), 3.1d firmware or later required	Coordinator		ZiGate
	Silicon Labs EZSP v8 (experimental)	Initial development started on experimental (pre-alpha stage) support for various adapters based on Silicon Labs EFR32 SoC families with EmberZNet NCP 6.7.8 firmware or later via EZSP version 8 (EmberZNet Serial Protocol) interface. This include all hardware based on SoCs/Modules from Silabs EFR32MG21/MGM210 and EFR32MG12/MGM12 series.	Coordinator

Notes #

Before buying an adapter, please read the notes below!

• Recommended adapters are the Electrolama zig-a-zig-ah! (zzh!) and Slaesh’s CC2652RB stick because: they are very powerful, have good range (external antenna), are well tested with Zigbee2MQTT, are easy to connect (USB), can be flashed without additional hardware and are small in size.
• The following adapters require additional hardware to flash: adapters based on the CC2530 and CC2531 require a CC debugger and downloader cable, adapters based on the CC2538 require a JTAG flasher.
• The adapters based on the CC2652R, CC2652RB, CC2652P and CC1352P chips are very similar to each other since (almost) the same chip is used. The differences:
  • The CC2652P and and CC1352P have a power amplifier which support up-to 20dBm output vs 5dBm on CC2652R(B).
  • The CC1352P support the sub-1 GHz frequency (which is not relevant for Zigbee since it uses 2.4 GHz), the CC2652* only supports 2.4 GHz
  • The difference between the CC2652R and CC2652RB is that the CC2652RB doesn’t require a crystal on the PCB, this only relevant for the manufacturing process.
• Adapters based on the CC2530 or CC2531 chip are not powerful and not recommended for networks larger than 20 devices.
• Adapters that can handle large networks are; adapters using the following chips CC2652R, CC2652RB, CC1352P, CC2538 and the Conbee II.
• Of all adapter the Texas Instruments CC2531 has the worst range, other adapters with a PCB antenna like the Texas Instruments LAUNCHXL-CC26X2R1 and ConBee II provide better range. Adapters with an external antenna have the best range.
• When migrating to another adapter make sure to modify your pan_id in your configuration, otherwise Zigbee2MQTT won’t start. Migrating to a different adapter may require repairing all devices.
• Support for the Conbee II (discussion), ZiGate USB-TTL (discussion), and Silicon Labs EZSP (discussion) is experimental, meaning not feature complete nor recommended for a stable enviroment.
• WiFi-based Serial-to-IP bridges are not recommended for Silicon Labs EZSP adapters as the serial protocol does not have enough fault-tolerance to handle packet loss or latency delays that can normally occur over WiFi connections. If cannot use a locally connected USB or UART/GPIO adapter then the recommendation is to use remote adapter that connected via Ethernet (wired) to avoid issues with EZSP caused by WiFi connections.
• When using a Conbee II or ZiGate USB-TTL and you get: Error: Failed to connect to the adapter (Error: SRSP - SYS - ping after 6000ms) when starting Zigbee2MQTT set the following in your configuration.yaml.

serial:
  adapter: deconz # deconz for Conbee II OR "zigate" for the ZiGate USB-TTL

Router #

Besides serving as a coordinator some adapters can also be used as a Zigbee router (check if there is a router firmware in the firmware column). To factory reset/pair:

• Texas Instruments CC2531: Press the S2 button for 5 seconds.
• Texas Instruments CC2530: Power on/power off the device three times (power on, wait 2 seconds, power off, repeat this cycle three times).
• Adapters based on CC2652R, CC2652RB and CC1352P: single press (one of the) buttons on the device
  • Slaesh’s CC2652RB stick has 2 buttons where only the one furthest away from the USB connector can be used to factory reset.

Texas Instruments LAUNCHXL-CC1352P-2 and LAUNCHXL-CC26X2R1 #

• These devices have two serial devices built in. Make sure you put the right serial device in the configuration or use auto detect (completely remove the serial section from configuration.yaml) if you only have one Texas Instruments CC device connected to your system.
• An external antenna can be connected which could increase range further:
  • LAUNCHXL-CC26X2R1: Has UF.L connector for external antenna (requires resoldering a tiny capacitor (moving C14 to C24)).
  • LAUNCHXL-CC1352P-2: Has SMA connector for external antenna (requires resoldering a tiny capacitor).