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.

Gateway Sonoff Zigbee Bridge Pro sobre una mesa de trabajo con cables, a punto de flashear Tasmota
El contexto del flasheo: bridge abierto, adaptador serial y cableado. Imagen generada con Gemini 3 Pro Image siguiendo la dirección de arte de esta web; no es una foto del proceso real.

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

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:

Vídeo: Flashing Tasmota on SONOFF Zigbee Bridge Pro, de NotEnoughTECH en YouTube

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.

Qué camino elegir para este bridge
AspectoZHAZigbee2MQTT
Curva de inicioBaja, todo dentro de Home AssistantMedia, add-on y config aparte
Dispositivos rarosMenos control directoConverters, mejor soporte de rarezas
Referencia para este bridgeVídeo de Home Sight con el ZBBridgeRepo de PhillyGilly con Tasmota 12.5

Referencias verificadas

Fuentes que sostienen esta guía
FuenteFechaQué aporta
blakadder — ZBBridge-PvivoTemplate canónico y opción tasmota32-zbbrdgpro
PhillyGilly — GitHub2023/2024Camino Z2M con Tasmota 12.5, template alterno
Stephen Grier10/01/2024Flasheo paso a paso, mismo template 3552/3584
NotEnoughTECH10:53Flasheo del Pro en vídeo
Home Sight16:55ZHA 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.