# Sonoff ZBridge Pro



# Hardware & Manuals

#### **Packaging**

[![top.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/top.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/top.jpg)[![bottom.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/bottom.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/bottom.jpg)

[![left.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/left.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/left.jpg)

[![right.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/right.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/right.jpg)

#### **Content**

[![overview.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/overview.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/overview.jpg)

1x Quickstart Guide ([quick\_start\_guide\_zigbee\_bridge\_pro.pdf](https://bookstack.greinet.com/attachments/357))

1x Reset Pin

1x MicroUSB Cable

1x Sonoff ZigBee Bridge Pro

#### **Manuals**

- [product\_spezification\_zigbee\_bridge\_pro.pdf](https://bookstack.greinet.com/attachments/360)
- [user\_manual\_zigbee\_bridge\_pro.pdf](https://bookstack.greinet.com/attachments/361)

# Flash Tasmota

#### **Step 1: Open ZbBrige Pro**

[![zbridge bottom.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/zbridge-bottom.jpg)c](https://bookstack.greinet.com/uploads/images/gallery/2023-07/zbridge-bottom.jpg)

Remove the rubber feets by using e.g. a scalpel at the bottom and unscrew the 4 small phillips screws beneath.

#### **Step 2: Prepare board**

[![zbridge_board_top.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/zbridge-board-top.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/zbridge-board-top.png)

Solder 5 pins to the GND, GPIO0, RX,TX and 3V pinholes.

#### **Step 3: Connect USB-to-TTL adapter**

[![zbridge_ttl_adapter_connect.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/zbridge-ttl-adapter-connect.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/zbridge-ttl-adapter-connect.png)

Connect using the following layout:

<table border="1" id="bkmrk-zbbridge-usb-to-ttl-" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 50%;">**ZbBridge**</td><td style="width: 50%;">**USB-to-TTL adapter**</td></tr><tr><td style="width: 50%;">3V3</td><td style="width: 50%;">3V3

</td></tr><tr><td style="width: 50%;">TX</td><td style="width: 50%;">RX</td></tr><tr><td style="width: 50%;">RX</td><td style="width: 50%;">RX</td></tr><tr><td style="width: 50%;">GPIO0</td><td style="width: 50%;">GND</td></tr><tr><td style="width: 50%;">GND</td><td style="width: 50%;">GND</td></tr></tbody></table>

#### **Step 4: Flash Tasmota**

**<span style="text-decoration: underline;">Option 1: Webinterface</span>**

[![tasmota-web-install.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/tasmota-web-install.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/tasmota-web-install.png)

Go to the [Tasmota install website](https://tasmota.github.io/install/) and select the options T**asmota32 Sonoff-ZigbeeBridgePro** and **All**, press connect and flash the firmware.

<span style="text-decoration: underline;">**Option 2: Manual install via Tasmotizer (not verified)**</span>

<span style="text-decoration: underline;">[![tasmotizer.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/tasmotizer.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/tasmotizer.png)</span>

Download the newest version of the Tasmota firmware for Zigbee Bridge Pro and flash using the Tasmotizer application ([tasmotizer-1.2.exe](https://bookstack.greinet.com/attachments/359)).

(Used version at date of creation: [tasmota32-zbbrdgpro.bin](https://bookstack.greinet.com/attachments/358))

#### **Step 5: Flash ZigBee Coordinator**

Plug in the device and head over to the Tasmota web interface. Then continue to **Consoles** &gt; **Berry Scripting console** and input the following to very the flash files for the ZigBee Coordinator chip:

```JavaScript
import sonoff_zb_pro_flasher as cc
cc.load("SonoffZBPro_coord_20220219.hex")
cc.check()
```

After getting a positive verification response contine to flash with the following command:

```JavaScript
cc.flash()
```

Now the Tasmota will become unresponsive for approximately 5 minutes, after that yet again a positive response should appear in the console (you might need to reload the website). Then restart the Tasmota device and head into the normal console, there should be messages regarding the ZigBee device now.

#### **Step 6: Configure template**

As a last step go to **Configuration** &gt; **Auto configuration** and select and apply the **Sonoff ZBPro** configuration.

##### **Credits**

I followed [Julian Decker's installation guid](https://atlane.de/sonoff-zigbee-bridge-pro-tasmota-flashing-und-homeassistant-integration/)e closely for the most parts, so have a look there if you need more detailed information.

# Using Tasmota

#### **Pair and name devices**

Using the Tasmota web interface, press **Zigbee Permit Join** to allow new devices to be paired. Now you can pair your new device and it will show up in the list with a name like **0x8C19**<span title="0x6CAD lumi.remote.b186acn01 - LUMI">. To more easily identify the devices later on, copy the name and head to the Tasmota console. Their use the following command to set a friendly name for the device.</span>

```HTML
ZbName 0x8C19,osram_bulb
```

#### **Group devices**

You can assign a group ID (default: 0) for each device to control multiple devices simulaneously.

```
ZbSend {"device":"osram_bulb","Send":{"AddGroup":100}}
```

#### **Send values to devices**

With the console you can also control your devices by sending values manually.

```
zbsend {"device":"0x96A2","send":{"power":true}}
```

Or control a whole group of devices.

```
zbsend {"group":"100","send":{"power":true}}
```

<table border="1" id="bkmrk-device-id-name-group" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 28.7654%;">Device ID</td><td style="width: 27.4692%;">Name</td><td style="width: 18.7962%;">Group</td><td style="width: 24.9692%;">Label</td></tr><tr class="ztd htr"><td style="width: 28.7654%;"><span title="0x6CAD lumi.remote.b186acn01 - LUMI">0x6CAD</span></td><td style="width: 27.4692%;">aqara-rocker-switch-1-ZB</td><td style="width: 18.7962%;">0</td><td style="width: 24.9692%;">Aqara\_Rocker\_Switch\_Zigbee</td></tr><tr><td style="width: 28.7654%;">0x9685</td><td style="width: 27.4692%;">osram\_smartplus\_bulb\_1\_ZB</td><td style="width: 18.7962%;">100</td><td style="width: 24.9692%;">1</td></tr><tr><td style="width: 28.7654%;">0x452B</td><td style="width: 27.4692%;">osram\_smartplus\_bulb\_2\_ZB</td><td style="width: 18.7962%;">100</td><td style="width: 24.9692%;">2</td></tr><tr><td style="width: 28.7654%;">0x3679</td><td style="width: 27.4692%;">osram\_smartplus\_bulb\_3\_ZB</td><td style="width: 18.7962%;">100</td><td style="width: 24.9692%;">3</td></tr><tr><td style="width: 28.7654%;">0xC5E5</td><td style="width: 27.4692%;">osram\_smartplus\_bulb\_4\_ZB</td><td style="width: 18.7962%;">100</td><td style="width: 24.9692%;">4</td></tr></tbody></table>

```C++
Rule1
on ZbReceived#?#Name do var1 %value% endon
on ZbReceived#?#Power do Publish stat/zbridge_pro/%var1%/power "%value%" endon
on ZbReceived#?#Dimmer do Publish stat/zbridge_pro/%var1%/dimmer "%value%" endon


Rule3
on ZbReceived#?#Name do var1 %value% endon
on ZbReceived#?#Click do publish stat/zbridge_pro/%var1%/click %value% endon
```

# Current Setup

**Device list**

<table border="1" id="bkmrk-device-id-name-group" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 28.7654%;">Device ID</td><td style="width: 27.4692%;">Name</td><td style="width: 18.7962%;">Group</td><td style="width: 24.9692%;">Label</td></tr><tr class="ztd htr"><td style="width: 28.7654%;"><span title="0x6CAD lumi.remote.b186acn01 - LUMI">0x6CAD</span></td><td style="width: 27.4692%;">aqara-rocker-switch-1-ZB</td><td style="width: 18.7962%;">0</td><td style="width: 24.9692%;">Aqara\_Rocker\_Switch\_Zigbee</td></tr></tbody></table>

**Tasmota Rules**

```C++
Rule1
on ZbReceived#?#Name do var1 %value% endon
on ZbReceived#?#Power do Publish stat/zbridge_pro/%var1%/power "%value%" endon
on ZbReceived#?#Dimmer do Publish stat/zbridge_pro/%var1%/dimmer "%value%" endon


Rule3
on ZbReceived#?#Name do var1 %value% endon
on ZbReceived#?#Click do publish stat/zbridge_pro/%var1%/click %value% endon
```