Logo
Model ZBBridge manufactured by Sonoff
Zigbee Bridge
Supports:
coordinator
Available from:
Itead.cc
Aliexpress.com
Banggood.com
Manufacturer:
Itead.cc
Zigbee ID: ""
Confirmed working with

Flash ESP8266

Remove the 4 rubber feet to access screws and disassemble the device. Take out the PCB and connect breadboard cables to labelled pin holes (if you only have Dupont wires you will need to solder them since the holes are too small for them).

ZBBridge pinout

ZbBridge Adapter
ETX RX
ERX TX
IO0 GND
GND GND
3v3 3V3/VCC

Download tasmota-zbbridge, a unique binary built specifically for ZBBridge and flash it using your favorite flashing software.

When the ZbBridge is flashed with Tasmota, disconnect all breadboard wires and power the board using its USB port with a 5V 1A power supply. Configure Wi-Fi over Tasmota AP (you cannot configure the device over serial with this binary). After it is connected to your network access the webUI again.

Flash Zigbee module

Download Zigbee module firmware ncp-uart-sw_6.7.6_115200.ota from Tasmota GitHub located in Tasmota/tools/fw_zbbridge/.

Go to Firmware Upgrade and next to “Upgrade by file upload” use the Choose File button and select Zigbee module firmware you downloaded (ncp-uart-sw_6.7.6_115200.ota).

ZBBridge Zigbee module flash

Click on Start upgrade, be patient and wait for a few minutes until flashing is complete. Once it is done, Tasmota will reboot. If the flash was successful the console will show Zigbee2Tasmota starting:

16:31:11 ZIG: Resetting EZSP device
16:31:12 RSL: tele/zbbridge/RESULT = {"ZbState":{"Status":1,"Message":"EFR32 booted","RestartReason":"Power-on","Code":2}}
16:31:12 RSL: tele/zbbridge/RESULT = {"ZbState":{"Status":55,"Version":"6.7.6.0","Protocol":8,"Stack":2}}
16:31:12 RSL: tele/zbbridge/RESULT = {"ZbState":{"Status":3,"Message":"Configured, starting coordinator"}}
16:31:13 RSL: tele/zbbridge/RESULT = {"ZbState":{"Status":56,"IEEEAddr":"0x80E423FFFE225691","ShortAddr":"0x0000","DeviceType":1}}
16:31:14 ZIG: Subscribe to group 0 'ZbListen0 0'
16:31:14 RSL: tele/zbbridge/RESULT = {"ZbState":{"Status":0,"Message":"Started"}}
16:31:14 ZIG: Zigbee started
16:31:14 ZIG: No zigbee devices data in Flash

Follow further instructions depending on your chosen method.

For Zigbee2Tasmota

You can start pairing Zigbee devices with ZbPermitJoin 1 command.

Read Zigbee documentation for complete guide to pairing and managing your devices.

Sonoff ZbBridge (75) is set as the default module. If you’re switching back to Zigbee2Tasmota from ZHA make sure module is configured back to 75.

For Home Assistant (ZHA)

This mode creates a TCP bridge from the zigbee module to Home Assistant. In this case Tasmota is only relaying all the messages from the zigbee module to ZHA and you cannot use any Zigbee commands in Tasmota console in this mode. All setup needs to be done from Home Assistant ZHA integratioon.

After Zigbee firmware is flashed and confirmed working in ZIgbee2Tasmota mode, apply the template:

{"NAME":"ZHA ZBBridge","GPIO":[56,208,0,209,59,58,0,0,0,0,0,0,17],"FLAG":0,"BASE":18}

Create a rule in Tasmota to start TCPBridge on boot:

Rule1 ON System#Boot do TCPStart 8888 endon

You can change 8888 to a port you prefer.

Enable rule with Rule1 1 and restart ZbBridge.

In Home Assistant (requires version 0.113+) go to Configuration - Integrations, click the + icon, search for ZHA integration and select it.

ZBBridge ZHA Configuration

  1. choose “Enter Manually” for serial port
  2. for Radio Type choose “EZSP”
  3. under Serial device path enter socket://[zbbridge_ip]:8888 replacing [zbbridge_ip] with its IP address. Do not use hostnames.
    • if you changed the port number use yours
    • set port speed to “115200”
  4. when the ZbBridge is discovered you will get a confirmation message

ZBBridge ZHA Configuration