BWT Aqua

 Version History...

Version 0.2.0

  • Ausführen von Befehlen auf dem BWT Wasserenthärter (Urlaubsmodus ein/aus, Extra Spühlung, Extra Regeneration, Inbetriebnahme, Ausserbetriebsetzen)
  • Zusätzliche Infomationen (Restkapazität Säule 1 und 2, Status Säule 1 und 2, Regeneration abgesaugte Sole Menge)
  • Zeitstempel letzter Aktualisierung steht neu in Loxone Epoch Time und als Text zur Verfügung
  • Auto Update von Version 0.1.1

Version 0.1.1

  • Fehlerkorrektur: Falsche IP beim Abrufen der Daten
  • Erweiterung Logging im Fehlerfall
  • Auto-Update Feature aktiviert für zukünftige Releases

Version 0.1.0

  • erste öffentliche Alpha Version


Inhalt



Download

https://github.com/paolobazzi/LoxBerry-Plugin-BWT-Aqua/archive/0.2.0.zip

Funktion des Plugins

Das Plugin verbindet sich via HTTP auf die BWT Aqua Perla Wasserenthärtungsanlage und liest via HTTP die aktuellen Daten zu Durchfluss und Füllstand aus.

Die Daten werden aus der Weboberläche der Anlage ausgelesen, welche im lokalen Netz unter https://<IP-der-BWT>/users/login zur Verfügung steht.


Installation

Zip Downloaden und installieren. Automatische Updates werden noch nicht unterstützt.

Konfigurationsoptionen

Die folgenden Einstellungen stehen zur Verfügung:

  • IP Adresse: Die lokale IP Adresse Enthärtungsanlage (ohne HTTP)
  • Code: Das Passwort für den Zugriff auf die Enthärtungsanlage  (Der Code steht in der Mail der Registrierung der Anlage bei BWT. Alternativ kann der Code via BWT Support angefragt werden).
  • Per HTTP senden: Wenn eingeschaltet, werden die Daten der Enthärtungsanlage alle 15 Min an virtuelle Eingänge des Miniservers gesendet.
  • Per HTTP bereitstellen: Mittels verlinkter URL können die Daten der Enthärtungsanlage aus Loxone mittels virtuellem HTTP Eingang ausgelesen werden.
  • Miniserver: Auswahl des Miniservers für den Versand der Daten via HTTP.


Mittels Button Testen kann der Verbindungsaufbau und das abrufen der Daten getestet werden. Sofern "Per HTTP senden" aktiviert ist, werden die Daten auch direkt zum Testen an den Miniserver gesendet.

Die Ausgabe zeigt, ob die Verbindung klappt und listet die abgerufenen Werte.

URL: http://loxberry/plugins/bwt-aqua/index.cgi?action=test

Einrichtung in der Loxone Config Software

Variante "Per HTTP senden"

Virtueller EingangBedeutungTyp
bwt-aqua-flow-currentAktueller Durchfluss (Liter)Virtueller Eingang
bwt-aqua-flow-current-percentAktuelle Leistung (Prozent)Virtueller Eingang
bwt-aqua-flow-todayAktueller Durchfluss Heute (Liter)Virtueller Eingang
bwt-aqua-flow-monthAktueller Durchfluss Monat (Liter)Virtueller Eingang
bwt-aqua-flow-yearAktueller Durchfluss Jahr (m^3)Virtueller Eingang
bwt-aqua-regenerant-refill-daysRegeneriermittel verbleibend (Tage)Virtueller Eingang
bwt-aqua-regenerant-remainingRegeneriermittel Stand (Prozent)Virtueller Eingang
bwt-aqua-data-timestampLetzte Datenübertragung

Virtueller Text Eingang

bwt-aqua-column1-remaining-capacityRestkapazität Säule 1 (Liter)Virtueller Eingang
bwt-aqua-column2-remaining-capacityRestkapazität Säule 2 (Liter)Virtueller Eingang
bwt-aqua-column1-stateRegenerationsschritt Säule 1Virtueller Text Eingang
bwt-aqua-column2-stateRegenerationsschritt Säule 2Virtueller Text Eingang
bwt-aqua-sole-counter-last-extracted-quantitySolezähler - Zuletzt abgesaugte Menge (ml)Virtueller Eingang

Die Namen der Eingänge werden in Zukunft konfigurierbar sein. Aktuell stehen sie schon im Konfigurationsfile des Plugins, sind aber via Oberfläche noch nicht anpassbar.


Visualisierung in Loxone

Variante "Per HTTP bereitstellen"

Alternativ können die Werde auch via HTTP Eingang abgerufen werden.

URL:   http://loxberry/plugins/bwt-aqua/index.cgi?action=fetch

Befehlserkennung:

Virtueller EingangBedeutungTyp
flowCurrent=\vAktueller Durchfluss (Liter)Zahl
flowCurrentPercent=\vAktuelle Leistung (Prozent)Zahl
flowToday=\vAktueller Durchfluss Heute (Liter)Zahl
flowMonth=\vAktueller Durchfluss Monat (Liter)Zahl
flowYear=\vAktueller Durchfluss Jahr (m^3)Zahl
regenerantRefillDays=\vRegeneriermittel verbleibend (Tage)Zahl
regenerantRemainingDays=\vRegeneriermittel Stand (Prozent)Zahl
timestamp=\vLetzte Datenübertragung

Zahl  (in Virtuellem Status mit <v.d> formatieren

remainingCapacityColumn1=\vRestkapazität Säule 1 (Liter)Zahl
remainingCapacityColumn2=\vRestkapazität Säule 1 (Liter)Zahl
soleCounterLastExtractedQuantity=\vSolezähler - Zuletzt abgesaugte Menge  (ml)Zahl 
stateColumn1=\1Regenerationsschritt Säule 1Zahl (in Statusbaustein prüfen, Wert = 66 entspricht "Betrieb")
stateColumn2=\1Regenerationsschritt Säule 2Zahl (in Statusbaustein prüfen, Wert = 66 entspricht "Betrieb")


Vorlage für virtuelle Eingänge:  

Importiert in der Config und mit Status-Baustein ergänzt:


Danke an Armin Votava  für die Vorlage.

Befehle aufrufen

Via BWT Aqua Plugin lassen sich auch diverse Aktionen auf der BWT Wasserenthärtungsanlage auslösen.


1) Zur Konfiguration zunächst den Loxberry Server als virtuellen Ausgang anlegen (Adresse als IP eintragen):

2) Danach für jede gewünschte Aktion einen virtuellen Ausgangsbefehl anlegen (Name und Befehl bei EIN eintragen):


Die möglichen Befehle sind hier aufgeführt oder auch direkt in der Loxberry Konfigurationsseite des Plugins aufgeführt:

AktionAusgangsbefehl
Regeneriermittelbefüllung/plugins/bwt-aqua/index.cgi?action=trigger&id=489&value=1
Urlaubsmodus einschalten/plugins/bwt-aqua/index.cgi?action=trigger&id=484&value=1
Urlaubsmodus ausschalten/plugins/bwt-aqua/index.cgi?action=trigger&id=484&value=0
Extra Regeneration auslösen/plugins/bwt-aqua/index.cgi?action=trigger&id=482&value=1
Extra Spülung auslösen/plugins/bwt-aqua/index.cgi?action=trigger&id=483&value=1
Ausserbetriebsetzen/plugins/bwt-aqua/index.cgi?action=trigger&id=507&value=1
Wiederinbetriebnahme/plugins/bwt-aqua/index.cgi?action=trigger&id=507&value=0


Vorlage für virtuelle Ausgänge: 


Danke an Armin Votava  für die Vorlage.


3) In der Loxone Config für Aktionen mit ein/aus einen Schalter und für Aktionen welche nur aufgerufen werden einen Taster anlegen:


Visualisierung mit Urlaubsmodus Ein:

Roadmap

  • Testen und Stabilisieren
  • Auslesen weiterer Daten welche via Weboberfläche zur Verfügung stehen, z.B. Datum der letzten Regeneration
  • Auslesen der Betriebshistorie

Fragen stellen und Fehler melden

Fragen und Fehler bitte im Loxforum melden:

https://www.loxforum.com/forum/projektforen/loxberry/plugins/278330-plugin-bwt-aqua-anbindung-wasserenth%C3%A4rter

Alternativ als Issue in Github:

https://github.com/paolobazzi/LoxBerry-Plugin-BWT-Aqua/issues