Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clearify recommended vs no longer recommended adapters #614

Open
wants to merge 2 commits into
base: dev
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 29 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,19 +13,35 @@ bellows interacts with the Zigbee Network Coprocessor (NCP) with EmberZNet PRO Z

## Hardware requirement

EmberZNet based Zigbee radios using the EZSP protocol (via the [bellows](https://github.com/zigpy/bellows) library for zigpy)
- [Tube's Zigbee Gateways (Silabs EFR32 variant)](https://github.com/tube0013/tube_gateways) Note! ESP32 based Ethernet bridge available as pre-assembed or as a DIY project.
- [ITEAD Sonoff ZBBridge](https://www.itead.cc/smart-home/sonoff-zbbridge.html) (**Note! WiFi-based bridges are not recommended for ZHA with EZSP radios.** Also, this first have to be flashed with [Tasmota firmware and EmberZNet firmware](https://www.digiblur.com/2020/07/how-to-use-sonoff-zigbee-bridge-with.html))
- ITead Zigbee 3.0 USB Dongle (EFR32MG21) Model 9888010100045 Note! Currently not recommended due to stability issues.
- [Nortek GoControl QuickStick Combo Model HUSBZB-1 (Z-Wave & Zigbee Ember 3581 USB Adapter)](https://www.nortekcontrol.com/products/2gig/husbzb-1-gocontrol-quickstick-combo/) (Note! Not a must but recommend [upgrade the EmberZNet NCP application firmware](https://github.com/walthowd/husbzb-firmware))
- [Elelabs Zigbee USB Adapter](https://elelabs.com/products/elelabs_usb_adapter.html) (Note! Not a must but recommend [upgrade the EmberZNet NCP application firmware](https://github.com/Elelabs/elelabs-zigbee-ezsp-utility))
- [Elelabs Zigbee Raspberry Pi Shield](https://elelabs.com/products/elelabs_zigbee_shield.html) (Note! Not a must but recommend [upgrade the EmberZNet NCP application firmware](https://github.com/Elelabs/elelabs-zigbee-ezsp-utility))
- [DEFARO SprutStick Pro (also known as Defaro SprutStick ZigBee 2 Pro)](https://defaro.ru/index.php/product/89-controllers/257-sprutstick-pro)
- Telegesis ETRX357USB/ETRX357USB-LRS/TRX357USB-LRS+8M (Note! This first have to be [flashed with other EmberZNet firmware](https://github.com/walthowd/husbzb-firmware))
- [IKEA Billy EZSP - DIY ICC-1 / ICC-A-1 module from IKEA TRÅDFRI devices](https://github.com/MattWestb/IKEA-TRADFRI-ICC-A-1-Module). (Note! This first have to be hacked and flashed with other EmberZNet firmware)
- [Tuya TYGWZ01 and rebranded Lidl Silvercrest Smart Home Gateway](https://paulbanks.org/projects/lidl-zigbee/) (Note! This first have to be hacked and flashed with other EmberZNet firmware)
- Bitron Video/Smabit BV AV2010/10 USB-Stick (a.k.a. Telekom Magenta Stick) based on Silicon Labs Ember 3587
- [EByte E180-Z120B SMD Module and EByte E180-Z120B-TB Evaluation Board](https://www.cnx-software.com/2020/04/27/ebyte-e180-zg120b-tb-zigbee-3-0-evaluation-board-features-silicon-labs-efr32mg1b-zigbee-thread-soc/) (Note! This first have to be [hacked and flashed with other EmberZNet firmware](https://github.com/zha-ng/EZSP-Firmware/tree/master/EByte-E180-Z120B))
This [bellows](https://github.com/zigpy/bellows) radio library for zigpy should be compatible with all EmberZNet based Zigbee radio adapters and modules with a firmware that support EZSP (EmberZNet Serial Protocol).

This tecnically includes the newer EFR32MG24, EFR32MG21/MGM210, EFR32MG13, EFR32MG12/MGM12 from Silicon Labs, as well as Silabs older EM35x/EM35xx (EM357, EM3581, EM3585, EM3587, EM3588) "Ember" family of chips.

Newer series of radio adapters and modules are generally recommended as Silicon Labs still maintains SDK for them so it is possible to get new firmware with bug-fixes and new features.

### EZSP adapters recommended for new purchase

- [Home Assistant SkyConnect](https://www.home-assistant.io/skyconnect/) (USB dongle based on EFR32MG21)
- [ITead SONOFF Zigbee 3.0 USB Dongle Plus Model “ZBDongle-E”](https://itead.cc/product/zigbee-3-0-usb-dongle/) (USB dongle based on EFR32MG21)
- [Easyiot Zigbee dongle model ZB-GW04](https://zigbee.blakadder.com/easyiot_ZB-GW04.html) (USB stick based on EFR32MG21 "SM-011 v1.0" Zigbee module from CoolKit-Technologies)
- [Zvidar Z-DG-Z01](https://zigbee.blakadder.com/Zvidar_Z-DG-Z01.html) (USB dongle based on EFR32MG21)
- [Tube's Zigbee Gateways (Silabs EFR32 variant)](https://github.com/tube0013/tube_gateways) Note! ESP32 based Ethernet bridge available as pre-assembed or as a DIY project.

### Other supported EZSP adapters not recommended for new purchase

- [IKEA Billy EZSP - DIY ICC-1 / ICC-A-1 module from IKEA TRÅDFRI devices](https://github.com/MattWestb/IKEA-TRADFRI-ICC-A-1-Module). (Note! This first has to be hacked and flashed with other EmberZNet firmware)
- [Tuya TYGWZ01 and rebranded Lidl Silvercrest Smart Home Gateway](https://paulbanks.org/projects/lidl-zigbee/) (Note! This first have to be hacked and flashed with other EmberZNet firmware)
- [ITEAD Sonoff ZBBridge](https://www.itead.cc/smart-home/sonoff-zbbridge.html) (**Note! WiFi-based bridges are not recommended for ZHA with EZSP radios.** Also, this first has to be flashed with [Tasmota firmware and EmberZNet firmware](https://www.digiblur.com/2020/07/how-to-use-sonoff-zigbee-bridge-with.html))

### Older supported EZSP adapters no longer recommended for new purchase

The adapters below are support and still work well for legacy installations but use outdated chips and firmware is no longer maintained:

- [Elelabs Zigbee USB Adapter ELU013](https://elelabs.com/products/elelabs_usb_adapter.html) (USB dongle based on EFR32MG13P)
- [Nortek GoControl QuickStick Combo Model HUSBZB-1 (Z-Wave & Zigbee Ember 3581 USB Adapter)](https://www.nortekcontrol.com/products/2gig/husbzb-1-gocontrol-quickstick-combo/) (Note! Should first [upgrade the EmberZNet NCP application firmware](https://github.com/walthowd/husbzb-firmware))
- Bitron Video/Smabit BV AV2010/10 USB-Stick (a.k.a. Telekom Magenta Stick) based on Silicon Labs Ember 3587
- [Elelabs Zigbee Raspberry Pi Shield ELR023](https://elelabs.com/products/elelabs_zigbee_shield.html) (Raspberry Pi Shield/HAT not generally recommended due to interference)
- Telegesis ETRX357USB/ETRX357USB-LRS/TRX357USB-LRS+8M (Note! Has to be manually [flashed with other EmberZNet firmware](https://github.com/walthowd/husbzb-firmware))

### Warning about Zigbee to WiFi bridges

Expand Down
Loading