Integración domótica Litter-Robot, gratuita y de código abierto
Litter-Robot 3 y 4, Feeder-Robot de Whisker: cajón, arena, visitas del gato, limpieza.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Siga desde Gladys sus areneros autolimpiables y su comedero Whisker: el Litter-Robot 3 Connect, el Litter-Robot 4 y el Feeder-Robot. Sepa cuándo hay que vaciar el cajón de residuos, cuándo fue el gato por última vez (y cuánto pesa, en un Litter-Robot 4), reciba un aviso ante un fallo, e inicie una limpieza o dispense una ración desde el panel o desde una escena.
La integración usa la nube de Whisker, con la cuenta de la aplicación Whisker, como la propia aplicación y como la integración de Home Assistant. No tiene relación con Whisker: Litter-Robot, Feeder-Robot y Whisker son marcas de su propietario.
Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se ha construido y probado con las respuestas reales de la nube de Whisker publicadas por la biblioteca pylitterbot y por Home Assistant, no con un robot real. Si algo no funciona como se describe, dígalo en el foro de Gladys o en las issues.
Lo que necesita
- Gladys Assistant 5.1.0 o posterior, con acceso a internet.
- Un Litter-Robot 3 Connect (el modelo Wi-Fi), un Litter-Robot 4 y/o un Feeder-Robot, ya configurados en la aplicación Whisker.
- El correo electrónico y la contraseña de esa cuenta Whisker. Una cuenta que pide un segundo factor al iniciar sesión no es compatible: inicie sesión primero una vez en la aplicación.
El Litter-Robot 5 y el Litter-Robot 3 sin Wi-Fi no son compatibles.
Configuración
- Instale la integración desde el catálogo de Gladys.
- En Configuración, introduzca el Correo electrónico y la Contraseña de su cuenta Whisker y guarde.
- Haga clic en Probar la conexión: el mensaje bajo el botón enumera los robots encontrados en la cuenta, con su estado.
- Abra la pestaña Descubrir: un dispositivo por robot. Haga clic en Añadir, elija una habitación y guarde.
Opciones:
- Intervalo de actualización: con qué frecuencia se leen los robots en la nube de Whisker, 2, 5 (por defecto), 10 o 15 minutos. Un Litter-Robot 4 y un Feeder-Robot también envían sus cambios en directo; un Litter-Robot 3 solo se lee con este intervalo.
- Unidad de peso: kilogramos o libras, para el peso del gato en el widget.
- Feeder-Robot: raciones por día: el número máximo de raciones que Gladys puede dispensar en 24 horas (4 por defecto, con un minuto de separación como mínimo). Vea Acciones.
- Idioma de los nombres de funciones: inglés, francés (por defecto), alemán o español. Los nombres se asignan al añadir un dispositivo; los estados de los robots y los mensajes de las escenas también siguen este idioma.
La contraseña solo se envía al servicio de inicio de sesión de Whisker (Amazon Cognito). La integración guarda los tokens de sesión recibidos en su almacenamiento privado, para que un reinicio no vuelva a iniciar sesión con la contraseña.
Los dispositivos
Litter-Robot 3 Connect
| Función | Qué es |
|---|---|
| Estado | El estado en palabras: Listo, Limpieza en curso, Cajón lleno… |
| Cajón de residuos | Llenado del cajón, en %, según los ciclos contados desde el vaciado |
| Ciclos desde el vaciado | Ciclos de limpieza desde la última puesta a cero del contador |
| Iniciar limpieza | Botón: inicia ahora un ciclo de limpieza |
| Restablecer el cajón | Botón: indica al robot que el cajón se vació (contador a cero) |
| Retraso de limpieza | Minutos entre la salida del gato y la limpieza: 3, 7 o 15 |
| Luz nocturna | Interruptor: luz nocturna encendida o apagada |
| Bloqueo del panel | Interruptor: bloquea los botones del robot |
| Modo noche | Si hay un periodo de reposo configurado (solo lectura) |
| Última visita | Fecha y hora de la última visita del gato vista por la integración |
Litter-Robot 4
| Función | Qué es |
|---|---|
| Estado | El estado en palabras |
| Cajón de residuos | Llenado del cajón, en %, tal como lo mide el robot |
| Nivel de arena | El nivel de arena en el globo, en % |
| Peso del gato (g) | El último peso registrado por el robot, en gramos (SmartWeight) |
| Ciclos de limpieza (total) | Todos los ciclos de limpieza desde la puesta en marcha |
| Iniciar limpieza | Botón: inicia ahora un ciclo de limpieza |
| Retraso de limpieza | 3, 7, 15, 25 o 30 minutos |
| Modo de la luz nocturna | Apagada, Encendida o Automática |
| Bloqueo del panel | Interruptor: bloquea los botones del robot |
| Modo noche | Si hay un periodo de reposo configurado al menos un día (solo lectura) |
| Última visita | Fecha y hora de la última visita del gato vista por la integración |
Gladys no tiene unidad de masa: el peso es un número de gramos, la unidad está en su nombre. Su historial y las escenas («peso inferior a 3500») funcionan como siempre.
Feeder-Robot
| Función | Qué es |
|---|---|
| Estado | Listo, Motor atascado, Conducto lleno, Con batería, Sin conexión |
| Nivel de pienso | El pienso restante en la tolva, en % (por niveles del sensor) |
| Raciones de hoy | Raciones dispensadas desde medianoche, comidas y raciones extra |
| Última comida | Fecha, nombre y raciones de la última comida o ración extra |
| Dispensar una ración | Botón: una ración ahora, dentro del límite diario |
| Luz nocturna automática | Interruptor |
| Bloqueo del panel | Interruptor |
Un robot que la nube de Whisker indica sin conexión lleva una insignia «inaccesible» en Gladys.
Panel
El widget Litter-Robot muestra un arenero (el elegido en su configuración, si no el primero): los niveles del Cajón y de la Arena, las Visitas hoy, su estado, su Última visita y su Último peso, y los botones:
- Limpiar: inicia un ciclo de limpieza (Gladys pide confirmación antes);
- Cajón vaciado (Litter-Robot 3): pone a cero el contador del cajón.
Escenas
Disparadores
- Visita del gato: un gato ha usado el Litter-Robot. La integración lo ve cuando el robot inicia su cuenta atrás antes de limpiar o, si ese momento cayó entre dos lecturas, cuando avanza el contador de ciclos (una limpieza iniciada por Gladys no cuenta). Filtro: el robot. Información para la escena: Nombre del robot, Último peso registrado (kg) y (lb) (Litter-Robot 4), Visitas de hoy.
- Cajón de residuos lleno: el robot indica que su cajón está lleno, una vez por llenado. Información: Nombre del robot, Nivel del cajón (%).
- Error del robot: un robot indica un fallo o se queda sin conexión. Filtros: el robot y el tipo de error (fallo del motor del globo, pinzamiento detectado, fallo del sensor de gato, cubierta retirada, robot sin conexión, motor del comedero atascado). Información: Nombre del robot, Tipo de error (código), Error, en palabras.
Acciones
- Iniciar una limpieza del Litter-Robot: inicia un ciclo ahora. Se rechaza mientras el robot detecta un gato.
- Dispensar una ración del Feeder-Robot: una ración ahora. Para proteger a su gato de una escena en bucle, Gladys dispensa como máximo el número de raciones configurado en 24 horas, y nunca dos en menos de un minuto. Más allá, la acción no hace nada y lo indica: su resultado Ración dispensada vale entonces «no», y Raciones restantes (24 h) indica cuántas quedan. Las comidas programadas en la aplicación Whisker no cuentan.
Ideas de escenas
- Vaciar el cajón: disparador Cajón de residuos lleno → enviar un mensaje «El cajón del arenero está lleno, ¡le toca a usted!».
- Vigilar la salud del gato: disparador Visita del gato → condición Visitas de hoy mayor que 8 → avisar, un número inusual de visitas puede indicar un problema urinario. O una escena sobre la función Peso del gato (g): por debajo de 3500 → avisar.
- Limpiar cuando no hay nadie: disparador «todos se han ido» → acción Iniciar una limpieza del Litter-Robot.
- Alerta de fallo: disparador Error del robot con el tipo Fallo del motor del globo o Pinzamiento detectado → mensaje con Error, en palabras.
Actualización, cuotas y privacidad
- Los robots se leen cada pocos minutos (el Intervalo de actualización), más una lectura unos segundos después de una orden; cada familia de robots se vuelve a listar una vez por hora para encontrar un robot añadido a la cuenta. Un Litter-Robot 4 y un Feeder-Robot se siguen en directo mediante la suscripción que usa la aplicación Whisker.
- Whisker no publica cuotas ni condiciones para esta API, que es la de su aplicación; la integración mantiene el ritmo de la integración de Home Assistant (5 minutos por defecto) y deja de intentarlo tras una contraseña rechazada o cuando Whisker limita la cuenta (15 minutos).
- Guardado en el almacenamiento privado de la integración: los tokens de sesión, un hash del correo, las visitas del día y las raciones dispensadas por Gladys. Nunca la contraseña; los registros nunca contienen la contraseña, el correo ni un token.
Solución de problemas
- «Whisker ha rechazado el correo o la contraseña»: compruébelos en la aplicación Whisker y guarde de nuevo la configuración. Tras un rechazo, la integración no vuelve a intentarlo sola: guarde la configuración o haga clic en Probar la conexión.
- «Su cuenta Whisker pide un paso más»: inicie sesión una vez en la aplicación Whisker (nueva contraseña, código de verificación) y pruebe la conexión.
- «La nube de Whisker no responde»: un corte de internet o de Whisker; la integración lo vuelve a intentar en la próxima actualización.
- Ningún dispositivo en la pestaña Descubrir: haga clic en Probar la conexión; la cuenta debe ser aquella en la que están configurados los robots (no una cuenta compartida).
- Una visita o un estado llega tarde: un Litter-Robot 3 solo se lee con el intervalo de actualización; bájelo a 2 minutos.
- Más detalles: configure
LOG_LEVEL=debugen la integración y lea sus registros.
Límites
- Desarrollada sin el hardware: las órdenes siguen a pylitterbot y a la aplicación Whisker, pero no se han probado en un robot real.
- Solo el Litter-Robot 3 Connect, el Litter-Robot 4 y el Feeder-Robot; sin Litter-Robot 5, sin perfiles de mascotas (el peso es la última medida del robot, no un peso por gato: con varios gatos, es el último que entró).
- Las visitas son las que la integración ha visto desde su instalación; no lee el historial de la aplicación Whisker.
- El Litter-Robot 3 no tiene actualizaciones en directo aquí: se lee con el intervalo de actualización.
- Sin edición de los periodos de reposo ni de las comidas programadas: use la aplicación Whisker.
- La nube es imprescindible: sin internet, no se puede leer ni controlar nada.
Parámetros de configuración
Estos son los parámetros que Litter-Robot te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su cuenta Whisker | section | No | La cuenta de la aplicación Whisker, donde está configurado su Litter-Robot 3 Connect, Litter-Robot 4 o Feeder-Robot. La integración los lee a través de la nube de Whisker, como la aplicación. Sin relación con Whisker. |
| Correo electrónico | string | Sí | El correo con el que inicia sesión en la aplicación Whisker. |
| Contraseña | secret | Sí | La contraseña de la aplicación Whisker. Solo se envía al servicio de inicio de sesión de Whisker, nunca se escribe en los registros. |
| Opciones | section | No | Un Litter-Robot 4 y un Feeder-Robot envían sus cambios en directo; cada robot también se vuelve a leer con el intervalo de abajo. |
| Intervalo de actualización | select | No | Con qué frecuencia se leen los robots en la nube de Whisker. La única fuente para un Litter-Robot 3. |
| Unidad de peso | select | No | Para el peso del gato en el widget (Litter-Robot 4). La función del dispositivo está en gramos. |
| Feeder-Robot: raciones por día | select | No | Como máximo este número de raciones dispensadas por Gladys en 24 horas, con un minuto de separación, para que una escena en bucle no vacíe la tolva. Las comidas de la aplicación Whisker no cuentan. |
| Idioma de los nombres de funciones | select | No | Nombres dados a las funciones al añadir un dispositivo, e idioma de los estados de los robots y de los mensajes de las escenas. |
Cómo instalar Litter-Robot en Gladys
- En Gladys, abre Integraciones: Litter-Robot 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-litter-robot: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-litter-robot.
Litter-Robot 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
Litter-Robot 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