Integración domótica Airly, gratuita y de código abierto
Calidad del aire de Airly: CAQI, PM1, PM2,5, PM10, tiempo y previsión 24 h de sus lugares.
Publicado por William-De71
- Dispositivos
- Versión 0.1.0
- Requiere Gladys >=5.2.0
- ★ 0
Presentación
Airly gestiona una red de miles de sensores de calidad del aire, sobre todo en Polonia y en Europa. Cada sensor mide las partículas finas (PM1, PM2,5, PM10), la mayoría el tiempo (temperatura, humedad, presión), algunos gases (NO₂, O₃, SO₂, CO). Airly calcula con ellos el CAQI (Common Air Quality Index, el índice europeo) y una previsión de las próximas 24 horas.
Esta integración lo lleva a Gladys para hasta tres lugares, cada uno una casa de Gladys o un sensor Airly: un dispositivo por lugar, activadores de escena cuando cambia la calidad del aire, cuando se prevé contaminación o cuando se supera un valor guía de la OMS, una acción de escena y dos widgets del panel.
El CAQI va de 0 a 100 y más: muy buena (0-25), buena (25-50), moderada (50-75), mala (75-100), muy mala (100 y más). El nivel siempre se deduce del valor.
Requisitos previos
- Gladys Assistant 5.2.0 o posterior (el selector de casa de la configuración). Las instancias más antiguas no pueden instalar la integración.
- Una clave de API de Airly gratuita (más abajo).
- Un lugar cubierto por Airly: una casa con sensores Airly a pocos kilómetros (el mapa de Airly los muestra), o el número de un sensor.
Obtener una clave de API
- Abra el portal para desarrolladores de Airly y cree una cuenta.
- Elija el plan gratuito: su clave de API aparece en la página de claves del portal. Cópiela.
Una clave gratuita permite 100 solicitudes al día (las claves creadas antes de 2020: 1000), contadas por día UTC. Una lectura de un lugar es una solicitud: la integración las reparte por sí misma entre sus lugares.
Encontrar el número de un sensor
En el mapa de Airly, haga clic en un sensor: el número de la instalación suele terminar la dirección de la página (…,i204 para la instalación 204). Pegue el número, o la dirección entera, en el campo de un lugar.
Configuración
| Campo | Qué introducir |
|---|---|
| Clave de API | La clave de su cuenta Airly. Guardada como secreto, nunca se vuelve a mostrar ni se escribe en los registros. |
| Casa (lugar 1, 2, 3) | Una casa de Gladys: su ubicación (Ajustes → Casas) sitúa el lugar. La integración pide este acceso. |
| O un número de sensor Airly | El número de una instalación Airly: 204. Prevalece sobre la casa del mismo lugar. |
| Calidad del aire de una casa | En la ubicación de la casa (Airly interpola los sensores cercanos), o el sensor más cercano (3 km como máximo). |
| Idioma de los textos | Nombres de los dispositivos y textos dados a las escenas. Automático: el idioma del último widget mostrado. |
Dos botones completan la pantalla: Leer ahora (comprueba la clave, sitúa los lugares y los lee enseguida) y Diagnóstico (el estado de la integración en sus registros, sin la clave ni las coordenadas).
Uso
Dispositivos
Abra la pestaña Descubrir de la integración y cree un dispositivo por lugar («Airly Casa», «Airly Kraków, Mikołajska»):
- Índice de calidad del aire (CAQI) y Calidad del aire, su nivel en texto;
- PM2,5 y PM10, en µg/m³;
- CAQI máximo en 24 h y Previsión de calidad del aire: «Máximo en 24 h: 62, Moderada, a las 18:00»;
- en cuanto el lugar los ha dado: Temperatura exterior, Humedad exterior, Presión atmosférica, Dióxido de nitrógeno (NO₂), Ozono (O₃), Dióxido de azufre (SO₂).
Un valor que Airly no dio conserva el anterior: no se inventa ningún 0. Una función ofrecida nunca desaparece. PM1 y CO no tienen categoría en Gladys: están en el widget y en la acción de escena.
Todos los lugares se leen en la misma ronda, tan a menudo como lo permite el límite diario de la clave: cada 30 minutos con un lugar, 35 con dos, 50 con tres, con una clave gratuita. Diez solicitudes al día quedan en reserva para Leer ahora, el botón Actualizar y la acción de escena.
Widgets del panel
- Calidad del aire Airly: el CAQI en el color de su nivel, PM1, PM2,5 y PM10 (verde por debajo del valor guía de la OMS, naranja hasta el doble, rojo por encima), la temperatura, un consejo, la humedad y la presión.
- Previsión Airly: el CAQI de las últimas 24 horas y de las próximas 24 en un gráfico, el valor actual, el pico previsto y una alerta cuando alcanza un nivel malo.
Ambos tienen un ajuste Lugar (el primer lugar por defecto) y un botón Actualizar, que solo vuelve a leer pasados 15 minutos. Un widget nunca gasta una solicitud por sí solo: muestra la última lectura.
Escenas
Activadores:
- Airly: cambio de calidad del aire: el nivel del CAQI cambia. Filtros: lugar, nuevo nivel (uno o varios), sentido (empeora, mejora). Variables:
caqi,level,level_name,previous_level,direction,pm25,pm10,name. - Airly: contaminación prevista: la previsión de las próximas 24 horas alcanza un nivel malo o muy malo; una vez por episodio, de nuevo si empeora. Filtros: lugar, nivel. Variables:
caqi,level_name,time,hours,current_caqi. - Airly: umbral de la OMS superado: PM2,5, PM10, NO₂ u ozono de la última hora supera el valor guía de la OMS; de nuevo solo tras volver por debajo. Filtros: lugar, contaminante. Variables:
pollutant_name,value,limit,percent.
Acción: Airly: leer la calidad del aire de un lugar: el CAQI y su nivel, PM1, PM2,5, PM10, el tiempo, los porcentajes OMS, el pico previsto y una frase lista summary.
Ejemplos:
- Cuando la calidad del aire se vuelve mala o muy mala → cerrar las ventanas y encender el purificador de aire.
- Cuando se prevé contaminación → enviar
Calidad del aire {{triggerEvent.data.level_name}} prevista hacia las {{triggerEvent.data.time}}a su teléfono. - Cada mañana a las 7:00 → leer la calidad del aire y hacer decir el
summaryantes de salir a correr.
Transporte
Nube ("transports": ["cloud"]): la integración contacta airapi.airly.eu por HTTPS con su clave (en una cabecera) y, por lugar, el número del sensor o las coordenadas de la casa (redondeadas a unos 10 m). Nada más sale de su red. Las lecturas y las solicitudes del día se guardan en el volumen /data de la integración: un reinicio no vuelve a leer nada reciente.
Solución de problemas
- Airly rechazó la clave de API: cópiela de nuevo del portal para desarrolladores (sin espacios) y guarde la configuración: las lecturas se reanudan enseguida.
- Ningún sensor cerca de un lugar: Airly no tiene nada al alcance de la casa. Elija el modo «Sensor más cercano», el número de un sensor u otro lugar.
- Se alcanzó el límite diario de la clave: las lecturas se reanudan tras la medianoche UTC. Con tres lugares y muchas pulsaciones de Actualizar, la reserva se agota antes.
- La casa no tiene ubicación: indíquela en Ajustes → Casas y pulse Leer ahora.
- Sin previsión: Airly solo la ofrece para parte de sus sensores; el widget lo indica.
- Sigue bloqueado: pulse Diagnóstico y abra una incidencia en GitHub con las versiones de Gladys y de la integración, y las líneas «Airly diagnostic» de los registros (añada
DEBUG=gladys-integration-sdken modo desarrollador).
Datos proporcionados por Airly. Esta integración comunitaria no está afiliada a Airly.
Parámetros de configuración
Estos son los parámetros que Airly te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Clave de API de Airly | section | No | Airly gestiona una red de sensores de calidad del aire, sobre todo en Polonia y en Europa: PM1, PM2,5, PM10, a menudo el tiempo, a veces gases, y una previsión de 24 horas. Su API necesita una clave gratuita (100 solicitudes al día): cree una cuenta en el portal para desarrolladores de Airly y copie la clave del plan gratuito. La integración reparte por sí misma las solicitudes entre sus lugares. |
| Clave de API | secret | Sí | |
| Lugar 1 | section | No | Una casa de Gladys (su ubicación), o el número de un sensor Airly, que prevalece sobre la casa. |
| Casa | select | No | |
| O un número de sensor Airly | string | No | |
| Lugar 2 | section | No | Una casa de Gladys (su ubicación), o el número de un sensor Airly, que prevalece sobre la casa. |
| Casa | select | No | |
| O un número de sensor Airly | string | No | |
| Lugar 3 | section | No | Una casa de Gladys (su ubicación), o el número de un sensor Airly, que prevalece sobre la casa. |
| Casa | select | No | |
| O un número de sensor Airly | string | No | |
| Opciones | section | No | La integración lee todos los lugares en una sola ronda, tan a menudo como lo permite el límite diario de la clave: cada 30 minutos con un lugar, 35 con dos, 50 con tres (clave gratuita). Algunas solicitudes quedan en reserva para el botón Leer ahora, el botón Actualizar de los widgets y la acción de escena. |
| Calidad del aire de una casa | select | No | Airly puede interpolar la calidad del aire en la ubicación de la casa a partir de los sensores cercanos, o dar los valores del sensor más cercano (3 km como máximo). |
| Idioma de los textos | select | No | Nombres de los dispositivos y textos de las escenas. Automático: el idioma del panel. |
Cómo instalar Airly en Gladys
- En Gladys, abre Integraciones: Airly 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/william-de71/gladys-airly:0.1.0), 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/William-De71/gladys-airly.
Airly 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
Airly 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 William-De71, 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