Integración domótica X-Sense, gratuita y de código abierto
Detectores X-Sense de humo, CO, calor y fugas de agua en Gladys: alarmas, batería, estación.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
La seguridad, primero. Gladys no sustituye a las sirenas de sus detectores, y no es un servicio de vigilancia. Las alarmas pasan por la nube de X-Sense: llegan a Gladys tras unos segundos (a veces más), y no llegan en absoluto si su acceso a internet, la nube de X-Sense o Gladys fallan. Utilice esta integración para añadir notificaciones y automatizaciones (luces encendidas, calefacción apagada, un mensaje a un vecino), nunca como su único aviso.
Presentación
Esta integración lleva a Gladys los detectores X-Sense de humo, monóxido de carbono (CO), calor y fugas de agua, a través de la nube de X-Sense — la que usa la aplicación X-Sense Home Security:
- un dispositivo de Gladys por detector: alarma en curso, batería, en línea, señal de radio o Wi-Fi y última prueba;
- un dispositivo de Gladys por estación base (SBS50, SBS10): en línea y señal Wi-Fi;
- disparadores de escena: alarma de incendio, alarma de CO, fuga de agua y batería baja, con el nombre y la habitación del detector;
- un widget del panel que lista todos los detectores, con las alarmas primero.
Las alarmas llegan en directo (el mismo canal de notificaciones que la aplicación), y la integración también lee la nube cada pocos minutos como red de seguridad.
Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración no está afiliada a X-Sense; X-Sense es una marca de su propietario.
Requisitos
- Detectores X-Sense vinculados a una cuenta X-Sense en la aplicación X-Sense Home Security: detectores de radio emparejados con una estación base SBS50 (o SBS10), o detectores Wi-Fi (XS01-WX, XC04-WX, SC07-WX…).
- El correo electrónico y la contraseña de esa cuenta. Una cuenta creada con «Iniciar sesión con Google/Apple» no tiene contraseña: cree una cuenta normal.
- Una segunda cuenta X-Sense para Gladys (muy recomendable): una misma cuenta no puede permanecer conectada a la aplicación y a Gladys a la vez, cada una desconectaría a la otra sin cesar. Cree una segunda cuenta en la aplicación y comparta con ella sus detectores desde su cuenta principal (el mismo consejo que la integración de Home Assistant).
- Gladys 5.1.0 o posterior, con acceso a internet.
Configuración
En Gladys, Integraciones → X-Sense → Configuración:
| Campo | Descripción |
|---|---|
| Correo electrónico | Correo electrónico de la cuenta X-Sense. |
| Contraseña | Su contraseña. Guardada por Gladys; la integración solo conserva los tokens de sesión en su volumen privado /data. |
| Idioma de los nombres de las funciones | Idioma de los nombres de las funciones de un dispositivo nuevo (Gladys conserva el nombre de una función una vez creada) y de los resultados de la autoprueba. Francés por defecto. |
| Intervalo de lectura de la nube (min) | Minutos entre dos lecturas completas de la nube (de 1 a 60, 5 por defecto). Las alarmas no lo esperan: llegan en directo. Esta lectura actualiza los niveles de batería y de señal. |
Guarde y pulse Probar la conexión: el resultado lista los detectores encontrados. Abra la pestaña Descubrimiento y añada los dispositivos que desee.
Cuotas y condiciones de uso. X-Sense no publica ninguna API pública: la integración usa la API privada de la aplicación, como la integración de Home Assistant, solo en lectura. Para no sobrecargar los servidores de X-Sense, lee la lista de dispositivos cada 30 minutos, el estado de cada estación base con el intervalo anterior (5 minutos por defecto, el ritmo de la integración de Home Assistant) y mantiene una sola conexión en directo por cuenta. No baje el intervalo más de lo necesario. X-Sense puede cambiar o cerrar esta API en cualquier momento.
Dispositivos
Detector (uno por detector de humo, CO, combinado, calor o fugas de agua):
| Función | Valores |
|---|---|
| Alarma de humo | 1 cuando el detector está en alarma de humo (detectores de humo y combinados). |
| Alarma de CO | 1 cuando el detector está en alarma de monóxido de carbono (detectores de CO y combinados). |
| Alarma de calor | 1 cuando el detector de calor está en alarma. Se muestra como un sensor de humo: Gladys no tiene categoría de calor, y es una alarma de incendio. |
| Fuga de agua | 1 cuando el detector de fugas detecta agua. |
| Batería | Batería en %. X-Sense solo da 4 niveles: 0, 33, 67 o 100 %. 33 % o menos se considera «baja». |
| En línea | 1 cuando el detector se comunica con su estación base (o con la nube en un detector Wi-Fi). |
| Señal de radio | Detectores de radio: de 0 a 3 barras hacia la estación base. |
| Señal Wi-Fi | Detectores Wi-Fi: señal en dBm (de -100 a -40). |
| Última prueba | Resultado y fecha de la última autoprueba (botón pulsado en el detector o prueba desde la aplicación), p. ej. «Superada · 12/10/26, 10:03». Vacío hasta la primera prueba tras la instalación. |
Estación base (SBS50, SBS10): En línea y Señal Wi-Fi (dBm).
Todo es de solo lectura. El nivel de CO en ppm, cuando el detector lo indica, se muestra en el widget y lo transmite el disparador «Alarma de CO» (Gladys no tiene ninguna función para mostrar un nivel de CO).
Widget
Detectores X-Sense: tres casillas (detectores en alarma, baterías bajas, dispositivos sin conexión) y una línea por detector — nombre, habitación, estado y batería — con las alarmas primero, luego los detectores sin conexión y luego las baterías bajas. Se listan hasta 10 detectores, una leyenda cuenta los demás. El widget se actualiza en cuanto una alarma empieza o termina.
Disparadores de escena
Los cuatro pueden limitarse a un detector (deje el campo vacío para todos). Sus variables se pueden usar en las
acciones de la escena, por ejemplo en un mensaje: {{triggerEvent.data.device_name}}.
| Disparador | Cuándo | Variables |
|---|---|---|
| Alarma de incendio (humo o calor) | Un detector activa una alarma de humo o de calor. Filtro: causa. | device_name, room, cause (smoke o heat) |
| Alarma de CO | Un detector activa una alarma de monóxido de carbono. | device_name, room, co_ppm |
| Fuga de agua | Un detector de fugas detecta agua. | device_name, room |
| Batería baja | La batería de un detector está baja (una vez por periodo, también tras un reinicio). | device_name, room, battery |
Una alarma que ya suena cuando arranca la integración dispara una vez. Las funciones anteriores también pueden usarse directamente como disparadores («la alarma de humo del detector de la cocina pasa a 1»).
Acción
Probar la conexión (pantalla de configuración): inicia sesión, lee la cuenta y lista los detectores encontrados. Úsela tras cambiar la contraseña: una contraseña rechazada no se reintenta automáticamente, para no bloquear la cuenta.
No hay ningún comando: la integración nunca silencia, prueba ni arma nada. Silenciar una alarma a distancia solo es posible desde la aplicación X-Sense, a propósito.
Ejemplos de escenas
- Incendio de noche: disparador «Alarma de incendio» → encender todas las luces, abrir las persianas de la vía de evacuación, enviar «🔥 Alarma de incendio: {{triggerEvent.data.device_name}} ({{triggerEvent.data.room}})» a todos los usuarios.
- Monóxido de carbono: disparador «Alarma de CO» → apagar el enchufe inteligente de la caldera, encender la ventilación, enviar «CO {{triggerEvent.data.co_ppm}} ppm en {{triggerEvent.data.room}}: salga y ventile».
- Fuga de agua: disparador «Fuga de agua» → cerrar la válvula de agua, enviar un mensaje con la habitación.
- Mantenimiento: disparador «Batería baja» → enviar «Cambie la pila de {{triggerEvent.data.device_name}}».
Solución de problemas
- «X-Sense rechaza el correo o la contraseña»: compruébelos en la aplicación X-Sense (cierre la sesión y vuelva a iniciarla). Las cuentas creadas con Google/Apple no tienen contraseña. Después, guarde de nuevo la configuración o pulse Probar la conexión.
- «Nube de X-Sense inaccesible»: Gladys no tiene acceso a internet, o la nube de X-Sense está caída. La integración lo reintenta por sí misma e indica cuándo vuelve.
- Falta un detector: solo se listan los detectores de humo, CO, calor y fugas de agua (ni cámaras, ni teclados, ni sensores de movimiento o de apertura, ni termohigrómetros). Pulse Probar la conexión y abra la pestaña Descubrimiento.
- «Sin valor reciente» en una batería: la integración vuelve a publicar cada valor al menos cada 6 horas; si persiste, consulte los registros de la integración.
- La aplicación del móvil se desconecta sin parar, o Gladys se reconecta sin parar: ambos usan la misma cuenta. Use una segunda cuenta X-Sense con los detectores compartidos (véase Requisitos).
- Más detalles en los registros: ponga
LOG_LEVEL=debugen el contenedor de la integración.
Limitaciones
- Solo nube: sin acceso local a la estación base. Sin internet, Gladys no recibe nada — los detectores siguen sonando.
- El retraso de las alarmas depende de la nube de X-Sense: normalmente unos segundos, a veces más.
- Solo lectura: sin silenciar, sin prueba, sin simulacro de incendio, sin armado desde Gladys.
- El nivel de CO en ppm no es una función del dispositivo (Gladys aún no tiene ninguna); el widget y el disparador de CO lo transmiten.
- El texto «Última prueba» solo aparece tras una prueba hecha mientras la integración funciona.
- API no oficial, estudiada por la comunidad (python-xsense, integración de Home Assistant): X-Sense puede cambiarla.
- Desarrollada sin el hardware: sus comentarios son bienvenidos en el repositorio de GitHub.
Parámetros de configuración
Estos son los parámetros que X-Sense te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Cuenta X-Sense | section | No | Utilice el correo electrónico y la contraseña de la aplicación X-Sense Home Security. Consejo: cree una segunda cuenta X-Sense, comparta su casa con ella desde la aplicación y utilícela aquí. Gladys no sustituye a las sirenas de sus detectores. |
| Correo electrónico | string | Sí | Correo electrónico de la cuenta X-Sense. |
| Contraseña | secret | Sí | |
| Idioma de los nombres de las funciones | select | No | Nombres de las funciones de un dispositivo nuevo (Gladys los conserva una vez creado) y de los resultados de la autoprueba. |
| Intervalo de lectura de la nube (min) | number | No | Las alarmas llegan en directo desde la nube de X-Sense. Esta lectura periódica es la red de seguridad y actualiza batería y señal. |
Cómo instalar X-Sense en Gladys
- En Gladys, abre Integraciones: X-Sense 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-xsense: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-xsense.
X-Sense 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
X-Sense 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