Integración domótica Worx Landroid, gratuita y de código abierto
Robots cortacésped Worx Landroid (Kress, LandXcape): estado, batería, lluvia, iniciar, pausa, base.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Presentación
Esta integración añade sus robots cortacésped Worx Landroid a Gladys Assistant, así como los de las marcas hermanas de la misma nube, Kress y LandXcape. Cada robot se convierte en un dispositivo: su estado, batería, retraso por lluvia y tiempos de corte, con botones para iniciarlo, pausarlo y enviarlo de vuelta a su base.
Lee los robots desde la nube del fabricante, donde la aplicación los guarda: su estado llega en tiempo real (MQTT), con una lectura periódica de respaldo.
La integración es un proyecto comunitario, no afiliado a Worx ni a Positec. Se ha desarrollado sin el hardware: sus comentarios son bienvenidos en las issues del repositorio.
Requisitos
- Gladys Assistant 5.1 o posterior.
- Un robot ya añadido en la aplicación Worx Landroid (o Kress, LandXcape), y el correo y la contraseña de esa cuenta.
- Acceso a Internet desde Gladys: la integración solo habla con la nube del fabricante.
Configuración
- En Gladys, abra Integraciones, busque Worx Landroid e instálela (o Instalar desde
GitHub con
https://github.com/guim31/gladys-landroid). - En la pestaña Configuración, elija la marca de su aplicación e introduzca el correo electrónico y la contraseña de la cuenta.
- Elija el idioma de los textos: los nombres de las funciones (fijados al añadir el robot) y los textos de estado y de error. Francés por defecto.
- Deje Compartir la posición GPS desactivado, salvo si su modelo tiene GPS (módulo 4G, RTK) y desea su posición en Gladys.
- Guarde. El botón Comprobar la conexión muestra los robots encontrados.
- Abra la pestaña Descubrir y añada sus robots.
Los tokens se guardan en el volumen de la integración: un reinicio no vuelve a iniciar sesión.
El dispositivo robot
| Función | Tipo | Detalle |
|---|---|---|
| Estado | texto | Cortando, volviendo a la base, cargando, en la base, error… |
| Error | texto | El fallo actual, o «Sin error» |
| Cortando | sí / no | El robot ha salido a trabajar |
| Batería | % | |
| Cargando | sí / no | |
| Temperatura de la batería | °C | |
| Lluvia detectada | sí / no | El sensor de lluvia está mojado |
| Retraso por lluvia restante | minutos | Espera antes de volver a cortar tras la lluvia |
| Retraso por lluvia | minutos, ajustable | Espera tras la lluvia, de 0 a 12 horas en pasos de 30 min |
| Zona actual | número | Zona que se corta (modelos multizona) |
| Tiempo de corte hoy | minutos | Contado desde el inicio del día local |
| Tiempo total de cuchilla | horas | Contador de vida |
| Tiempo total de corte | horas | Contador de vida |
| Señal Wi-Fi | % | -100 dBm o menos = 0 %, -50 dBm o más = 100 % |
| Posición GPS | texto | Solo si está activada y el modelo la indica |
| Iniciar el corte | botón | |
| Pausa | botón | |
| Volver a la base | botón | |
| Corte de bordes | botón | Solo en los modelos que lo tienen |
| Bloqueo | activado / desactivado | El bloqueo antirrobo (PIN) |
| Programación | activada / desactivada | Activa o desactiva la programación de corte de la app |
Una función solo aparece cuando el robot la indica: un modelo antiguo sin sensor de lluvia no tiene las funciones de lluvia. Iniciar, pausa y volver son botones, no interruptores: un asistente de voz nunca puede poner en marcha las cuchillas por error.
Widget
El widget Robot cortacésped muestra el estado de un robot (con el fallo o el retraso por lluvia si lo hay), su batería y el tiempo de corte del día, y los botones Iniciar, Pausa y Base (más Bordes en los modelos que lo tienen). Elija el robot en los ajustes del widget.
Disparadores de escena
- Error del robot: el robot indica un nuevo fallo. Filtro por robot y por tipo de fallo (atascado, levantado o volcado, fuera del perímetro, cuchilla, batería o carga, base de carga, tapa abierta, otro). Información transmitida: nombre del robot, texto del error, tipo, código de error. La lluvia no es un fallo: use la función Lluvia detectada.
- Corte terminado: el robot ha vuelto a su base tras trabajar (fin de programación, lluvia o a petición). Información transmitida: nombre del robot, duración de la sesión en minutos, batería, si volvió por la lluvia.
Acción de escena
- Cortar una vez: una sesión de corte puntual fuera de la programación, de 10 a 480 minutos, con o sin los bordes primero. Solo en los modelos con programación puntual.
Ejemplos de escenas
- Avíseme si el robot se queda atascado: disparador Error del robot, tipos atascado y levantado → enviar un mensaje «{{nombre del robot}}: {{error}}».
- Cortar después del riego: cuando termina la escena de riego, acción Cortar una vez, 60 minutos, bordes primero.
- Dejar libre el césped para una fiesta: cuando empieza el modo «Fiesta en el jardín», pulsar Volver a la base y desactivar la Programación; reactivarla al final.
Solución de problemas
- «La cuenta rechazó el correo o la contraseña»: compruébelos en la aplicación y vuelva a guardar la configuración. La integración no vuelve a intentar sola una contraseña rechazada.
- «La nube pide reducir el ritmo»: la nube respondió «demasiadas solicitudes». Todo se pausa (una hora, luego más) y se reanuda solo. No reinicie la integración una y otra vez: empeoraría la situación.
- La aplicación y la integración han dejado de funcionar: Worx puede bloquear una cuenta hasta 24 horas. La solución que documenta la comunidad: en el sitio web de Worx, desvincule el robot de la cuenta y vuelva a añadirlo en la aplicación.
- Punto naranja en la insignia del dispositivo: el enlace en tiempo real está caído; el robot se lee cada 30 minutos hasta que vuelva.
- Una orden falla con «Enlace en tiempo real caído»: las órdenes necesitan el enlace en tiempo real; espere a que vuelva.
- Más detalles: ponga la variable de entorno
LOG_LEVELde la integración endebug.
Límites
- Solo nube: los robots no tienen API local. Sin Internet, Gladys conserva los últimos valores.
- Cuotas, para evitar los bloqueos temporales del fabricante (no existe ninguna cifra oficial; son los valores prudentes de los clientes comunitarios): como máximo 50 órdenes por robot y por día, una orden cada 1,1 s, 96 solicitudes a la nube por día, 5 inicios de sesión con contraseña por día. La nube se lee cada hora mientras funciona el enlace en tiempo real, cada 30 minutos si no; el enlace en tiempo real se reconecta al cabo de 1 minuto y luego espera un poco más cada vez, hasta 30 minutos.
- Tiempo de corte hoy empieza en 0 el primer día: lo que el robot cortó antes de que la integración lo viera es desconocido.
- La programación, las zonas y la altura de corte no se modifican desde Gladys; las actualizaciones del firmware y los reinicios se dejan a propósito a la aplicación.
- Los eventos Corte terminado y Error del robot necesitan el enlace en tiempo real: mientras está caído, una sesión corta puede pasar desapercibida.
- Desarrollada sin el hardware: los comentarios de los propietarios de modelos Vision y RTK son especialmente bienvenidos.
Parámetros de configuración
Estos son los parámetros que Worx Landroid te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su cuenta del fabricante | section | No | Use el correo y la contraseña de la aplicación Worx Landroid (o Kress, LandXcape), donde sus robots ya están añadidos. La integración los lee desde la nube del fabricante y no está afiliada a Worx ni a Positec. |
| Marca | select | Sí | La aplicación en la que se creó su cuenta. |
| Correo electrónico | string | Sí | |
| Contraseña | secret | Sí | |
| Idioma de los textos | select | Sí | Idioma de los nombres de las funciones (fijados al añadir el robot) y de los textos de estado y error. |
| Compartir la posición GPS | boolean | No | Solo para los modelos con GPS (módulo 4G, RTK). Desactivado por defecto: la posición es un dato personal. |
Cómo instalar Worx Landroid en Gladys
- En Gladys, abre Integraciones: Worx Landroid 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-landroid: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-landroid.
Worx Landroid 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
Worx Landroid 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