Supported adapters #
Zigbee2MQTT officially supports the following adapters:
|Electrolama zig-a-zig-ah! (zzh!) (recommended)||USB connected adapter with external antenna||Coordinator
|Slaesh's CC2652RB stick (recommended)||USB connected adapter with external antenna, currently long shipping times||Coordinator
|Texas Instruments CC2531||USB connected Zigbee adapter with PCB antenna||
|Texas Instruments CC2530||Serial connected adapter with external antenna optionally with CC2591 or CC2592 RF frontend||
|Flashing Connecting||AliExpress GBAN Tindie|
|Texas Instruments CC2538 PCB||Serial connected adapter with CC2592 RF Amplifier||
|Texas Instruments CC2538 HAT||Raspberry pinout compatible HAT with CC2538 and optional external antenna||
|Texas Instruments LAUNCHXL-CC26X2R1||USB connected development kit||Coordinator
|Texas Instruments LAUNCHXL-CC1352P-2||USB connected development kit||Coordinator
|ConBee II (experimental)||USB connected adapter||Coordinator
|ZiGate USB-TTL (experimental)||USB connected adapter based on NXP JN516x (JN5168/JN5169), 3.1d firmware or later required||Coordinator
|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
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 Electrolama zig-a-zig-ah! (zzh!) (= based on CC2652R chip), Slaesh’s CC2652RB stick (= based on CC2652RB chip), Texas Instruments LAUNCHXL-CC26X2R1 (= based on CC2652R chip) and Texas Instruments LAUNCHXL-CC1352P-2 (= based on CC1352P chip) are very similar to each other since (almost) the same chip is used. The difference between the CC2652R and the CC1352P is that the CC1352P support sub-1 GHz frequency (which is not relevant for Zigbee since it uses 2.4 GHz) and that the CC1352P has a power amplifier (which support up-to 20dBm output vs 5dBm on CC2652R(B)). 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. The ones with external antenna provide more range.
- 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_idin 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
serial: adapter: deconz # deconz for Conbee II OR "zigate" for the ZiGate USB-TTL
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
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).