Hausautomation: openHAB-Binding?

[Aurelio]

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.

[jheiler]

@Aurelio Bin interessiert.
Viele Grüße

[Mario [air-Q]]

Wir danken Wolfgang R. für sein Engagement. Er hat uns erlaubt seine openHAB Einbindung zu Posten.
Download ist hier möglich:
Anleitung air-Q Integration in openHAB (pdf)
air-Q Integration in openHAB (air-q-data.sh)

[jheiler]

Vielen Dank an den Autor!

Ich habe getestet mit Openhab 2.5.6 und erhalte folgenden Fehler:

~ $ sudo -u openhab /usr/bin/python3 /usr/local/bin/air-q-data.shTraceback (most recent call last):
  File "/usr/local/bin/air-q-data.sh", line 45, in <module>
    msg['content'] = json.loads(decodeMessage(msg['content']))
  File "/usr/local/bin/air-q-data.sh", line 33, in decodeMessage
    return unpad(cipher.decrypt(msg[16:]).decode('utf-8'))
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xd0 in position 3: invalid continuation byte

Es werden keine Daten angezeigt, s. Screenshot. Der Air-Q läuft im lokalen Netzwerk und in der Cloud, in der Android App werden Daten angezeigt.

Viele Grüße

[jheiler]

Ergänzend noch die openhab.log

2020-07-20 17:10:29.585 [WARN ] [ng.exec.internal.handler.ExecHandler] - Couldn't transform response because transformationService of type 'REGEX' is unavailable
2020-07-20 17:10:34.442 [WARN ] [rthome.model.script.actions.BusEvent] - Cannot convert 'Traceback (most recent call last):
  File "/usr/local/bin/airq-data.sh", line 45, in <module>
    msg['content'] = json.loads(decodeMessage(msg['content']))
  File "/usr/local/bin/airq-data.sh", line 33, in decodeMessage
    return unpad(cipher.decrypt(msg[16:]).decode('utf-8'))
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xcc in position 0: invalid continuation byte
Traceback (most recent call last):
  File "/usr/local/bin/airq-data.sh", line 45, in <module>
    msg['content'] = json.loads(decodeMessage(msg['content']))
  File "/usr/local/bin/airq-data.sh", line 33, in decodeMessage
    return unpad(cipher.decrypt(msg[16:]).decode('utf-8'))
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xcc in position 0: invalid continuation byte' to a state type which item 'AirQ_Timestamp' accepts: [DateTimeType, UnDefType].
2020-07-20 17:10:34.467 [WARN ] [rthome.model.script.actions.BusEvent] - Cannot convert 'Traceback (most recent call last):
  File "/usr/local/bin/airq-data.sh", line 45, in <module>
    msg['content'] = json.loads(decodeMessage(msg['content']))
  File "/usr/local/bin/airq-data.sh", line 33, in decodeMessage
    return unpad(cipher.decrypt(msg[16:]).decode('utf-8'))
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xcc in position 0: invalid continuation byte
Traceback (most recent call last):
  File "/usr/local/bin/airq-data.sh", line 45, in <module>
    msg['content'] = json.loads(decodeMessage(msg['content']))
  File "/usr/local/bin/airq-data.sh", line 33, in decodeMessage
    return unpad(cipher.decrypt(msg[16:]).decode('utf-8'))
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xcc in position 0: invalid continuation byte' to a state type which item 'AirQ_aktZeit' accepts: [DecimalType, QuantityType, UnDefType].
2020-07-20 17:10:34.487 [ERROR] [ntime.internal.engine.RuleEngineImpl] - Rule 'Air-Q meldet neue Werte': For input string: "Traceback (most recent call last):
  File "/usr/local/bin/airq-data.sh", line 45, in <module>
    msg['content'] = json.loads(decodeMessage(msg['content']))
  File "/usr/local/bin/airq-data.sh", line 33, in decodeMessage
    return unpad(cipher.decrypt(msg[16:]).decode('utf-8'))
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xcc in position 0: invalid continuation byte
Traceback (most recent call last):
  File "/usr/local/bin/airq-data.sh", line 45, in <module>
    msg['content'] = json.loads(decodeMessage(msg['content']))
  File "/usr/local/bin/airq-data.sh", line 33, in decodeMessage
    return unpad(cipher.decrypt(msg[16:]).decode('utf-8'))
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xcc in position 0: invalid continuation byte"

[Mario [air-Q]]

@jheiler Ich habe Wolfgang einmal kontaktiert. Er ist nicht hier im Forum bisher.
Wir haben selbst leider im Moment kein openHAB System zum Testen.
@Daniel-air-Q hat die Smart Home Integrationen aber auf dem Schirm. Wir kümmern uns noch intensiv darum. Im Moment ist die Auslastung wg Bugfixing an anderen Stellen noch recht groß.

[Mario [air-Q]]

@Aurelio Wie weit bist Du gekommen?

[Wolfgang]

Hallo jheiler,

ist in Deinem air-q-data.sh der Header korrekt definiert für die UTF-8-Codierung ?

#!/usr/bin/python
#-*- coding:utf-8 -*-

Grüße
Wolfgang

[jheiler]

@Wolfgang

Hallo,

ich habe alles so implementiert, wie es im 3.Post angegeben ist. EXEC und JSONPATH laufen. Der Hinweis auf REGEX ist nicht plausibel, da die Transformation doch mit JSONPATH erfolgen soll.

Viele Grüße

[jheiler]

Ich habe alles noch einmal installiert, in der Beispieldokumentation für Things ist ein Tipfehler, ich hatte noch einen weiteren produziert (vermutlich Editor-Problem). Ergebnis: der REGEX-Fehler ist immer noch da, aber ich habe Daten.

Vielen Dank noch einmal an den Autor.

[Openphil]

Super !
Ein echtes Binding wäre zwar noch cooler, aber ist wahrscheinlich gar nicht weit. Das team von air-q sollte sich bald möglichst damit auseinander setzen. Gerade weil air-q offline funktioniert spricht es die gleiche Zielgruppe an, die auch ihr smarthome offline haben, und da ist openhab und io broker Integration ein riesen plus.

Daber ei noch die Frage. Sind die Grenzwerte nur in der app? Würde mir gut passen wenn diese als eigene info in der api wären. Ähnlich wie die led Quick Status info.

[Mario [air-Q]]

@Openphil
Wir sind im Moment noch nicht so fit mit openHAB. Da brauchen wir noch Einarbeitungszeit. Es gibt auch ein paar dringende Funktionen und auch Bugfixes, die wir noch angehen müssen bevor wir uns intensiver mit openHAB beschäftigen können. Wir sind für Eure Unterstützung schonmal sehr dankbar.

[Aurelio]

@Mario-air-Q
Das Binding ist soweit in einer Alpha-Version fertig. Ich kann die Werte schon in Openhab einlesen und eine Datenreihe bilden.

Für die Vollendung habe ich aber noch die folgenden Fragen offen, v.a. zur API:

• Die API wird sicher irgendwann angepasst. Gibt es ein Feld mit der API-Version, die ich abfragen kann?
• "bat" wird für die bisherigen air-q nicht genutzt, aber es wäre schon schön, wenn ich die vollständige API implementieren könnte. Was geben die zwei bat-Werte aus?
• In meinen Messungen habe ich cnt2_5 bis cnt10 immer Null. Kann das sein, zumal pm2_5 und pm10 positive Werte ausgeben? Da müsste es doch eine Beziehung geben? In welcher Einheit sind die cnt-Werte (Partikelzahl pro was? m3?)
• Welchen Wert wird "door_event" ausgeben, wenn die Tür offen ist?
• Ich werde das in der ersten Version noch nicht unterstützen, aber das Ziel ist, dass das openhab-Binding das Gerät im lokalen Netzwerk selber findet über das discovery service. Wie kann ich das Gerät am besten 'finden'?

[Aurelio]

Das Binding steht im Github zum Einbinden in eine Eclipse-Installation im Quellcode zur Verfügung: https://github.com/aurelio1/openhab-addons/tree/2.5.x/bundles/org.openhab.binding.airq

Es gibt noch keine automatische Erkennung (discovery). Deshalb muss man im Openhab ein 'thing' kreieren durch Anwahl des Bindings. Der Rest ist selbsterklärend.

Wer zum testen 'nur' das .jar benötigt, kann sich bei mir melden: aureliocaliaro@yahoo.de. Ich schicke es dann per E-Mail.

[Aurelio]

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:

[Hakan]

Hallo Aurelio,

Vielen Dank für das Addon, ich baue es gerade und werde es in meine OH3-Installation hineinschrauben.

Eine Frage noch: Hast du dafür schon einen pull request aufgemacht damit es irgendwann in die "offizielle" Distribution kommt?

Tschüß,
Hakan

[Aurelio]

Das Binding für OpenHAB 3 ist unter diesem Link bezugsbereit: https://github.com/aurelio1/openhab-addons/blob/2.5.x/bundles/org.openhab.binding.airq/org.openhab.binding.airq-3.1.0-SNAPSHOT.jar (zu beachten: dieses 3.1-Binding entspricht nicht dem Quellcode auf github)

Bitte dieses Java-Archiv in das /addons-Verzeichnis kopieren. Danach lässt sich in OpenHAB ein "Thing" (eben das Air-Q-Gerät) installieren.
Beachtet bitte, dass das Binding soweit funktioniert und die Werte korrekt ausliest, dass es aber trotzdem noch nicht ganz fertig ist.
Ich wäre froh um ein Feedback, um es allenfalls optimieren zu können.

[Aurelio]

Nachtrag: Der oben angegebene Link führt zur GitHub-Seite, wo man das Binding herunterladen kann. Wenn man den direkten Link zum Binding möchte, z.B. für den direkten Bezug per wget, bitte den folgenden Link verwenden: https://github.com/aurelio1/openhab-addons/blob/2.5.x/bundles/org.openhab.binding.airq/org.openhab.binding.airq-3.1.0-SNAPSHOT.jar?raw=true

[jheiler]

@Aurelio sagte in Hausautomation: openHAB-Binding?:

Nachtrag: Der oben angegebene Link führt zur GitHub-Seite, wo man das Binding herunterladen kann. Wenn man den direkten Link zum Binding möchte, z.B. für den direkten Bezug per wget, bitte den folgenden Link verwenden: https://github.com/aurelio1/openhab-addons/blob/2.5.x/bundles/org.openhab.binding.airq/org.openhab.binding.airq-3.1.0-SNAPSHOT.jar?raw=true

Danke für Deine Arbeit. Ich habe gerade erst auf Version 3 migriert und konnte Dein Addon noch nicht ausprobieren. Eine Frage vorab: Ist es mit dieser Datenkonstellation möglich, auch in Openhab anzuzeigen, welche Sensoren überhöhte Werte liefern, wie dies in der App der Fall ist? Wahrscheinlich brauchte man dazu einen Marker aus der API, da der Hersteller ja nicht im Detail beschreibt, wann eine rote Ampel angezeigt wird.
Viele Grüße

[Aurelio]

@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.