Gestern wurde das openHAB-Binding auch vom zweiten Reviewer abgenommen, die Voraussetzungen zur Einbindung in die openHAB-Distribution sind also gegeben: mit der nächsten Version wird es integraler Teil davon sein. Wer die definitive Version jetzt schon verwenden möchte, findet sie hier: https://github.com/aurelio1/openhab-addons/releases/tag/v1.0 .
Beachtet bitte, dass die Channels teilweise anders heissen - sie entsprachen in früheren Versionen nicht den offiziellen openHAB-Richtlinien. Wenn ihr also einfach ein früheres Binding durch diese Version ersetzt, werden mehrere Items nicht mehr richtig erkannt, und ihr müsst die entsprechenden Items manuell den neuen Kanalnamen zuordnen.

Hallo zusammen
Da die API des airQ in einer Betaversion schon für Tests zugänglich ist, bin ich daran, ein Binding für openHAB zu schreiben.
Wer auch openHAB verwendet und das Binding derzeit dann testen möchte, kann sich gerne mit mir in Verbindung setzen.

Das Binding ist unter obigem Link aktualisiert. Alle vom air-Q verfügbaren Channels werden an openHAB zur Verfügung gestellt und sind Persistenz-tauglich, d.h. gemäss openHAB-Installation kann man sie in einer Datenbank speichern lassen. Wenn man das macht und HabPanel entsprechend konfiguriert, sehen die Werte so aus:

Zur Info an alle, die dasselbe Problem haben oder haben werden.
@rz und ich haben das Problem analysiert und festgestellt, dass Docker ohne Aktivierung der starken Verschlüsselung gestartet wurde. Dadurch konnten die Daten, die das air-Q an openHAB zurückschickt, nicht entschlüsselt werden.
Hier steht, wie man Docker mit uneingeschränkter Verschlüsselung starten kann. Wichtig ist die Zeile: -e CRYPTO_POLICY=unlimited

@jheiler : Das Binding stellt für jeden gelieferten Messwert - inklusive Gesundheits- und Leistungsindex - einen Kanal zur Verfügung, der einem 'Item' zugeordnet werden kann. Dieses kann von OpenHAB beliebig verwendet werden, sei es als Grafik, zur Anzeige des Wertes oder für Regeln und Skripte.
Die Logik, wann ein Wert als überhöht gilt, ist nicht im Air-Q-Gerät implementiert, sondern in der App bzw. auf my.air-q.com. Die API des Air-Q liefert also nebst den beiden Indizes keine Beurteilung. Welche Werte für Dich selbst als zu hoch gelten sollen und was dann gemacht werden soll (Alarm, rote Anzeige, Lüftung einschalten, ferngesteuertes Fenster öffnen etc.) musst Du über Regeln steuern, die Du nach Deinen Wünschen selbst erstellen kannst. Die grosse Flexibilität ist denn auch die grosse Stärke der OpenHAB-Anbindung.

@jheiler Werte, bei denen Du Probleme hast:

• CO: Item wird vom airq-Binding richtig gesetzt. Müsste angezeigt werden, und wenn nicht, stimmt etwas mit der Item-Beschreibung oder der Sitemap nicht, das Binding funktioniert richtig.
• Fine Dust Concentration: hast Du alle Zeilen des Logs einkopiert? Wenn ja, werden diese vom Binding tatsächlich nicht geliefert.
• Humidity und Oxygen: Werden bei Dir mit falschem Komma angezeigt, gemäss Log gibt das Binding die Werte aber gar nicht weiter.

Kannst Du bestätigen, dass obige Einträge den vollen 'Datenübergabezyklus' abbilden? Kann es sein, dass Fine Dust, Humidity und Oxygen beim Binding gar nicht als Items registriert sind (=Channel verbunden)? Du siehst das in Admin/Items.

Es kann passieren, dass das Item zwar vorhanden ist, aber nicht mit dem Channel verbunden. Das passiert, wenn man ein 'Thing' abmeldet und dann wieder anmeldet - der neue Channel heisst dann anders.
Du kannst gerne auch versuchen, beide Log-Einstellungen gleichzeitig zu haben, dann wird gleich alles angezeigt. Also:

log:set TRACE org.openhab.binding.airq
log:set TRACE openhab.event.ItemStateEvent

Hallo Holger.

Das air-Q-Plugin von openHAB greift einfach per HTTP-Verbindung auf das Gerät zu (Port 80). Du musst keine zusätzlichen Ports öffnen.
Für weitere Fragen zum openHAB-Plugin kannst Du mich gerne auch direkt auf aurelio@caliaro.net kontaktieren.

Viele Grüsse
Aurelio

Hallo @me-systeme
Danke für die Information - das hätte ich nicht erwartet, aber schön, dass es so auch funktioniert.

Hallo @me-systeme
Das funktioniert so leider nicht, weil man in den Einstellungen des openHAB-Plugins keine Portnummer erfassen kann. Wenn Du auf mehrere Geräte zugreifen möchtest, die z.B. hinter einer Firewall liegen, würde ich Dir empfehlen, in der Firewall oder in der DMZ Reverse Proxies einzurichten. Wenn Deine eigene Domain lokal.de wäre, wäre das z.B. wie folgt:
airq1.lokal.de -> 192.168.0.55
airq2.lokal.de -> 192.168.0.56
airq3.lokal.de -> 192.168.0.57

Hallo Holger.

Das air-Q-Plugin von openHAB greift einfach per HTTP-Verbindung auf das Gerät zu (Port 80). Du musst keine zusätzlichen Ports öffnen.
Für weitere Fragen zum openHAB-Plugin kannst Du mich gerne auch direkt auf aurelio@caliaro.net kontaktieren.

Viele Grüsse
Aurelio

Ich habe nicht herausgefunden, warum es bei Dir diesen Fehler gibt, ich kann ihn nicht reproduzieren.
Ich bin daran, die vielen Änderungen an der API im Binding zu implementieren, und ich werde Dir danach eine Testversion schicken, wo noch mehr Trace-Informationen produziert werden. Vielleicht lässt sich das Problem dann besser verstehen.

OK, konzentrieren wir uns mal auf die relative Luftfeuchtigkeit. Wenn ich in Things>Channel-List auf die (1) klicke, sieht das bei mir so aus:

Items>Humidity sieht bei mir so aus:

Und wenn ich dann auf "Online" klicke:

Sieht das bei Dir auch so aus?

@jheiler Werte, bei denen Du Probleme hast:

• CO: Item wird vom airq-Binding richtig gesetzt. Müsste angezeigt werden, und wenn nicht, stimmt etwas mit der Item-Beschreibung oder der Sitemap nicht, das Binding funktioniert richtig.
• Fine Dust Concentration: hast Du alle Zeilen des Logs einkopiert? Wenn ja, werden diese vom Binding tatsächlich nicht geliefert.
• Humidity und Oxygen: Werden bei Dir mit falschem Komma angezeigt, gemäss Log gibt das Binding die Werte aber gar nicht weiter.

Kannst Du bestätigen, dass obige Einträge den vollen 'Datenübergabezyklus' abbilden? Kann es sein, dass Fine Dust, Humidity und Oxygen beim Binding gar nicht als Items registriert sind (=Channel verbunden)? Du siehst das in Admin/Items.

Es kann passieren, dass das Item zwar vorhanden ist, aber nicht mit dem Channel verbunden. Das passiert, wenn man ein 'Thing' abmeldet und dann wieder anmeldet - der neue Channel heisst dann anders.
Du kannst gerne auch versuchen, beide Log-Einstellungen gleichzeitig zu haben, dann wird gleich alles angezeigt. Also:

log:set TRACE org.openhab.binding.airq
log:set TRACE openhab.event.ItemStateEvent

@jheiler Ich habe bei mir alles nochmals durchgeprüft, die Werte werden richtig übertragen. Ich habe das Logging der ItemStateEvent von OpenHAB auf TRACE eingestellt und erhalte für CO die folgende Zeile:

23:42:31.252 [TRACE] [openhab.event.ItemStateEvent        ] - Received event of type 'ItemStateEvent' under the topic 'openhab/items/airQ_COConcentration/state' with payload: '{"type":"Decimal","value":"1.2960000038146973"}'

Versuche mal die folgende Log-Einstellung:
<Logger level="TRACE" name="openhab.event.ItemStateEvent"/>
bzw. in der Console:
log:set TRACE openhab.event.ItemStateEvent

Schreibe mir (am besten über PN), was gemeldet wird. Und nicht vergessen: Logging der Items wieder abstellen, sonst wird das Logfile geflutet ;)

Hallo @jheiler
Ich kann das Problem nicht einfach so nachvollziehen, weil es bei mir klappt, ebenfalls mit OH3.1. Allerdings zeige ich die Daten im HabPanel an, nicht mit einer manuell konfigurierten Sitemap.
Um der Sache auf die Spur zu kommen, stelle doch bitte den TRACE-Modus des Bindings an und schicke mir die Daten, die ausgegeben werden (eine Abrufperiode der Sensordaten). Den Trace-Modus kannst Du wie folgt einstellen:

openhab> log:set TRACE org.openhab.binding.airq

Nach dem Abruf kannst Du es gerne wieder auf WARN zurückstellen, mit:

openhab> log:set WARN org.openhab.binding.airq

Gestern wurde das openHAB-Binding auch vom zweiten Reviewer abgenommen, die Voraussetzungen zur Einbindung in die openHAB-Distribution sind also gegeben: mit der nächsten Version wird es integraler Teil davon sein. Wer die definitive Version jetzt schon verwenden möchte, findet sie hier: https://github.com/aurelio1/openhab-addons/releases/tag/v1.0 .
Beachtet bitte, dass die Channels teilweise anders heissen - sie entsprachen in früheren Versionen nicht den offiziellen openHAB-Richtlinien. Wenn ihr also einfach ein früheres Binding durch diese Version ersetzt, werden mehrere Items nicht mehr richtig erkannt, und ihr müsst die entsprechenden Items manuell den neuen Kanalnamen zuordnen.

@jheiler Ich war Dir noch eine Antwort zur Prozentzahl schuldig. Die Indices gehen von 0 bis 1000, sind also, werden man so will, als Promille-Daten ausgegeben. Wenn Du das so möchtest, ist das Format: "%d ‰".

Wenn Du trotzdem einen Prozent-Wert möchtest, musst Du wohl eine Transformation verwenden, in etwa so (ich habe es nicht getestet, benutze aber ähnliche Transformationen):

(function(i) {
    var d = Int.parse(i);
    return d/10;
})(input)

Das Mapping musst Du dann in der Sitemap-Zeile 'aufrufen', wie im obigen Transformation-Link erläutert, und das Ganze im Format "%d %" ausgeben.