Integración domótica Awair, gratuita y de código abierto
Sensores de calidad del aire Awair por su API local: puntuación, CO2, COV, PM2.5, temperatura.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Presentación
Esta integración lleva a Gladys los sensores de calidad del aire Awair: Awair Element, Awair Omni, Awair 2nd Edition, Awair Mint y Awair Glow C, leídos en su propia red mediante su Local API. Cada sensor se convierte en un dispositivo de Gladys con su puntuación Awair, la temperatura, la humedad, el CO2, los COV, las partículas finas y, según el modelo, la luminosidad y el ruido.
Los sensores sin Local API (Awair de primera generación, Awair Glow) pueden leerse, como opción, a través de la nube de Awair con un token de desarrollador.
Todo es de solo lectura: la integración nunca modifica un ajuste de sus sensores.
Desarrollada sin el hardware: sus comentarios son bienvenidos. La integración se ha escrito a partir de la documentación de la API de Awair y de respuestas reales de los sensores grabadas por otros proyectos de código abierto. Si algo parece incorrecto con su modelo, abra una issue en el repositorio de GitHub.
Esta integración no está afiliada a Awair.
Requisitos
- Gladys Assistant 5.1.0 o posterior.
- Para cada sensor, la Local API activada en la aplicación Awair Home: abra el sensor y luego Awair+ → Awair APIs → Local API, y actívela.
- Los sensores en la misma red que Gladys. Se recomienda una dirección IP fija (reserva DHCP en su router), pero no es obligatoria.
- Opcional: un token de desarrollador de Awair, solo para los sensores sin Local API.
Configuración
Abra Integraciones → Awair → Configuración.
- Haga clic en Buscar sensores. La integración pide a Gladys que recorra la red (mDNS) y lee cada sensor Awair encontrado. El informe bajo el botón los enumera, con su dirección.
- Abra la pestaña Descubrir y añada a Gladys los sensores que desee.
| Ajuste | Uso |
|---|---|
| Direcciones IP de los sensores | Solo para un sensor que la búsqueda no encuentra. Varias direcciones separadas por comas. |
| Intervalo de actualización local | 10 s, 30 s (por defecto), 1 min o 5 min. El propio sensor actualiza sus valores cada 10 segundos. |
| Token de acceso de Awair | Opcional. Token de la consola de desarrollador de Awair, para los sensores sin Local API. |
| Intervalo de actualización de la nube | 5 min (por defecto), 10, 15 o 30 min. |
| Idioma de la integración | Nombres de las funciones de los dispositivos añadidos después y textos de la acción de escena. Francés por defecto. |
Cuota de la nube de Awair
La API de desarrollador de Awair cuenta las llamadas por día. El nivel Hobbyist, el gratuito, permite 300 llamadas «latest» al día: 5 minutos entre dos lecturas de un sensor es el ritmo más rápido que se mantiene dentro. La integración lee la cuota de su cuenta y nunca va más rápido de lo que esta permite, repartida entre todos sus sensores en la nube. Si la API responde aun así «cuota superada», el sensor se deja tranquilo durante una hora. Un sensor accesible por la Local API siempre se lee en local y no consume cuota.
Dispositivos
Un dispositivo por sensor, con el nombre de su modelo hasta que usted lo cambie. Sus funciones son las mediciones que el sensor realmente envía; a modo de guía:
| Función | Unidad | Modelos |
|---|---|---|
| Puntuación Awair | 0-100 | todos |
| Calidad del aire | nivel | todos: buena (80+), regular (60-79), mala (menos de 60) |
| Temperatura | °C | todos |
| Humedad | % | todos |
| CO2 | ppm | Element, Omni, 2nd Edition, Glow, primera generación |
| COV | ppb | todos |
| PM2.5 | µg/m³ | Element, Omni, 2nd Edition, Mint |
| PM10 | µg/m³ | Element y 2nd Edition (valor estimado por el sensor) |
| Polvo | µg/m³ | primera generación (un solo sensor para PM2.5 y PM10) |
| Luminosidad | lux | Omni, Mint |
| Ruido | dBA | Omni |
| Punto de rocío | °C | Element (Local API) |
| Batería | % | Omni (Local API) |
| Conectado a la red | sí/no | Omni (Local API) |
Cuando el sensor da a la vez un valor medido y un valor estimado (CO2, PM10), se usa el medido. El nivel Calidad del aire se muestra en color en el panel: verde, amarillo, naranja.
Solo se envían a Gladys los valores que cambian, más cada valor al menos cada 6 horas para que ninguno parezca antiguo.
Widget del panel
Calidad del aire: elija un sensor en los ajustes del widget. El widget muestra la puntuación Awair en un indicador, el CO2, las PM2.5 (o el polvo), la temperatura y la humedad en mosaicos en directo, y luego el nivel de calidad del aire y la conexión (local, nube o inaccesible).
Disparadores de escena
- Sensor Awair perdido: el sensor ya no responde, tres lecturas fallidas seguidas (desenchufado, sin wifi, Local API desactivada). Elija un sensor o deje el campo vacío para todos. La escena recibe el nombre del sensor.
- Sensor Awair de vuelta: un sensor considerado perdido vuelve a responder.
Los propios valores (puntuación, CO2…) no necesitan disparador: use el disparador estándar «valor de un dispositivo» de Gladys sobre las funciones del dispositivo.
Acción de escena
Leer la calidad del aire: lee el sensor en el acto y da a las acciones siguientes de la escena:
summary: una frase preparada, por ejemplo «Oficina: calidad del aire buena (puntuación 92/100), CO2 650 ppm, PM2.5 3 µg/m³, 21,5 °C, 45 % de humedad.»;score,co2,pm25,temperature,humidity: los valores;level:good,fairopoor, para comparar en una condición.
La frase sigue el idioma de la configuración de la integración.
Ejemplos de escenas
- Abrir las ventanas: disparador «valor de un dispositivo» sobre el CO2 por encima de 1200 ppm → enviar el mensaje «Hora de ventilar».
- Informe matinal: cada día a las 7:30 → acción «Leer la calidad del aire»
→ enviar un mensaje con
summary. - Ventilación: cuando el nivel Calidad del aire pasa a «mala» → encender el enchufe de la ventilación; cuando vuelve a «buena» → apagarlo.
- Vigilar el sensor: disparador «Sensor Awair perdido» → enviar un mensaje con el nombre del sensor.
Solución de problemas
- No se encuentra ningún sensor: compruebe que la Local API está activada en la aplicación Awair Home y luego introduzca la dirección IP del sensor en la configuración. La dirección se muestra en la aplicación Awair Home o en su router.
- «El descubrimiento automático (mDNS) a través de Gladys no está disponible»: su Gladys no retransmite el mDNS. Introduzca las direcciones IP.
- Un sensor ha cambiado de dirección: la integración vuelve a buscar por sí misma cuando un sensor deja de responder, como mucho cada 10 minutos. También puede hacer clic en Buscar sensores.
- «La nube de Awair ha rechazado el token»: copie de nuevo el token desde la consola de desarrollador de Awair.
- Registros: la integración solo escribe lo esencial. Para ver cada
lectura, defina la variable de entorno
LOG_LEVEL=debug.
Limitaciones
- Solo lectura: la pantalla, el LED y los demás ajustes del sensor se quedan en la aplicación Awair Home.
- La señal wifi del sensor no está disponible: la Local API no la proporciona.
- El Awair de primera generación y el Awair Glow no tienen Local API: necesitan el token de la nube y se leen cada 5 minutos como máximo.
- Solo las respuestas Local API del Element y del Omni se han podido comprobar con grabaciones reales; los demás modelos deberían responder igual.
- Los nombres de las funciones se fijan al añadir el dispositivo: cambiar el idioma después no los renombra.
Parámetros de configuración
Estos son los parámetros que Awair te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Encontrar sus sensores | section | No | Active primero la Local API de cada sensor en la aplicación Awair Home (Awair+, Awair APIs, Local API). Los sensores de la misma red que Gladys se encuentran entonces automáticamente (mDNS): abra la pestaña Descubrir. Si falta alguno, introduzca su dirección IP a continuación. |
| Direcciones IP de los sensores | string | No | Opcional, separadas por comas. Solo para los sensores que el descubrimiento automático no encuentra. |
| Intervalo de actualización local | select | No | Frecuencia de lectura de los sensores en la red. El propio sensor se actualiza cada 10 segundos. |
| Nube de Awair (opcional) | section | No | Solo para los sensores sin Local API (Awair de primera generación, Glow): pegue el token de la consola de desarrollador de Awair. Su cuota diaria limita el ritmo: 5 minutos como mínimo. Los sensores accesibles en local siempre se leen en local. |
| Token de acceso de Awair | secret | No | |
| Intervalo de actualización de la nube | select | No | |
| Idioma de la integración | select | No | Nombres de las funciones de los dispositivos añadidos después y textos de la acción de escena. |
Cómo instalar Awair en Gladys
- En Gladys, abre Integraciones: Awair 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-awair: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-awair.
Awair requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Awair 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