Geräteprofil · Sensoren
Awair Element / Omni
Hinweis: Dieses Profil beruht auf der offiziellen Beschreibung der Local API von Awair.
Voraussetzungen
- Ein Awair Element oder Awair Omni im lokalen Netz.
- Die Local API muss in der Awair-App eingeschaltet werden: Gerät öffnen → Awair+ → Local API (einmalig je Gerät). Ohne diesen Schalter antwortet das Gerät nicht.
- Prüfen lässt sich das im Browser:
http://<IP-des-Geräts>/air-data/latestEs muss ein JSON mit
score,temp,co2undpm25zurückkommen.
Einrichtung
- Dem Gerät im Router eine feste IP-Adresse geben
- Skills → Add-ons: Profil importieren
- Gerät anlegen und die IP-Adresse eintragen; der Port 80 ist fest
Datenbereich
Abgefragt werden alle 30 Sekunden die Messwerte und einmal pro Stunde die Geräteinfos. Das Gerät selbst aktualisiert seine Werte alle 10 Sekunden; häufiger als das abzufragen bringt nichts.
- Awair Score (
score) 0–100 - Temperatur (
temperature), Luftfeuchte (humidity) - CO₂ (
co2) in ppm - VOC (
voc) in ppb, Feinstaub PM2.5 (pm25) in µg/m³ - Taupunkt, absolute Luftfeuchte, geschätztes CO₂ aus dem VOC-Sensor und geschätztes PM10 (ausgeblendet)
- Nur Omni: Helligkeit (
light-level) und Schallpegel (noise), beide ausgeblendet - Firmware, Geräte-UUID und MAC-Adresse (ausgeblendet)
- Erreichbarkeit (
reachable): aus dem Erfolg der Abfragen
Das Gerät lässt sich nur lesen. Die LED-Helligkeit und die Anzeige sind über die Local API zwar schreibbar, sind hier aber bewusst nicht enthalten.
Hinweise
- Die Temperatureinheit folgt der App. Ist in der Awair-App Fahrenheit eingestellt, liefert auch die Local API Fahrenheit, und nomos zeigt die Zahl unverändert als °C an. Bitte in der App auf Celsius stellen.
- Element und Omni liefern unterschiedliche Felder. Der Omni meldet zusätzlich Helligkeit und Schallpegel, der Element dafür einen weiteren CO₂-Bezugswert. Was ein Gerät nicht meldet, bleibt in nomos auf seinem Ausgangswert – deshalb sind Helligkeit und Schallpegel ausgeblendet; auf einem Omni lassen sie sich einblenden.
- Luftfeuchte und Helligkeit werden auf ganze Zahlen gerundet, weil die App für diese beiden Werte Ganzzahlen erwartet. Temperatur, Taupunkt und absolute Luftfeuchte haben eine Nachkommastelle.
- Der Awair Score ist der zusammenfassende Wert des Herstellers (100 = beste Luft). Er wird vom Gerät berechnet, nicht von nomos.
- Nicht im Profil enthalten: die Rohwerte (
/air-data/raw), das Umstellen von LED und Anzeige und die Cloud-API von Awair.