LoxBerry PoolManager

Version History…

https://github.com/mschlenstedt/LoxBerry-Plugin-Poolmanager/releases

Download über das entsprechende GIT-Archiv. Der aktuellste Download findet sich oben in der Tabelle. Ältere Versionen im Release-Archiv: https://github.com/mschlenstedt/LoxBerry-Plugin-Poolmanager/releases

Das Plugin stellt ein Gateway zu den Atlas Scientific Sensoren und Aktoren bereit. Dabei werden alle unterstützten Sensoren (z. B. pH-Sonde, Redox-Sonde) kontinuierlich ausgelesen und per MQTT und dem MQTT Gateway Plugin an den Miniserver übertragen. Aktoren (Dosierpumpen) von Atlas Scientific können zudem über das Gateway angesteuert werden und so entsprechende Dosierungen vorgenommen werden.

Alle Sensoren und Aktoren können über das Plugin kalibriert werden. Des weiteren bietet das Plugin die Ausgabe aller Messwerte sowie die Durchführung des Kalibrierungsprozesses über ein LCD Display an, welches vor Ort im Pool-Technikhaus angebracht sein kann (Raspberry muss dazu natürlich im Pool-Technikhaus installiert sein).

Folgende Hardware wird vom Plugin unterstützt: Unterstützte Hardware

Keine Besonderheiten. Das Plugin wird standardmäßig über die Pluginverwaltung installiert. Das Plugin setzt ein installiertes und konfiguriertes  MQTT Gateway Plugin voraus!

Vor der ersten Verwendung mit dem Plugin müssen alle Sensoren und Aktoren in den I2C-Modus versetzt werden (standardmäßig werden die Sensoren im UART Modus ausgeliefert). Wenn ihr zwei gleiche Sensoren oder Aktoren einsetzen möhctet (z. B. zwei Dosierpumpen), müsst ihr zudem von einem der Geräte die Default-Busadresse ändern. Wie das geht ist hier beschrieben: Unterstützte Hardware

Weitere Beispiele für Hardware Rund um den Pool und Loxone: Beispiel: Hardware für die Steuerung

Hier kann das Atlas Scientific Gateway gestartet und gestoppt werden und es können neue Sensoren oder Aktoren zu eurer Konfiguration hinzugefügt werden. Zudem kann der I2C Bus nach Geräten gescannt werden.

Hinzufügen/Editieren von Sensoren und Aktoren:

Beispiel: Kalibrierungseinstellungen pH Sonde mit 3-Punkt-Kalibrierung:

Lest in den Datenblättern bei Atlas Scientific nach wie die Sensoren kalibriert werden (z. B. ob 3-Punkt, 1-Punkt oder wie auch immer)

Grundlegende Einstellungen zum Plugin werden im Tab "Einstellungen" getätigt:

In diesem Reiter seht ihr die aktuellen Messwerte eurer Sensoren und Aktoren. Die Webseite wird kontinuierlich aktualisiert.

Wenn ihr in der Konfiguration eures Sensors/Aktors die Kalibrierung über das Plugin aktiviert habt, könnt ihr von hier aus auch die Kalibrierung starten. Die Zielwerte der Kalibrierung werden ebenfalls in der Konfiguration des Sensors/Aktors eingetragen. Lest in den [[https://atlas-scientific.com/|Datenblättern bei Atlas Scientific]] nach wie die Sensoren kalibriert werden (z. B. ob 3-Punkt, 1-Punkt oder wie auch immer).

Bei der Kalibrierung werdet ihr Schritt für Schritt durch die einzelnen Schritte durchgeführt. Dabei wird das Plugin gestoppt (damit eure Regelung nicht verrückt spielt). Wartet bei jeden Schritt bis sich die Anzeige stabilisiert hat und speichert dann die Kalibrierung ab. Bei Aktoren (Pumpe) wird eine Menge X dosiert, die ihr über eine hochgenaue Waage oder einen Messzylinder ermitteln müsst. Den tatsächlich gemessenen Wert müsst ihr im Kalibrierschritt dann eintragen.

Das Plugin sendet alle ausgelesenen Messwerte per MQTT an den MQTT Broker bzw. das  MQTT Gateway Plugin. Im Gateway Plugin muss das Topic des PoolManager Plugins abonniert werden (standardmäßig lautet das Topic "poolmanager/#"). Bitte lest in der Dokumentation des  MQTT Gateway Plugin nach, wie genau die Werte in der Loxone Config verwendet werden: MQTT - Schritt für Schritt: MQTT -> Loxone

Ich behandele das Thema "Anlegen eines Virtuellen Eingangs" hier nur in Kürze:

• Virtuellen Eingang anlegen
• Bezeichnung aus der Incoming Overview des Gateway Plugins kopieren und im Virtuellen Eingang exakt so einfügen. 
• Als Digitaleingang verwenden: NEIN
• Validierung korrekt setzen.

Beispiel anhand der pH Sonde (Adresse 99):

Alle Aktoren (Pumpen) und auch das Plugin können über das Topic poolmanager/set/command gesteuert werden. Dazu muss für das MQTT Gateway Plugin ein Virtueller Ausgang angelegt werden. Bitte lest in der Dokumentation des  MQTT Gateway Plugin nach, wie genau die Werte in der Loxone Config verwendet werden: MQTT - Schritt für Schritt: Loxone -> MQTT

Ich behandele das Thema "Anlegen eines Virtuellen Ausgangs" hier nur in Kürze:

• Virtuellen Ausgang anlegen, Adresse: /dev/udp/192.168.3.212/11884 (IP und ggf. Port müsst ihr anpassen)
• Darunter einen "Virtuellen Ausgang Befehl" anlegen
• Befehl bei EIN: publish poolmanager/set/command <EUER BEFEHL>
• Optional: Befehl bei AUS: publish poolmanager/set/command <EUER BEFEHL>
• Als Digitalausgang verwenden: je nach Bedarf, meist hier NEIN (um Werte über <v> an das Plugin zu übertragen

Für die Befehle gibt es nun zwei Möglichkeiten: Entweder einen Befehl direkt an einen Sensor oder Aktor senden oder aber einen Befehl an das Plugin senden:

Hierbei fügt ihr direkt den Befehl, den ihr aus der Dokumentation des Atlas Scientific Sensors entnehmen könnt, direkt 1:1 hier ein. Dem Befehl wird die Sensor-Adresse gefolgt von einem Doppelpunkt vorangestellt. Beispiel: Dosierbefehl an die Pumpe mit der Adresse 103 senden. Der Befehl lautet dann: 103:d,<v> Das <v> wird von Loxone dann wie üblich durch den Analogwert des Befehlseingangs ersetzt. An das Plugin und damit die Pumpe wird also z. B. gesendet: 103:d,50 um 50ml über die Pumpe zu dosieren.

Beispiel Dosierbefehl an Pumpe:

Das Plugin kann über das gleiche Topic wie die Sensoren und Aktoren gesteuert werden. Anstelle der vorangestellten Sensoradresse wird hier aber das Signalwort "plugin" gefolgt von einem Doppeltpunkt gestellt. Beispiel Auslesen der Sensoren pausieren: plugin:pause

Folgende Befehle werden aktuell vom Plugin unterstützt:

• plugin:pause - Pausiert das Plugin bzw. das Auslesen der Sensoren und versetzt alle Sensoren und Aktoren in den SLEEP Modus (z. B. wenn die Poolpumpe nicht läuft)
• plugin:start - Startet das Plugin wieder (z. B. wenn die Poolpumpe morgens wieder läuft)
• plugin:getstatus - liest alle Statuswerte neu ein
• plugin:getvalues - Liest alle Messwerte neu ein
• plugin:readconfig - Liest die Pluginkonfiguration neu ein (z. B. bei Änderungen) und aktualisiert anschließend den Status aller Sensoren

Beispiel Plugin bei EIN starten und bei AUS pausieren lassen:

Die Aktoren und Sensoren können auch manuell vom LoxBerry aus gesteuert und konfiguriert werden: Manuelle Steuerung/Auslesen von Sensoren/Aktoren

Kalibrierung über die WebUI von Sensoren und Aktoren (zugewiesen an Michael Schlenstedt)

LCD Display zur Anzeige (zugewiesen an Michael Schlenstedt)

LCD Display zur Steuerung (zugewiesen an Michael Schlenstedt)

https://www.loxforum.com/forum/projektforen/loxberry/plugins/355455-plugin-loxberry-poolmanager