Integración domótica Bosch HomeCom Easy, gratuita y de código abierto

Bombas de calor, calderas y aires acondicionados Bosch de la app HomeCom Easy, vía la nube Bosch.

• Publicado por guim31
• Dispositivos
• Versión 1.0.1
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones

Presentación

Esta integración lleva a Gladys los aparatos Bosch de su cuenta HomeCom Easy, a través de la nube Bosch (la misma que usa la app):

• las bombas de calor y calderas conectadas a un Connect-Key K 30 RF / K 40 RF (Compress 5800i, 6800i, calderas Condens…) o a un módulo ICOM (Compress 7000i / 7001i AW): temperatura exterior, temperaturas de impulsión y de retorno, presión de la instalación, estado del generador, averías y, por cada circuito de calefacción, la temperatura ambiente, la consigna ambiente y el modo de funcionamiento; el agua caliente sanitaria con su temperatura, su consigna, su modo y la carga puntual;
• los aires acondicionados Climate (3000i, 5000i, 6000i): encendido/apagado, modo, consigna, velocidad del ventilador, temperatura ambiente.

Lee la nube cada pocos minutos y envía sus órdenes de inmediato, dentro de los límites que anuncia el aparato.

Desarrollada sin el hardware: esta integración se ha escrito a partir del trabajo público de la comunidad (vea «Límites» y los créditos del README) y se ha probado con respuestas grabadas, no con un aparato real. Sus comentarios son bienvenidos, en el foro de Gladys o en las issues de GitHub.

Esta integración no está afiliada a Bosch ni aprobada por Bosch. Es distinta de la integración Bosch Smart Home (Smart Home Controller), que cubre otros productos.

Requisitos

• Gladys 5.1.0 o posterior.
• Una cuenta HomeCom Easy (SingleKey ID) en la que su aparato ya está instalado y funciona en la app. Los aparatos Buderus de la app MyDevice funcionan igual: elija «Buderus MyDevice» como marca de la app.
• Un ordenador con un navegador con herramientas de desarrollo (Chrome, Edge, Firefox), para el inicio de sesión único.
• Gladys debe tener acceso a Internet (singlekey-id.com y pointt-api.bosch-thermotechnology.com).

Configuración

Bosch no ofrece un inicio de sesión público para software de terceros: la integración usa el inicio de sesión de la app, que termina en una dirección que solo la app sabe abrir. Usted copia un código a mano, una sola vez.

1. En Integraciones → Bosch HomeCom Easy → Configuración, elija la marca de la app y guarde.
2. Haga clic en Conectar junto a «Cuenta Bosch (SingleKey ID)»: la página de inicio de sesión de Bosch se abre en una pestaña nueva.
3. En esa pestaña, pulse F12 para abrir las herramientas de desarrollo y elija la pestaña Red. Después inicie sesión con el correo electrónico y la contraseña de su SingleKey ID.
4. La última página no se abre (el navegador no sabe abrir com.bosch.tt.dashtt.pointt://…): es normal. En la pestaña Red, busque la petición cuya dirección contiene code= y copie el valor tras code= (termina en -1). También sirve copiar la dirección completa.
5. Péguelo en Código de autorización y guarde en menos de un minuto: el código caduca pronto y solo sirve una vez.

El estado pasa a «conectado» y los aparatos aparecen en la pestaña Descubrimiento: añada los que desee.

Su contraseña nunca llega a Gladys. La integración guarda un token de actualización en su volumen privado (/data) y lo renueva sola: solo vuelve a iniciar sesión si Bosch lo revoca (cambio de contraseña, cierre de todas las sesiones…). El estado lo indica entonces.

Otros ajustes:

• Intervalo de actualización: frecuencia de lectura de la nube, 5 minutos por defecto, 2 minutos como mínimo.
• Idioma de los nombres de aparatos: los nombres fijados al añadir un aparato (francés por defecto).
• Probar la conexión: lista los aparatos de la cuenta, compatibles o no.

Aparatos

Cada instalación da varios aparatos de Gladys, para colocar cada circuito en su habitación. Solo se crean los valores que su aparato comunica.

Generador de calor

La bomba de calor o la caldera: temperatura exterior, temperaturas de impulsión y de retorno, presión de la instalación (bar), estado del generador (calefacción, agua caliente, antihielo, en reposo), consumo total (kWh, solo ICOM) y códigos de avería activos («Sin averías» si no hay).

Circuito de calefacción

Un aparato por circuito (hc1, hc2…): temperatura ambiente (si hay una sonda o un termostato de ambiente), humedad (si está disponible), consigna ambiente y modo de funcionamiento (programa, manual, apagado — los modos que ofrece el circuito). La consigna se limita al rango que anuncia el aparato (5–30 °C normalmente) y se redondea al medio grado. En refrigeración, se cambia la consigna de refrigeración.

Agua caliente

Un aparato por circuito de agua caliente: temperatura del agua, consigna, modo (apagado, eco, confort, programa propio…, según el aparato) y carga de agua caliente, una carga puntual que usted inicia o detiene. La consigna cambia la temperatura del nivel en uso (confort, eco…); no se puede cambiar cuando el agua caliente está apagada.

Aire acondicionado

Encendido/apagado, modo (auto, frío, calor, deshumidificación, ventilación), consigna (16–30 °C normalmente), velocidad del ventilador y temperatura ambiente.

Widget

Calefacción y agua caliente muestra en el panel la temperatura y la consigna ambiente del primer circuito, las temperaturas del agua caliente y exterior, los modos de calefacción y de agua caliente, lo que hace el generador y las averías, con un botón Carga de agua. En sus ajustes, elija cualquier aparato de una instalación para mostrarla (útil con varias pasarelas); vacío, se muestra la primera.

Disparador de escena

Avería Bosch notificada inicia una escena cuando un aparato notifica un nuevo código de avería. Elija el generador de calor o el aire acondicionado, o déjelo vacío para cualquiera. La variable Código de avería contiene el código (por ejemplo A01-5), para incluirlo en una notificación. Las averías ya presentes al iniciar sesión no inician la escena, y una avería la inicia una vez, no en cada lectura.

Las temperaturas, los modos y las consignas son funciones de aparatos: úselas en los disparadores y condiciones habituales «valor de un aparato» del editor de escenas.

Ejemplos de escenas

• Alerta de avería: disparador «Avería Bosch notificada» → enviar el mensaje «Avería bomba de calor {{triggerEvent.data.code}}» a la familia.
• Agua caliente con excedente solar: cuando la producción solar supere 2 kW, encender «Carga de agua caliente» del aparato de agua caliente.
• Ausencia: cuando todos se van, poner la consigna ambiente a 17 °C; cuando vuelve la primera persona, a 20 °C.
• Tarde de verano: a las 19:00, si el salón supera 27 °C, encender el aire acondicionado en modo frío a 25 °C.

Solución de problemas

• «Este código no procede del botón Conectar»: el código se obtuvo en otro lugar (por ejemplo con otra herramienta). Haga clic en Conectar en esta integración, inicie sesión de nuevo y pegue el nuevo código.
• «Bosch ha rechazado el código»: el código ya se usó, ha caducado (dura alrededor de un minuto) o se copió incompleto. Haga clic de nuevo en Conectar; pegue el valor justo después de code=, hasta el & si lo hay.
• Ninguna petición con code=: abra las herramientas de desarrollo antes de iniciar sesión, en la pestaña de la página de inicio de sesión. En Chrome, marque «Conservar registro» en la pestaña Red.
• «La sesión de Bosch ha caducado»: Bosch revocó el token de actualización. Inicie sesión de nuevo como se indica en Configuración.
• «La nube de Bosch no responde»: corte de Internet o de Bosch; la integración reintenta en cada actualización e indica cuando vuelve a funcionar. Los aparatos siguen en la lista.
• Falta un aparato: ejecute Probar la conexión. Un aparato indicado como «no compatible» (calentador de agua wddw2, termostato rrc2, cargador de vehículos, aire acondicionado Matter…) aún no está cubierto.
• Se rechaza una orden: el valor está fuera del rango que anuncia el aparato, o el modo no lo ofrece este aparato. Los registros de la integración indican el motivo (LOG_LEVEL=debug muestra cada lectura).

Límites

• Solo nube: sin acceso local. Si la nube de Bosch o la conexión a Internet fallan, no se lee ni se envía nada.
• Cuotas: Bosch no publica ninguna cuota para esta API. La integración es moderada: dos o tres peticiones por pasarela en cada actualización (5 minutos por defecto, 2 minutos como mínimo), una petición por orden, y se detiene en cuanto Bosch responde «demasiadas peticiones» o rechaza la sesión.
• API no oficial: es la de la app HomeCom Easy, documentada por la comunidad. Bosch puede cambiarla sin aviso.
• Retraso: una orden se muestra de inmediato, pero la nube puede tardar un minuto en comunicar el nuevo valor; la lectura siguiente lo confirma o lo corrige.
• K30/K40 en modo programa: la consigna ambiente escrita es la del modo manual (como en la integración de Home Assistant). Para cambiar la temperatura ambiente ahora, pase el circuito a manual.
• No cubiertos: programas de vacaciones y ausencia, horarios, ventilación, circuitos solares, piscinas, historial de energía (contadores diarios y mensuales), calentadores de agua wddw2, termostatos rrc2, cargadores de vehículos y aires acondicionados puestos en servicio mediante Matter.
• Los ajustes que podrían ser peligrosos (curvas de calefacción, temperatura de impulsión máxima, desinfección térmica) no se ofrecen.

Datos y privacidad

La integración guarda en su volumen privado (/data): el token de actualización de su cuenta Bosch, el secreto PKCE del último inicio de sesión en curso, la lista de sus aparatos y los códigos de avería ya notificados. Nunca guarda ni registra su contraseña, sus tokens ni el código de autorización. Solo se comunica con singlekey-id.com y pointt-api.bosch-thermotechnology.com.

Parámetros de configuración

Estos son los parámetros que Bosch HomeCom Easy te pide en su pantalla de configuración en Gladys.

Parámetro	Tipo	Obligatorio	Descripción
Bosch HomeCom Easy	section	No	Lee y controla los aparatos Bosch de su cuenta HomeCom Easy a través de la nube Bosch: bombas de calor y calderas con pasarela K 30 RF / K 40 RF o ICOM, aires acondicionados Climate. Sin relación con Bosch. Desarrollada sin el hardware: se agradecen los comentarios.
Marca de la app	select	No	La app que usa: Bosch HomeCom Easy o Buderus MyDevice. Guarde antes de hacer clic en «Conectar».
Inicio de sesión en su cuenta Bosch	section	No	1. Haga clic en «Conectar»: la página de inicio de sesión de Bosch se abre en una pestaña nueva. 2. En esa pestaña, pulse F12 y abra la pestaña Red; después inicie sesión con su SingleKey ID. 3. La última página no se abre (es normal): en la pestaña Red, copie el valor tras «code=» (termina en «-1»). 4. Péguelo abajo y guarde en menos de un minuto.
Cuenta Bosch (SingleKey ID)	account_link	No	Abre la página de inicio de sesión de Bosch. Su contraseña nunca llega a Gladys.
Código de autorización	secret	No	El código copiado tras iniciar sesión, se usa una sola vez. También sirve la dirección completa con «code=».
Intervalo de actualización (minutos)	number	No	Frecuencia de lectura de la nube Bosch: 2 minutos como mínimo, para no sobrecargarla.
Idioma de los nombres de aparatos	select	No	Nombres de los aparatos y funciones, fijados al añadirlos.

Cómo instalar Bosch HomeCom Easy en Gladys

1. En Gladys, abre Integraciones: Bosch HomeCom Easy aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-bosch-homecom: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).
3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-bosch-homecom.

Bosch HomeCom Easy 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 HomeCom Easy 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

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂