Netatmo (integración externa) — presentación + resumen hasta la v1.3.0
Hola a todos
Me doy cuenta de que nunca he abierto un tema dedicado a la integración externa Netatmo, aunque existe desde este verano (v1.0.0 el 21 de julio de 2026, disponible para todos desde la llegada de las integraciones externas con Gladys 4.84). Me pongo al día: aquí tienes una presentación completa y el resumen de las versiones hasta la v1.3.0, que acaba de salir. Este tema servirá luego para anunciar las novedades y recoger vuestros comentarios.
¿Qué es?
Es la versión « integración externa » del servicio Netatmo de Gladys: funciona en su propio contenedor, se instala desde el catálogo de integraciones y es donde llegan las novedades de Netatmo (cámaras, accesorios de seguridad, tiempo real…).
Lo que se admite
Meteorología: estación (NAMain) y módulos exterior, viento, lluvia y interiores (temperatura, min/max, humedad, CO2, ruido, presión, viento, ráfagas, lluvia…).
Energía: termostato (NATherm1), relé (NAPlug) y válvulas (NRV), con ajuste modificable desde Gladys (por pasos de 0,5 °C).
Cámaras interior (NACamera) y exterior Presence (NOC): imagen en el panel de control (recuperada localmente en prioridad), interruptor de vigilancia, flujo en directo con la calidad de tu elección.
Accesorios de seguridad: sensor puerta/ventana (NACamDoorTag), sirena interior (NIS), detector de humo (NSD).
Batería y señal de cada módulo, y un distintivo « inalcanzable » cuando Netatmo señala un módulo fuera de línea (Gladys deja de republicar sus últimos valores).
Tiempo real con Gladys Plus (opcional): con tu clave Open API, los cambios se actualizan en 2-3 segundos en lugar de 2 minutos, y obtienes disparadores de escena: movimiento, persona detectada, animal y vehículo (Presence), humo.
Instalación
Crea tu propia aplicación en Netatmo Connect para obtener un client id y un client secret (no hay ámbito ni URL de redirección que configurar).
En Gladys: Integraciones → busca Netatmo → Instalar.
Pestaña Configuración: pega el client id / secret, Guardar, luego Conectar.
Elige las familias de dispositivos (Energía, Meteorología, Seguridad), guarda, y crea tus dispositivos desde Descubrimiento.
El paso a paso completo está en la documentación de la integración (enlace « Documentación » en la pantalla de configuración).
Resumen de versiones
v1.0.0 (21 de julio): conexión OAuth2, dispositivos Meteorología y Energía, ajuste del termostato, cámaras (imagen, vigilancia, flujo en directo).
v1.0.1: fiabilidad (reanudación después de corte Netatmo, plazos, tokens), ajuste de la calidad de vídeo, menos valores falsos para los módulos fuera de línea.
v1.1.0: webhooks Gladys Plus (tiempo real), sensor puerta/ventana, sirena y detector de humo, documentación FR/EN.
v1.1.2: las imágenes de cámara demasiado pesadas se reducen en lugar de ser ignoradas.
v1.2.0: detecciones en tiempo real (movimiento, persona, animal, vehículo, humo) utilizables en las escenas.
v1.3.0 (16 de octubre):
etiqueta Cloud y clasificación en las categorías Clima, Seguridad y Entorno del catálogo;
toda la integración en francés, inglés, alemán y español (configuración, mensajes, documentación);
actualización técnica (SDK, herramientas de lanzamiento, notas de versión en GitHub).
Requisitos previos
Gladys ≥ 4.86.0 para la v1.3.0.
Una aplicación Netatmo Connect a tu nombre (gratis).
Gladys Plus solo si quieres el tiempo real y las detecciones.
¿Vienes del servicio Netatmo integrado? ¡Conserva tu historial!
Los dispositivos de la integración externa tienen nuevos identificadores (ext:netatmo:*) y se crean como nuevos dispositivos, pero desde Gladys 4.84.1 puedes migrar cada antiguo dispositivo a su reemplazo: el historial, las escenas y los paneles de control se mantienen.
Antes de empezar: no elimines tus antiguos dispositivos Netatmo (la migración parte de ellos), y migra poco después de haber creado los nuevos (si los dos han registrado valores en el mismo período, solo el historial anterior al primer valor del nuevo dispositivo se conserva, para no contar nada en doble).
Instala la integración externa, conéctala y crea tus dispositivos desde la pestaña Descubrimiento.
Abre Integraciones → Netatmo (la integración integrada, señalada como obsoleta) → pestaña Dispositivos.
En un antiguo dispositivo, haz clic en Migrar.
Elige el Dispositivo de destino (el nuevo dispositivo, bajo la integración externa Netatmo).
Verifica la Correspondencia de funciones: está prellenada, ajusta si es necesario (sobre todo las líneas de temperatura de los termostatos y estaciones). « No migrar » elimina el historial de la función concernida.
Haz clic en Migrar y eliminar el antiguo dispositivo.
Gladys mueve el historial, actualiza tus escenas y paneles de control, retoma la habitación, luego elimina el antiguo dispositivo. Para un historial grande, sigue el progreso en Configuración → Tareas (una migración interrumpida puede reanudarse, solo retoma lo que queda).
En curso, lado núcleo de Gladys
Dos solicitudes de @smuteau requieren una evolución del núcleo, las PR están propuestas:
el nivel de batería mostrado en la tarjeta de cada dispositivo (pestaña Dispositivos) — la integración ya publica la batería;
la foto de cada dispositivo, como con el servicio integrado (las imágenes seguirán en el contenedor de la integración).
Comentarios bienvenidos
¿Todo funciona bien en tu caso (meteorología, termostatos, válvulas)?
Cámaras: imagen, flujo en directo, detecciones con Gladys Plus?
Las traducciones al alemán / español, para los que usan Gladys en estos idiomas.
Un modelo Netatmo no reconocido (ej. timbre, persianas Bubendorff/iDiamant)? Dilo aquí o abre un issue.
Hola @Terdious, te propondría un PR para el termostato porque he hecho un fork por mi parte para añadir información que me faltaba. O te haría un resumen de lo que necesito.
Gran actualización de la integración externa de Netatmo, y de paso, la versión mínima pasa a Gladys 5.2.0.
Nuevos dispositivos
Persianas Bubendorff / iDiamant (NBR, NBO, NBS): abrir / cerrar / detener y posición, a través del nuevo interruptor « Persianas ».
Timbre de video: imagen en el tablero y activador de escena « Si el timbre suena ».
Detector de monóxido de carbono: alerta de CO utilizable en las escenas, con pre-alerta.
Home Coach (calidad del aire): temperatura, humedad, CO2, ruido, presión e índice de calidad del aire (con color en el tablero y HomeKit, más el nivel en todas las letras), a través del interruptor « Calidad del aire ».
Novedades de Gladys 5.x
Modo de calefacción de la casa (Planificación / Ausente / Anticongelante) en los termostatos y válvulas. @Will_71, no dudes en decirme si esto corresponde a lo que querías hacer y, de lo contrario, hacerme una PR encima.
Escenas: activadores « una persona conocida llega / se va », « la sirena suena »; acciones « cambiar el modo de calefacción », « marcar ausente / presente ».
Widgets del tablero: Clima Netatmo, Calefacción Netatmo, Cámaras Netatmo.
Fiabilidad
El clima sigue subiendo incluso si el servicio meteorológico de Netatmo falla, y se muestra una falla prolongada (insignia Degradado + mensaje en la configuración).
El final de una alerta de humo (« humo disipado ») ya no vuelve a activar las escenas de humo.
Qué hacer después de la actualización
Gladys 5.2.0 mínimo para recibir esta versión.
Para el timbre y las persianas: volver a hacer clic en « Conectar » en la configuración (nuevos permisos de Netatmo; la pantalla lo indica si es necesario).
Para los dispositivos ya creados: Descubrir → Actualizar en los termostatos / válvulas (modo de calefacción).
Llamado a los probadores
Todo se ha desarrollado según la API de Netatmo (y verificado con lo que hacen Home Assistant / pyatmo y openHAB), pero sin tener todo el material a mano. Si tienes un detector de CO, un timbre, persianas Bubendorff o un Home Coach, tus comentarios (y un extracto de la pestaña Registros) son bienvenidos aquí!
Nueva versión menor. Sigue requiriendo Gladys 5.2.0 mínimo (5.2.1 recomendada).
Calefacción
Termostato modulante / OpenTherm (OTM + relé OTH) : funciona como el termostato clásico (temperatura, consigna, modo de calefacción, estado de la caldera, batería). El relé envía la temperatura exterior y un binario Fallo de la caldera.
BTicino Smarther con termostato Netatmo (BNS) : temperatura, consigna, modo de calefacción, estado de la caldera y de la climatización. Se necesitan nuevos permisos de Netatmo: haga clic nuevamente en « Conectar » en la configuración de la integración (la pantalla se lo recuerda).
Calefacción avanzada, 4 nuevas acciones de escena :
consigna de una habitación, con una duración opcional;
aumento de una habitación;
retorno al horario;
elección del horario de calefacción.
El widget de calefacción también muestra el horario activo, señala las habitaciones en modo manual o de aumento, y ofrece un botón « Cambiar de horario ».
Cámaras y seguridad
Cámara interior Advance (NPC) : imagen en el tablero de control, vigilancia activada/desactivada, detección de movimiento y de personas. Aparece en el widget de cámaras. También requiere hacer clic nuevamente en « Conectar ».
Límite: como el timbre, solo transmite en directo en WebRTC, que Gladys aún no sabe leer. Por ahora, solo tenemos la imagen. Dos opciones están en estudio.
Proyector de la cámara exterior (NOC) : el modo encendido/apagado/automático se convierte en dos funcionalidades, Proyector (una luz: encendido = forzado) y Modo automático del proyector (un interruptor). Una escena « todo apagado » nunca corta el modo automático. En las cámaras ya creadas, haga Actualizar en la pantalla de Descubrimiento.
Solo se propone una funcionalidad « modo » del lado de Gladys. Se migrará tan pronto como esté disponible.
Presencia de personas conocidas por las cámaras : un dispositivo « - Personas conocidas », con una presencia por persona nombrada en la aplicación Netatmo, actualizada en tiempo real por los webhooks.
Corregido
Una actualización desencadenada por un webhook siempre vuelve a los datos frescos de Netatmo.
Para probar en equipos reales
Si tiene un termostato OpenTherm, un Smarther, una cámara Advance o una cámara exterior, sus comentarios son valiosos: valores enviados, comandos del proyector, fallo de la caldera.
Un pequeño resumen sobre los límites de estas dos versiones: ya están todas reguladas por PR core y SDK que esperan su fusión. @pierre-gilles, cuando tengas un momento para revisarlas
El Home Coach da un nivel en 5 escalones (bueno → muy malo), no un índice. Mientras tanto, la integración convierte este nivel en un índice aproximado, con la etiqueta solo en francés. Una vez que se fusionen estos PR, pasamos a un tipo estándar « nivel de calidad del aire », traducido y con historial :
La opción elegida : el directo WebRTC negociado por el navegador. Gladys se limita a reenviar la oferta y la respuesta a la integración, como lo hace Home Assistant para estas cámaras. El flujo va directamente de la nube Netatmo al navegador : sin conversión, el sonido se conserva, muy poca latencia, y también funciona a través de Gladys Plus.
En cuanto a la integración, estoy preparando la conexión para el timbre (NDB) y la cámara Advance (NPC) (#70). Permanecerá inactivo hasta que Gladys lo soporte. Podré validarlo en mi propio timbre.
El nuevo tipo estándar « modo de funcionamiento » de una iluminación (apagado / encendido / auto / programación) servirá para todas las luces que tienen un modo auto : proyectores de cámaras, iluminaciones con detector, Zigbee, Matter… Una vez fusionado, las dos funcionalidades del proyector se convertirán en una (#69).
Pequeña versión que prepara lo que viene. Gladys 5.2.0 mínimo.
Intercomunicador BTicino Classe 300X / Classe 300 EOS (vista previa)
Nuevo interruptor « Intercomunicador BTicino (Classe 300) — vista previa », desactivado por defecto.
Una vez activado, los módulos del intercomunicador son descubiertos: puesto interior, placa de calle, cerradura, iluminación de escalera, toma y módulo X. Por ahora, tenemos su señal y el indicador « inalcanzable ».
Activar el interruptor requiere 4 permisos adicionales de Netatmo: haga clic nuevamente en « Conectar » (la pantalla de configuración se lo recuerda). Si no tiene un intercomunicador BTicino, no cambia nada para usted, no se requiere reconexión.
Es un paso de relevamiento. Un registro [bticino-diagnostic] registra los datos brutos de estos módulos, ocultando los tokens, las claves y los correos electrónicos. Si tiene un Classe 300, sus registros me ayudarán a agregar el timbre como disparador de escena, la apertura de puerta y la iluminación de escalera. Asegúrese de revisarlos antes de publicarlos.
Directo WebRTC del timbre y la cámara Advance (preparado)
La integración ya sabe retransmitir el directo WebRTC del timbre (NDB) y la cámara interior Advance (NPC). Solo lo activa una vez que Gladys lo admite (PR core #3215 y SDK #43). Hasta entonces, nada cambia: mantiene la imagen fija.
Netatmo (integración externa) — presentación + resumen hasta la v1.3.0
¿Qué es?
Lo que se admite
Instalación
Resumen de versiones
Requisitos previos
¿Vienes del servicio Netatmo integrado? ¡Conserva tu historial!
En curso, lado núcleo de Gladys
Comentarios bienvenidos
Persianas Bubendorff / iDiamant (NBR, NBO, NBS): abrir / cerrar / detener y posición, a través del nuevo interruptor « Persianas ».
Timbre de video: imagen en el tablero y activador de escena « Si el timbre suena ».
Detector de monóxido de carbono: alerta de CO utilizable en las escenas, con pre-alerta.
Home Coach (calidad del aire): temperatura, humedad, CO2, ruido, presión e índice de calidad del aire (con color en el tablero y HomeKit, más el nivel en todas las letras), a través del interruptor « Calidad del aire ».
Modo de calefacción de la casa (Planificación / Ausente / Anticongelante) en los termostatos y válvulas. 
Escenas: activadores « una persona conocida llega / se va », « la sirena suena »; acciones « cambiar el modo de calefacción », « marcar ausente / presente ».
Widgets del tablero: Clima Netatmo, Calefacción Netatmo, Cámaras Netatmo.
Notas de la versión completas: 
Documentación: 
Cámaras y seguridad
Corregido
Directo WebRTC del timbre y la cámara Advance (preparado)