Agregar dispositivos Shelly a una red Zigbee

Modificado el Mie, 22 Abr a 2:14 A. M.

Requisitos del Sistema

Asegúrate de tener los siguientes componentes y acceso:

  • Un coordinador Zigbee (por ejemplo, Sonoff ZBDongle, ConBee II, SkyConnect) conectado a tu sistema de hogar inteligente

  • Software controlador Zigbee instalado y operativo, como:

    • Home Assistant con integración ZHA, o

    • Zigbee2MQTT con un broker MQTT configurado correctamente

  • Un dispositivo Shelly con soporte Zigbee y acceso físico a su botón

  • Una computadora o dispositivo móvil conectado a la misma red local que tu plataforma de hogar inteligente


Configuración Paso a Paso

Paso 1: Cambiar al Firmware Zigbee (Si Aplica)

Algunos dispositivos Shelly se envían con firmware Wi-Fi/Matter por defecto. Si tu dispositivo soporta Zigbee pero no está actualmente en modo Zigbee, debes cambiarlo manualmente.

Para firmware inferior a 1.7.0:

  1. Presiona rápidamente el botón del dispositivo 5 veces.

  2. Espera 5–10 segundos mientras el dispositivo cambia al modo de firmware Zigbee.

Nota: Este proceso solo se requiere una vez, a menos que el firmware se revierta posteriormente al modo Wi-Fi.

Para firmware 1.7.0 y superior:

El cambio de firmware solo se puede hacer a través de la interfaz web local:

Settings → Switch to Matter/Zigbee


Paso 2: Entrar en Modo de Emparejamiento

El dispositivo Shelly debe estar en modo de emparejamiento para conectarse a tu red Zigbee.

  • Modo de emparejamiento automático: Se activa después de un restablecimiento de fábrica

  • Modo de emparejamiento manual: Presiona rápidamente el botón 3 veces


Paso 3: Emparejar el Dispositivo con tu Red Zigbee

Para Home Assistant (ZHA)

  1. Navega a:
    Settings → Devices & Services → Add Integration → Add Zigbee Device

  2. Haz clic en Add Device.

  3. Espera a que aparezca el dispositivo Shelly.

  4. Selecciónalo y opcionalmente asigna un nombre y área.

Para Zigbee2MQTT

  1. Abre la interfaz web de Zigbee2MQTT (típicamente http://<your-ip>:8080).

  2. Haz clic en Permit Join.

  3. Espera a que se descubra el dispositivo Shelly.

  4. Renómbralo y configúralo según sea necesario.


Paso 4: Comenzar a Usar el Dispositivo

Después del emparejamiento exitoso, el dispositivo expondrá sus entidades Zigbee disponibles, como:

  • Interruptores

  • Sensores

  • Indicadores de nivel de batería (si es compatible)

Ahora puedes usar el dispositivo en automatizaciones, escenas o controles manuales dentro de tu plataforma Zigbee.


Paso 5 (Recomendado): Actualizar el Firmware Zigbee

Para un rendimiento óptimo y compatibilidad continua, actualiza tu dispositivo Shelly a la última versión de firmware Zigbee.

⚠️ Las actualizaciones de firmware deben realizarse actualmente en modo Wi-Fi/BLE. Las actualizaciones OTA de Zigbee no son compatibles en este momento.

Procedimiento de Actualización

1. Habilitar Modo Wi-Fi/BLE
Mantén presionado el botón en la parte posterior durante 5 segundos para cambiar de modo.

2. Conectarse al Punto de Acceso del Dispositivo

  • Después del restablecimiento, el dispositivo transmite un punto de acceso Wi-Fi local.

  • Conéctate a él y abre http://192.168.33.1 en tu navegador.

3. Actualizar Firmware a través de la Interfaz Web

  • Ve a: Settings → Firmware

  • Instala la última versión de firmware disponible que incluya mejoras de Zigbee.

4. Confirmar el Estado de Conexión Zigbee

Estado ZigbeeSignificado
joinedEl dispositivo está conectado exitosamente a la red
steeringEl dispositivo está en modo de emparejamiento y buscando una red
failedEl dispositivo falló al unirse a una red

Si el estado muestra "failed", presiona el botón 3 veces rápidamente para volver a entrar en modo de emparejamiento.


Solución de Problemas

SíntomaResolución
Sin respuesta después de 5 presiones del botónAsegúrate de que las presiones sean rápidas y distintas; espera 5–10 segundos después de presionar
El dispositivo no apareceConfirma que está en modo Zigbee; reintenta el emparejamiento presionando el botón 3 veces
El dispositivo aparece como "desconocido"Espera unos minutos; actualiza las definiciones de dispositivos de tu coordinador Zigbee
Señal Zigbee débil o interrupcionesMueve el dispositivo más cerca del coordinador o agrega routers Zigbee para fortalecer la red