Integración domótica Rain Bird, gratuita y de código abierto
Programadores de riego Rain Bird (wifi LNK), en local: zonas, sensor de lluvia, retraso, programas.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.2.0
- ★ 0
Siga y controle su programador de riego Rain Bird desde Gladys, en su red local: vea qué zona está regando, si el sensor de lluvia detecta lluvia y si un retraso por lluvia suspende el programa; riegue una zona unos minutos, detenga todo, inicie un programa o suspenda el programa para los días de lluvia anunciados. Sin cuenta Rain Bird ni nube: Gladys habla directamente con el módulo wifi del programador.
Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se construyó a partir del protocolo de la biblioteca libre pyrainbird y de las respuestas de programadores reales grabadas en sus pruebas y en las de Home Assistant, no sobre un programador real. Si algo no funciona como se describe, dígalo en el foro de Gladys o en las issues.
Esta integración no está afiliada a Rain Bird Corporation ni respaldada por ella.
Lo que necesita
- Gladys Assistant 5.2.0 o posterior.
- Un programador Rain Bird con módulo wifi LNK o LNK2 (ESP-TM2, ESP-Me, ESP-ME3, ESP-RZXe, ST8x-WiFi, ARC8, TRU…), ya configurado con la aplicación Rain Bird y conectado a su wifi.
- La dirección IP del módulo en su red: búsquela en la lista de dispositivos de su router. Asígnele una dirección fija (reserva DHCP) para que no cambie.
- La contraseña del programador elegida en la aplicación Rain Bird al configurar el módulo. Cifra cada intercambio con el módulo.
El módulo atiende a un solo cliente a la vez y responde despacio. Mientras Gladys lo lee (unos segundos cada minuto por defecto), la aplicación Rain Bird puede tener que esperar o mostrar un error: vuelva a intentarlo un momento después, o elija un intervalo de lectura más largo.
Configuración
- Instale la integración desde el catálogo de Gladys.
- En Configuración, introduzca la Dirección del módulo (por ejemplo
192.168.1.20), su Contraseña del módulo y, si lo desea, un Nombre. ¿Dos o tres programadores? Rellene también las secciones Segundo programador y Tercer programador. - Elija las opciones: Riego desde el interruptor de una zona (min) (10 por defecto), el Intervalo de lectura (1 minuto por defecto; 2 o 5 minutos dejan el módulo más libre para la aplicación) y el Idioma de los nombres de funciones.
- Guarde y haga clic en Probar la conexión: el mensaje bajo el botón indica, para cada programador, su modelo, sus zonas, lo que está regando, el sensor de lluvia y el retraso por lluvia.
- Abra la pestaña Descubrir: un dispositivo por programador. Haga clic en Añadir, elija una habitación y guarde.
La dirección también puede escribirse https://192.168.1.20 o
http://192.168.1.20: sin prefijo, la integración prueba primero HTTPS (los
firmwares LNK2 recientes, con su certificado autofirmado) y luego HTTP (los más
antiguos), y se queda con el que responde.
El dispositivo de cada programador
El dispositivo lleva el Nombre de la configuración, o «Rain Bird» seguido del modelo. Se identifica por la dirección MAC de su módulo wifi: cambiar la dirección IP del programador conserva el dispositivo y su historial.
| Función | Qué hace |
|---|---|
| Zona 1, Zona 2… (una por zona conectada al programador) | Un interruptor, encendido mientras la zona riega. Encenderlo riega la zona durante los minutos de la configuración (el programador la detiene por sí solo); apagarlo detiene el riego de todas las zonas: el programador no tiene orden de «detener solo esta zona». |
| Sensor de lluvia | Encendido (1) cuando el sensor de lluvia conectado al programador detecta lluvia. Permanece apagado sin sensor. Ausente si el programador rechaza esta lectura. |
| Retraso por lluvia | Los días en que el programa queda suspendido (0: ninguno). Un control deslizante de 0 a 14 días (30 en los modelos BAT-PRO y LX): moverlo ajusta el retraso en el programador. |
| En línea | Encendido mientras el programador responde; apagado tras dos lecturas seguidas sin respuesta. |
| Detener el riego | Un botón: detiene todas las zonas. |
| Iniciar el programa A, Iniciar el programa B… | Un botón por programa del modelo (de A a H como máximo; ninguno en el ESP-RZXe ni en el ST8x-WiFi, que programan cada zona por separado): inicia el programa ahora, como a su hora de inicio. |
Rain Bird nombra las zonas en su aplicación, en la nube: la integración no lee esos nombres. Cambie el nombre de las funciones en Gladys (ajustes del dispositivo) por «Césped», «Huerto»…
Las funciones se crean en el Idioma de los nombres de funciones de la configuración (francés por defecto) y conservan su nombre después.
Panel
El widget Rain Bird muestra un programador (el elegido en sus ajustes, o el primero de la configuración):
- las zonas, primero las que riegan, con una insignia Regando o En reposo (8 como máximo; el número de las demás se indica debajo);
- el sensor de lluvia, el retraso por lluvia, y la conexión cuando el programador no responde;
- cuatro botones: Regar… (elegir la zona y los minutos), Detener (todas las zonas; una marca de verificación cuando nada riega), Programa… (elegir el programa; ausente si el modelo no tiene) y Retraso… (elegir los días, 0 cancela el retraso).
Escenas
Desencadenantes
- Riego Rain Bird iniciado: una zona empieza a regar. Filtros: el programador, la zona, e Iniciado por: El programador (programa, aplicación) o Gladys. Información transmitida: la zona, quién la inició, el nombre del programador.
- Riego Rain Bird terminado: una zona deja de regar. Mismos filtros. Información transmitida: la zona, los minutos de riego vistos por Gladys (con la precisión del intervalo de lectura; vacío si el riego empezó antes que la integración), quién la inició, el nombre del programador.
Un riego se ve en la lectura siguiente: con un intervalo de un minuto, un inicio o un final aparece en menos de un minuto. El interruptor de una zona ya da «zona encendida/apagada» a las escenas; estos desencadenantes añaden quién la inició, cuánto tiempo regó, y un solo desencadenante para todas las zonas.
Acciones
- Regar una zona Rain Bird: un programador, un número de zona, una duración en minutos (10 por defecto). El programador detiene la zona por sí solo.
- Detener el riego Rain Bird: todas las zonas de un programador, o de todos si el programador se deja vacío.
- Iniciar un programa Rain Bird: un programador y un programa (de A a H).
- Ajustar el retraso por lluvia Rain Bird: un programador y un número de días (0 cancela el retraso; limitado al máximo del modelo).
Ideas de escenas
- Lluvia prevista: cuando la previsión meteorológica anuncia lluvia para mañana, Ajustar el retraso por lluvia Rain Bird a 2 días.
- Alguien en el jardín: cuando se abre la puerta del jardín, Detener el riego Rain Bird.
- Informe de riego: con Riego Rain Bird terminado iniciado por El programador, enviar el mensaje «Zona {zone} regada {minutes} min».
- Semilleros: cada día a las 14 h durante una ola de calor, Regar una zona Rain Bird: la zona del huerto durante 5 minutos.
Solución de problemas
- «no responde»: compruebe la dirección (puede haber cambiado: asigne al módulo una dirección fija en su router), que el programador tiene corriente y que el indicador wifi del módulo está encendido. Gladys debe poder alcanzar la red del módulo.
- «contraseña rechazada (o no es un módulo Rain Bird)»: vuelva a escribir la contraseña del programador (la de la aplicación Rain Bird, respetando mayúsculas). Compruebe también que la dirección es la del módulo Rain Bird. Tras una contraseña rechazada, la integración solo lo reintenta cada 10 minutos (el módulo puede bloquear los intentos repetidos); guardar la configuración lo reintenta de inmediato.
- «ocupado con otro cliente»: la aplicación Rain Bird (u otro sistema domótico) estaba hablando con el módulo. La integración lo reintenta varias veces, y luego en la lectura siguiente. Dos sistemas que leen el módulo cada minuto se molestarán continuamente: conserve solo uno.
- La aplicación Rain Bird no consigue conectarse: el módulo está ocupado con Gladys unos segundos; vuelva a intentarlo, o elija un intervalo de lectura de 2 o 5 minutos.
- El interruptor de una zona vuelve atrás: el programador rechazó o ignoró la orden. La integración vuelve a leer el programador cinco segundos después de cada orden y muestra lo que hace realmente.
- Falta una zona nueva: haga clic en Buscar en la pestaña Descubrir (o en Probar la conexión) y luego Actualice el dispositivo.
- Más detalles: inicie la integración con
LOG_LEVEL=debugpara ver cada lectura en sus registros. Las contraseñas y los ajustes wifi nunca aparecen en ellos.
Límites
- Desarrollada sin el hardware: sus comentarios son bienvenidos. Probada con las respuestas grabadas de programadores reales, no con un programador real.
- Solo red local, mediante un módulo wifi LNK o LNK2: un programador sin él (solo Bluetooth, o solo nube) no es accesible de esta forma.
- La integración lee el programador como mucho una vez por minuto (el módulo atiende a un solo cliente a la vez): un riego iniciado desde el programador aparece dentro del intervalo de lectura.
- Sin nombres de zonas (están en la nube Rain Bird) ni modificación del programa.
- Apagar una zona detiene todas las zonas (la única orden de parada del programador). Iniciar una zona mientras otra riega: según el modelo, el programador detiene la primera o pone la nueva en cola.
- Duraciones de 1 a 240 minutos (menos si el límite del modelo es inferior).
Parámetros de configuración
Estos son los parámetros que Rain Bird te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su programador Rain Bird | section | No | Un programador con módulo wifi LNK o LNK2, configurado con la aplicación Rain Bird. El módulo atiende a un solo cliente a la vez: la aplicación puede tener que esperar mientras Gladys lo lee. |
| Dirección | string | Sí | Dirección IP del módulo wifi en su red (consulte su router; mejor una dirección fija). |
| Contraseña del módulo | secret | Sí | La contraseña del programador elegida en la aplicación Rain Bird, que cifra cada intercambio. |
| Nombre | string | No | Nombre del dispositivo en Gladys. Vacío: «Rain Bird» seguido del modelo. |
| Segundo programador (opcional) | section | No | Los mismos campos, para otro programador Rain Bird de su red. |
| Dirección | string | No | |
| Contraseña del módulo | secret | No | |
| Nombre | string | No | |
| Tercer programador (opcional) | section | No | Los mismos campos, para un tercer programador Rain Bird. |
| Dirección | string | No | |
| Contraseña del módulo | secret | No | |
| Nombre | string | No | |
| Opciones | section | No | |
| Riego desde el interruptor de una zona (min) | number | No | Cuánto riega una zona encendida en Gladys; el programador la detiene por sí solo. |
| Intervalo de lectura | select | No | Frecuencia de lectura de los programadores. Más largo deja el módulo libre para la aplicación. |
| Idioma de los nombres de funciones | select | No | Nombres de las funciones cuando el dispositivo se añade a Gladys, y mensajes. |
Cómo instalar Rain Bird en Gladys
- En Gladys, abre Integraciones: Rain Bird aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-rainbird: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). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-rainbird.
Rain Bird requiere Gladys >=5.2.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
Rain Bird 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.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación