Hinweis: Der Beitrag wurde mit KI-Unterstützung (Claude Code) verfasst und manuell nachbearbeitet.
Wer einen Philips Air+ Luftreiniger hat und ihn in Home Assistant einbinden möchte, wird beim Suchen schnell frustriert. Philips bietet keine offizielle API an — das Gerät kommuniziert über die Versuni-Cloud per MQTT, dasselbe Protokoll das die offizielle App nutzt. Theoretisch integrierbar, aber ohne Dokumentation — und ohne jemanden der die Arbeit schon gemacht hat, kaum zu stemmen.
Der Ausgangspunkt
Nach längerer Suche fand sich ein GitHub-Repo von ShorMeneses: eine funktionierende Home-Assistant-Integration für den Philips Air+ AC0650/10, die tatsächlich das MQTT-Protokoll der App nutzt. Genau das was ich gesucht hatte — nur für das falsche Modell. Ich habe einen AC0651/10.
Um das zum Laufen zu bringen, mussten die gerätespezifischen Werte ermittelt und eingebaut werden. Und damit ich beim nächsten Modell nicht wieder von vorne anfange, habe ich die Architektur gleich so umgebaut dass alles modellspezifische — Modusnamen, MQTT-Properties, welche Sensoren ein Modell hat — in einer models.yaml landet statt im Code. Ob das bei weiteren Modellen tatsächlich so reibungslos funktioniert, wird sich zeigen; getestet ist bisher nur der AC0651/10.
Die richtigen Werte herausfinden
Bevor irgendetwas funktionieren konnte, mussten die konkreten MQTT-Werte für den AC0651/10 her. Welche Property steuert den Modus? Welche Werte entsprechen welchen Einstellungen?
Die Antwort kam durch systematisches Durchprobieren: jeden Modus einschalten, ausschalten, beobachten was das Gerät zurückmeldet — mit Claude Code als Analyse-Hilfe. Das Ergebnis:
| Modus | Modus-Property (D0310C) | Lüfterstufe (D0310D) |
|---|---|---|
| Aus | — | 0 |
| Ruhe | 17 | 1 |
| Auto | 0 | 2* |
| Mittel | 1 | 3 |
| Turbo | 18 | 18 |
*Im Auto-Modus variiert D0310D je nach Luftqualität zwischen 1 und 18 — der gemessene Wert 2 war der aktuelle Stand beim Test. Daher macht ein eigener Lüfterstufen-Sensor mit Verlaufsanzeige hier besonders Sinn: man sieht live wie der Lüfter im Auto-Modus gerade dreht.
Das Ergebnis
Die Integration heißt Philips Air+ Multi und lässt sich per HACS als Custom Repository installieren:
https://github.com/markusstephany/philips-airplus-homeassistant
Was sie für den AC0651/10 bietet:
- Lüftersteuerung mit Voreinstellungen (Auto, Mittel, Ruhe, Turbo)
- Lüfterstufen-Sensor mit Verlaufsanzeige
- Filterüberwachung: Filterwechsel und Filterreinigung (Prozent + verbleibende Stunden)
- Reset-Buttons für Filterreinigung und Filterwechsel
- Feinstaub PM2.5 und Allergen-Index
- Sensor-Standby-Schalter
- Übersetzungen: Deutsch, Englisch, Französisch
Entwickelt mit Claude Code
Die Arbeit — Architektur überdenken, Code umschreiben, MQTT-Werte ermitteln — lief im Dialog mit Claude Code. Ich habe die Richtung vorgegeben, Claude hat umgesetzt und erklärt. Für jemanden der nicht täglich in Python-HA-Integrationen unterwegs ist, ein praktischer Weg um trotzdem zu einem brauchbaren Ergebnis zu kommen.
Fazit
- Für den Philips Air+ AC0651/10 habe ich keine brauchbare HA-Integration gefunden
- Ausgangspunkt war das Repo von ShorMeneses für den AC0650/10
- Erweitert auf eine modellunabhängige Architektur mit
models.yaml - Installierbar per HACS: https://github.com/markusstephany/philips-airplus-homeassistant
- Neue Modelle lassen sich hoffentlich ohne Code-Änderungen ergänzen — getestet ist bisher nur der AC0651/10