🌐 Zigbee2MQTT en un PC Diferente o en Hyper-V: Guía Completa

Recursos Necesarios y Hardware

Para este tutorial hemos utilizado el siguiente material, cuyos enlaces directos tienes aquí:

• Coordinador Zigbee: Sonoff Zigbee 3.0 USB Dongle Plus (Modelo P). Es el más compatible y el que usamos en las pruebas. En Amazon o en Aliexpress
• Drivers CP210x: Necesarios para que Windows reconozca el dongle. Descárgalos aquí.
• Node.js: Necesario para ejecutar Zigbee2MQTT. Descarga la versión recomendada (LTS).

1. Instalación de Zigbee2MQTT en Windows

Una vez instalados los drivers y Node.js, sigue estos pasos:

1. Guía de instalación en Windows de Zigbee2MQTT: https://www.zigbee2mqtt.io/guide/installation/05_windows.html
2. Descarga el repositorio: Como el comando directo a veces falla, descarga el ZIP de Zigbee2MQTT desde su GitHub oficial y descomprímelo en una carpeta (ej: C:\zigbee2mqtt).
3. Instala las dependencias: Abre PowerShell, navega hasta la carpeta y ejecuta:

npm ci

2. Configuración del archivo configuration.yaml

Este es el punto más crítico. Debes editar el archivo data/configuration.yaml. Aquí tienes el código exacto que debes usar, prestando especial atención al formato del puerto en Windows:

configuration.yml base de Zigbee2MQTT:
# Home Assistant integration (MQTT discovery)
homeassistant: true

# Enable the frontend, runs on port 8080 by default
#Usar esta línea si NO se utiliza https:
frontend: true 
#utilizar esta línea si se utiliza https:
frontend:
  ssl_cert: E:\HyperV\zigbee2mqtt\ssl\fullchain.pem
  ssl_key: E:\HyperV\zigbee2mqtt\ssl\privkey.pem

# MQTT settings
mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://192.168.1.30:1883
  user: 
  password: 
  reject_unauthorized: false

# Serial settings
serial:
  # Location of CC2531 USB sniffer
  port: \\.\COM3

# Advanced settings
advanced:
  # Let Zigbee2MQTT generate a network key on first start
  network_key: GENERATE
  # Let Zigbee2MQTT generate a pan_id on first start
  pan_id: GENERATE
  # Let Zigbee2MQTT generate a ext_pan_id on first start
  ext_pan_id: GENERATE

Importante:

• El puerto en Windows se escribe siempre con el prefijo \\.\.
• Si usas HTTPS en Home Assistant, para integrar el panel deberás configurar los certificados en la sección frontend del YAML apuntando a tus archivos .crt y .key.

3. Integración en el Panel de Home Assistant

Para ver la interfaz de Zigbee2MQTT directamente en Home Assistant, crea un panel de tipo Página Web (Iframe) con la URL http://IP_DE_TU_PC:8080.

Solución de problemas comunes:

• Firewall de Windows: Debes crear una "Inbound Rule" (Regla de entrada) para permitir el tráfico en el puerto 8080 (TCP).
• Red Pública/Privada: Asegúrate de que tu red esté configurada como Privada en Windows para permitir la visibilidad entre equipos.

4. Ejecución Automática al Arrancar Windows

Para que el sistema sea robusto, configuramos una Tarea Programada:

1. Crea una tarea que se ejecute al iniciar el sistema (independientemente de si hay sesión iniciada).
2. Acción: Iniciar un programa.
3. Programa/script: cmd
4. Argumentos: /c "cd C:\ruta\a\tu\carpeta && npm start"

Conclusión

Gracias a este método, tu Zigbee2MQTT funcionará de forma independiente, enviando todos los datos vía MQTT a tu Home Assistant, sin importar si este corre sobre Hyper-V o está en la otra punta de la casa.

Si te ha sido útil, no olvides suscribirte a mi canal HectorziN | Domótica y Home Assistant. ¡Seguimos llegando cada vez a más suscriptores!