Zigbee · Tasmota · Integración
Flashear Sonoff Zigbee Bridge Pro con Tasmota: template y ZHA/Zigbee2MQTT
Para convertir el Sonoff Zigbee Bridge Pro en un coordinador local necesitas un adaptador serial de 3,3 V, la opción tasmota32-zbbrdgpro del instalador web de Tasmota y el template que pego más abajo. Al final el bridge habla con Home Assistant por MQTT o TCP dentro de tu red, sin cuenta de Sonoff y sin nube.
Qué ganas con el flasheo
El bridge viene atado a eWeLink: para emparejar y gestionar dispositivos pasas por la nube de Sonoff. Con Tasmota encima, el radio Zigbee pasa a ser tuyo. Lo gestionas desde tu red, lo integras con Home Assistant y cortas una dependencia externa entera. Es el mismo argumento de siempre aquí: si la nube del fabricante cae o cierra, tu malla sigue funcionando.
Lo que necesitas
- Sonoff Zigbee Bridge Pro (el modelo Pro, con ESP32; esta guía no sirve para el ZBBridge original, que es ESP8266).
- Un adaptador USB-serial de 3,3 V con pines libres.
- Destornillador pequeño para abrir la carcasa y un par de cables dupont.
- Chrome o Edge con el instalador web de Tasmota.
1. Abre la carcasa y conecta el serial
El flasheo se hace por serial. Al abrir, localiza los pines de 3V3, GND, TX y RX; TX del adaptador va al RX del bridge y al revés. No publico un pinout de memoria: no he podido confirmarlo en mis fuentes a fecha de 03/11, y darte pines mal dados te deja con un bridge muerto. El vídeo de NotEnoughTECH de más abajo muestra la zona exacta y la conexión del Pro, y la página de blakadder lo documenta.
2. Flashea Tasmota
Abre el instalador web de Tasmota y elige tasmota32-zbbrdgpro. Es la variante preparada para el Pro, así que no uses la tasmota32 genérica: te saltas configuración que luego toca rehacer a mano. Tras el flasheo, Tasmota levanta un punto de acceso propio; conéctate y déjale tu WiFi local.
Los diez minutos de flasheo en vídeo, con el Pro delante, son más claros que cualquier descripción mía:
3. Flashea el firmware del radio (Zigbee2Tasmota)
blakadder lo marca como paso previo al template: primero Tasmota, después el firmware Zigbee en modo Zigbee2Tasmota y comprobar que funciona, y solo entonces aplicar la plantilla. Para el binario exacto de este paso, la página del ZBBridge-P en blakadder es la referencia; un comando de memoria sin comprobarlo antes no te lo voy a dar.
4. Aplica el template
En la consola de Tasmota ve a Configuration → Configure Template y pega esto:
{"NAME":"TCP ZBBridge Pro","GPIO":[0,0,576,0,480,0,0,0,0,1,1,5792,0,0,0,5472,0,320,5793,5504,0,640,608,32,0,0,0,0,0,1,0,0,0,0,0,0],"FLAG":0,"BASE":1}
Es el template canónico de blakadder para el ZBBridge-P. Guarda y reinicia.
Un detalle que importa y casi nadie explica: hay un segundo template circulando, el del repo de PhillyGilly y la guía de Stephen Grier (enero de 2024), que difiere del de blakadder en dos posiciones del array GPIO — 3552 y 3584 donde blakadder pone 5472 y 5504:
{"NAME":"Sonoff Zigbee Pro","GPIO":[0,0,576,0,480,0,0,0,0,1,1,5792,0,0,0,3552,0,320,5793,3584,0,640,608,32,0,0,0,0,0,1,0,0,0,0,0,0],"FLAG":0,"BASE":1}
Mi sospecha es que corresponde a otra revisión de hardware del Pro, pero sin el dispositivo delante no lo puedo confirmar a fecha de 03/11. Orden de trabajo: prueba primero el de blakadder, que es el más actualizado. Si el bridge no responde, carga el alternativo.
5. Conéctalo a Home Assistant
Con Tasmota y el template aplicados, el bridge ya es un coordinador. Quedan dos caminos:
ZHA
Es el camino más corto. Añade la integración de Zigbee en Home Assistant y elige el dispositivo Tasmota como coordinador, o deja que la integración Tasmota lo vea por MQTT y lo exponga. El vídeo de Home Sight que enlazo en referencias enseña el proceso con el ZBBridge original a secas; los pasos son análogos en el Pro, con la única diferencia de la opción del instalador que ya usamos arriba.
Zigbee2MQTT
Da más control sobre dispositivos raros, pero en este bridge conlleva más pasos. El repo de PhillyGilly documenta cómo dejar el Pro listo con Tasmota 12.5 y qué tocar. Con el bridge en modo Zigbee2Tasmota, Zigbee2MQTT le habla por TCP, así que el add-on puede correr en otro host de tu red.
| Aspecto | ZHA | Zigbee2MQTT |
|---|---|---|
| Curva de inicio | Baja, todo dentro de Home Assistant | Media, add-on y config aparte |
| Dispositivos raros | Menos control directo | Converters, mejor soporte de rarezas |
| Referencia para este bridge | Vídeo de Home Sight con el ZBBridge | Repo de PhillyGilly con Tasmota 12.5 |
Referencias verificadas
| Fuente | Fecha | Qué aporta |
|---|---|---|
| blakadder — ZBBridge-P | vivo | Template canónico y opción tasmota32-zbbrdgpro |
| PhillyGilly — GitHub | 2023/2024 | Camino Z2M con Tasmota 12.5, template alterno |
| Stephen Grier | 10/01/2024 | Flasheo paso a paso, mismo template 3552/3584 |
| NotEnoughTECH | 10:53 | Flasheo del Pro en vídeo |
| Home Sight | 16:55 | ZHA con Tasmota en el ZBBridge (modelo anterior) |
Transparencia: esta guía está montada desde fuentes públicas, no desde un flasheo propio — no tengo el dispositivo delante. Lo verificado lleva su fuente; lo que no he podido confirmar (pinout exacto, a qué revisión corresponde cada template) está marcado como tal.
Suscríbete
Cada domingo un YAML nuevo ya probado y el aviso cuando una integración local se rompe tras actualizar. Lo prometido existe: mira las plantillas YAML.
Última revisión y cambios
Última revisión: 03/11. Primera publicación de esta guía.
Changelog: 03/11 — pieza nueva; template de blakadder, template alterno de PhillyGilly, flujo SVG y vídeo de flasheo incorporados.
Suscríbete
El aviso cuando una integración local se rompe tras actualizar, y un YAML probado cada domingo. Pruebas reales, no novedades: mira lo prometido.