Intégration externe - Airthings

cover-airthings

Salut tout le monde !

Le radon, on ne le voit pas, on ne le sent pas, et en Bretagne ou dans le Massif central il s’invite volontiers à la cave. Les capteurs Airthings le mesurent très bien, avec le CO₂ et les particules : les voilà dans Gladys, pour que la VMC réagisse toute seule plutôt que de découvrir le chiffre dans l’appli trois semaines plus tard.

Ce que ça fait

  • Un appareil par capteur (Wave, Wave Plus, Wave Mini, Wave Radon, View Plus, View Pollution, Space…).
  • Les mesures : radon (court terme, et long terme quand l’API le donne), CO₂, COV, PM1, PM2.5, PM10, température, humidité, pression, batterie.
  • L’âge de la mesure, pour repérer un capteur qui ne remonte plus rien.
  • Un widget « Qualité de l’air » :
    • toutes les pièces d’un coup d’œil, ou un seul capteur avec sa courbe de radon de la semaine ;
    • le radon en couleur : vert sous 100 Bq/m³ (seuil de l’OMS), rouge à partir de 300 Bq/m³ (référence française, réglable).
  • Un bouton Tester la connexion.
  • Une relève toutes les 5 minutes, bien en dessous du quota de l’API.
  • En français, anglais, allemand et espagnol.

Pas de déclencheur spécifique : les seuils de Gladys sur les états des appareils font déjà tout le travail.

Le truc sympa

Radon de la cave au-dessus de 300 → message, et la prise de la VMC s’allume
CO₂ de la chambre au-dessus de 1000 avec quelqu’un à la maison → « Ouvrez la fenêtre »
Âge de la mesure au-dessus de 180 minutes → « Vérifiez le hub ou les piles »

Installation

:warning: Gladys 5.1 minimum.

Elle arrive dans le store au prochain passage de l’indexeur. En attendant : Intégrations → Installer depuis GitHub, avec https://github.com/guim31/gladys-airthings

  1. Créez un client d’API gratuit sur le tableau de bord de l’API Airthings, avec votre compte Airthings.
  2. Dans Gladys : collez l’identifiant et le secret de ce client, puis Tester la connexion.
  3. Onglet Découverte : ajoutez vos capteurs.

Petites réserves honnêtes

  • Cloud uniquement : pas de lecture en Bluetooth local. Les Wave passent par un hub, un View Plus ou l’appli du téléphone.
  • Les valeurs datent de la dernière remontée du capteur, ce qui peut faire plusieurs minutes pour un Wave.
  • Gladys n’a pas de catégorie « radon » ni « PM1 » : le radon apparaît comme un compteur en Bq/m³, et le PM1 à côté des PM2.5, sous son propre nom.
  • Les indices de moisissure et de virus ne sont pas lus.
  • Développée sans capteur. J’ai vérifié depuis chez moi que la vraie API Airthings refuse proprement de fausses clés, mais aucun vrai compte n’y est encore passé : les types de mesures par modèle et l’heure exacte des relevés restent à confirmer. Si vous avez un Airthings, vos retours sont les bienvenus.

Comme les précédentes, développée avec Claude Code. Projet indépendant, non affilié à Airthings.

Dépôt : https://github.com/guim31/gladys-airthings