Intégration domotique Blueair, gratuite et open source

Purificateurs d'air Blueair via le cloud Blueair : qualité de l'air, filtre, ventilation, modes.

• Publiée par guim31
• Appareils
• Version 1.0.1
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Suivez et pilotez vos purificateurs d'air Blueair depuis Gladys : qualité de l'air (PM2.5, PM10, COV), durée de vie du filtre, marche, vitesse du ventilateur, modes auto / nuit / éco, luminosité de l'affichage et sécurité enfant — via le cloud Blueair, celui qu'utilise l'appli Blueair. Soyez prévenu une fois quand un filtre est à changer, et passez tous les purificateurs en mode nuit d'un geste au coucher.

Développée sans le matériel : vos retours sont bienvenus. Cette intégration a été construite et testée sur de vraies réponses du cloud Blueair enregistrées par les projets libres blueair_api et ha_blueair, pas sur un purificateur ni un compte. Si quelque chose ne marche pas comme décrit, dites-le sur le forum Gladys ou dans les issues.

Sans lien avec Blueair ni Unilever, qui ne l'approuvent ni ne la prennent en charge. Blueair est une marque de son propriétaire.

Ce qu'il vous faut

• Gladys Assistant 5.1.0 ou plus récent.
• Un purificateur Blueair connecté au Wi-Fi et installé dans l'appli Blueair (Blue Pure Max, Protect, DustMagnet, HealthProtect, Signature, Classic, 2-en-1…).
• L'e-mail et le mot de passe de votre compte Blueair, et sa région (celle choisie à la création du compte).
• Une connexion Internet : tout passe par le cloud Blueair, il n'y a pas de pilotage local des appareils Blueair.

Mise en route

1. Installez l'intégration depuis le catalogue de Gladys.
2. Dans Configuration, saisissez l'E-mail du compte Blueair, le Mot de passe du compte Blueair et la Région du compte (Europe, Amérique du Nord, Australie, Chine).
3. Enregistrez, puis cliquez sur Tester la connexion : le message sous le bouton liste les appareils du compte.
4. Ouvrez l'onglet Découverte : un appareil par appareil Blueair du compte. Cliquez sur Ajouter, choisissez une pièce, enregistrez.

Options :

• Intervalle de rafraîchissement : la fréquence de lecture des appareils, de 1 à 5 minutes (2 minutes par défaut).
• Filtre à changer à : la durée de vie restante (5, 10, 15 ou 20 %, 10 % par défaut) à laquelle le filtre est à changer.
• Langue des noms de fonctionnalités : anglais, français, allemand ou espagnol. Les noms sont donnés à l'ajout d'un appareil (français par défaut).

Le mot de passe n'est envoyé qu'à Blueair. L'intégration garde la session Blueair dans /data : un redémarrage ne reconnecte pas le compte.

L'appareil de chaque purificateur

Fonctionnalités

Chaque fonctionnalité n'apparaît que si l'appareil l'a.

Fonctionnalité	Ce que c'est
Marche	Interrupteur : allumé, le purificateur tourne ; éteint, en veille
Vitesse du ventilateur	La vitesse manuelle, dans les bornes du modèle (voir plus bas)
Mode	Manuel, Auto, Nuit, Éco (Éco sur la série Signature seulement)
Luminosité de l'affichage	Luminosité de l'affichage et des voyants, 0–100 (0–4 sur les Classic)
Sécurité enfant	Verrouille les boutons du purificateur
Durée de vie du filtre	Durée de vie restante du filtre, en %
Filtre à changer	1 quand la durée de vie restante atteint le seuil de la configuration
PM2.5	Particules fines, µg/m³
PM10	Particules grossières, µg/m³
COV	Composés organiques volatils, ppb (Protect, HealthProtect, Classic série i)
CO2	Dioxyde de carbone, ppm (Classic série i)
Température	°C, sur les modèles qui ont le capteur
Humidité	%, sur les modèles qui ont le capteur
En ligne	1 quand le purificateur est connecté au cloud Blueair

Choisir une vitesse passe le purificateur en mode manuel, comme le fait l'appli. Les particules s'affichent comme dans l'appli Blueair (le cloud les envoie 1,32 fois plus hautes ; l'intégration les corrige comme ha_blueair). Les PM1 ne sont pas publiées : Gladys n'a pas de capteur PM1.

Modèles

• Bornes de la vitesse : 0–91 sur les modèles à quatre vitesses (Blue Pure Max, Protect, 2-en-1), 0–100 sur les autres, 1–3 sur les humidificateurs, 0–3 sur les Classic de l'ancien cloud (0 = éteint).
• ComfortPure 3-en-1 (T10i, T20i) : ces appareils chauffent. Ils sont en lecture seule dans Gladys (qualité de l'air, température, filtre) : une scène erronée ne doit jamais laisser un chauffage allumé. Pilotez-les avec l'appli Blueair.
• Modèles anciens (Classic 205/280i/290i/480i/680i, Sense+) : ils vivent sur l'ancien cloud Blueair et sont trouvés avec le même compte. Leur filtre dit seulement « à changer » ou non, sans pourcentage.
• Les humidificateurs du compte apparaissent aussi, avec leur marche, vitesse, modes et capteurs.

Widget du tableau de bord

Le widget Purificateurs Blueair, deux présentations :

• tous les appareils (aucun appareil choisi dans ses réglages) : une ligne par appareil — son mode et ses PM2.5, en vert, orange ou rouge selon la qualité de l'air, « Filtre à changer » le moment venu, « Hors ligne » s'il n'est pas connecté — et deux boutons, Tout en auto et Tout en nuit ;
• un appareil : des tuiles en direct (PM2.5, durée de vie du filtre, température ou COV), son mode, son filtre, sa connexion, et des boutons : Éteindre / Allumer et ses modes (Auto, Nuit, Éco). Le mode en cours porte une coche.

Scènes

Déclencheur

Filtre Blueair à changer : une fois par filtre, quand sa durée de vie restante atteint le seuil de la configuration (ou quand un ancien Classic dit que son filtre est à changer). Pas une seconde fois pour le même filtre, même après un redémarrage ; une fois le filtre changé, le suivant sera annoncé. Filtre : un appareil (vide : tous). Informations transmises : nom de l'appareil, modèle, durée de vie restante (%).

Action

Choisir le mode Blueair : met un appareil, ou tous ceux qui proposent ce mode (appareil laissé vide), en mode Auto, Nuit, Éco ou Manuel. Renvoie le nombre d'appareils modifiés.

Les fonctionnalités des appareils s'utilisent aussi directement dans les scènes : allumer ou éteindre un purificateur, régler sa vitesse, ou lancer une scène quand les PM2.5 dépassent une valeur.

Idées de scènes

• Coucher : à 22 h 30, Choisir le mode Blueair → Nuit, tous les appareils. Le matin, retour en Auto.
• Rappel du filtre : déclencheur Filtre Blueair à changer → envoyer un message « Changez le filtre de {nom de l'appareil} (encore {durée de vie restante} %) ».
• Fumée de cuisine : quand les PM2.5 du purificateur de la cuisine dépassent 35 µg/m³, vitesse au maximum ; retour en Auto quand elles repassent sous 10.
• Maison vide : quand plus personne n'est là, éteindre les purificateurs ; au retour, les rallumer en Auto.

Rafraîchissement et limites du cloud Blueair

Blueair ne publie aucun quota pour son cloud. L'intégration reste légère :

• une requête par appareil à chaque rafraîchissement (1 à 5 minutes, 2 par défaut) ;
• la qualité de l'air est une moyenne sur 5 minutes côté Blueair : elle est lue au plus une fois toutes les 5 minutes ;
• la liste des appareils est relue toutes les 6 heures (ou avec Scanner dans l’onglet Découverte) ;
• la connexion est gardée dans /data et renouvelée depuis la session, sans renvoyer le mot de passe ;
• un mot de passe refusé arrête toute requête jusqu'à un changement de la configuration (des essais répétés bloqueraient le compte) ; une réponse « trop de requêtes » suspend tout pendant 10 minutes.

Gladys n'interroge pas ces appareils : l'intégration les rafraîchit avec son propre minuteur. Les changements faits dans l'appli Blueair apparaissent dans Gladys au rafraîchissement suivant.

Dépannage

• « e-mail ou mot de passe refusé par Blueair » : vérifiez-les dans l'appli Blueair, puis enregistrez de nouveau la configuration (l'intégration cesse d'essayer d'ici là).
• « ouvrez une fois l'appli Blueair et complétez votre profil (nom) » : Blueair exige désormais un nom sur le compte. Ouvrez l'appli, complétez le profil, puis cliquez sur Tester la connexion.
• Connecté, mais aucun appareil : la région est sans doute fausse — essayez l'autre (les comptes créés au Royaume-Uni sont souvent en « Europe »).
• Un purificateur est « Hors ligne » : vérifiez son Wi-Fi dans l'appli Blueair. Le cloud Blueair dit parfois hors ligne un purificateur qui fonctionne : des valeurs récentes de capteurs comptent comme signe de vie.
• Les valeurs ne bougent pas : la qualité de l'air ne change que toutes les 5 minutes côté Blueair.
• Journaux : LOG_LEVEL=debug montre chaque requête (jamais le mot de passe ni les jetons).

Limites

• Cloud seulement : pas de pilotage local, et rien ne marche sans Internet ou quand le cloud Blueair est en panne.
• Pas de temps réel : les changements apparaissent au rafraîchissement suivant (le MQTT qu'utilise l'appli n'est pas implémenté).
• Les chauffages ComfortPure 3-en-1 sont en lecture seule. Leurs modes de chauffage et de refroidissement ne sont pas montrés.
• Les PM1, le germ shield, la veilleuse, la minuterie et la mèche des humidificateurs ne sont pas publiés.
• Les comptes dont les appareils vivent dans une autre région que le compte lui-même (rare) ne sont pas pris en charge.
• Développée sans le matériel : les familles de modèles suivent blueair_api et ha_blueair, construits avec de vrais appareils. Vos retours sont bienvenus.

Paramètres de configuration

Voici les paramètres demandés par Blueair dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Votre compte Blueair	section	Non	Saisissez l'e-mail et le mot de passe de l'appli Blueair, et la région choisie à la création du compte. Chaque appareil Blueair du compte apparaît dans l'onglet Découverte. L'intégration passe par le cloud Blueair : une connexion Internet est nécessaire. Sans lien avec Blueair ni Unilever.
E-mail du compte Blueair	string	Oui
Mot de passe du compte Blueair	secret	Oui
Région du compte	select	Oui	La région choisie dans l'appli Blueair à la création du compte.
Intervalle de rafraîchissement	select	Non	Fréquence de lecture des appareils sur le cloud Blueair. La qualité de l'air est une moyenne sur 5 minutes.
Filtre à changer à	select	Non	Durée de vie restante à laquelle le filtre est à changer (fonctionnalité et déclencheur de scène).
Langue des noms de fonctionnalités	select	Non	Pour les appareils ajoutés désormais, et les messages de l'intégration.

Comment installer Blueair dans Gladys

1. Dans Gladys, ouvrez Intégrations : Blueair apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-blueair:1.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-blueair.

Blueair nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

Blueair est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂