Blueair Smart-Home-Integration, kostenlos und Open Source

Blueair-Luftreiniger über die Blueair-Cloud: Luftqualität, Filter, Lüfter und Modi.

• Veröffentlicht von guim31
• Geräte
• Version 1.0.1
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Verfolge und steuere deine Blueair-Luftreiniger aus Gladys: Luftqualität (PM2.5, PM10, VOC), Filterlebensdauer, Betrieb, Lüfterstufe, die Modi Auto / Nacht / Eco, Displayhelligkeit und Kindersicherung — über die Blueair-Cloud, dieselbe, die die Blueair-App nutzt. Lass dich einmal benachrichtigen, wenn ein Filter zu wechseln ist, und schalte zur Schlafenszeit alle Luftreiniger mit einem Tipp in den Nachtmodus.

Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration wurde mit echten Antworten der Blueair-Cloud gebaut und getestet, aufgezeichnet von den Open-Source-Projekten blueair_api und ha_blueair, nicht mit einem Luftreiniger oder einem Konto. Wenn etwas nicht wie beschrieben funktioniert, sag es bitte im Gladys-Forum oder in den Issues.

Nicht mit Blueair oder Unilever verbunden, nicht von ihnen unterstützt oder empfohlen. Blueair ist eine Marke ihres Inhabers.

Was du brauchst

• Gladys Assistant 5.1.0 oder neuer.
• Einen Blueair-Luftreiniger, mit dem WLAN verbunden und in der Blueair-App eingerichtet (Blue Pure Max, Protect, DustMagnet, HealthProtect, Signature, Classic, 2-in-1…).
• Die E-Mail-Adresse und das Passwort deines Blueair-Kontos und seine Region (die beim Anlegen des Kontos gewählte).
• Eine Internetverbindung: Alles läuft über die Blueair-Cloud, eine lokale Steuerung der Blueair-Geräte gibt es nicht.

Einrichtung

1. Installiere die Integration aus dem Gladys-Katalog.
2. Gib unter Konfiguration die E-Mail des Blueair-Kontos, das Passwort des Blueair-Kontos und die Region des Kontos ein (Europa, Nordamerika, Australien, China).
3. Speichere und klicke dann auf Verbindung testen: Die Meldung unter dem Knopf listet die Geräte des Kontos auf.
4. Öffne den Tab Entdecken: ein Gerät pro Blueair-Gerät des Kontos. Klicke auf Hinzufügen, wähle einen Raum, speichere.

Optionen:

• Aktualisierungsintervall: wie oft die Geräte gelesen werden, 1 bis 5 Minuten (standardmäßig 2 Minuten).
• Filter wechseln bei: die restliche Filterlebensdauer (5, 10, 15 oder 20 %, standardmäßig 10 %), ab der der Filter zu wechseln ist.
• Sprache der Funktionsnamen: Englisch, Französisch, Deutsch oder Spanisch. Die Namen werden beim Hinzufügen eines Geräts vergeben (standardmäßig Französisch).

Das Passwort wird nur an Blueair gesendet. Die Integration bewahrt die Blueair-Sitzung unter /data auf: Ein Neustart meldet das Konto nicht neu an.

Das Gerät jedes Luftreinigers

Funktionen

Jede Funktion erscheint nur, wenn das Gerät sie hat.

Funktion	Was es ist
Betrieb	Schalter: an, der Luftreiniger läuft; aus, Standby
Lüfterstufe	Die manuelle Stufe, innerhalb der Grenzen des Modells (siehe unten)
Modus	Manuell, Automatisch, Nacht, Eco (Eco nur bei der Signature-Serie)
Displayhelligkeit	Helligkeit von Display und Leuchten, 0–100 (0–4 bei den Classic-Modellen)
Kindersicherung	Sperrt die Tasten des Luftreinigers
Filterlebensdauer	Restliche Filterlebensdauer, in %
Filter wechseln	1, wenn die restliche Filterlebensdauer die Schwelle der Konfiguration erreicht
PM2.5	Feinstaub, µg/m³
PM10	Grobstaub, µg/m³
VOC	Flüchtige organische Verbindungen, ppb (Protect, HealthProtect, Classic i-Serie)
CO2	Kohlendioxid, ppm (Classic i-Serie)
Temperatur	°C, bei den Modellen mit diesem Sensor
Luftfeuchtigkeit	%, bei den Modellen mit diesem Sensor
Online	1, wenn der Luftreiniger mit der Blueair-Cloud verbunden ist

Eine Lüfterstufe zu wählen schaltet den Luftreiniger in den manuellen Modus, wie die App. Die Partikelwerte erscheinen wie in der Blueair-App (die Cloud sendet sie 1,32-mal höher; die Integration korrigiert sie wie ha_blueair). PM1 wird nicht veröffentlicht: Gladys hat keinen PM1-Sensor.

Modelle

• Grenzen der Lüfterstufe: 0–91 bei den Modellen mit vier Stufen (Blue Pure Max, Protect, 2-in-1), 0–100 bei den anderen, 1–3 bei Luftbefeuchtern, 0–3 bei den Classic-Modellen der älteren Cloud (0 ist dort aus).
• ComfortPure 3-in-1 (T10i, T20i): Diese Geräte heizen. Gladys kann diese Geräte nur lesen (Luftqualität, Temperatur, Filter): Eine falsche Szene darf nie eine Heizung eingeschaltet lassen. Steuere diese Geräte mit der Blueair-App.
• Ältere Modelle (Classic 205/280i/290i/480i/680i, Sense+) liegen in der älteren Blueair-Cloud und werden mit demselben Konto gefunden. Der Filter dieser Modelle sagt nur „zu wechseln“ oder nicht, ohne Prozentwert.
• Luftbefeuchter des Kontos erscheinen ebenfalls, mit Betrieb, Stufe, Modi und Sensoren.

Dashboard-Widget

Das Widget Blueair-Luftreiniger, zwei Ansichten:

• alle Geräte (kein Gerät in seinen Einstellungen gewählt): eine Zeile pro Gerät — Modus und PM2.5, grün, orange oder rot je nach Luftqualität, „Filter wechseln“, wenn es so weit ist, „Offline“, wenn es nicht verbunden ist — und zwei Knöpfe, Alle auf Auto und Alle auf Nacht;
• ein Gerät: Live-Kacheln (PM2.5, Filterlebensdauer, Temperatur oder VOC), sein Modus, sein Filter, seine Verbindung, und Knöpfe: Ausschalten / Einschalten und seine Modi (Automatisch, Nacht, Eco). Der aktuelle Modus trägt ein Häkchen.

Szenen

Auslöser

Blueair-Filter wechseln: einmal pro Filter, wenn seine restliche Lebensdauer die Schwelle der Konfiguration erreicht (oder wenn ein älterer Classic meldet, dass sein Filter zu wechseln ist). Nicht ein zweites Mal für denselben Filter, auch nicht nach einem Neustart; ist der Filter gewechselt, wird der nächste gemeldet. Filter: ein Gerät (leer: alle). Weitergegebene Informationen: Name des Geräts, Modell, Restlebensdauer (%).

Aktion

Blueair-Modus wählen: setzt ein Gerät oder alle Geräte, die den Modus bieten (Gerät leer gelassen), auf Automatisch, Nacht, Eco oder Manuell. Gibt die Zahl der geänderten Geräte zurück.

Die Funktionen der Geräte lassen sich auch direkt in Szenen verwenden: einen Luftreiniger ein- oder ausschalten, seine Stufe setzen, oder eine Szene starten, wenn PM2.5 einen Wert übersteigt.

Szenen-Ideen

• Schlafenszeit: um 22:30 Blueair-Modus wählen → Nacht, alle Geräte. Am Morgen zurück auf Automatisch.
• Filter-Erinnerung: Auslöser Blueair-Filter wechseln → eine Nachricht senden „Wechsle den Filter von {Name des Geräts} (noch {Restlebensdauer} %)“.
• Küchenrauch: Wenn PM2.5 des Küchen-Luftreinigers 35 µg/m³ übersteigt, die Stufe auf das Maximum; zurück auf Automatisch, wenn es unter 10 fällt.
• Niemand zu Hause: Ist das Haus leer, die Luftreiniger ausschalten; bei der Rückkehr auf Automatisch einschalten.

Aktualisierung und Grenzen der Blueair-Cloud

Blueair veröffentlicht keine Kontingente für seine Cloud. Die Integration bleibt sparsam:

• eine Anfrage pro Gerät bei jeder Aktualisierung (1 bis 5 Minuten, standardmäßig 2);
• die Luftqualitätswerte sind auf der Blueair-Seite 5-Minuten-Mittel und werden höchstens alle 5 Minuten gelesen;
• die Geräteliste wird alle 6 Stunden neu gelesen (oder mit Scannen im Tab Entdecken);
• die Anmeldung wird unter /data aufbewahrt und aus der Sitzung erneuert, ohne das Passwort erneut zu senden;
• ein abgelehntes Passwort stoppt jede Anfrage, bis sich die Konfiguration ändert (wiederholte Versuche würden das Konto sperren); eine Antwort „zu viele Anfragen“ pausiert alles für 10 Minuten.

Gladys fragt diese Geräte nicht ab: Die Integration aktualisiert sie mit ihrem eigenen Timer. Änderungen in der Blueair-App erscheinen in Gladys bei der nächsten Aktualisierung.

Fehlerbehebung

• „E-Mail oder Passwort von Blueair abgelehnt“: Prüfe sie in der Blueair-App und speichere dann die Konfiguration erneut (bis dahin versucht es die Integration nicht mehr).
• „Öffne einmal die Blueair-App und vervollständige dein Profil (Name)“: Blueair verlangt jetzt einen Namen im Konto. Öffne die App, vervollständige das Profil und klicke dann auf Verbindung testen.
• Verbunden, aber kein Gerät: Die Region ist wahrscheinlich falsch — versuche die andere (im Vereinigten Königreich angelegte Konten sind oft in „Europa“).
• Ein Luftreiniger ist „Offline“: Prüfe sein WLAN in der Blueair-App. Die Blueair-Cloud meldet manchmal einen funktionierenden Luftreiniger als offline: Aktuelle Sensorwerte zählen als Lebenszeichen.
• Die Werte ändern sich nicht: Die Luftqualität ändert sich auf der Blueair-Seite nur alle 5 Minuten.
• Protokolle: LOG_LEVEL=debug zeigt jede Anfrage (nie das Passwort oder die Tokens).

Grenzen

• Nur Cloud: keine lokale Steuerung, und nichts funktioniert ohne Internet oder wenn die Blueair-Cloud ausfällt.
• Keine Echtzeit: Änderungen erscheinen bei der nächsten Aktualisierung (das MQTT der App ist nicht umgesetzt).
• Die Heizgeräte ComfortPure 3-in-1 sind nur lesbar. Heiz- und Kühlmodi werden nicht angezeigt.
• PM1, der Germ Shield, das Nachtlicht, der Timer und der Docht der Luftbefeuchter werden nicht veröffentlicht.
• Konten, deren Geräte in einer anderen Region liegen als das Konto selbst (selten), werden nicht unterstützt.
• Ohne die Hardware entwickelt: Die Modellfamilien folgen blueair_api und ha_blueair, die mit echten Geräten gebaut wurden. Rückmeldungen sind willkommen.

Konfigurationseinstellungen

Diese Einstellungen fragt Blueair in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Dein Blueair-Konto	section	Nein	Gib die E-Mail-Adresse und das Passwort der Blueair-App ein sowie die Region, die beim Anlegen des Kontos gewählt wurde. Jedes Blueair-Gerät des Kontos erscheint im Tab Entdecken. Die Integration läuft über die Blueair-Cloud: Eine Internetverbindung ist nötig. Nicht mit Blueair oder Unilever verbunden.
E-Mail des Blueair-Kontos	string	Ja
Passwort des Blueair-Kontos	secret	Ja
Region des Kontos	select	Ja	Die Region, die beim Anlegen des Kontos in der Blueair-App gewählt wurde.
Aktualisierungsintervall	select	Nein	Wie oft die Geräte aus der Blueair-Cloud gelesen werden. Luftqualitätswerte sind 5-Minuten-Mittel.
Filter wechseln bei	select	Nein	Restliche Filterlebensdauer, ab der der Filter zu wechseln ist (Funktion und Szenen-Auslöser).
Sprache der Funktionsnamen	select	Nein	Für die ab jetzt hinzugefügten Geräte und die Meldungen der Integration.

So installierst du Blueair in Gladys

1. Öffne in Gladys Integrationen: Blueair erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-blueair:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-blueair.

Blueair benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

Blueair ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂