Saltar al contenido principal

Integración domótica SMLIGHT SLZB, gratuita y de código abierto

Integración SMLIGHT SLZB para Gladys Assistant

Coordinadores Zigbee SMLIGHT SLZB en la red local: estado, actualizaciones de firmware, reinicios.

Ver en GitHubTodas las integraciones externas

Vigile sus coordinadores Zigbee SMLIGHT SLZB (SLZB-06, SLZB-06M, SLZB-06p7, SLZB-07, SLZB-MR1, Ultima…) desde Gladys, a través de su red local: sus temperaturas y su memoria, si Zigbee2MQTT está conectado a ellos, su conexión de red, su firmware y sus actualizaciones, y reinícielos, a ellos o a su chip Zigbee, cuando la red Zigbee falle.

Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se ha construido y probado con respuestas reales de coordinadores SLZB publicadas por la biblioteca pysmlight y la integración de Home Assistant, no con un coordinador encima de la mesa. Si algo no funciona como se describe, díganoslo en el foro de Gladys o en las issues.

Esta integración no está afiliada a SMLIGHT.

Lo que necesita​

  • Gladys Assistant 5.1.0 o posterior.
  • Un coordinador SLZB con firmware v2.3.6 o posterior (SLZB-OS), en la misma red que Gladys. Los firmwares más antiguos no tienen API local que leer: actualícelo primero desde la interfaz web del SLZB.
  • Si ha protegido la interfaz web del SLZB con un usuario (Settings → Security), ese usuario y su contraseña.

La integración lee el coordinador; no sustituye a Zigbee2MQTT ni a ZHA, que siguen controlando sus dispositivos Zigbee a través de él.

Instalación​

  1. Instale SMLIGHT SLZB desde el catálogo de Gladys (o Integraciones → Instalar desde GitHub con https://github.com/guim31/gladys-smlight).
  2. Abra la pestaña Descubrir: los coordinadores de la red de Gladys se encuentran automáticamente (mDNS). ¿Falta alguno? Introduzca su dirección IP en Configuración (Direcciones IP de los coordinadores) (la interfaz web del SLZB la muestra en su página Network), por ejemplo 192.168.1.50; varias direcciones se separan con comas.
  3. Acceso: rellene Usuario y Contraseña solo si la interfaz web del SLZB lo pide. El mismo usuario sirve para todos los coordinadores.
  4. Haga clic en Probar la conexión: el mensaje bajo el botón enumera los coordinadores encontrados y lo que ha fallado.
  5. En Descubrir, haga clic en Añadir a Gladys en cada coordinador, elija una habitación y guarde.

Opciones:

  • Intervalo de actualización: 30 segundos o 1 minuto (por defecto).
  • Buscar actualizaciones de firmware: activado por defecto. Una vez al día, la integración pregunta al servidor de actualizaciones de SMLIGHT, en Internet, el último firmware de cada coordinador, como lo hace la interfaz web del SLZB. Desactívelo para quedarse totalmente en local: las funciones de las últimas versiones y de la actualización no se crean entonces.
  • Idioma de los nombres de las funciones: inglés, francés (por defecto), alemán o español. Los nombres se dan al añadir el dispositivo.

El dispositivo de cada coordinador​

Cada coordinador es un dispositivo, con el nombre de su nombre de host. Solo se crean las funciones que ofrece el coordinador.

FunciónQué es
Temperatura del núcleo ESP32Temperatura del chip ESP32 que hace funcionar el coordinador, en °C
Temperatura del chip ZigbeeTemperatura del chip de radio Zigbee, en °C (Temperatura de la radio 1, Temperatura de la radio 2 en los modelos con dos radios)
Memoria RAM usada, Sistema de archivos usadoMemoria usada por el coordinador, en kilobytes (el indicador llega hasta el total)
Tiempo de funcionamientoTiempo desde el arranque del coordinador, en horas
Cliente Zigbee conectado desde haceTiempo desde que Zigbee2MQTT o ZHA se conectó al coordinador por la red, en horas; 0: ningún cliente conectado
Conexión de redEthernet, Wi-Fi o LTE
Modo del coordinadorCómo se ofrece la radio Zigbee: Ethernet, Wi-Fi o USB
Firmware del núcleo, Firmware ZigbeeVersiones instaladas (Firmware de la radio 1, Firmware de la radio 2 en los modelos con varias radios)
Último firmware del núcleo, Último firmware ZigbeeÚltimas versiones en el servidor de actualizaciones de SMLIGHT, en el canal de firmware elegido en la interfaz web del SLZB (Último firmware de la radio 1, Último firmware de la radio 2 en los modelos con varias radios)
Actualización de firmware disponibleActivo cuando existe un firmware del núcleo o Zigbee más reciente
Internet accesibleSi el coordinador llega a Internet (consultado cada 15 minutos)
LED apagados, Modo nocturno de los LEDInterruptores: apagar los LED del coordinador, o atenuarlos de noche, cuando el firmware lo ofrece
Reiniciar el coordinadorBotón «Pulsar»: reinicia todo el coordinador (unos 20 segundos sin Zigbee)
Reiniciar el chip ZigbeeBotón «Pulsar»: reinicia solo la radio Zigbee (Reiniciar la radio 1, Reiniciar la radio 2 en el Ultima y los modelos U)

Los valores se leen cada 30 o 60 segundos, y solo se envían a Gladys los que han cambiado. La integración nunca flashea un firmware ni cambia el modo del coordinador: un error dejaría su red Zigbee sin coordinador. Use para ello la interfaz web del SLZB.

Widget del panel​

Añada el widget Coordinador SLZB a un panel (Editar, luego Agregar en una columna). Elija el coordinador en su configuración; vacío, muestra el primero. Muestra:

  • las temperaturas del ESP32 y del chip Zigbee (en directo) y el tiempo encendido;
  • el estado del coordinador (en línea, inaccesible, acceso rechazado), si hay un cliente Zigbee conectado, la conexión de red y el modo;
  • el firmware instalado, con la nueva versión al lado cuando la hay;
  • si el coordinador llega a Internet;
  • los botones Reiniciar Zigbee (en los modelos que reinician cada radio: Reiniciar radio 1, Reiniciar radio 2) y Reiniciar, que piden confirmación.

Escenas​

Desencadenantes​

  • Actualización de firmware SLZB disponible: ha salido un nuevo firmware del núcleo o Zigbee para un coordinador. Una vez por versión, incluso tras un reinicio. Filtros: el coordinador, el firmware (Núcleo (ESP32) o Chip Zigbee). Variables: el nombre del coordinador, el firmware (core, zigbee), la versión instalada y la nueva versión.
  • Coordinador SLZB inaccesible: un coordinador ha dejado de responder, dos lecturas seguidas (la segunda 15 segundos después de la primera). Variable: lo que ha pasado.
  • Coordinador SLZB de vuelta: vuelve a responder. Variable: los minutos sin respuesta.
  • Coordinador SLZB reiniciado: su tiempo de funcionamiento volvió a cero (corte, bloqueo, actualización, orden de reinicio), incluso cuando el reinicio fue demasiado rápido para parecer una avería. Filtro y variable: el origen, gladys cuando Gladys pidió el reinicio en los 3 minutos anteriores, other en caso contrario. Variable: el tiempo de funcionamiento antes del reinicio, en horas.

Ideas de escenas​

  • Coordinador SLZB inaccesible → enviar un mensaje «El coordinador Zigbee ya no responde: los dispositivos Zigbee están desconectados», y encender una luz del pasillo que no sea Zigbee.
  • Coordinador SLZB reiniciado con el origen Fuera de Gladys → enviar un mensaje con el tiempo de funcionamiento anterior: un coordinador que se reinicia solo suele tener un problema de alimentación.
  • Actualización de firmware SLZB disponible → enviar un mensaje «Ha salido el firmware {{triggerEvent.data.latest_version}} para {{triggerEvent.data.coordinator}}», y actualizarlo desde la interfaz web del SLZB cuando le convenga.

Solución de problemas​

  • Ningún coordinador en Descubrir: puede que el mDNS no atraviese su red (VLAN, Docker sin red de host para Gladys…). Introduzca la dirección IP del coordinador en la configuración y haga clic en Probar la conexión.
  • Acceso rechazado: la interfaz web del SLZB está protegida; introduzca su usuario y su contraseña en la configuración.
  • «no es un SLZB, o firmware anterior a la v2.3.6»: actualice el firmware desde la interfaz web del SLZB (o el flasheador web de SMLIGHT), o compruebe la dirección.
  • Internet accesible sigue vacío: el estado viene del flujo de eventos del coordinador (puerto 81 desde el firmware v2.6.8); sin él, la integración no envía ningún estado de Internet antes que uno falso.
  • El último firmware sigue vacío: el modelo del coordinador no está en el catálogo de SMLIGHT, o Gladys no llega a updates.smlight.tech; la integración lo vuelve a intentar cada hora.
  • Registros detallados: ponga LOG_LEVEL=debug en el entorno del contenedor.

Límites​

  • Ni actualización de firmware, ni cambio de modo, ni ajustes de Wi-Fi o de red desde Gladys, a propósito.
  • El proxy Bluetooth, el infrarrojo, el zumbador y la luz ambiental del Ultima no son compatibles.
  • Los firmwares anteriores a la v2.3.6 no son compatibles.
  • Peticiones: dos pequeñas peticiones HTTP por coordinador cada 30 o 60 segundos, una consulta del estado de Internet cada 15 minutos y, con la opción, una petición por firmware (núcleo y cada radio) y por día al servidor de actualizaciones de SMLIGHT. Nada más sale de su red.
  • El usuario es el mismo para todos los coordinadores.
  • Los nombres de las funciones se eligen al añadir el dispositivo; un coordinador cuyas radios cambian (Thread en lugar de Zigbee, un chip nuevo) ofrece una Actualización en la pestaña Descubrir.

Parámetros de configuración​

Estos son los parámetros que SMLIGHT SLZB te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Encontrar sus coordinadoressectionNoLos coordinadores SLZB de la misma red que Gladys se encuentran automáticamente (mDNS): abra la pestaña Descubrir. Si falta alguno, introduzca su dirección IP a continuación (se muestra en la interfaz web del SLZB, página Network).
Direcciones IP de los coordinadoresstringNoOpcional, separadas por comas. Solo para los coordinadores que el descubrimiento automático no encuentra.
Acceso a la interfaz websectionNoSolo si ha protegido la interfaz web del SLZB con un usuario (página Settings, Security). El mismo usuario sirve para todos los coordinadores.
UsuariostringNo
ContraseñasecretNo
OpcionessectionNo
Intervalo de actualizaciónselectNoCon qué frecuencia se leen los coordinadores. Cada lectura son dos pequeñas peticiones.
Buscar actualizaciones de firmwarebooleanNoUna vez al día, en el servidor de actualizaciones de SMLIGHT (Internet), como la interfaz web del SLZB. Nunca se instala nada desde Gladys.
Idioma de los nombres de las funcionesselectNoNombres dados a las funciones de los nuevos dispositivos (Tiempo de funcionamiento, Firmware del núcleo…) y textos de las variables de escena.

Cómo instalar SMLIGHT SLZB en Gladys​

  1. En Gladys, abre Integraciones: SMLIGHT SLZB aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-smlight:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-smlight.

SMLIGHT SLZB requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

SMLIGHT SLZB es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en