Integración domótica Sensibo, gratuita y de código abierto
Controladores de aire Sensibo: encendido, modo, temperatura, ventilador, sensores, widget y escenas.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Controle desde Gladys los aires acondicionados y bombas de calor aire-aire manejados por un Sensibo (Sky, Air, Air Pro), mediante la API en la nube oficial de Sensibo: encendido, modo, temperatura objetivo, velocidad del ventilador y oscilación, Climate React, y la temperatura ambiente, la humedad y la calidad del aire que mide el Sensibo. El Sensibo Pure (purificador de aire) y el Elements (medidor de calidad del aire) también son compatibles. Un widget del panel muestra todos los aires con botones Encender y Apagar, y las escenas reaccionan cuando un Sensibo se desconecta o hay que limpiar un filtro.
Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se construyó y probó con una nube de Sensibo simulada, alimentada con dispositivos reales de los datos de prueba de pysensibo y Home Assistant, no con una cuenta Sensibo real. Si algo no funciona como se describe, dígalo en el foro de Gladys o en las issues.
Requisitos
- Gladys Assistant 5.1.0 o posterior.
- Una cuenta Sensibo, con sus dispositivos ya configurados en la aplicación Sensibo (mando del aire acondicionado detectado).
- Una clave de API de Sensibo: inicie sesión en home.sensibo.com/me/api y cree una.
- Una conexión a Internet: la integración se comunica con la nube de Sensibo.
Puesta en marcha
- Instale la integración desde el catálogo de Gladys.
- En Configuración, pegue la Clave de API y guarde.
- Haga clic en Probar la conexión: el mensaje bajo el botón enumera los dispositivos de la cuenta.
- Abra la pestaña Descubrimiento: un dispositivo por Sensibo, con el nombre de su habitación en la aplicación Sensibo. Haga clic en Añadir, elija una habitación y guarde.
Opciones:
- Intervalo de actualización: frecuencia de lectura de la nube de Sensibo, de 1 a 10 minutos (2 minutos por defecto). Una sola solicitud lee todos los dispositivos. Un cambio hecho desde Gladys se muestra al instante; un cambio hecho con el mando o la aplicación Sensibo aparece en la lectura siguiente.
- Idioma de los nombres: inglés, francés, alemán o español (francés por defecto), para los nombres de las funciones (dados al añadir un dispositivo) y los mensajes de la integración.
El dispositivo de cada Sensibo
| Función | Qué es |
|---|---|
| Encendido | Enciende y apaga el aire acondicionado (o el Pure) |
| Modo | Auto, Frío, Calor, Seco, Ventilador: solo los modos que ofrece el mando de su aire acondicionado |
| Temperatura objetivo | Limitada a los valores del mando, en la unidad elegida en la aplicación Sensibo |
| Velocidad del ventilador | Auto, de baja a alta, silencio, turbo: las velocidades que ofrece el mando en el modo actual |
| Oscilación vertical | Parada, oscilación o una de cinco posiciones fijas |
| Oscilación horizontal | Parada, oscilación o una de cinco posiciones fijas |
| Climate React | Activa o desactiva la automatización Climate React, configurada en la aplicación Sensibo |
| Temperatura ambiente | Medida por el Sensibo, solo lectura |
| Humedad | Medida por el Sensibo, solo lectura |
| CO2 | Air Pro y Elements, solo lectura |
| COV totales | Compuestos orgánicos volátiles, Air Pro y Elements, solo lectura |
| PM2.5 | Partículas finas, Elements, solo lectura |
| Vida útil del filtro | Parte restante del intervalo de limpieza: 0 % significa limpiar el filtro |
Una función solo aparece si el dispositivo la ofrece: el Pure tiene Encendido y la vida útil del filtro, el Elements solo sus mediciones. La insignia del dispositivo indica Nube mientras el Sensibo está conectado e Inaccesible cuando está desconectado.
Seguridad. Una orden nunca sale de lo que el mando de su aire acondicionado puede enviar: un modo que no tiene se rechaza, una temperatura objetivo se ajusta a sus valores (17 °C pedidos en un mando que enfría desde 18 °C dan 18 °C), y una velocidad o una posición de oscilación que falta en el modo actual se rechaza con un mensaje. Son las funciones de climatización que Gladys da a sus otros aires acondicionados.
Panel
Añada el widget Aires Sensibo a un panel. Por defecto enumera todos los aires: Apagado, o el modo y la temperatura objetivo cuando funciona, y luego la temperatura de la habitación. Elija uno en su configuración para mostrar solo ese. Sus dos botones actúan sobre lo que muestra el widget:
- Encender: enciende con el último modo y la última temperatura, como el botón de encendido del mando;
- Apagar: apaga.
El botón del estado actual lleva una marca cuando todos los aires mostrados están en él. El modo, la temperatura y el ventilador están en el dispositivo.
Escenas
Disparadores
- Sensibo desconectado: un Sensibo ha perdido la conexión con la nube de Sensibo (wifi, corte de luz). Filtro: el dispositivo. Variables: nombre y dispositivo.
- Sensibo conectado de nuevo: el Sensibo vuelve a estar conectado. Filtro: el dispositivo.
- Filtro que limpiar: Sensibo indica que hay que limpiar el filtro, según el tiempo de funcionamiento ajustado en la aplicación Sensibo. Filtro: el dispositivo.
Para una temperatura o una humedad fuera de rango, use el disparador de dispositivo de Gladys sobre la función Temperatura ambiente o Humedad (por ejemplo «por encima de 28 °C»): ya se dispara al cruzar el umbral.
Acciones
- Encender aires Sensibo: un aire acondicionado, o todos si el campo está vacío, en un modo (Frío, Calor, Auto, Seco, Ventilador), a una temperatura en °C (convertida para los dispositivos en Fahrenheit), en una sola orden. La temperatura se ajusta a los valores de cada mando en ese modo; vacía, se mantiene la actual. Salidas: el número de aires encendidos y la temperatura aplicada.
- Apagar aires Sensibo: un aire acondicionado, o todos si el campo está vacío. Los desconectados se omiten. Salida: el número de aires apagados.
Para una sola función de un dispositivo, la acción de Gladys Controlar un dispositivo también sirve.
Ideas de escenas
- Salir de casa (alarma activada): Apagar aires Sensibo, campo vacío: todos los aires apagados.
- Ola de calor: cuando la Temperatura ambiente del dormitorio supera 27 °C, entre las 14 h y las 20 h: Encender aires Sensibo, dormitorio, Frío, 25.
- Recordatorio del filtro: Filtro que limpiar → enviar un mensaje: «Limpie el filtro de {{triggerEvent.data.name}}».
Solución de problemas
- «Sensibo rechaza la clave de API»: compruebe la clave en home.sensibo.com/me/api, o cree una nueva. Tras este error, la integración solo lo vuelve a intentar una vez por hora, o de inmediato cuando guarde la configuración o haga clic en Probar la conexión.
- «Demasiadas solicitudes»: la nube de Sensibo limita las solicitudes de una clave; la integración espera diez minutos. Elija un intervalo más largo si vuelve a ocurrir.
- Se rechaza un modo o una velocidad: el mando de su aire acondicionado no lo ofrece en ese modo. La aplicación Sensibo muestra lo que ofrece.
- El aire acondicionado no reacciona: un Sensibo envía infrarrojos: compruebe que ve la unidad interior y que el mando configurado en la aplicación Sensibo es el correcto.
- Más detalles: los registros de la integración (Ajustes → Integraciones → Sensibo). Nunca contienen la clave de API.
Límites
- Solo nube: sin Internet, o cuando la nube de Sensibo falla, no se puede controlar nada desde Gladys.
- Una lectura por minuto como máximo, para respetar los límites de la API de Sensibo. Los cambios hechos con el mando se ven en la lectura siguiente.
- El infrarrojo no tiene retorno: el estado mostrado es el último que envió Sensibo, no uno leído en el aire acondicionado.
- Climate React, programaciones, temporizadores, Pure Boost y los sensores de movimiento de Sensibo se configuran en la aplicación Sensibo; Gladys solo activa o desactiva Climate React. La velocidad del Pure no se ofrece.
- En un panel, Gladys puede mostrar el interruptor Climate React con su nombre genérico, «Interruptor».
- Desarrollada sin el hardware: sus comentarios son bienvenidos.
- Sin relación con Sensibo.
Parámetros de configuración
Estos son los parámetros que Sensibo te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su cuenta Sensibo | section | No | Cree una clave de API en su cuenta Sensibo y péguela abajo: cada Sensibo de la cuenta se convierte en un dispositivo en la pestaña Descubrimiento. La integración lee la nube de Sensibo: se necesita conexión a Internet. |
| Clave de API | secret | Sí | Se queda en Gladys y solo se envía a la nube de Sensibo. Elimínela en su cuenta Sensibo para revocarla. |
| Intervalo de actualización | select | No | Frecuencia de lectura de la nube de Sensibo (una solicitud para todos los dispositivos). Un cambio hecho desde Gladys se muestra al instante. |
| Idioma de los nombres | select | No | Idioma de los nombres de las funciones y de los mensajes de la integración. |
Cómo instalar Sensibo en Gladys
- En Gladys, abre Integraciones: Sensibo 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-sensibo:1.0.0), 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-sensibo.
Sensibo 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
Sensibo 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