Supported Adapters
All officially supported adapters are listed on this page. Note that before an adapter can be used with Zigbee2MQTT it has to be flashed with a coordinator firmware (some adapters come preflashed).
TIP
Want to migrate to a different adapter? Read this
Recommended
The adapters below are recommended because they use powerful chips, can handle large networks and are well-supported.
Based on Texas Instruments CC2652/CC1352 chip:
(in order of first appearance)
USB connected (easiest)
Electrolama zig-a-zig-ah! (zzh!)
USB connected adapter with external antenna based on CC2652R chip
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
Slaesh's CC2652RB stick
WARNING: Problems with customer support have been reportedopen in new window.
USB connected adapter with external antenna based on CC2652RB chip
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
Tube's CC2652P2 USB Coordinator
Open source hardware CC2652P based USB connected adapter with external antenna and USB extension cable
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
Egony Stick V4
Powerful CC2652P Zigbee USB dongle and Raspberry Pi GPIO module. Available in Ebyte (left picture) and RFSTAR (right picture) version.
- Coordinator firmware: Ebyteopen in new window RFSTARopen in new window
- Router firmware: Ebyteopen in new window RFSTARopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Description: Ebyteopen in new window RFSTARopen in new window
- Contactopen in new window
ZigStar Stick v4
Powerfull Open source dongle with external antenna based on CC2652P
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Descriptionopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
CircuitSetup's CC2652P2 USB Coordinator
CC2652P based USB connected adapter pre-programmed with Z-Stack
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
SMARTLIGHT CC2652P Zigbee USB Adapter SLZB-02
CC2652P factory-made Zigbee USB coordinator with external 6dB antenna and worldwide delivery
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Descriptionopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy: eBayopen in new window Aliexpressopen in new window Official storeopen in new window Telegramopen in new window
SONOFF Zigbee 3.0 USB Dongle Plus
CC2652P based USB connected adapter pre-programmed and with enclosure
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
Vision CC2652 dongle
Adapter or small development board based on CC2652R (VS201) or CC2652P (VS202)
Coordinator firmware: VS201open in new window VS202open in new window
Router firmware: VS201open in new window VS202open in new window- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy: VS201open in new window VS202open in new window
Hybrid (network + USB)
Gio-dot Z-Bee Duo with CC2652P
4 in 1 zigbee adapter: USB Stick, WiFi, LAN, PI Zero Hat, with external antenna and 3D printed case.
- Descriptionopen in new window
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
ZigStar LAN Coordinator
Powerfull Open source LAN Coordinator with external antenna on CC2652P
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Descriptionopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window {Tindie}(https://www.tindie.com/products/zigstar/zigstar-lan-gateway/)
ZigStar PoE Coordinator
Open source PoE af Coordinator with external antenna on CC2652P
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Descriptionopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window Tindieopen in new window
Network
Tube's Zigbee Gateways (CC2652P2 variant)
Open source hardware CC2652P and ESP32 based Zigbee to Ethernet Coordinator (left picture), POE variant is also available (right picture)
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
cyijun OpenZ3Gateway
An open source Zstack3 gateway powered by ESP8266 and CC2652P modules. One costs less than 60 CNY in China.
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructions; see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Descriptionopen in new window
- Tindieopen in new window
XGG 52PZ2MGateway
An open source Zstack3 gateway powered by ESP8266 and CC2652P modules. One costs less than 60 CNY in China.
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructions; see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Descriptionopen in new window
- Buyopen in new window
SMARTLIGHT Zigbee LAN Adapter CC2652P Model SLZB-05
Pre-flashed ready-to-use Zigbee LAN CC2652P Adapter, factory made, metal case, 6dB antenna, worldwide delivery, Zigbee firmware can be manually updated via USB in 5 easy steps, customer/tech support, fast order processing.
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Descriptionopen in new window
- Flashing instructions; see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy: eBayopen in new window Official storeopen in new window Telegramopen in new window
cod.m ZigBee CC2652P2 TCP Coordinator
CC2652P2 ZigBee Ethernet Coordinator, ethernet part based on USR-K6open in new window module. POE possible with external splitter. Comes complete with 3d printed case and antenna.
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructionsopen in new window
- Buyopen in new window
Raspberry Pi hat
cod.m Zigbee CC2652P RPi Module
Raspberry Pi GPIO module with CC2652P and integrated power amplifier (+20dBm)
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
ZigStar Shield
Powerfull Open source Pi Shield based on CC2652P
- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Descriptionopen in new window
- Flashing instructionsopen in new window or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
Development board
Texas Instruments LAUNCHXL-CC1352P-2
USB connected development kit, based on CC1352P chip
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 theserial
section fromconfiguration.yaml
) if you only have one Texas Instruments CC device connected to your system.
An external antenna can be connected which could increase range: requires resoldering a tiny capacitor (moving C14 to C24)open in new window- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
Texas Instruments LAUNCHXL-CC26X2R1
USB connected development kit, based on CC2652R chip
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 theserial
section fromconfiguration.yaml
) if you only have one Texas Instruments CC device connected to your system.
An external antenna can be connected which could increase range: requires resoldering a tiny capacitoropen in new window- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buyopen in new window
Other
ConBee / ConBee II / RaspBee / RaspBee II
USB connected adapters (ConBee and ConBee II) and Raspberry Pi GPIO modules (RaspBee and RaspBee II). If Zigbee2MQTT fails to start, try adding the following to your
configuration.yaml
serial: adapter: deconz
1
2- Coordinator firmwareopen in new window
- Flashingopen in new window
- Buyopen in new window (ConBee II)
- Buyopen in new window (RaspBee II)
Not recommended
The adapters below are well-supported but use outdated chips.
USB connected
Texas Instruments CC2531
USB connected Zigbee adapter with PCB antenna
Warning 1: requires additional hardware to flash (CC debugger + download cable)
Warning 2: might not be powerful enough to handle networks of 20+ devices
Warning 3: this adapter has bad range- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructions
- Buyopen in new window
Vision CC2538+CC2592 Dongle(VS203)
Adapter or small development board based on CC2538 and CC2592 chip
Serial connected
Texas Instruments CC2530
Serial connected adapter with external antenna optionally with CC2591 or CC2592 RF frontend
Warning 1: requires additional hardware to flash (CC debugger + download cable)
Warning 2: might not be powerful enough to handle networks of 20+ devices- Coordinator firmwareopen in new window
- Router firmwareopen in new window
- Flashing instructions
- Connecting
- Buy: AliExpressopen in new window GBANopen in new window Tindieopen in new window RF ZU USBopen in new window
Texas Instruments CC2538
Serial connected adapter with CC2592 RF Amplifier
- Coordinator firmwareopen in new window
- Flashing
- Buy: AliExpressopen in new window Tindieopen in new window
Raspberry Pi
Texas Instruments CC2538 HAT
Raspberry pinout compatible HAT with CC2538 and optional external antenna
Network
XGG gateway
An open source zigbee gateway powered by ESP8266 and CC2538+CC2592PA (XGG 38PZ2MGateway) or CC2530 (XGG 30Z2MGateway)
Coordinator firmware: XGG 38PZ2MGatewayopen in new window XGG 30Z2MGatewayopen in new window
Experimental
The adapters below are experimental, don't use these if you want a stable setup.
ZiGate
Initial development started on experimental (alpha stage) support for various ZigGate adapters (based on NXP Zigbee chips like JN5168 and JN5169). This include all ZiGate compatible hardware adapters with ZigGate 3.1d firmware or later.
If Zigbee2MQTT fails to start, try adding the following to yourconfiguration.yaml
serial: adapter: zigate
1
2Silicon Labs EZSP v8
Initial development started on experimental (alpha stage) support for various adapters based on Silicon Labs EM35X and EFR32MG 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
If Zigbee2MQTT fails to start, try adding the following to yourconfiguration.yaml
serial: adapter: ezsp
1
2
Notes
Before buying an adapter, please read the notes below!
- Want to migrate to a different adapter? This may require repairing all your devices in some cases, see FAQ
- Network adapters connected via WiFi might have reduced stability 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.
- What are the differences between the various CC2652/CC1352 chips?
- Chips ending with
P
have a power amplifier which support up-to 20dBm vs 5dBm on adapters ending withR
/RB
. - Chips starting with
CC1352
support the sub-1 GHz frequency (which is not relevant for Zigbee since it uses 2.4 GHz),CC2652
only supports 2.4 GHz. So for Zigbee2MQTT purposes there is no difference betweenCC1352
andCC2652
. - Chips ending with
RB
don't require a crystal on the PCB, this only makes a difference for the manufacturing process.
- Chips ending with
Flashing CC1352/CC2652/CC2538 based adapters
Adapters based on CC1352 or CC2652 chips can be flashed by putting them in the bootloader. See your adapter manual on how to do this. After you have done this one of the following tools can be used to flash it.
- ZigStar GW Multi toolopen in new window (multi platform GUI tool)
- CC2538-BSLopen in new window (multi platform Python based command line tool) (instructions)
- llama-bslopen in new window (multi platform Python based command line tool, a fork of cc2538-bsl with added features)
- Texas Instrumens FLASH PROGRAMMER 2open in new window (Windows only)
Router
Besides serving as a coordinator some adapters can also be used as a Zigbee router (check if there is a router firmware by clicking on your adapter). 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 CC2652/CC1352: single press (one of the) buttons on the device