Integración domótica Bosch Smart Home, gratuita y de código abierto
Controlador Bosch Smart Home en local: calefacción, contactos, humo, enchufes, persianas, alarma.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Conecte su Bosch Smart Home Controller (primera o segunda generación) a Gladys, por su red local, sin ninguna nube: la calefacción de cada habitación (temperatura, consigna, modo), los termostatos de radiador y de ambiente, los contactos de puerta y ventana, los detectores de movimiento, los detectores de humo, los enchufes, los interruptores, las persianas, los detectores de fugas de agua, los interruptores universales y el estado de la alarma de intrusión.
Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se ha construido a partir de la API local pública del controlador y del trabajo de la biblioteca boschshcpy, y se ha probado con un controlador simulado, no con uno real. Si algo no funciona como se describe, indíquelo en el foro de Gladys o en las issues.
Esta integración no está afiliada a Bosch ni respaldada por Bosch.
Lo que necesita
- Gladys Assistant 5.1.0 o posterior.
- Un Bosch Smart Home Controller (I o II), instalado con la aplicación Bosch Smart Home, en la misma red local que Gladys.
- Su dirección IP. La aplicación la muestra en Ajustes → Sistema → Smart Home Controller; su router también la muestra. Asigne una dirección fija al controlador (reserva DHCP en su router): la integración lo contacta en esa dirección.
- Su contraseña del sistema, elegida al instalar el controlador. Solo se usa una vez, para el emparejamiento.
- Acceso al controlador, para pulsar su botón durante el emparejamiento.
Configuración
El controlador solo habla con los clientes que ha emparejado. El
emparejamiento registra a Gladys como cliente del controlador, con un
certificado que la integración genera y guarda en su volumen /data.
- En Gladys, abra Integraciones → Bosch Smart Home → Configuración.
- Introduzca la Dirección IP del controlador (p. ej.
192.168.1.20) y la Contraseña del sistema y guarde. - Vaya al controlador y mantenga pulsado su botón (en el frontal) hasta que parpadeen sus luces: el controlador queda en modo emparejamiento durante un breve momento.
- De vuelta en Gladys, haga clic enseguida en Emparejar. Tras unos segundos, el resultado aparece bajo el botón: Emparejado. N dispositivo(s) encontrado(s).
- Abra la pestaña Descubrimiento y añada los dispositivos que desee.
Una vez emparejado, la contraseña del sistema se borra de la configuración de Gladys: ya no se necesita. El emparejamiento aparece en la aplicación Bosch (como oss_Gladys_Assistant), donde puede eliminarlo en cualquier momento.
Probar la conexión vuelve a leer el controlador e indica su versión de software y cuántos dispositivos son compatibles.
Los demás ajustes:
- Idioma de los nombres: el idioma de los nombres de las funciones de los nuevos dispositivos y de los textos que envía la integración (francés por defecto).
- Duración de un movimiento: un detector de movimiento solo indica la hora de cada detección; es el tiempo durante el que su función Movimiento permanece activa (1 minuto por defecto).
- Permitir el armado desde Gladys: desactivado por defecto, vea Alarma de intrusión más abajo.
- No comprobar el certificado del controlador: desactivado. Solo para un controlador cuyo certificado ha caducado porque estuvo sin Internet durante años: la conexión falla entonces con un error de certificado.
Dispositivos
Cada dispositivo compatible del controlador se convierte en un dispositivo de Gladys, con el nombre de la aplicación Bosch. Los estados llegan en tiempo real: la integración mantiene abierta una suscripción a los eventos del controlador (long polling, como recomienda Bosch) y lo vuelve a leer todo cada 15 minutos por seguridad. Un dispositivo que el controlador declara no disponible muestra la insignia inaccesible.
Calefacción
Bosch gestiona la calefacción por habitación: para cada habitación con termostatos de radiador, el controlador tiene una regulación de habitación, que se convierte en el dispositivo Calefacción <habitación>:
| Función | Qué hace |
|---|---|
| Temperatura | Temperatura de la habitación medida por el controlador. |
| Consigna | Temperatura deseada, de 5 a 30 °C por medios grados. En modo manual se mantiene. |
| Modo de calefacción | Apagado (verano), Manual (consigna fija) o Programa (el programa semanal de la aplicación Bosch). |
| Demanda de calefacción | Si un radiador de la habitación pide calor. |
En modo Programa, una nueva consigna vale hasta el siguiente paso del programa, como en la aplicación Bosch. Cuando la habitación está en modo eco, una nueva consigna sale del modo eco.
Los termostatos de radiador y los termostatos de ambiente también son dispositivos: Temperatura, Humedad (termostatos de ambiente que la miden) y Batería baja.
Sensores
| Dispositivo | Funciones |
|---|---|
| Contacto de puerta/ventana | Apertura, Batería baja |
| Detector de movimiento | Movimiento, Batería baja |
| Detector de humo | Humo, Batería baja |
| Detector de fugas de agua | Fuga de agua, Batería baja |
| Interruptor universal | Batería baja |
Humo se activa cuando el propio detector detecta humo. Cuando es otro detector de la casa, todos los detectores suenan, pero solo el de la habitación con humo muestra Humo: el disparador Detector de humo en alarma distingue los dos casos.
Enchufes, interruptores y persianas
| Dispositivo | Funciones |
|---|---|
| Enchufe inteligente, enchufe compacto | Encendido/Apagado, Potencia (W), Energía (kWh) |
| Interruptor de luz, micromódulos de luz y de relé | Encendido/Apagado (y Potencia, Energía si se miden) |
| Control de persiana, módulos de persiana y toldo | Posición (0 % cerrada, 100 % abierta), Abrir/Cerrar (abrir, cerrar, parar) |
Energía es el contador del enchufe: Gladys le añade las funciones de consumo y de coste en las pantallas de energía.
Alarma de intrusión
Cuando el controlador tiene el sistema de alarma de intrusión, el dispositivo Alarma de intrusión muestra:
- Armada: activa cuando el sistema está armado;
- Alarma activada: activa durante una prealarma o una alarma;
- Estado de la alarma: Desarmada, Armándose, Armada, Prealarma, ¡Alarma! o Alarma silenciada.
La alarma es de solo lectura por defecto. Con Permitir el armado desde Gladys, la acción de escena Armar la alarma de intrusión puede armarla. Desarmarla o silenciarla nunca es posible desde Gladys: una escena, un asistente de voz o un panel compartido no deben poder desactivar la protección de la casa. Use la aplicación Bosch para ello.
Panel
El widget Bosch Smart Home (en la lista de widgets de un panel) resume la casa: el estado del controlador y de la alarma de intrusión, cuántas puertas y ventanas están abiertas, cuántas pilas están bajas, cuántos dispositivos no responden, y luego sus nombres. Es de solo lectura.
Las funciones se colocan en un panel como de costumbre (widget Dispositivos de la habitación, widget de termostato…).
Escenas
Disparadores
Detector de humo en alarma: un detector de humo detecta humo, o suena
porque otro lo detecta. Filtros: el detector, el origen (Humo detectado por
este detector o Alarma transmitida desde otro detector). Información
transmitida a la escena: Nombre del detector, Habitación, Origen
(detected o relayed).
Interruptor universal pulsado: una pulsación corta o larga en una tecla de un interruptor universal Bosch. Filtros: el interruptor, la tecla (superior, inferior y las cuatro del modelo de cuatro teclas), la pulsación (Pulsación corta, Pulsación larga). Información transmitida: Nombre del interruptor, Habitación, Tecla, Pulsación.
Los demás estados (una ventana abierta, una fuga, la alarma armada) son funciones de dispositivo: use el disparador habitual Estado de un dispositivo de Gladys.
Acciones
Armar la alarma de intrusión: arma el sistema de alarma del controlador con un perfil de protección: Protección total, Protección parcial o Protección personalizada (tal como se configuró en la aplicación Bosch). Solo funciona si Permitir el armado desde Gladys está activado; si no, la acción falla y la escena continúa.
Ideas de escenas
- Incendio: disparador Detector de humo en alarma → encender todas las luces, abrir las persianas, enviar a todos un mensaje con la Habitación del detector (desde el selector de variables).
- Botón de la mesilla: disparador Interruptor universal pulsado, tecla inferior, pulsación larga → cerrar todas las persianas y apagar las luces.
- Ventana abierta, calefacción apagada: disparador Estado de un dispositivo sobre la Apertura de la ventana del salón = abierta durante 2 minutos → poner el Modo de calefacción de la habitación en Apagado (verano); volver a Programa al cerrarla.
- Salir de casa: cuando la casa queda vacía → Armar la alarma de intrusión (Protección total), tras permitir el armado en la configuración.
Solución de problemas
- Aún no emparejado: siga la Configuración anterior; el emparejamiento se
guarda en el volumen
/datade la integración y sobrevive a las actualizaciones. - el controlador no está en modo emparejamiento: el botón no se pulsó el tiempo suficiente, o el modo emparejamiento terminó antes del clic. Pulse hasta que parpadeen las luces y haga clic en Emparejar en los segundos siguientes.
- contraseña del sistema rechazada: compruebe la contraseña en la aplicación Bosch (allí se puede cambiar), escríbala de nuevo, guarde y vuelva a emparejar.
- el controlador no responde en esta dirección: compruebe la dirección IP (puede haber cambiado: asigne una fija al controlador) y que Gladys llega al controlador por los puertos 8443 (emparejamiento) y 8444 (API).
- el controlador rechaza a Gladys (vuelva a emparejarlo): el emparejamiento se eliminó en la aplicación Bosch, o el controlador se restableció. Vuelva a emparejar.
- el certificado del controlador no es un certificado Bosch válido: otro aparato responde en esta dirección, o el certificado del controlador ha caducado. Compruebe la dirección; si es la correcta, marque No comprobar el certificado del controlador.
- Un dispositivo nuevo de la aplicación Bosch aparece solo en la pestaña Descubrimiento en pocos segundos; uno eliminado allí desaparece.
- Registros detallados: defina la variable de entorno
LOG_LEVEL=debugde la integración. Los registros nunca contienen la contraseña, la clave ni el certificado.
Límites
- Desarrollada sin el hardware: probada solo con un controlador simulado. Sus comentarios son bienvenidos.
- Un solo controlador por instancia de Gladys.
- Dispositivos compatibles: termostatos de radiador I y II, termostatos de ambiente, termostatos de pared, contactos de puerta/ventana I y II, detectores de movimiento I y II, detectores de humo I y II, enchufes inteligentes y compactos, interruptores de luz, micromódulos de luz y de relé, controles de persiana I y II, módulos de persiana y toldo, detectores de fugas de agua, interruptores universales. No compatibles (ignorados): Twinguard, cámaras, sirena exterior, reguladores y luces de color, circuitos de calefacción y calderas, simulación de presencia, escenarios y automatizaciones de Bosch.
- No se ofrecen: la posición de la válvula de los termostatos de radiador, la luminosidad del detector de movimiento II, los preajustes boost y eco, el bloqueo infantil y los demás ajustes de los dispositivos.
- La alarma de intrusión solo se puede armar (opcional), nunca desarmar ni silenciar.
- Bosch pide a los clientes locales usar long polling y limitar el número de peticiones: la integración mantiene una sola petición de eventos abierta a la vez (30 s cada una), lo vuelve a leer todo cada 15 minutos (4 peticiones) y reenvía a Gladys los valores sin cambios cada 6 horas.
- La API local de Bosch está reservada a un uso privado y no comercial.
Parámetros de configuración
Estos son los parámetros que Bosch Smart Home te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su Smart Home Controller | section | No | Smart Home Controller I o II, en la misma red que Gladys. 1. Introduzca su dirección IP y su contraseña del sistema y guarde. 2. Pulse el botón del controlador hasta que parpadeen las luces. 3. Haga clic en «Emparejar» antes de un minuto. |
| Dirección IP del controlador | string | Sí | Aparece en la aplicación Bosch Smart Home (Ajustes, Sistema, Smart Home Controller) o en su router. Asígnele una dirección fija. |
| Contraseña del sistema | secret | No | La contraseña elegida al instalar el controlador. Se usa una vez, para el emparejamiento, y luego se borra de Gladys. |
| Idioma de los nombres | select | No | Idioma de los nombres de las funciones de los nuevos dispositivos y de los textos que envía la integración. |
| Duración de un movimiento | select | No | El controlador solo envía la hora de cada detección: tiempo durante el que un detector muestra entonces «movimiento». |
| Seguridad | section | No | La alarma de intrusión es de solo lectura por defecto. Desarmarla o silenciarla nunca es posible desde Gladys. |
| Permitir el armado desde Gladys | boolean | No | Permite que la acción de escena «Armar la alarma de intrusión» arme el sistema de alarma del controlador. |
| No comprobar el certificado del controlador | boolean | No | Solo si la conexión falla por un error de certificado (controlador sin Internet durante años). Menos seguro. |
Cómo instalar Bosch Smart Home en Gladys
- En Gladys, abre Integraciones: Bosch Smart Home 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-bosch-shc: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-bosch-shc.
Bosch Smart Home 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
Bosch Smart Home 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