antena
Photo by Gontran Isnard on Unsplash

Integración Zigbee con Home Assistant

Nos iniciamos en uno de los aspectos más potentes de nuestro sistema domótico: La integración de sensores Zigbee en Home Assistant…. con Paciencia

Son varios pasos, pero creo que es importante primero dar una visión por encima de las opciones disponibles.

Zigbee es un protocolo. No es mi más ni menos que eso, una forma como otra de comunicar entre dispositivos, pero tiene cierras ventajas respecto a otros protocolos usados en IOT. El mercado para el hogar finalmente se va decantando (por ahora) principalmente por tres de ellos:

  • Zigbee
  • Z-Wave
  • WiFi

Quizás el más conocido en otros ámbitos es WiFi. Es muy cómodo comprar una bombilla con WiFi, conectarla a nuestra red, instalar alguna aplicación del fabricante y voila!

Todo bien si solo tuviéramos una bombilla o unas pocas.

Os imagináis una casa con 10 bombillas WiFi + 5 enchufes WiFi + 3 niños conectados con sus móviles + 2 tablets + un libro electrónico + 2 televisores + 3 Fire sticks + …. Ya cogéis la idea…. la red estará más saturada que Tarifa en verano.

Piensa en la saturación de dispositivos WiFi. Además no formarán una malla por lo que tendremos problemas de cobertura en algunas ocasiones

Los otros dos protocolos ( Z-Wave y Zigbee ) resuelven ese problema y además el del consumo de forma muy eficiente. Crean una malla entre ellos para llegar a un dispositivo central que llamado Coordinador y que conectaremos a nuestra Raspberry Pi con HA funcionando.

Además, todo dispositivo Zigbee en HA alimentado de nuestra red eléctrica (un enchufe por ejemplo) hará de router automáticamente.

Ambos, Zigbee y Z-Wave, disponen de muchos dispositivos compatibles. Z-Wave tiene un alcance algo mayor entre nodos, pero su competidor es que es un estándard abierto y se puede usar libremente, mientras que Z-Wave está controlado por un conjunto de empresas.

Nosotros nos hemos decantado por Zigbee sobre todo porque su coordinador (uno de los posibles que podemos usar) es bien conocido y muy barato. Se trata del cc2531 con conector USB:

Lo podéis comprar por poco dinero con el último firmware ya preinstalado y así os ahorráis el equipo necesario para flashearlo. De cualquier forma os dejo el enlace oficial que explica todo lo necesario: https://www.zigbee2mqtt.io/information/flashing_the_cc2531.html


Existen otros coordinadores, algunos con más potencia, con antenas externas con extensión, otros que incluso llevan integrados los dos protocolos… Pero el más conocido y del que encontraréis más información es el veterano cc2531 o alguno de sus clones.

Está pequeña maravilla nos servirá para conectar nuestros dispositivos en Home Assistant (sigue leyendo que ahora vamos con algún ejemplo concreto)

Al final de esta guía tendremos un dispositivo instalado y funcionando (en concreto un enchufe de la marca Blitzwolf con medidor de consumo)

Para empezar, y no gastar más de la cuenta, os recomiendo revisar esta entrada: https://www.pacienciadigital.com/4-dispositivos-zigbee-baratos/

Los pasos serán los siguientes:

Paso 1. Conectamos nuestro coordinador cc2531

Evidentemente hay un paso previo de instalación de Home Assistant en uno de los varios equipos posibles. Os dejo el post donde explicamos cómo instalarlo en una Raspberry PI.

Solo tendremos que pincharlo en algún USB libre de nuestra Raspberry PI o equipo equivalente que estemos usando para HA. Las luces verdes nos indicarán que está todo correcto. En todo caso el botón de reset es el que está más cercano al puerto USB.


Paso 2. Instalación de Zigbee2MQTT y Mosquitto

La cosa la vamos a complicar un poco (no mucho) introduciendo MQTT. MQTT es otro protocolo de comunicación de mensajes para dispositivos IOT muy utilizado, no solo en el ámbito de nuestro HA, sino también en otras plataformas desde Google hasta Amazon.

Usaremos por tanto un software que convertirá nuestros mensajes Zigbee en MQTT, actuando como pasarela.

Por último, en nuestro caso con Home Assistant, lo único necesario será un software concentrador (broker) que gestione esos mensajes MQTT para las diferentes aplicaciones (como ejemplo Node-Red de IBM). El más popular es Mosquitto Broker, de código abierto.

Resumiendo, necesitaremos instalar Zigbee2MQTT y Mosquitto Broker. Luego todo será mucho más fácil como veremos.

Primero instalareoms Mosquitto Broker. Desde la pantalla Supervisor > Add-on Store y buscando el complento, lo instalaremos pero todavía no lo arrancaremos:

Zigbee en Home Assistant

Le dejamos por defecto como siembre que arranque al inicio y que si en alguna ocasión para intente arrancarlo.


Ahora buscaremos el otro complemento (zigbee2mqtt) pero al no venir en el repositorio por defecto tendremos primero que decirle al sistema dónde encontrarlo:

 Supervisor > Add-on store y en menú (con los 3 puntos), elegimos repositories

Tendremos que agregar un nuevo repositorio: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

Ahora sí, buscaremos e instalaremos Zigbee2MQTT:

Ojo a la opción OPEN WEB UI que la usaremos luego, ya veréis que chulo.

Paso 3. Emparejando un dispositivo

En teoría ya está todo preparado, vamos a realizar el emparejamiento de un dispositivo.

En este caso hemos elegido un enchufe inteligente Blitzwolf que es una de las otras marcas con las que juega Tuya.

En concreto se trata del modelo BW-SHP13, pero en Amazon podéis encontrar un modelo equivalente:

Vamos a establecer un modo «escucha» en el que nuestro sistema estará listo para agregar cualquier dispositivo que quiera emparejarse. Para ello entramos de nuevo en la ventana principal de nuestro Zigbee2MQTT add-on y ahora sí elegimos la opción OPEN WEB UI. Nos debe salir un listado por ahora vacío:

En el menú Settings activaremos la opción Permit join:


Solo nos queda enchufar nuestro enchufe intelignte Blitzwolf, y dejar pulsado unos segundos el único botón que trae.

Tras un breve tiempo veréis en el menú devices inicial de Zigbee2MQTT Add-on nuestro nuevo dispositivo:

Y eso es todo. El proceso de instalación de lo necesario lleva un poco de tiempo, pero compensa por lo fácil que es ir agregando nuevos dispositivos.

Dos consejos importantes:

  • No dejar activada la opción Permit join por defecto. Por seguridad
  • Mejor renombrar ahora el nombre de nuestro dispositivo. Lo vemos en detalle:

Para renombrar nuestro dispositivo (device) y todas sus variables (entities), simplemente pinchamos en él y pulsmos el icono azul para renombrarlo:

Le damos el nombre representativo que queramos y activamos la opción de actualizar las entidades:

Para representarlo, lo más sencillo es ir al menú Configuration > Devices. Buscaremos nuestro Enchufe Blitzwolf-1 y ADD TO LOVELACE:

Veis que viene muy completo. Otra opción muy intersante la encontramos en el menú Map de la interface gráfica de Zigbee2MQTT, donde podremos ver la malla que se ha autogenerado:

Os vamos a dejar una selección que hemos realizado de otros dispositivos zigbee realmente baratos para lo que ofrecen:

Si quieres conocer más acerca de las frecuencias de trabajo de Zigbee y sus posibles interferencias con Wifi, puedes leer este post donde se analiza la mejora conseguida con un extensor.

En otro post veremos cómo añadirle un contador de energía consumida en kwh de reseteo mensual, y cómo incluirle el coste real exacto acumulado de cada mes, tanto si tienes pvpc como si no:

Otras entradas que te pueden interesar:

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *