Integración domótica Netatmo, gratuita y de código abierto
Conecte sus dispositivos Netatmo (estación meteorológica, termostatos, cámaras) a Gladys Assistant.
Publicado por Terdious
- Dispositivos
- Versión 2.6.3
- Requiere Gladys >=5.2.0
- ★ 0
Conecte sus dispositivos Netatmo — estación meteorológica, termostatos y válvulas de radiador, cámaras de interior/exterior y sus accesorios, persianas enrollables Bubendorff, monitores de calidad del aire — a Gladys Assistant.
Esta integración se comunica con la nube de Netatmo en su nombre: usted crea una sola vez su propia aplicación Netatmo Connect, conecta su cuenta, y Gladys descubre sus dispositivos y mantiene sus valores actualizados.
En resumen
- Cree una aplicación gratuita en dev.netatmo.com/apps y copie su client ID y su client secret (paso 1).
- En Gladys: Integraciones → Netatmo → pestaña Configuración. Péguelos, haga clic en Guardar configuración y luego en Conectar (paso 2).
- Active las familias de dispositivos que tenga y guarde (paso 3).
- Pestaña Descubrir → Añadir a Gladys en cada dispositivo que quiera (paso 4).
- Opcional, con Gladys Plus: cree una clave de Open API y péguela en el bloque Webhooks de Gladys Plus para el tiempo real (sección Webhooks de Gladys Plus).
Requisitos previos
- Una cuenta Netatmo, con sus dispositivos ya instalados y funcionando en la aplicación Netatmo (Gladys lee lo que Netatmo expone — un dispositivo debe estar primero en línea en Netatmo).
- Gladys Assistant 5.2 o posterior.
- Opcional: una suscripción a Gladys Plus, solo para recibir los eventos en tiempo real (vea Webhooks de Gladys Plus). Sin ella todo funciona, con una actualización cada 2 minutos.
Paso 1 — Cree su aplicación Netatmo Connect
Gladys no incluye ninguna clave de Netatmo compartida: usted usa su propia aplicación Netatmo Connect, gratuita, para que sus datos queden entre su Gladys y su cuenta Netatmo. Se tarda 2 minutos.
-
Abra dev.netatmo.com/apps e inicie sesión con la misma cuenta que en la aplicación Netatmo (la que ve sus dispositivos).
-
Haga clic en Create para crear una aplicación y rellene el formulario:
- nombre de la aplicación y descripción: lo que quiera, por ejemplo
GladysyMi domótica; - nombre y correo del responsable de protección de datos (data protection officer): los suyos;
- Redirect URI: déjelo vacío;
- Webhook URI: déjelo vacío. Netatmo acepta un webhook por aplicación, y la integración registra el suyo (vea Webhooks de Gladys Plus): una dirección escrita aquí lo sustituiría.
Acepte las condiciones de uso y guarde (Save).
- nombre de la aplicación y descripción: lo que quiera, por ejemplo
-
La página de la aplicación muestra entonces dos valores:
- el client ID: una serie de letras y números;
- el client secret: otra serie, más larga.
Deje esta página abierta: los va a copiar en Gladys.
No hace falta configurar permisos (scopes) en el portal: Gladys solicita automáticamente los permisos necesarios (lectura + escritura, para Energía, Meteorología, Seguridad incluidas las cámaras y el timbre con vídeo, y las persianas enrollables) al conectar.
Paso 2 — Pegue las credenciales y conecte su cuenta
- En Gladys, abra Integraciones, busque Netatmo (insignia «externa») y abra la pestaña Configuración.
- En el bloque Aplicación Netatmo Connect:
- pegue el client ID en ID de cliente de la aplicación Netatmo;
- pegue el client secret en Secreto de cliente de la aplicación Netatmo.
- Baje al final del formulario y haga clic en Guardar configuración.
- Vuelva al campo Cuenta Netatmo y haga clic en Conectar. Se abre la página de Netatmo: inicie sesión si hace falta y acepte los permisos solicitados. Vuelve a Gladys y el estado pasa a Conectado.
La dirección de redirección mostrada encima del botón Conectar: Gladys la muestra para todas las integraciones que se conectan a una cuenta. Con Netatmo no hace falta declararla: el campo Redirect URI de su aplicación queda vacío. Solo si Netatmo rechaza la conexión por la dirección de redirección (
redirect_uri), cópiela con el botón de copiar, péguela en Redirect URI en dev.netatmo.com, guarde y vuelva a hacer clic en Conectar.
Si no funciona:
- «Introduzca Y GUARDE el ID / secreto de cliente de Netatmo…»: hizo clic en Conectar antes de guardar. Haga clic en Guardar configuración y luego otra vez en Conectar.
- Netatmo muestra un error en lugar de su página de inicio de sesión: el client ID o el secreto se copiaron mal (un espacio de más, un carácter que falta). Vuelva a copiarlos desde dev.netatmo.com, guarde y vuelva a conectar. Un secreto guardado ya no se muestra: deje su campo vacío para conservarlo, o pegue uno nuevo para sustituirlo.
- «Conectado, pero faltan permisos de Netatmo añadidos recientemente…»: una familia que acaba de activar (persianas, portero BTicino, Legrand…) necesita permisos adicionales. Vuelva a hacer clic en Conectar y acepte: sus dispositivos y ajustes se conservan.
Los tokens de acceso y de actualización los guarda la propia integración y nunca aparecen en el formulario. Gladys los renueva automáticamente; si la sesión caduca definitivamente, la pantalla de Configuración le invita a volver a conectarse.
Paso 3 — Elija las familias de dispositivos
En Dispositivos a descubrir, active las familias que posee:
| Interruptor | Descubre |
|---|---|
| Energía | Termostato (NATherm1), relé (NAPlug), válvulas de radiador (NRV), termostato modulante (OTM + OTH), BTicino Smarther (BNS) |
| Meteorología | Estación (NAMain) + módulos exterior, viento, lluvia e interiores adicionales |
| Seguridad | Cámaras de interior (NACamera), de interior Advance (NPC) y de exterior (NOC), timbre con vídeo (NDB), más sus accesorios y las personas conocidas |
| Persianas enrollables | Persianas Bubendorff de una pasarela iDiamant (NBR, NBO, NBS) |
| Calidad del aire | Monitor de calidad del aire interior — Home Coach (NHC), desactivado por defecto |
| Portero BTicino | Portero BTicino Classe 300X / Classe 300 EOS, un solo dispositivo (BNCX + sus BNEU, BNDL, BNSL, BNCS, BNXM) — vista previa, desactivado por defecto |
| Legrand Home + Control | Luces, reguladores, enchufes y relés Legrand with Netatmo de una pasarela Home + Control (NL*) — vista previa, desactivado por defecto |
Active los interruptores de las familias que tenga y haga clic en Guardar configuración: el descubrimiento se vuelve a ejecutar solo, no hace falta hacer clic en Buscar.
Calidad de la transmisión en directo de las cámaras (poor / low /
medium / high, por defecto high) define la calidad del directo de las
cámaras de interior y exterior. Bájela si el directo se entrecorta o tarda en
arrancar, sobre todo a distancia a través de Gladys Plus.
Los valores se actualizan cada 2 minutos (límites de uso de la API de Netatmo), o en segundos con los webhooks de Gladys Plus.
Paso 4 — Añada sus dispositivos a Gladys
- Abra la pestaña Descubrir de la integración. Cada dispositivo Netatmo encontrado aparece allí, con sus funciones.
- Haga clic en Añadir a Gladys en cada dispositivo que quiera. Pasa a la pestaña Dispositivos, donde puede cambiarle el nombre y elegir su habitación.
- Muéstrelo en el panel: Panel → Editar, y añada una caja (Dispositivos, Cámara, Termostato…) o uno de los widgets de la integración (Tiempo Netatmo, Calefacción Netatmo, Cámaras Netatmo, vea Widgets del panel).
Un dispositivo marcado Ya añadido ya está en Gladys. Tras una actualización de la integración, puede aparecer un botón Actualizar en un dispositivo ya añadido: le aporta las nuevas funciones, sin perder su historial.
¿No aparece nada? Compruebe que el estado es Conectado, que la familia está activada y guardada, y que el dispositivo está en línea en la aplicación Netatmo; luego haga clic en Buscar.
Modo de calefacción (programación / ausencia / antihielo)
Cada termostato (NATherm1, modulante OTM, BTicino Smarther BNS) y válvula
de radiador (NRV) incluye una funcionalidad Modo de calefacción (un
preajuste de termostato en Gladys) con tres opciones:
| En Gladys | En la aplicación Netatmo |
|---|---|
| Programación | seguir la programación semanal |
| Ausencia | modo ausente |
| Antihielo | antihielo (hg) |
En Netatmo, el modo es el de toda la casa: cambiarlo en un dispositivo cambia toda la vivienda, y cada termostato y válvula de la casa muestra el nuevo modo justo después (la integración se actualiza de inmediato). Un modo cambiado desde la aplicación Netatmo aparece en la siguiente actualización (2 minutos, o 2-3 segundos con los webhooks de Gladys Plus).
Úselo en una escena («todos se han ido → calefacción en Ausencia») con la acción estándar «Establecer valor del dispositivo».
⚠️ Si sus termostatos ya existían en Gladys, la funcionalidad no aparece sola: vaya a la pantalla Descubrimiento y haga clic en Actualizar en cada termostato y válvula. Se requiere Gladys 5.2 o posterior (el preajuste de termostato no existe antes).
Duración de una consigna enviada por Gladys
Netatmo termina cada consigna manual: tras la duración predeterminada definida en la aplicación Netatmo, la habitación vuelve a su programación Netatmo. El ajuste Duración de una consigna enviada por Gladys (sección Calefacción de la pantalla Configuración) elige cuánto duran las consignas que escribe Gladys — la Setpoint temperature de un termostato o una válvula, fijada desde la página del dispositivo, una acción de escena «Establecer valor del dispositivo» o el Termostato de Gladys:
| Opción | La consigna dura |
|---|---|
| Duración predeterminada de Netatmo | la duración predeterminada de la aplicación Netatmo (el comportamiento anterior a este ajuste, por defecto) |
| 1 hora … 12 horas | ese tiempo |
| Hasta el próximo cambio de programación | hasta el próximo tramo de la programación Netatmo activa que cambia la temperatura de la habitación, en la zona horaria de la casa (duración predeterminada de Netatmo si no se conoce ninguna programación) |
| Sin fin | tanto como Netatmo lo acepte: 30 días, menos si Netatmo rechaza ese final, sin hora de fin como último recurso — en la práctica hasta que Gladys (o alguien) la cambie |
Las acciones de escena Ajustar la consigna de una habitación y Potenciar una habitación conservan la duración que usted les da, y un boost conserva siempre su propia duración.
¿Utiliza la integración Termostato de Gladys? Elija Sin fin. Gladys controla la programación semanal y escribe ella misma cada cambio. Con una duración limitada, Netatmo vuelve a su propia programación al terminar la consigna, y Gladys ve la nueva consigna como un cambio hecho en el termostato: una anulación manual (vea La programación de Netatmo sigue funcionando más abajo).
Termostato modulante (OpenTherm)
El termostato Netatmo actual, el modelo modulante (OpenTherm), forma parte de la familia Energía. Sus dos módulos se crean cada uno como un dispositivo:
- el termostato (
OTM): temperatura de la habitación, una consigna ajustable, el Modo de calefacción (ver arriba), la detección de ventana abierta de su habitación (Detecting open window), el estado de la caldera (encendido mientras la caldera calienta), batería y señal de radio, como el antiguoNATherm1; - el relé OpenTherm (
OTH) conectado a la caldera: su calidad WiFi, la temperatura exterior con la que Netatmo modula la calefacción, y una funcionalidad Fallo de la caldera: 1 mientras la caldera indica un fallo a Netatmo (presión del agua, llama, mantenimiento…), 0 en caso contrario. La aplicación Netatmo indica de qué fallo se trata.
La habitación del termostato aparece en el widget Calefacción Netatmo, y el termostato puede elegirse en la acción de escena Cambiar el modo de calefacción. Un termostato inaccesible recibe la insignia inaccesible y su batería y su señal dejan de publicarse. No es necesario volver a conectar: los permisos de los termostatos forman parte de la conexión desde la primera versión.
Termostato BTicino Smarther
El termostato BTicino Smarther with Netatmo (BNS) forma parte de la
familia Energía. Se crea con la temperatura de su habitación, una consigna
ajustable, el Modo de calefacción (ver arriba), la detección de ventana
abierta de su habitación (Detecting open window), el estado de la
caldera (encendido mientras calienta), el estado de la climatización
(encendido mientras funciona el aire acondicionado), un estado Boost de
confort de solo lectura (el campo Netatmo boiler_valve_comfort_boost, tal
como se reporta) y su calidad WiFi. Su habitación aparece en el widget
Calefacción Netatmo y el termostato puede elegirse en la acción de escena
Cambiar el modo de calefacción.
⚠️ ¿Cuenta Netatmo conectada antes de esta versión? El Smarther necesita dos nuevos permisos de Netatmo (
read_smarther,write_smarther): vuelva a hacer clic en Conectar en la pantalla Configuración y acéptelos — sus dispositivos y ajustes se conservan. Mientras tanto, el estado de la conexión muestra el aviso «vuelva a hacer clic en Conectar», y una orden de consigna o de modo de calefacción en el Smarther falla con un mensaje «vuelva a conectar su cuenta Netatmo».
Usar el widget Termostato de Gladys
Gladys 5.2 incluye una integración Termostato y su widget de panel
Termostato: una programación semanal definida en Gladys, preajustes de
temperatura (Confort, Eco, Noche, Ausencia, Antihielo), un botón de parada y el
corte de la calefacción cuando se abre una ventana. Puede controlar un
termostato real, y cada habitación calefactada de Netatmo lo es: una
habitación con termostato (NATherm1, modulante OTM, Smarther BNS) o una
habitación solo con válvulas de radiador (NRV).
Para ello, un dispositivo por habitación calefactada — su termostato o, en una habitación sin termostato, una de sus válvulas — incluye dos funcionalidades con el nombre de la habitación (los nombres de las funcionalidades están en inglés en Gladys):
| Funcionalidad | Lo que indica |
|---|---|
| Heating state - habitación | estado de calefacción: Calentando mientras la habitación pide calor (o, en un termostato de caldera, mientras la caldera funciona), Inactivo si no (Enfriando mientras funciona el aire acondicionado de un Smarther) |
| Thermostat mode - habitación | Apagado o Calor, controlable: Apagado apaga la habitación en Netatmo, Calor la devuelve a su programación Netatmo. No se envía nada a Netatmo si la habitación ya está en ese modo |
El sensor de ventana es la funcionalidad Detecting open window que ya tienen todos los termostatos y válvulas: la detección de ventana abierta de Netatmo para su habitación, Abierto / Cerrado — 0 abierto, 1 cerrado, como todo sensor de apertura de Gladys (nada mientras Netatmo no la informa).
⚠️ Si sus termostatos y válvulas ya existían en Gladys, las nuevas funcionalidades no aparecen solas: vaya a la pantalla Descubrimiento y haga clic en Actualizar en cada termostato y válvula. No se necesita ningún permiso Netatmo nuevo.
Crear el termostato
- Abra la integración Termostato de Gladys y haga clic en Nuevo, un termostato por habitación Netatmo.
- En Tipo de termostato, elija Termostato real (el aparato regula por sí mismo).
- Elija las funcionalidades del dispositivo que incluye las de la habitación:
| Campo en Gladys | Funcionalidad Netatmo que elegir |
|---|---|
| Consigna del termostato real | Setpoint temperature de ese dispositivo |
| Sensor de temperatura | Temperature - room habitación |
| Estado de calefacción (opcional) | Heating state - habitación |
| Modo de funcionamiento (opcional) | Thermostat mode - habitación |
| Sensor de apertura de ventana | Detecting open window de un termostato o una válvula de la habitación (opcional, vea más abajo) |
- Defina los preajustes y una programación, guarde y añada el widget Termostato a un panel.
Cada termostato y cada válvula de una habitación tiene su propia Setpoint temperature, y todas ajustan la misma consigna de la habitación: elija la del dispositivo que incluye las funcionalidades de la habitación, para que todo el termostato lea un solo dispositivo.
Lo que obtiene
- el halo de calefacción del widget mientras la habitación calienta;
- la programación semanal y los preajustes de Gladys: en cada tramo, Gladys escribe la temperatura del preajuste como consigna de la habitación (una consigna manual en Netatmo);
- la parada (y los tramos Apagado): Gladys apaga la habitación en Netatmo y luego escribe su consigna antihielo — que no se envía mientras la habitación está apagada, así que la habitación sigue apagada. Puesta en marcha: la habitación vuelve a encenderse (con su programación Netatmo) y luego Gladys escribe su consigna;
- la ventana: cuando Detecting open window pasa a Abierto, Gladys detiene la habitación y la vuelve a poner en marcha al cerrarse la ventana. Es opcional: los termostatos y las válvulas Netatmo ya cortan la calefacción por sí mismos cuando detectan una ventana abierta. Elíjala si quiere ver la parada en Gladys.
La programación de Netatmo sigue funcionando
Gladys no desactiva la programación de Netatmo: la sustituye con consignas manuales. Netatmo termina una consigna manual tras la duración predeterminada definida en la aplicación Netatmo, y la habitación vuelve entonces a seguir su programación Netatmo — como cuando alguien gira el termostato o cambia la consigna en la aplicación Netatmo. Gladys ve cambiar la consigna en el dispositivo y la mantiene como una anulación manual, exactamente como un giro del dial del widget (durante la Duración del modo manual del termostato, o hasta el tramo siguiente), y luego retoma el control con su propia programación. Netatmo se lee cada 2 minutos y informa la misma consigna una y otra vez: Gladys reconoce su propia consigna en estas lecturas, así que un informe sin cambios nunca cuenta como un cambio. Para el resultado más previsible, ponga la Duración de una consigna enviada por Gladys en Sin fin (vea Duración de una consigna enviada por Gladys más arriba): las consignas que escribe Gladys se mantienen entonces hasta que Gladys las cambie.
Dos cosas más:
- una habitación apagada desde la aplicación Netatmo vuelve a encenderla Gladys en su siguiente pasada cuando su programación pide calor: deténgala mejor desde Gladys (botón de parada, tramo Apagado);
- mientras una habitación está apagada, una consigna enviada desde Gladys (página del dispositivo, escena) no se transmite a Netatmo — una consigna manual volvería a encender la habitación. Vuelva a encender primero la habitación con su Thermostat mode.
Cámaras
Cuando la familia Seguridad está activada, cada cámara se crea con:
- una imagen para el panel (una captura, actualizada automáticamente) — Gladys la obtiene primero desde la red local (y, si no, desde la URL VPN de Netatmo);
- un interruptor de vigilancia (activar/desactivar la vigilancia de la cámara);
- un botón de transmisión en directo (HLS), construido también priorizando la red local.
Transmisión en directo — latencia y audio
- Latencia (~10 s): es inherente a la transmisión HLS en directo de Netatmo
— exactamente el mismo retraso existe en las propias aplicaciones web y móvil
de Netatmo. Prefiera la latencia
lowen el recuadro de cámara del panel, y la calidad de cámaramedium(720p) si desea una reproducción más fluida. - ¿No hay sonido? El micrófono de la cámara debe estar activado en la aplicación Netatmo: Gestionar mi casa → seleccione la habitación de la cámara → Cámara → Ajustes avanzados → active el Micrófono. Si allí está desactivado, ningún cliente (Gladys, web de Netatmo, aplicación Netatmo) recibe audio. Gladys transmite el audio siempre que la transmisión lo incluya — no hay nada que configurar del lado de Gladys.
Foco de la cámara de exterior
La cámara de exterior (NOC) recibe también dos funciones para su foco, que
Netatmo ajusta en Encendido, Apagado o Auto (se enciende con una
detección):
| Modo Netatmo | Floodlight (luz) | Floodlight automatic mode (interruptor) |
|---|---|---|
| Encendido | Encendido | Apagado |
| Apagado | Apagado | Apagado |
| Auto | Apagado | Encendido |
- Encender Floodlight fuerza la luz; encender el modo automático vuelve a Auto.
- Apagar una de las dos solo actúa si es el modo actual, y entonces pone el foco en Apagado: una escena que apaga las luces no toca un foco en Auto, y apagar el modo automático nunca apaga una luz forzada.
- El foco es una luz de Gladys: las acciones de escena de las luces (encender / apagar) funcionan con él.
Un modo cambiado desde la aplicación Netatmo aparece en la siguiente actualización (2 minutos, o al instante con los webhooks de Gladys Plus).
⚠️ Si su cámara de exterior ya existía en Gladys, el foco no aparece por sí solo: vaya a la pantalla Descubrimiento y haga clic en Actualizar en la cámara.
Cámara de interior Advance (NPC)
La cámara de interior Advance se crea como la cámara de interior: una imagen para el panel, un interruptor de vigilancia, las detecciones Movimiento y Persona detectada (ver Detecciones más abajo), y aparece en el widget Cámaras Netatmo. Dos diferencias, ambas del lado de Netatmo:
- su captura se obtiene a través de la URL VPN de Netatmo: como el timbre con vídeo, esta cámara no la sirve en la red local;
- su vídeo en directo se negocia en WebRTC (vea Vídeo en directo WebRTC más abajo): con un Gladys más antiguo, el recuadro de cámara muestra la imagen fija.
⚠️ ¿Cuenta Netatmo conectada antes de esta versión? Esta cámara necesita tres nuevos permisos de Netatmo (
read_camerapro,write_camerapro,access_camerapro): vuelva a hacer clic en Conectar en la pantalla Configuración y acéptelos. Mientras tanto, el estado de la conexión muestra una invitación a volver a hacer clic en Conectar, la cámara puede faltar o aparecer inaccesible, y una orden de vigilancia rechazada por Netatmo falla con un mensaje «volver a conectar».
Timbre con vídeo
Cuando la familia Seguridad está activada, el timbre con vídeo Netatmo (NDB)
se crea con:
- una imagen para el panel (una captura, actualizada automáticamente) — obtenida a través de la URL VPN de Netatmo: el timbre no la sirve en la red local;
- una funcionalidad Timbre que muestra Sonando cuando alguien pulsa el botón, utilizable como disparador de escena (Si suena el timbre) — en tiempo real con los webhooks de Gladys Plus, si no en unos 2 minutos (ver más abajo);
- la calidad de su enlace Wifi.
No hay interruptor de vigilancia (Netatmo no ofrece ninguno para el timbre). Su vídeo en directo se negocia en WebRTC (vea Vídeo en directo WebRTC más abajo): con un Gladys más antiguo, el recuadro de cámara muestra la imagen fija.
⚠️ ¿Cuenta Netatmo conectada antes de esta versión? El timbre necesita dos nuevos permisos de Netatmo (
read_doorbell,access_doorbell): vuelva a hacer clic en Conectar en la pantalla Configuración y acéptelos. Mientras tanto, el estado de la conexión muestra una invitación a volver a hacer clic en Conectar.
Vídeo en directo WebRTC (timbre y cámara de interior Advance)
El timbre con vídeo y la cámara de interior Advance transmiten solo en WebRTC, a través de la nube de Netatmo: ni HLS, ni nada en la red local. Con una versión de Gladys posterior a la 5.2.1 que incluya el vídeo en directo WebRTC de las cámaras (Gladys#3215), el recuadro de cámara del panel reproduce su vídeo en directo. El navegador establece la transmisión; Gladys y la integración solo transmiten ese establecimiento a Netatmo, y el vídeo va directamente de la nube de Netatmo al navegador, en casa como a través de Gladys Plus.
- Gladys más antiguo: el recuadro de cámara muestra la imagen fija, actualizada automáticamente, como antes. Tras actualizar Gladys, guarde una vez la configuración de la integración (o vuelva a escanear en la pantalla Descubrimiento): el timbre y la cámara existentes pasan al vídeo en directo, no hay que volver a crearlos.
- Detención: el vídeo en directo se detiene cuando lo pone en pausa, sale del panel o cierra la pestaña (Gladys termina una sesión olvidada al cabo de 30 segundos).
- El vídeo en directo no arranca: el recuadro muestra un mensaje y la última
imagen. Compruebe que la cámara está en línea en la aplicación Netatmo y que
el navegador admite WebRTC. Un cortafuegos estricto o una VPN pueden bloquear
el tráfico WebRTC hacia la nube de Netatmo. Si el estado de la conexión o los
Registros de la integración piden volver a conectar la cuenta, a la
autorización le falta
access_doorbell/access_camerapro: vuelva a hacer clic en Conectar.
Webhooks de Gladys Plus (tiempo real) — opcional
Por defecto, Gladys consulta Netatmo cada 2 minutos. Con los webhooks, Netatmo avisa a Gladys en cuanto ocurre algo: los valores se actualizan entonces en 2-3 segundos en lugar de esperar al siguiente ciclo — sin aumentar el número de llamadas a la API de Netatmo.
Como un Gladys local no es accesible desde Internet, Gladys Plus retransmite los eventos, por lo que se requiere una suscripción activa a Gladys Plus.
Configuración (3 minutos)
Necesita una suscripción activa a Gladys Plus y su Gladys vinculado a Gladys Plus (Configuración → Gladys Plus).
-
Abra Gladys desde plus.gladysassistant.com e inicie sesión con su cuenta de Gladys Plus. La pestaña Open API solo aparece allí: no existe cuando abre Gladys por su dirección local (por ejemplo
http://192.168.1.10). -
Vaya a Configuración → Open API. Escriba un nombre (por ejemplo
Netatmo), haga clic en Generar y copie la clave que aparece: solo se muestra una vez. Si la ha perdido, revóquela y genere otra.No es la «clave RSA» de la pestaña Gladys Plus: esa sirve para el cifrado de extremo a extremo de Gladys Plus y no funciona aquí.
-
Abra Integraciones → Netatmo → pestaña Configuración (desde Gladys Plus o desde la dirección local, da igual). Debajo del formulario, en el bloque «Webhooks de Gladys Plus», pegue la clave en Clave de Open API de Gladys Plus y haga clic en el botón Guardar de ese bloque (no en «Guardar configuración»).
El bloque muestra después la dirección del webhook. Contiene su clave: no la comparta.
No hay nada que pegar en el sitio web de Netatmo: la propia integración registra la URL en Netatmo, y la vuelve a registrar en cada reconexión. Para comprobarlo, abra la pestaña Registros de la integración: debería ver
Netatmo webhook registered — events will trigger an immediate refresh
Después, cada evento entregado por Netatmo añade una línea como
Netatmo webhook event received: NACamera-movement (70:ee:50:…).
¿Registrado pero no llega nada? Ejecute la acción Diagnóstico de un dispositivo (pantalla Configuración, ambos campos vacíos): la línea Webhook URL held by Netatmo indica si Netatmo sigue teniendo la URL de la integración. Un solo webhook por aplicación Netatmo: si otro cliente la sustituyó (el campo "webhook URI" de dev.netatmo.com, el antiguo servicio Netatmo del core), vuelva a guardar la clave de Gladys Plus. Netatmo también deja de enviar durante 24 horas a una aplicación cuyo webhook falló 5 veces seguidas (solo dev.netatmo.com lo muestra y permite levantarlo). Si la URL es la de la integración y aun así no llega nada, cree una nueva clave Open API (desde plus.gladysassistant.com, Configuración → Open API) y guárdela aquí: una clave antigua (por ejemplo tomada de la URL del antiguo servicio Netatmo del core) puede autenticarse sin entregar nunca los webhooks. Las detecciones solo existen mientras la vigilancia de la cámara está activada. Sea cual sea la causa, las detecciones siguen llegando, en unos 2 minutos (ver más abajo).
Sin clave (o sin Gladys Plus), la integración se comporta exactamente como antes, consultando cada 2 minutos — detecciones incluidas.
Qué aporta
- Los valores llegan casi al instante — por ejemplo, una consigna de termostato cambiada desde la aplicación Netatmo, o el estado de vigilancia de una cámara.
- Detecciones en tiempo real en lugar de en unos 2 minutos (ver más abajo).
Detecciones (disparadores de escena)
Algunos eventos son momentáneos: solo existen en el flujo de eventos de Netatmo, y ningún estado de dispositivo los reporta. Se publican como funcionalidades dedicadas, utilizables como disparadores de escena:
| Dispositivo | Funcionalidad | Activada por |
|---|---|---|
| Cámaras de interior y exterior | Movimiento | movimiento detectado |
| Cámaras de interior y exterior | Persona detectada | una persona detectada / reconocida |
| Cámara de exterior (Presence) | Animal detectado | un animal detectado |
| Cámara de exterior (Presence) | Vehículo detectado | un vehículo detectado |
| Detector de humo | Humo | una detección de humo |
| Detector de monóxido de carbono | Monóxido de carbono | una detección de monóxido de carbono |
| Timbre con vídeo | Timbre | alguien llama al timbre |
Cada detección pasa a Sí y vuelve a No por sí sola al cabo de un minuto (Netatmo no envía ningún evento de "fin de detección", salvo para el humo y el monóxido de carbono: el evento "humo disipado" / "vuelta a la normalidad" la devuelve a No de inmediato). En una escena, utilice el disparador "el valor pasa a Sí" — para el timbre, el disparador Si suena el timbre. Un timbrazo dispara una sola vez: los eventos posteriores "llamada aceptada" / "llamada perdida" de la aplicación Netatmo no son disparadores aparte.
¿Con qué rapidez? Con los webhooks de Gladys Plus, en unos segundos. Sin
ellos — o cuando Netatmo no los envía — la integración también lee los últimos
eventos de cada casa en cada actualización de 2 minutos (getevents de
Netatmo, una llamada por casa): se activan las mismas funcionalidades y los
mismos disparadores de escena, en unos 2 minutos. Una detección que llega
por ambas vías nunca se activa dos veces, los eventos ya presentes al arrancar
la integración no se repiten, y un evento con más de 10 minutos cuando se lee
(tras una caída) no activa nada.
⚠️ Si sus cámaras ya existían en Gladys, estas nuevas funcionalidades no aparecen por sí solas: vaya a la pestaña Descubrir y haga clic en Actualizar en cada cámara (o detector de humo) para añadirlas.
Escenas: activadores y acciones de Netatmo
La integración añade sus propias tarjetas al editor de escenas (Gladys 5.1 o posterior): elija Activador de integración o Acción de integración y luego la entrada de Netatmo.
Activadores (en tiempo real con los webhooks de Gladys Plus, en unos 2 minutos sin ellos)
| Activador | Se activa cuando | Información transmitida a las acciones |
|---|---|---|
| Llega una persona conocida | una cámara de interior reconoce una cara conocida | Persona, Cámara, Casa |
| Se va una persona conocida | Netatmo marca a una persona conocida como ausente | Persona, Cámara, Casa |
| La sirena suena | una sirena de interior empieza a sonar | Sirena, Casa |
Filtros opcionales: la cámara (o la sirena) — vacío = cualquiera — y la persona: escriba el nombre exactamente como aparece en la aplicación Netatmo (el editor de escenas no puede listar las personas de Netatmo; un campo vacío = cualquier persona conocida). Una cara no reconocida nunca activa «Llega una persona conocida»: la funcionalidad Persona detectada de la cámara cubre a todas las personas.
Acciones
| Acción | Qué hace |
|---|---|
| Cambiar el modo de calefacción | Programación, Ausencia o Antihielo para toda la casa; duración opcional en minutos (Ausencia y Antihielo: vuelta a la programación después) |
| Marcar a una persona como ausente | una persona conocida o — persona vacía — toda la casa vacía (reactiva la vigilancia de las cámaras configurada para seguir la presencia) |
| Marcar a una persona como presente | una persona conocida o — persona vacía — todas las personas conocidas |
| Ajustar la consigna de una habitación | consigna manual (7 a 30 °C) de la habitación del termostato o la válvula elegidos; duración opcional en minutos, luego vuelta a la programación (vacío: la duración por defecto de una consigna manual en la aplicación Netatmo) |
| Potenciar una habitación | calienta a plena potencia (boost) la habitación del termostato o la válvula elegidos; duración opcional en minutos (vacío: la duración por defecto del boost en la aplicación Netatmo) |
| Volver a la programación | termina la consigna manual o el boost de la habitación: vuelve a seguir la programación |
| Elegir la programación de calefacción | activa una de las programaciones de calefacción de la casa |
La casa es la del dispositivo que elija en la acción (un termostato o una válvula para la calefacción, una cámara para las personas). Déjelo vacío si su cuenta tiene una sola casa. El campo persona acepta una variable de escena: «Llega una persona conocida → Marcar a una persona como presente» con la información Persona. Cada acción devuelve el nombre de la Casa a los pasos siguientes.
Las tres acciones de habitación se aplican a la habitación del termostato o la válvula elegidos (obligatorio) y también devuelven el nombre de la Habitación. Elegir la programación de calefacción espera el nombre de la programación exactamente como aparece en la aplicación Netatmo (sin distinguir mayúsculas): el editor de escenas no puede listar las programaciones de Netatmo. Un nombre inexistente hace fallar la acción, y los registros de la escena citan las programaciones de la casa. También devuelve el nombre de la Programación.
Widgets del panel
Tres widgets se suman al selector de widgets del panel (Gladys 5.1 o posterior): Editar panel, añada un widget y busque «Netatmo».
| Widget | Muestra | Ajustes |
|---|---|---|
| Tiempo Netatmo | las fichas en directo de la estación (temperaturas, humedad, CO2, ruido, presión, lluvia, viento) y una fila de estado por módulo con batería baja o inaccesible | la estación (vacío: la primera) y las mediciones mostradas: Resumen, Interior, o Exterior, lluvia y viento |
| Calefacción Netatmo | el modo de calefacción de la casa, cuántas habitaciones calientan, la programación activa, una fila por habitación y botones — vea más abajo | un termostato o una válvula de la casa (vacío: su única casa); su habitación es la que el formulario preselecciona |
| Cámaras Netatmo | la última imagen de cada cámara, su vigilancia y botones para activarla / desactivarla | una cámara mostrada en grande (vacío: todas las cámaras en lista) |
El widget Calefacción Netatmo
- Subtítulo: la casa y su programación activa. Fichas: el modo de
calefacción (Programación, Antihielo, Ausencia) y las habitaciones que
calientan (
2/11). - Una fila compacta por habitación: temperatura medida → consigna, luego los marcadores Manual, Boost o Apagado (consigna que no viene de la programación; una habitación apagada no muestra consigna), Ventana (Netatmo detectó una ventana abierta) y Calienta (la habitación pide calor, o su caldera funciona — el Heating state de la habitación). El icono y su color siguen: naranja mientras la habitación calienta, azul con una ventana abierta. Hasta diez habitaciones tienen su fila; con más, la décima fila resume las demás.
- Botones: los modos de calefacción salvo el activo (Programación, Antihielo, Ausencia), Consigna de habitación y, con varias programaciones, Cambiar programación (un formulario que las lista).
- Consigna de habitación abre un formulario corto en la tarjeta: la habitación, la acción — Fijar la consigna, Boost, Volver a la programación o Apagar —, la consigna (7 a 30 °C, redondeada a 0,5 °C; si se deja vacía, se mantiene la consigna actual de la habitación — útil para cambiar solo su duración) y la duración (las opciones del ajuste Duración de una consigna enviada por Gladys, que la preselecciona). La duración se aplica a una consigna, un boost y al apagado; un boost con Duración predeterminada de Netatmo o Sin fin dura la duración de boost de Netatmo. Las filas del panel no se pueden tocar y una tarjeta admite cuatro botones: un solo formulario sirve para todas las habitaciones.
Las fichas siguen los valores en directo; el resto se actualiza con la integración (2 minutos, o en cuanto cambian el modo de calefacción, la vigilancia o una imagen). Las imágenes de las cámaras las sirve la propia integración: el panel nunca carga una imagen desde los servidores de Netatmo. Un widget solo muestra los dispositivos creados en Gladys.
Accesorios de seguridad (conectados a través de la cámara)
Cuando la familia Seguridad está activada, también se descubren los accesorios vinculados a sus cámaras:
- Sensor de puerta / ventana (
NACamDoorTag) — un sensor de apertura, más la batería y la señal RF. Como todo sensor de apertura de Gladys (y la funcionalidad Detecting open window de los termostatos y las válvulas), vale 0 cuando está abierto y 1 cuando está cerrado. - Sirena de interior (
NIS) — un sensor de sirena sonando, de solo lectura, más la batería y la señal RF. - Detector de humo (
NSD) — descubierto con su batería y su señal, más la detección Humo (ver Detecciones más arriba): en tiempo real con los webhooks, en unos 2 minutos sin ellos. - Detector de monóxido de carbono (
NCO) — igual que el detector de humo: batería y señal (cuando Netatmo las reporta), más la detección Monóxido de carbono, como el humo.
Personas conocidas
Cuando la familia Seguridad está activada, cada casa cuyas cámaras reconocen rostros obtiene un dispositivo «<casa> - Known persons», con una funcionalidad Presence por cada persona con nombre en la aplicación Netatmo: Presencia detectada cuando Netatmo considera que la persona está en casa, Sin presencia cuando está ausente — el estado que muestra la aplicación Netatmo. Úsela en sus escenas como cualquier sensor de presencia.
- Solo las personas con nombre tienen una funcionalidad: un rostro desconocido (sin nombre en la aplicación Netatmo) se ignora.
- La presencia se actualiza cada 2 minutos, e inmediatamente con los webhooks de Gladys Plus (una persona conocida llega / se va) o después de las acciones de escena Marcar a una persona como ausente / presente.
- Cuando Netatmo no reporta la presencia de una persona, no se publica nada: se conserva el último valor conocido.
- Una persona añadida, renombrada o eliminada en la aplicación Netatmo: haga clic en Actualizar en el dispositivo en la pestaña Descubrir para añadir, renombrar o quitar la funcionalidad. La funcionalidad sigue el identificador Netatmo de la persona: un cambio de nombre conserva su historial.
Persianas enrollables (Bubendorff / iDiamant)
Active Persianas enrollables (Bubendorff / iDiamant) en Dispositivos a
descubrir (desactivado por defecto) para descubrir las persianas Bubendorff
conectadas a su pasarela iDiamant: modelos por radio (NBR), cableados
(NBO) y solares (NBS). Cada persiana se crea con:
- un control abrir / cerrar / parar;
- una posición (0 % = cerrada, 100 % = abierta), que también puede ajustar;
- la calidad de su señal RF.
La pasarela iDiamant no se crea como dispositivo: su identificador se guarda en
el parámetro plug_id de la persiana, y cada orden pasa por ella. Tras una
orden, Gladys actualiza los valores unos 30 segundos después para que la nueva
posición aparezca sin esperar al siguiente ciclo de 2 minutos.
⚠️ ¿Ya estaba conectado antes de la compatibilidad con las persianas? Las persianas necesitan dos nuevos permisos de Netatmo. Vuelva a hacer clic en Conectar en la pantalla de configuración y autorice a Gladys — sus dispositivos y ajustes se conservan. Hasta entonces, una orden de persiana falla y la pantalla de configuración le pide que vuelva a conectarse.
Posiciones intermedias: según el modelo y el motor, algunas persianas Bubendorff solo se abren o se cierran por completo. Una posición intermedia puede entonces ser ignorada o redondeada por la persiana, y la posición reportada puede reflejar solo la última orden — use abrir / cerrar / parar en esos modelos.
Monitor de calidad del aire (Home Coach)
Cuando la familia Dispositivos de Calidad del aire (Home Coach) está
activada, cada monitor de calidad del aire interior Netatmo (Home Coach, NHC)
se descubre con su temperatura (más el mínimo y el máximo del día), su humedad,
su CO2, su ruido, su presión y su presión absoluta, la calidad de su WiFi y una
funcionalidad Calidad del aire. Lleva el nombre que usted le dio en la
aplicación Netatmo.
El Home Coach no mide un índice de calidad del aire: califica la habitación en cinco niveles, a partir de su CO2, su humedad, su ruido y su temperatura. Gladys lee una funcionalidad de calidad del aire como un índice AQI (de 0 a 500) para colorearla en el panel y transmitirla a HomeKit, así que cada nivel se publica en el centro del tramo AQI correspondiente:
| Nivel Home Coach | Valor en Gladys | Color en el panel | HomeKit |
|---|---|---|---|
| Saludable | 25 | verde | Excelente |
| Bueno | 75 | amarillo | Buena |
| Regular | 125 | naranja | Regular |
| Malo | 175 | rosa | Deficiente |
| Insalubre | 250 | morado | Mala |
En una escena, compare con estos valores: por ejemplo "Calidad del aire superior a 150" significa malo o insalubre.
Una funcionalidad Air quality level muestra el mismo nivel en palabras en el panel. Gladys aún no traduce las etiquetas de opciones: están en francés (Sain, Correct, Moyen, Mauvais, Malsain — saludable, bueno, regular, malo, insalubre). No guarda historial: la funcionalidad numérica Calidad del aire conserva el historial, los colores y HomeKit.
Un Home Coach sin conexión recibe la insignia inaccesible y sus últimos
valores conocidos no se publican. No hace falta volver a conectarse: el permiso
Home Coach (read_homecoach) forma parte de la conexión desde la primera
versión.
Portero BTicino (Classe 300X / Classe 300 EOS) — vista previa
Los videoporteros BTicino Classe 300X y Classe 300 EOS with Netatmo funcionan a través de la API de Netatmo, que expone mucho menos que la aplicación Netatmo (issue #59). Active Portero BTicino (Classe 300) — vista previa en Dispositivos a descubrir (desactivado por defecto) y guarde.
El portero se descubre como un solo dispositivo, con el nombre de su
unidad interior (la pasarela BNCX, p. ej. «Classe 300EOS with Netatmo»). Los
módulos que conecta le añaden sus funciones, con su nombre:
| Módulo | Tipo Netatmo | En el dispositivo del portero |
|---|---|---|
| Unidad interior (pasarela) | BNCX | calidad WiFi, timbre (en tiempo real con los webhooks de Gladys Plus) |
| Luz de escalera / exterior | BNSL | luz encendida / apagada (p. ej. «Iluminación exterior») |
| Toma controlada | BNCS | estado encendido / apagado (solo lectura), cuando Netatmo lo envía |
| Placa de calle | BNEU | nada (Netatmo no envía ningún valor para ella) |
| Cerradura | BNDL | nada — vea más abajo |
| Módulo X | BNXM | su calidad de señal, cuando Netatmo envía una |
- Luz: se acciona a través de Netatmo como en la aplicación. Netatmo nunca indica si está encendida: Gladys muestra la última orden enviada (la luz de escalera suele apagarse sola al cabo de un tiempo, Gladys no puede saber cuándo).
- Timbre: se publica como el del timbre con vídeo («Sonando» y luego la hora del último timbrazo), utilizable como activador de escena — en tiempo real con los webhooks de Gladys Plus, en unos 2 minutos sin ellos. Netatmo documenta este evento para el Classe 300 EOS; todavía no se ha visto en una instalación real: si sus llamadas no aparecen, envíe un diagnóstico (más abajo).
- La apertura de la puerta no está disponible. La API de Netatmo para aplicaciones de terceros no les permite abrir una cerradura BTicino (Netatmo lo bloquea por motivos de seguridad); solo puede hacerlo la aplicación Netatmo / BTicino.
- La insignia inaccesible sigue a la unidad interior. Un módulo conectado que Netatmo indica fuera de línea no publica ningún valor.
- Si creó dispositivos con la vista previa 2.2.0 (uno por módulo), elimínelos y vuelva a crear el dispositivo del portero.
⚠️ Nuevos permisos de Netatmo — vuelva a hacer clic en Conectar. Activar la opción solicita cuatro permisos adicionales, solo mientras está activa:
read_bfi/write_bfi(BTicino IP, Classe 300X) yread_mx/write_mx(Classe 300 EOS). Vuelva a hacer clic en Conectar en la pantalla de configuración y acéptelos — sus dispositivos y ajustes se conservan. Hasta entonces, el estado de la conexión muestra una invitación a volver a conectarse, y Netatmo puede omitir los módulos BTicino (una orden de luz falla entonces con un mensaje «vuelva a conectar»).
Enviar un diagnóstico al mantenedor
Use la acción Diagnóstico de un dispositivo de la pantalla de
configuración (vea Solución de problemas): elija el dispositivo del
portero, o deje ambos campos vacíos para toda la cuenta, y pegue el resultado
en la issue #59. Toque el timbre una vez antes de ejecutarla (y espere 2 minutos): el informe
enumera los últimos eventos webhook de cada módulo, y los últimos eventos que Netatmo devuelve para él (getevents).
Mientras la opción está activa, la integración también escribe en sus
registros, en la primera actualización tras un arranque y después solo
cuando algo cambia, los datos brutos que Netatmo devuelve para cada módulo
BTicino y cada evento webhook de Gladys Plus que le concierne. Cada línea
empieza por [bticino-diagnostic]; se aplica la misma anonimización (tokens,
claves, direcciones de correo y URL se sustituyen por <redacted>, los ID de
módulo, de pasarela y de casa se conservan), y una línea de más de 8 KB se
corta con un marcador [truncated].
Legrand Home + Control (Céliane / dooxie / Mosaic) — vista previa
Los mecanismos Legrand with Netatmo (Céliane, dooxie, Mosaic…) conectados a una pasarela Home + Control pasan por la misma API de Netatmo (issue #60). Active Legrand Home + Control — vista previa en Dispositivos a descubrir (desactivado por defecto) y guarde.
ℹ️ Probado con los fixtures de pyatmo, se agradecen los comentarios. Todavía no se ha probado ninguna instalación Legrand real: los datos proceden de los datos de prueba de pyatmo (la biblioteca que usa Home Assistant). Si algo parece incorrecto, envíe un diagnóstico (más abajo).
Cada módulo de iluminación, enchufe o relé se convierte en un dispositivo, con el nombre que tiene en la aplicación Netatmo:
| Módulos | Tipos Netatmo | Funciones en Gladys |
|---|---|---|
| Interruptores, micromódulo, interruptor doble (cada canal) | NLM, NLL, NLIS | luz encendida / apagada, potencia (W) |
| Reguladores | NLF, NLFN, NLFE, NLUF, NLUO | luz encendida / apagada, brillo (0-100 %), potencia (W) |
| Enchufes | NLP, NLPM, NLPBS, NLC, NLUP | interruptor encendido / apagado, potencia (W) |
| Relés | NLUI, NLPO, NLPT, NLPD | interruptor encendido / apagado, potencia (W) |
| Pasarela | NLG, NLGS | no es un dispositivo: todas las órdenes de sus módulos pasan por ella |
(NLUI interruptor empotrado, NLPO contactor, NLPT telerruptor, NLPD
contacto seco.)
- Órdenes: pasan por Netatmo como en la aplicación, a través de la
pasarela (guardada en el parámetro
plug_id). Netatmo devuelve el estado: Gladys lo vuelve a leer unos 2 segundos después de una orden. Un cambio hecho en el interruptor aparece en la siguiente actualización (cada 2 minutos, Netatmo no envía webhook para estos módulos). - Brillo: en la escala 0-100 de Netatmo. Un regulador que no devuelve brillo no lo tiene (es entonces una luz de encendido / apagado). La reacción de un regulador apagado a un cambio de brillo aún no se ha comprobado en hardware real.
- Potencia (solo lectura): se añade solo cuando Netatmo la devuelve para el módulo. Un módulo desconectado durante el descubrimiento no tiene ni brillo ni potencia: vuelva a lanzar el descubrimiento cuando vuelva, antes de crearlo.
- Interruptor doble (
NLIS): cada canal es una luz propia; el interruptor en sí no es un dispositivo. - Contactor (
NLPO): solo encendido / apagado; sucontactor_modeaún no se expone. - Insignia inaccesible: un módulo que Netatmo indica desconectado, o detrás de una pasarela desconectada, recibe la insignia inaccesible y no publica ningún valor.
⚠️ Nuevos permisos de Netatmo — vuelva a hacer clic en Conectar. Activar la opción pide dos permisos adicionales, solicitados solo mientras está activa:
read_magellan/write_magellan(mecanismos Legrand). Vuelva a hacer clic en Conectar en la pantalla de configuración y acéptelos — sus dispositivos y ajustes se conservan. Hasta entonces, el estado de conexión muestra «vuelva a hacer clic en Conectar», Netatmo puede omitir los módulos Legrand, y una orden falla con un mensaje de reconexión.
Aún no compatible
Las persianas enrollables (NLV, NLLV, NLLM), los contadores de energía
(Ecocompteur NLE, NLPC, NLY, deslastrador NLPS), los interruptores y
mandos inalámbricos (NLT, NLD, NLDD, NLAS, NLAO, NLDP), la
ventilación (NLLF) y la puerta de garaje (NLJ) son los próximos pasos del
issue #60. El
diagnóstico de dispositivo los indica como «not supported».
Enviar un diagnóstico Legrand
Ejecute la acción Diagnóstico de un dispositivo de la pantalla de configuración (vea Solución de problemas): elija un dispositivo Legrand, escriba el nombre de un módulo no creado, o deje ambos campos vacíos para toda la cuenta. Pegue el resultado en el issue #60: muestra los datos brutos de Netatmo de cada módulo y los campos que Gladys aún no usa.
Actualizar la integración
Instalada desde el catálogo (el caso habitual): Gladys consulta el store con regularidad. Cuando sale una nueva versión, la integración muestra la insignia "Actualización disponible" (también contada junto a Integraciones en el menú), y su pestaña Supervisión indica la versión ofrecida, con un enlace a sus notas de versión. Haga clic en Actualizar: Gladys descarga la nueva imagen y aplica el nuevo manifiesto — los nuevos campos de configuración aparecen solos, no hay nada que volver a pegar. Su configuración y sus dispositivos se conservan.
Gladys puede tardar hasta una hora y media aproximadamente en detectar una nueva versión (actualización del índice del store). "Forzar actualización" lo comprueba de inmediato: lee la última versión publicada y descarga su imagen.
Instalada en modo desarrollador (manifiesto pegado a mano): "Forzar actualización" solo vuelve a descargar la imagen de la etiqueta instalada, y la versión mostrada y los campos de configuración provienen del manifiesto pegado — vuelva a pegar el manifiesto actualizado para obtener los nuevos campos.
Migrar desde el servicio Netatmo integrado
Esta integración externa sustituye al servicio Netatmo integrado en Gladys. Sus
dispositivos tienen nuevos identificadores (netatmo:* → ext:netatmo:*), por
lo que se crean como dispositivos nuevos — pero desde Gladys 4.84.1 puede
migrar cada dispositivo antiguo a su sustituto y conservar su historial de
estados, sus escenas y sus paneles.
Antes de empezar
- No elimine sus antiguos dispositivos Netatmo: la migración parte de ellos.
- Migre poco después de crear los nuevos dispositivos. Si ambos dispositivos registraron valores durante el mismo periodo, solo se mueve el historial antiguo anterior al primer valor del nuevo dispositivo, para no contar nada dos veces: los valores del dispositivo antiguo en el periodo común se descartan.
Pasos
- Instale y conecte esta integración y luego cree sus dispositivos desde la pestaña Descubrir: el destino debe existir antes de migrar.
- Abra Integraciones → Netatmo — la integración integrada, marcada como obsoleta — y luego su pestaña Dispositivos.
- En un dispositivo antiguo, haga clic en Migrar.
- Elija el Dispositivo de destino: el nuevo dispositivo, listado bajo la integración externa Netatmo (la lista se puede filtrar por integración, habitación y nombre).
- Revise la tabla Coincidencia de funciones. Gladys la rellena de antemano (misma categoría, mismo tipo y misma unidad, y luego mismo nombre para distinguir las gemelas); cada función antigua puede asociarse a mano o marcarse como No migrar — su historial se elimina entonces. Revise bien las filas de temperatura de los termostatos y las estaciones, que tienen varias funciones de temperatura.
- Haga clic en Migrar y eliminar el dispositivo antiguo.
Gladys mueve el historial, reescribe las escenas y los paneles que usaban el dispositivo antiguo, coloca el nuevo dispositivo en la habitación del antiguo si no tiene ninguna, vuelve a enlazar los vínculos de energía y luego elimina el dispositivo antiguo. El resultado indica el número de estados movidos y de escenas / paneles actualizados. Repita para cada dispositivo.
Un historial largo puede tardar varios minutos: sígalo en Configuración → Tareas. Si la página pierde la conexión, la migración sigue en segundo plano — revise esa página antes de volver a intentarlo. Una migración fallida puede relanzarse: solo mueve lo que queda.
Solución de problemas
- Una escena sobre una ventana o puerta abierta ya no se dispara
(actualización desde la 2.4.0 o anterior): Detecting open window
(termostatos, válvulas) y el Opening del sensor de puerta / ventana
siguen ahora la convención de los sensores de apertura de Gladys — 0
abierto, 1 cerrado. Antes valían 1 cuando estaba abierto, por lo que el
panel mostraba una ventana o puerta abierta como cerrada. Una escena que
comprobaba
= 1para «abierto» debe comprobar ahora= 0. - "Guarde primero" al conectar: guarde el ID de cliente / secreto y luego vuelva a hacer clic en Conectar.
- Sesión expirada: vuelva a hacer clic en Conectar para volver a autorizar su cuenta Netatmo.
- Un dispositivo muestra una insignia "inaccesible": Netatmo lo reporta como desconectado (batería agotada, apagado, fuera de alcance). Gladys deja de publicar sus últimos valores conocidos para que no le induzcan a error datos obsoletos; la insignia desaparece cuando el dispositivo vuelve.
- Un dispositivo muestra una insignia "Degradado", o el estado muestra un mensaje estando Conectado: una parte de la nube de Netatmo falla desde hace varios minutos (por ejemplo el servicio meteorológico). Gladys sigue publicando lo que el resto de la nube proporciona — las medidas de la estación y de sus módulos también proceden del estado de la casa — y marca los dispositivos que se quedan sin valores recientes. No hay nada que hacer: ambos desaparecen solos en la primera actualización completa. Si persiste, los Logs de la integración indican la API que falla.
- Un valor de cámara o un comando de vigilancia falla una vez con un mensaje de "reconectar": a su autorización Netatmo le falta el permiso de cámara — vuelva a conectar su cuenta.
- Una orden de persiana falla con un mensaje de "reconectar": su autorización Netatmo es anterior a la compatibilidad con las persianas — vuelva a hacer clic en Conectar.
- Las detecciones de movimiento / persona (o los timbrazos) llegan con unos
2 minutos de retraso, mientras que la aplicación Netatmo avisa al instante:
los webhooks de Gladys Plus no llegan a la integración, las detecciones
proceden de la lectura de
geteventscada 2 minutos. Ejecute la acción Diagnóstico de un dispositivo (ambos campos vacíos) y compare Last events seen by getevents con Last webhook events: eventos en el primero y ninguno en el segundo significa que Netatmo no envía los webhooks — vea ¿Registrado pero no llega nada? en la sección de webhooks. Nada en ninguno: compruebe que la vigilancia de la cámara está activada. La línea Events poll (getevents) muestra su último error (por ejemplo un permiso que falta: vuelva a hacer clic en Conectar). - No hay sonido en la cámara: consulte el consejo sobre el micrófono en la sección Cámaras más arriba.
- Timbre o cámara de interior Advance sin vídeo en directo: consulte Vídeo en directo WebRTC en la sección Timbre con vídeo (versión de Gladys, navegador, cortafuegos).
- Estado "faltan algunos permisos de Netatmo": una versión más reciente añadió permisos (timbre con vídeo, cámara de interior Advance, portero BTicino, Legrand Home + Control) — vuelva a hacer clic en Conectar y acéptelos. Los Registros de la integración indican cuáles faltan.
- Diagnóstico de un dispositivo (informar de un problema o de un
dispositivo no compatible): en la pantalla de configuración, ejecute la
acción Diagnóstico de un dispositivo. Elija un dispositivo creado en
Gladys, o escriba el nombre o el ID de Netatmo de un módulo que no haya
creado (por ejemplo, uno aún no compatible); deje ambos campos vacíos para
un resumen de toda la cuenta. El informe muestra lo que Netatmo envía para el
módulo, lo que la integración publica para él, los campos de Netatmo que aún
no utiliza, los últimos eventos webhook y los últimos eventos leídos con
getevents, los permisos y el estado de cada API de Netatmo. También se escribe en los Registros de la integración (líneas tras[netatmo-diagnostic]) si no puede copiarlo desde la pantalla. Reléalo antes de publicarlo: los tokens, las URL y las direcciones de correo se eliminan, pero los ID de módulos y de casa y los nombres de sus módulos se conservan. - ¿Sigue bloqueado, o falta un dispositivo? Pregunte en el tema del foro Intégration externe - Netatmo o abra una issue en GitHub con los registros de la integración (pestaña Registros).
Parámetros de configuración
Estos son los parámetros que Netatmo te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Aplicación Netatmo Connect | section | No | Gladys se comunica con Netatmo a través de SU propia aplicación Netatmo Connect (gratuita, 2 minutos): 1. Abra «Crear una aplicación» abajo e inicie sesión con la cuenta que usa en la app Netatmo. 2. Rellene los campos obligatorios: nombre (p. ej. «Gladys»), descripción, nombre y correo del responsable de protección de datos (los suyos). Deje vacíos «Redirect URI» y «Webhook URI». 3. Guarde: la página muestra un «client ID» y un «client secret». Cópielos en los dos campos de abajo. 4. Haga clic en «Guardar configuración» abajo, luego en «Conectar», y acepte en la página de Netatmo. Después abra la pestaña «Descubrir» y haga clic en «Añadir a Gladys» en cada dispositivo que quiera. |
| ID de cliente de la aplicación Netatmo | string | Sí | La línea «client ID» de la página de su aplicación en dev.netatmo.com (una serie de letras y números). |
| Secreto de cliente de la aplicación Netatmo | secret | Sí | La línea «client secret» de la misma página. Una vez guardado ya no se muestra: deje el campo vacío para conservarlo. |
| Cuenta Netatmo | oauth2 | Sí | Una vez guardados el ID y el secreto, haga clic en «Conectar»: se abre la página de Netatmo, inicie sesión y acepte. El estado pasa a «Conectado». La dirección de redirección mostrada arriba no hace falta declararla en Netatmo. Si Netatmo rechaza la conexión por la dirección de redirección (redirect_uri), péguela en el campo «Redirect URI» de su aplicación. Vuelva a hacer clic en «Conectar» cada vez que el estado lo pida: algunas familias (persianas, BTicino, Legrand…) añaden permisos. |
| Dispositivos a descubrir | section | No | Active las familias que tenga y haga clic en «Guardar configuración»: el descubrimiento se vuelve a ejecutar solo. Después abra la pestaña «Descubrir» y haga clic en «Añadir a Gladys» en cada dispositivo que quiera. En un dispositivo añadido con una versión anterior, «Actualizar» trae las nuevas funciones. Los valores se actualizan cada 2 minutos (límites de la API de Netatmo), en segundos con los webhooks de Gladys Plus (final de este formulario). |
| Dispositivos de Energía (termostatos, válvulas) | boolean | No | Termostatos (clásico, modulante OpenTherm, BTicino Smarther), relés y válvulas de radiador. Cada habitación con calefacción aparece también en el widget «Calefacción Netatmo». |
| Dispositivos de Meteorología (estaciones y módulos) | boolean | No | Descubrir los dispositivos Netatmo Meteorología: estaciones y módulos exterior, viento, lluvia e interior. |
| Dispositivos de Seguridad (cámaras, timbre, detectores) | boolean | No | Cámaras de interior (NACamera), de interior Advance (NPC) y de exterior (NOC), timbre con vídeo (NDB) y sus accesorios: sensores de puerta/ventana, sirena, detectores de humo y de monóxido de carbono, además de la presencia de las personas conocidas. Las detecciones (movimiento, persona, timbre…) pueden activar escenas. |
| Persianas enrollables (Bubendorff / iDiamant) | boolean | No | Descubrir las persianas enrollables Bubendorff conectadas a una pasarela iDiamant (abrir, cerrar, parar, posición). ¿Ya está conectado? Vuelva a hacer clic en Conectar para conceder los permisos de las persianas. |
| Dispositivos de Calidad del aire (Home Coach) | boolean | No | Descubrir los monitores de calidad del aire interior Netatmo (Home Coach): temperatura, humedad, CO2, ruido, presión y calidad del aire. |
| Portero BTicino (Classe 300) — vista previa | boolean | No | Descubrir el portero BTicino Classe 300X / Classe 300 EOS como un solo dispositivo (señal, timbre a través de los webhooks, luz de escalera o exterior) y escribir sus datos brutos de Netatmo en los registros. La apertura de la puerta no está disponible a través de la API de Netatmo. ¿Ya está conectado? Vuelva a hacer clic en Conectar para conceder los permisos de BTicino. |
| Legrand Home + Control — vista previa | boolean | No | Descubrir los mecanismos Legrand with Netatmo (Céliane, dooxie, Mosaic) de una pasarela Home + Control: luces y reguladores, enchufes y relés (encendido/apagado, brillo, potencia). Las persianas enrollables, los contadores de energía y los interruptores inalámbricos aún no son compatibles. ¿Ya está conectado? Vuelva a hacer clic en Conectar para conceder los permisos de Legrand. |
| Calidad de la transmisión en directo de las cámaras | select | No | Calidad de la transmisión en directo de las cámaras de interior y exterior en Gladys. Bájela si el directo se entrecorta o tarda en arrancar, sobre todo a distancia a través de Gladys Plus. |
| Calefacción | section | No | Cómo se comportan las consignas que Gladys envía a sus habitaciones Netatmo. |
| Duración de una consigna enviada por Gladys | select | No | Netatmo termina cada consigna manual y vuelve a su propia programación. Se aplica a las consignas que escribe Gladys (panel, escenas, Termostato de Gladys), no a las acciones de escena que fijan su propia duración ni al boost. ¿Utiliza la integración Termostato de Gladys? Elija «Sin fin»: Gladys controla la programación, y una consigna que Netatmo termina por sí sola parecería un cambio manual. |
| Tiempo real con Gladys Plus (opcional) | section | No | Sin hacer nada, Gladys consulta Netatmo cada 2 minutos. Con una suscripción a Gladys Plus, Netatmo avisa a Gladys en segundos (detecciones, timbre, consigna cambiada en la app Netatmo). La clave se crea en 3 pasos: 1. Abra Gladys desde plus.gladysassistant.com: la pestaña Open API no existe en la dirección local. 2. Configuración → Open API: escriba un nombre (p. ej. «Netatmo»), haga clic en «Generar» y copie la clave, que solo se muestra una vez. No es la clave RSA de la pestaña Gladys Plus. 3. Péguela en el bloque «Webhooks de Gladys Plus» debajo de este formulario y haga clic en su propio botón «Guardar». Nada que introducir en dev.netatmo.com: la integración registra la dirección ella misma. Para comprobarlo: acción «Diagnóstico de un dispositivo», línea «Webhook URL held by Netatmo». |
Cómo instalar Netatmo en Gladys
- En Gladys, abre Integraciones: Netatmo 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/terdious/gladys-netatmo:2.6.3), 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/Terdious/gladys-netatmo.
Netatmo 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
Netatmo 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 Terdious, 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