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 firmware
- Router firmware
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
Slaesh's CC2652RB stick
USB connected adapter with external antenna based on CC2652RB chip
- Coordinator firmware
- Router firmware
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
Tube's CC2652P2 USB Coordinator
Open source hardware CC2652P based USB connected adapter with external antenna and USB extension cable
- Coordinator firmware
- Router firmware
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
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: Ebyte RFSTAR
- Router firmware: Ebyte RFSTAR
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Description: Ebyte RFSTAR
- Contact
ZigStar Stick v4
Powerfull Open source dongle with external antenna based on CC2652P
- Coordinator firmware
- Router firmware
- Description
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
CircuitSetup's CC2652P2 USB Coordinator
CC2652P based USB connected adapter pre-programmed with Z-Stack
- Coordinator firmware
- Router firmware
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
SMLIGHT CC2652P Zigbee USB Adapter SLZB-02
CC2652P factory-made Zigbee USB coordinator with external 6dB antenna and worldwide delivery
- Coordinator firmware
- Router firmware
- Description
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy: Official store, Tindie
SONOFF Zigbee 3.0 USB Dongle Plus ZBDongle-P
CC2652P based USB connected adapter pre-programmed and with enclosure.
Note before buying that ITead slightly confusingly now sells both the Dongle Plus "ZBDongle-P" (based on CC2652P), and the Dongle Plus V2 "ZBDongle-E" (based on EFR32MG21). This section is about the "ZBDongle-P", for "ZBDongle-E" see below.
- Coordinator firmware
- Router firmware
- Flashing instructions (PDF version) or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
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.
- Description
- Coordinator firmware
- Router firmware
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
ZigStar LAN Coordinator
Powerfull Open source LAN Coordinator with external antenna on CC2652P
- Coordinator firmware
- Router firmware
- Description
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy Tindie
ZigStar PoE Coordinator
Open source PoE af Coordinator with external antenna on CC2652P
- Coordinator firmware
- Router firmware
- Description
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy Tindie
SMLIGHT SLZB-06 Zigbee ethernet USB POE WiFi LAN adapter
Powerfull, tiny modern design, developed for Zigbee2MQTT, PoE supported, pre-flashed and ready to use Zigbee adapter. Supports Zigbee 3.0, Ethernet, LAN, USB and WiFi connections. Rich packing that includes SLZB-06 adapter, +5dB antenna, screws, adhesive tapes, screwdriver, microUSB-typeC adapter, screw-fix-helper and QR-manual. Distant update, modern UI open-source firmware. Optoelectronic isolation for Ethernet, LEDs and physical button for interacting with user. Fits home and business use.
- Coordinator firmware (CC2652P)
- ESP32 firmware
- Manual
- Product site
- Buy: Official store, Aliexpress, Amazon US, Tindie
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 firmware
- Router firmware
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
cyijun OpenZ3Gateway
An open source Zstack3 gateway powered by ESP8266 and CC2652P modules. One costs less than 60 CNY in China.
- Coordinator firmware
- Router firmware
- Flashing instructions; see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Description
- Tindie
XGG 52PZ2MGateway
An open source Zstack3 gateway powered by ESP8266 and CC2652P modules. One costs less than 60 CNY in China.
- Coordinator firmware
- Router firmware
- Flashing instructions; see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Description
- Buy
SMLIGHT 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 firmware
- Router firmware
- Description
- Flashing instructions; see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy: eBay Official store Telegram
cod.m ZigBee CC2652P2 TCP Coordinator
CC2652P2 ZigBee Ethernet Coordinator, ethernet part based on USR-K6 module. POE possible with external splitter. Comes complete with 3d printed case and antenna.
Raspberry Pi hat
cod.m Zigbee CC2652P RPi Module
Raspberry Pi GPIO module with CC2652P and integrated power amplifier (+20dBm)
- Coordinator firmware
- Router firmware
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
ZigStar ZigiHAT PoE
Powerfull Open source Pi HAT based on CC2652P with PoE,RTC onboard
- Coordinator firmware
- Router firmware
- Description
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
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)- Coordinator firmware
- Router firmware
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
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 capacitor- Coordinator firmware
- Router firmware
- Flashing instructions or see "Flashing CC1352/CC2652/CC2538 based adapters" below
- Buy
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
Warning: Conbee 2 firmware versions newer than 0x26580700 will result in an unstable network with devices dropping randomly, see Issue 9554
- Coordinator firmware
- Flashing
- Buy (ConBee II)
- Buy (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 rangeVision 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+ devicesTexas Instruments CC2538
Serial connected adapter with CC2592 RF Amplifier
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 38PZ2MGateway XGG 30Z2MGateway
Experimental
The adapters below are experimental, don't use these if you want a stable setup.
Based on Silicon Labs EFR32MG2x/MGM21x and EFR32MG1x/MGM1x series
Initial development started on experimental (beta stage) support for Silicon Labs based Zigbee adapters. This includes all EM35X, EFR32MG12, EFR32MG13, EFR32MG21, EFR32MG24 SoCs/Modules families with Silabs EmberZNet NCP 6.7.8 firmware or later via EZSP version 8 (EmberZNet Serial Protocol) interface.
USB connected
ITead Sonoff Zigbee 3.0 USB Dongle Plus V2 model "ZBDongle-E"
USB connected adapter with external antenna.
Note before buying that ITead slightly confusingly now sells both the "ZBDongle-E" (based on EFR32MG21) and "ZBDongle-P" (based on CC2652P). This section is about the "ZBDongle-E", for "ZBDongle-P" see above.
If Zigbee2MQTT fails to start, try adding the following to your
configuration.yaml
serial: adapter: ezsp
Home Assistant SkyConnect (by Nabu Casa)
USB connected adapter with integrated antenna.
This dongle/stick ships with standard Silicon Labs EmberZNet Zigbee NCP firmware so it works like other ezsp adapters out-of-the-box as long as you do not change firmware from NCP (Network Co-Processor) to RPC (Radio Co-Processor) firmware architecture for the EmberZNet Zigbee protocol stack. If you plan on using it only with Zigbee2MQTT then it is therefore currently not recommended to flash/upgrade to an RPC Multi-PAN firmware for it as that enables multiprotocol support for the radio which adds an extra prerequisite of running a service called "Zigbeed" (Zigbee daemon) on the same computer as the RCP Multi-PAN design offloads the Silicon Labs EmberZNet Zigbee protocol stack from the radio adapter, and that required Zigbee daemon for Silicon Labs EmberZNet is not yet included as a dependency with Zigbee2MQTT/zigbee-herdsman, meaning that you need to install and maintain that dependency yourself.
If Zigbee2MQTT fails to start, try adding the following to your
configuration.yaml
serial: adapter: ezsp
Elelabs ELU013 and Popp ZB-STICK
USB connected adapters (Elelabs ELU013 and Popp ZB-STICK 701554).
If Zigbee2MQTT fails to start, try adding the following to your
configuration.yaml
serial: adapter: ezsp
- Coordinator firmware
- Flashing
- Buy (Elelabs Zigbee USB Adapter Model ELU013 based on Silabs EFR32MG13P)
- Buy (Popp ZB-STICK white-label rebranded version of Elelabs 701554 based on Silabs EFR32MG13P)
CoolKit ZB-GW04 USB dongle (a.k.a. easyiot stick)
USB connected adapter (CoolKit ZB-GW04 USB dongle, also known as "easyiot stick") widly available online from China.
USB dongle is originally a DIY design from Modkam (Russian speaking Zigbee DIY community) and it using pre-flashed "SM-011 V1.0" (ZYZBP008) radio module from CoolKit-Technologies (which has a Silabs EFR32MG21 Zigbee SoC chip on it).
Warning! Before buying understand that the "SM-011 V1.0" module/board used in this is missing electromagnetic interference shielding and have relativly low-quality circuit board antenna with less than optimal hardware tuning so it has been reported signal reception with these is very sensitive to all types of interference unless connect it via a very long USB extension cable that is properly shielded to get it away from any sources of EMF/EMI/RMI.
Note that the same USB dongle is also sold pre-flashed with Zigbee Router firmware as a lower price and it is reported to act much better as a Zigbee Router than what it does as a Zigbee Coordinator.
If Zigbee2MQTT fails to start, try adding the following to your
configuration.yaml
serial: adapter: ezsp
Z-Wave.Me Z-Station dual Zigbee & Z-Wave
USB connected adapter with external antenna and USB extension cable. Supports Zigbee and Z-Wave.
Z-Station is a Z-Wave and Zigbee USB adapter. A controller software compatible to the Silicon Labs Z-Wave Serial API (for example Z-Way) and Zigbee NCP is required to use the functions of the device.
Based on Silabs EFR32MG21P and ZGM130S.
If Zigbee2MQTT fails to start, try adding the following to your
configuration.yaml
serial: adapter: ezsp baudrate: 115200
Raspberry Pi
Elelabs Zigbee Raspberry Pi Shield/Popp ZB-Shield
Hat for Raspberry Pi (Elelabs ELR023 and Popp ZB-SHIELD 701561).
If Zigbee2MQTT fails to start, try adding the following to your
configuration.yaml
serial: adapter: ezsp
- Coordinator firmware
- Flashing
- Buy (Elelabs Zigbee Raspberry Pi Shield Model ELR023 based on Silabs EFR32MG13P)
- Buy (Popp ZB-SHIELD 701561 is a white-label rebranded version of Elelabs ELR023 based on Silabs EFR32MG13P)
Hybrid (network + USB)
TubesZB Zigbee EFR32 pro ethernet/USB serial coordinator
TubesZB early models works only over (wired LAN) while his later models can be set to work either over Ethernet or USB (USB-to-Serial Bridge).
If Zigbee2MQTT fails to start, try adding the following to your
configuration.yaml
serial: adapter: ezsp
- Coordinator firmware
- Flashing
- Buy (TubesZB Zigbee variants including Silabs EFR32 MGM12/MGM210P module based models)
mPCIe adapter
Z-Wave.Me dual Zigbee & Z-Wave mPCIe adapter
USB connected adapter with external antenna and mPCIe USB adapter. Supports Zigbee and Z-Wave.
The Z-Wave.Me Z-Wave and Zigbee mPCIe adapter is a controller board for embedded application. It fits in the mPCIe slot with full- or half-size holder. A controller software compatible to the Silicon Labs Z-Wave Serial API (for example Z-Way) and Zigbee NCP is required to use the functions of the device.
The Z-Wave and Zigbee mPCIe adapter supports Z-Wave and Zigbee / Thread / Bluetooth Low Energy (on your choice, selected by firmware update). Based on Silabs EFR32MG21P and ZGM130S.
If Zigbee2MQTT fails to start, try adding the following to your
configuration.yaml
serial: adapter: ezsp baudrate: 115200
Wiren Board
Wiren Board 7
Wiren Board 7 with Zigbee module with external antenna.
The Z-Wave.Me Wiren Board 7 is a professional multiprotocol controller for home and commercial automation. It is a DIN-rail ready Debian-based computer with Z-Way software and a lot of other open-source software including MQTT broker, device configurators, port configurators.
Based on Silabs MGM210PA32JIA.
Based on ZiGate
Initial development started on experimental (alpha stage) support for various ZigGate adapters. This includes all ZiGate compatible hardware adapters which are currently based on NXP Zigbee MCU chips like JN5168 and JN5169 with ZigGate 3.1d firmware or later.
ZiGate adapter
If Zigbee2MQTT fails to start, try adding the following to your configuration.yaml
serial:
adapter: zigate
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
Coordinator backups
Note that only adapters based on a Texas Instruments chip (CC2530/CC2531/CC2538/CC2652/CC1352) support a coordinator backup (coordinator_backup.json
).
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 tool (multi platform GUI tool)
- CC2538-BSL (multi platform Python based command line tool) (instructions)
- llama-bsl (multi platform Python based command line tool, a fork of cc2538-bsl with added features)
- Texas Instruments FLASH PROGRAMMER 2 (Windows only) (can't find your device? read below!)
- Some Ethernet adapters support flashing Zigbee firmware over their own web-interface. In this case you do not need any external software and hardware. Just go to the webinterface and press "Update Zigbee firmware". Please refer to the manual of your particular Zigbee adapter for this functionality.
Flashing an existing adapter
The above flashing tools can be used to upgrade the firmware on an existing adapter without needing to repair devices. See the FAQ for information on what does and does not require repairing of devices.
Flashing Silabs EFR32/EM358x/ETRX35x based adapters
Firmware updates to Zigbee EmberZNet (EZSP) adapter based on EFR32, EM358x, and ETRX35x chips from Silicon Labs can be flashed over USB/UART by putting them in bootloader (BSL) mode. If your adapters has an EM358x or ETRX35x chip it will have an older/legacy Ember Bootloader (EBL) and you will need to see your adapter manual on how to put your adapter into bootloader mode, also known as boot mode or firmware recovery mode. After you have done this one of the following tools/guides can be used to flash it. If your adapter has a EFR32xG1 or EFR32MG2x chip adapters then it will have the newer Gecko Bootloader (GBL) that has the ability to enter bootloader mode automatically (also known as Auto-BSL) without need to pressing holding physical BTL/reset button or short circuit any GPIO/soldering-pads.
- Universal Silicon Labs Flasher (by Nabu Casa) (multi platform Python based command line tool)
- Manufacturers of SiLabs dongles can also offer SL Web Tools (web browser flasher).
- Elelabs Firmware Update Utility (multi platform Python based command line tool)
- walthowd husbzb-firmware script (community maintained multi platform bash script)
- Manual Xmodem sending commands over a terminal console (note that any terminal application with "Xmodem(N)" send can be used)
- Silicon Labs Simplicity Studio included "Flash Programmer" (instructions) (can't find your device? read below!)
- Additional programming options for Silicon Labs MCU based devices (info and links about other tools for developers or advanced users)
Is your OS unable to find your device?
If you're asking yourself "Why won't my dongle or adapter show up?" when you are using (for example) Flash Programmer 2, chances are that your OS can't communicate with your device over VCP (Virtual COM Port) serial port, causing your dongle not showing up as a flashable device. To fix this problem, be sure to install a USB-to-UART bridge/converter VCP driver for your operating system like the one at Silicon Labs, FTDI Chip, or WCH (CH34x/CH91xx).
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