Integración domótica Muller Intuitiv (intuis), gratuita y de código abierto
Radiadores Muller Intuitiv con la nube intuis Connect: habitaciones, consignas, modos, consumo.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.2.0
- ★ 0
Presentación
Esta integración controla desde Gladys los radiadores conectados Muller Intuitiv: los de las marcas Muller, Campa, Airelec, Applimo o Noirot con el módulo conectado y configurados con la app intuis Connect (antes «Muller Intuitiv with Netatmo»). Pasa por la nube de intuis, como la app: Gladys ve lo que ve la app, y lo que usted cambia en Gladys aparece en la app.
Para cada habitación: la temperatura medida, la consigna, el modo (programación o manual), el modo de calefacción (programación, ausencia, antihielo), si calienta en este momento, la detección de ventana abierta, la presencia y la electricidad consumida cuando sus radiadores la miden. Para la vivienda: el modo de la casa y la programación semanal activa.
Integración independiente, sin relación con Muller, Groupe Atlantic ni intuis. Desarrollada sin el hardware: se basa en la API documentada por proyectos de la comunidad (Home Assistant, Jeedom, Node-RED). Sus comentarios son bienvenidos en el foro de Gladys o en las incidencias de GitHub.
Requisitos
- Gladys 5.2.0 o más reciente.
- Radiadores ya instalados y configurados en la app intuis Connect, con su pasarela conectada.
- El correo electrónico y la contraseña de su cuenta intuis Connect.
Configuración
- En Gladys, abra Integraciones, instale Muller Intuitiv (intuis) y abra su pestaña Configuración.
- Introduzca el correo y la contraseña de la app intuis Connect y guarde. El estado de la conexión aparece arriba en la pantalla.
- El botón Probar la conexión indica cuántas viviendas y habitaciones se han encontrado.
- Abra la pestaña Descubrir: aparecen cada habitación y la vivienda. Añada las que le interesen.
Ajustes opcionales:
- Duración de una consigna fijada desde Gladys: cuánto tiempo se mantiene una temperatura elegida en Gladys antes de que la habitación vuelva a su programación, como con el «+» y el «-» de la app. Por defecto, la duración configurada en la app intuis.
- Seguir el consumo de cada habitación: activado por defecto.
- Idioma de los nombres de funciones: francés por defecto. Los nombres se fijan al añadir el dispositivo: un cambio solo se aplica a los dispositivos añadidos después.
La contraseña se queda en Gladys y solo se envía a intuis para iniciar sesión. La integración guarda
en su carpeta /data los tokens de sesión que intuis le entrega, nunca la contraseña.
Dispositivos
La vivienda
| Función | Qué hace |
|---|---|
| Modo de la casa | Programación, Ausencia o Antihielo para toda la vivienda. Ajustable en Gladys. |
| Programación activa | El nombre de la programación semanal elegida en la app (solo lectura). |
Cada habitación
| Función | Qué hace |
|---|---|
| Temperatura | La temperatura medida por los radiadores de la habitación. |
| Consigna | La temperatura deseada, de 7 a 30 °C por medio grado. Cambiarla desde Gladys la mantiene durante la duración elegida y luego vuelve la programación. |
| Programación o manual | «Auto» mientras la habitación sigue su programación, «Calor» mientras se mantiene una consigna manual. Elegir «Auto» devuelve la habitación a su programación. |
| Modo de calefacción | Programación, Ausencia o Antihielo solo para esta habitación. Durante una consigna manual, muestra lo que se reanudará después. |
| Calentando | Si un radiador de la habitación calienta en este momento. Solo cuando los radiadores lo indican (no con hilo piloto). |
| Ventana abierta | La detección de ventana abierta de los radiadores: «Abierto» cuando un descenso brusco de temperatura ha cortado la calefacción. |
| Presencia | El sensor de presencia integrado, en los radiadores que lo tienen. |
| Consumo | La electricidad consumida por la habitación, por media hora (o por día cuando intuis solo da el total diario), para el seguimiento de energía de Gladys. |
Calentando, Ventana abierta, Presencia y Consumo solo aparecen si sus radiadores los proporcionan. Si uno aparece más tarde (el consumo puede tardar un día), la pestaña Descubrir propone Actualizar en la habitación.
No se ofrece apagar del todo una habitación: un radiador apagado por error en invierno puede dejar que se congele una tubería. El antihielo es la parada segura; apagar sigue siendo posible en la app.
El consumo entra en la pestaña Energía de Gladys: asocie las habitaciones a su contador y a su contrato (tarifa única, horas valle…) para ver su coste. La lectura por media hora separa horas punta y horas valle.
Widget
Añada el widget Habitaciones a un panel. Muestra cada habitación en una línea (temperatura medida → consigna, modo, ventana abierta) y tres botones para el modo de la casa: Programación, Ausencia, Antihielo. El modo actual lleva una marca. Con varias viviendas, elija una en los ajustes del widget.
Escenas
La integración no declara ningún disparador: una temperatura, una ventana abierta o un modo son estados de dispositivos que el editor de escenas ya vigila («Cuando cambia el estado de un dispositivo»).
Añade una acción, en la categoría Integraciones del editor de escenas:
- Fijar la consigna de una habitación un tiempo: elija la habitación, la temperatura («20,5», se acepta una variable de escena) y la duración. Después la habitación vuelve a su programación. La acción da la hora de vuelta a la programación a las acciones siguientes.
Las funciones de los dispositivos también se controlan con la acción habitual «Controlar un dispositivo»: modo de la casa, consigna, modo de calefacción de una habitación.
Ejemplos de escenas
- Salir de casa: cuando se va la última persona, poner el Modo de la casa en Ausencia; a su vuelta, ponerlo de nuevo en Programación.
- Baño de la tarde: cada día a las 19 h, Fijar la consigna del cuarto de baño a 22,5 °C durante 1 hora.
- Ventana olvidada: cuando la Ventana abierta del salón pasa a «Abierto», enviar un mensaje; los radiadores ya dejan de calentar por sí mismos.
- Vacaciones: antes de salir, poner el Modo de la casa en Antihielo.
Ritmo y cuotas
- Las habitaciones y la vivienda se leen cada 5 minutos, y unos segundos después de cada orden. Una lectura cuesta dos peticiones a la nube de intuis.
- El consumo se lee una vez por hora, una petición por habitación añadida que lo proporciona. intuis lo completa con retraso: cuente hasta un día para el día en curso.
- intuis no publica ninguna cuota. Su API es la de Netatmo, cuyo límite documentado es de 500 peticiones por hora y por cuenta: la integración hace unas 30 para una vivienda. Si intuis pide reducir las consultas, las lecturas se detienen 15 minutos.
- Tras una contraseña rechazada, la integración espera 30 minutos antes de reintentar, para no bloquear nunca la cuenta. Guardar la configuración o pulsar Probar la conexión reintenta de inmediato.
Solución de problemas
- «intuis rechaza el correo o la contraseña»: compruébelos iniciando sesión en la app intuis Connect y guarde de nuevo la configuración.
- «La nube de intuis no responde»: el servicio intuis o su conexión a Internet no está disponible. Los dispositivos pasan a «inaccesibles» y todo se reanuda solo.
- Una habitación aparece sin conexión: su radiador ya no habla con la pasarela (corte de corriente, módulo desenchufado). Compruébelo en la app.
- La consigna vuelve sola: ha terminado la duración elegida y la habitación retoma su programación. Alargue la Duración de una consigna fijada desde Gladys.
- Sin consumo: no todos los radiadores lo miden (en particular los de hilo piloto). La integración vuelve a preguntar una vez por semana.
- Para más detalles, añada
LOG_LEVEL=debuga las variables de la integración y consulte sus registros: nunca muestran la contraseña ni los tokens.
Limitaciones
- Desarrollada sin el hardware ni una cuenta intuis: los intercambios con la nube siguen los proyectos de la comunidad y el autor no los ha probado en una instalación real.
- Pasa por la nube: sin Internet, o si intuis cambia su API, ya no llega nada.
- La programación semanal se edita en la app intuis, no en Gladys.
- No se puede apagar del todo una habitación desde Gladys (ver arriba) ni hay modo «boost».
- El consumo llega con retraso y solo algunos radiadores lo proporcionan.
Parámetros de configuración
Estos son los parámetros que Muller Intuitiv (intuis) te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su cuenta intuis Connect | section | No | Introduzca el correo y la contraseña de la app intuis Connect (antes Muller Intuitiv with Netatmo). Gladys encontrará cada habitación de su vivienda: abra la pestaña Descubrir. |
| Correo electrónico | string | Sí | |
| Contraseña | secret | Sí | Guardada por Gladys, solo se envía a intuis para iniciar sesión. |
| Duración de una consigna fijada desde Gladys | select | No | Después la habitación vuelve a su programación, como con el + y el - de la app. |
| Seguir el consumo de cada habitación | boolean | No | Cuando sus radiadores lo miden. Se lee una vez por hora, con hasta un día de retraso. |
| Idioma de los nombres de funciones | select | No | Se aplica a los dispositivos añadidos después. |
Cómo instalar Muller Intuitiv (intuis) en Gladys
- En Gladys, abre Integraciones: Muller Intuitiv (intuis) 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-intuis: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-intuis.
Muller Intuitiv (intuis) requiere Gladys >=5.2.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
Muller Intuitiv (intuis) 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