Zigbee2MQTT

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

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)

Other

  • ConBee / ConBee II / ConBee III / RaspBee / RaspBee II

    USB connected adapters (ConBee / ConBee II / ConBee III) 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

    Add the correct baudrate to the configuration.yaml into the serial section.

    • For ConBee2: specifying the baudrate is not necessary
    • For RaspBee2 it is 38400
    • For ConBee3 it is 115200

    Note: The support for Conbee 3 is not yet in the main branch (as of 2023/11/23). If you have a Conbee 3 stick, please use the dev-branch.


    Warning: Conbee 2 firmware versions newer than 0x26580700 will result in an unstable network with devices dropping randomly, see Issue 9554open in new window

The adapters below are well-supported but use outdated chips.

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 (Network Co-Processor, Zigbee only) firmware as opposed to the RCP (Radio Co-Processor, multi-protocol) firmware. It is recommended you remain on an NCP firmware which will allow it to work out-of-the-box like any other EZSP adapter.

      While the RCP firmware allows you to utilize the adapter with other protocols such as Thread, it requires offloading large parts of the application onto the host computer using an additional service, Zigbeed (Zigbee daemon) instead. This service is not currently included with Zigbee2MQTT/zigbee-herdsman and you will be required to install and maintain the dependency yourself. More discussion can be found hereopen in new window.

      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

    • 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)open in new window and it using pre-flashed "SM-011 V1.0" (ZYZBP008) radio module from CoolKit-Technologiesopen in new window (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 relatively 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

    • SMLIGHT SLZB-07 Zigbee USB adapter with +3dB antenna

      Zigbee USB adapter with +3dB external antenna and Thread/Matter-over-Thread ready.

      Zigbee USB adapter based on EFR32 and CP2102 Silicon Labs SoCs. External +3dB antenna secures a strong LQI signal all around your place. Pre-flashed, tested and and ready-to-use with both Zigbee2MQTT and ZHA Home Assistant. Supports Thread/Matter-over-Thread firmware architecture for the EmberZNet Zigbee protocol stack.

      Zigbee2MQTT settings in configuration.yaml

      serial:
  adapter: ezsp

    • JetHome JetStick Z4

      Powerful EFR32MG21 based factory-made Zigbee USB dongle with external antenna.

  • Raspberry Pi

  • 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

    • SMLIGHT SLZB-06M EFR32MG21 Zigbee Ethernet USB POE WiFi LAN adapter

      Powerful, 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-06M 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 buttons for interacting with the user. It fits home and business use.

  • 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

  • Hub

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

    • JetHome JetHub D1+

      Controller with ZigBee module onboard with external antenna.

      JetHub D1+ is DIN-rail home automation controller with Ubuntu/Debian OS and a lot of peripherals.

      Based on Silabs EFR32MG21.

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 with R/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 between CC1352 and CC2652.
    • Chips ending with RB don't require a crystal on the PCB, this only makes a difference for the manufacturing process.

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.

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 FAQopen in new window 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.

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 Labsopen in new window, FTDI Chipopen in new window, or WCH (CH34x/CH91xx)open in new window.

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