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:
Presiona rápidamente el botón del dispositivo 5 veces.
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)
Navega a:
Settings → Devices & Services → Add Integration → Add Zigbee DeviceHaz clic en Add Device.
Espera a que aparezca el dispositivo Shelly.
Selecciónalo y opcionalmente asigna un nombre y área.
Para Zigbee2MQTT
Abre la interfaz web de Zigbee2MQTT (típicamente
http://<your-ip>:8080).Haz clic en Permit Join.
Espera a que se descubra el dispositivo Shelly.
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.1en tu navegador.
3. Actualizar Firmware a través de la Interfaz Web
Ve a:
Settings → FirmwareInstala la última versión de firmware disponible que incluya mejoras de Zigbee.
4. Confirmar el Estado de Conexión Zigbee
| Estado Zigbee | Significado |
|---|---|
| joined | El dispositivo está conectado exitosamente a la red |
| steering | El dispositivo está en modo de emparejamiento y buscando una red |
| failed | El 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íntoma | Resolución |
|---|---|
| Sin respuesta después de 5 presiones del botón | Asegúrate de que las presiones sean rápidas y distintas; espera 5–10 segundos después de presionar |
| El dispositivo no aparece | Confirma 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 interrupciones | Mueve el dispositivo más cerca del coordinador o agrega routers Zigbee para fortalecer la red |