AirCube — Handbuch
Tinysquare AirCube · Luftqualitätssensor für Home Assistant. Diese Anleitung führt dich durch Inbetriebnahme, Einrichtung und Diagnose.
Übersicht
Der AirCube ist ein kompakter Luftqualitätssensor für das Smart Home. Er misst Temperatur, Luftfeuchtigkeit, CO₂, flüchtige organische Verbindungen (TVOC) und den Luftqualitätsindex (AQI) — und zeigt die Luftqualität direkt per farbiger LED-Anzeige an.
Die Verbindung zum Smart-Home-System erfolgt per Zigbee 3.0, vollständig lokal ohne Cloud oder externe Accounts. Unterstützt werden ZHA und Zigbee2MQTT in Home Assistant.
Lieferumfang
- AirCube Gerät
- USB-C Kabel
- USB-C Netzteil (5 V)
Inbetriebnahme
- AirCube per USB-C an eine Stromquelle anschließen (5 V, mindestens 500 mA).
- Das Gerät startet automatisch und zeigt eine kurze Startanimation (grün → rot → grün) an.
- Anschließend leuchtet die LED grün — der Sensor ist betriebsbereit.
- Für die Nutzung mit Home Assistant: Gerät per Zigbee koppeln (siehe Zigbee-Einrichtung).
LED-Anzeige
Die drei LEDs an der Vorderseite zeigen kontinuierlich die aktuelle Luftqualität an:
| Farbe | Bedeutung |
|---|---|
| 🟢 Grün | Sehr gute Luftqualität (AQI ≤ 10) |
| 🟡 Gelb-Grün | Gute Luftqualität |
| 🟠 Orange | Mäßige Luftqualität |
| 🔴 Rot | Schlechte Luftqualität (AQI ≥ 200) |
| 🔵 Blau (blinkend) | Zigbee-Kopplung aktiv |
| ⚫ Aus | LED-Helligkeit auf 0 gestellt |
Der Farbverlauf wechselt stufenlos zwischen Grün und Rot — je nach AQI-Wert.
Button-Funktionen
Der AirCube hat einen Taster an der Seite des Gehäuses.
Kurzer Druck — Helligkeit ändern
Ein kurzer Druck auf den Taster wechselt die LED-Helligkeit. Es gibt 5 Stufen:
| Stufe | Helligkeit |
|---|---|
| 1 | Aus (0 %) |
| 2 | Sehr dunkel (10 %) |
| 3 | Gedimmt (30 %) |
| 4 | Normal (60 %) ← Standard |
| 5 | Maximum (100 %) |
Die gewählte Helligkeit wird gespeichert und bleibt nach einem Neustart erhalten.
Langer Druck (3 Sekunden) — Zigbee-Kopplung
Taster 3 Sekunden gedrückt halten → Gerät startet neu und geht in den Kopplungsmodus:
- LEDs blinken blau
- Das Gerät ist 60 Sekunden lang für neue Zigbee-Netzwerke sichtbar
- Nach erfolgreicher Kopplung leuchten die LEDs wieder in der Luftqualitätsfarbe
Zigbee-Einrichtung in Home Assistant
Voraussetzungen
- Home Assistant mit ZHA oder Zigbee2MQTT
- Zigbee-Koordinator (z. B. Sonoff Zigbee 3.0 USB Dongle)
Schritt-für-Schritt (ZHA)
- In Home Assistant: Einstellungen → Geräte & Dienste → ZHA → Gerät hinzufügen
- ZHA wartet nun auf neue Geräte.
- Am AirCube den Taster 3 Sekunden gedrückt halten → LEDs blinken blau.
- ZHA erkennt das Gerät automatisch und zeigt es an.
- Gerät benennen und bestätigen.
Schritt-für-Schritt (Zigbee2MQTT)
- Zigbee2MQTT in den Permit Join-Modus versetzen (z. B. über das Zigbee2MQTT-Dashboard).
- Am AirCube den Taster 3 Sekunden gedrückt halten → LEDs blinken blau.
- Das Gerät wird automatisch erkannt und in Zigbee2MQTT angezeigt.
- Gerät benennen und in Home Assistant als Entität verwenden.
Entitäten in Home Assistant
Nach der Kopplung erscheinen folgende 5 Entitäten:
| Entität | Einheit | Beschreibung |
|---|---|---|
| Temperature | °C | Raumtemperatur |
| Humidity | % | Relative Luftfeuchtigkeit |
| Carbon dioxide | ppm | Geschätzter CO₂-Gehalt (eCO₂) |
| eTVOC | ppb | Flüchtige organische Verbindungen |
| AQI | — | Luftqualitätsindex (ScioSense) |
Die Werte werden jede Sekunde aktualisiert und automatisch an Home Assistant gemeldet, sobald eine relevante Änderung vorliegt.
Gemessene Werte
Temperatur (°C)
Die Raumtemperatur wird vom ENS210-Sensor gemessen. Ein kleiner Offset wird werkseitig kompensiert, um die Eigenerwärmung des Geräts auszugleichen.
Luftfeuchtigkeit (%)
Relative Luftfeuchtigkeit in Prozent. Idealbereich für Wohnräume: 40–60 %.
eCO₂ (ppm)
Geschätzte CO₂-Konzentration auf Basis der VOC-Messung. Richtwerte:
| Wert | Bewertung |
|---|---|
| < 800 ppm | Gut (Frischluft) |
| 800–1200 ppm | Akzeptabel |
| 1200–2000 ppm | Mäßig (Lüften empfohlen) |
| > 2000 ppm | Schlecht (Sofort lüften) |
eTVOC (ppb)
Flüchtige organische Verbindungen — ein Maß für Schadstoffe aus Reinigungsmitteln, Farben, Möbeln etc. Werte unter 150 ppb gelten als gut.
AQI (Luftqualitätsindex)
Der AQI-Wert fasst die Gesamtluftqualität zusammen:
| AQI | Bewertung | LED-Farbe |
|---|---|---|
| 1 | Ausgezeichnet | 🟢 Grün |
| 2 | Gut | 🟢 Hellgrün |
| 3 | Mäßig | 🟡 Gelb |
| 4 | Schlecht | 🟠 Orange |
| 5 | Sehr schlecht | 🔴 Rot |
Einlaufzeit der Sensoren
Der ENS161-Sensor (eCO₂, TVOC, AQI) benötigt eine Einlaufzeit von 24–48 Stunden im Dauerbetrieb, bevor die Werte stabil und präzise sind. In dieser Zeit kann es zu erhöhten oder unregelmäßigen Werten kommen — das ist normal.
Bei einem fabrikneuen oder längere Zeit nicht genutzten Gerät bitte entsprechend Geduld einplanen.
Technische Daten
| Mikroprozessor | ESP32-H2 |
|---|---|
| Konnektivität | Zigbee 3.0 |
| Sensoren | ENS161 (VOC/eCO₂), ENS210 (Temp/Feuchte) |
| Stromversorgung | USB-C, 5 V |
| Abmessungen | 52 × 52 × 32 mm |
| Gehäuse | 3D-Druck (PLA), diffuse Oberseite |
| Aktualisierungsrate | 1 Sekunde |
| Kompatibilität | ZHA, Zigbee2MQTT |
| Cloud-Abhängigkeit | Keine — vollständig lokal |
Fehlerbehebung
Das Gerät wird in Home Assistant nicht gefunden
- Sicherstellen, dass der Zigbee-Koordinator aktiv und mit Home Assistant verbunden ist.
- Am AirCube Taster 3 Sekunden halten → LEDs müssen blau blinken.
- Parallel dazu in ZHA / Zigbee2MQTT den Kopplungsmodus aktivieren.
- Falls das Gerät zuvor mit einem anderen Netzwerk verbunden war: Factory Reset durchführen (Taster 3 Sekunden halten) und anschließend erneut koppeln.
Die LEDs blinken blau, aber kein Gerät erscheint in Home Assistant
- Prüfen, ob ZHA / Zigbee2MQTT aktiv den Kopplungsmodus zulässt (Permit Join muss aktiv sein).
- Bei ZHA: Prüfen, ob das Zigbee-Netzwerk korrekt eingerichtet ist. Im Zweifelsfall ZHA-Netzwerk neu erstellen.
- Kopplungsfenster beträgt 60 Sekunden — bei Ablauf den Vorgang wiederholen.
Werte erscheinen falsch oder mit falscher Einheit in Home Assistant
- Das Gerät aus ZHA / Zigbee2MQTT entfernen und neu koppeln.
- Home Assistant neu starten, um den Entitäts-Cache zu leeren.
Die Werte zweier AirCubes weichen voneinander ab
Das ist bei MOX-Sensoren (ENS161) normal, besonders wenn die Geräte unterschiedlich lange in Betrieb waren. Nach 48 Stunden Dauerbetrieb nebeneinander sollten sich die Werte annähern. Temperatur- und Feuchtigkeitswerte weichen aufgrund von Fertigungstoleranzen des ENS210 leicht ab (typisch ±0,2 °C, ±2 % rH).
Das Gerät startet, aber die LEDs bleiben aus
- Helligkeit möglicherweise auf 0 gestellt. Kurzen Tasterdruck ausführen, um die Helligkeit zu erhöhen.
Keine serielle Ausgabe am PC sichtbar
- Baudrate auf
115200einstellen. - Das Gerät gibt alle Messwerte einmal pro Sekunde als JSON aus — nützlich für Diagnose und Entwicklung.
Tinysquare c/o Thinkdigital GmbH · tinysquare.com