Metainformationen zur Seite

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
plugins:loxberry_poolmanager:start [2023/07/01 19:12] – Michael Schlenstedtplugins:loxberry_poolmanager:start [2024/07/18 11:43] (aktuell) – Struct-Daten geändert Michael Schlenstedt
Zeile 21: Zeile 21:
 ===== Installation ===== ===== Installation =====
  
-Keine Besonderheiten. Das Plugin wird standardmäßig über die Pluginverwaltung installiert. Das Plugin setzt ein installiertes und konfiguriertes  [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] voraus!+Keine Besonderheiten. Das Plugin wird standardmäßig über die Pluginverwaltung installiert. Das Plugin setzt ein installiertes und konfiguriertes  [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] voraus (nur LoxBerry 2.2 - ab LoxBerry 3.0 ist das Gateway bereits im LoxBerry integriert)!
  
 ===== Hardware vorbereiten ===== ===== Hardware vorbereiten =====
Zeile 30: Zeile 30:
  
 Das Plugin blockiert den I2C Bus, an dem alle Sensoren angeschlossen werden. Es werden an alle Busteilnehmer regelmäßig Befehle gesendet (auch an fremde Sensoren/Aktoren) - das kann zu erheblichen Fehlfunktionen bei den "Nicht-Atlas-Scientific-Komponenten" auf dem Bus führen! Ich empfehle Euch die Atlas Scientific Sensoren auf einem eigenen I2C Bus laufen zu lassen (wobei das Whiteboard zwingend Bus 1 verwendet - ihr müsst also eure anderen Komponenten umlegen). Wie man mehrere I2C Busse auf dem Raspberry aktiviert, könnt ihr hier nachlesen: [[howtos_knowledge_base:mehrere_i2c_busse]] Das Plugin blockiert den I2C Bus, an dem alle Sensoren angeschlossen werden. Es werden an alle Busteilnehmer regelmäßig Befehle gesendet (auch an fremde Sensoren/Aktoren) - das kann zu erheblichen Fehlfunktionen bei den "Nicht-Atlas-Scientific-Komponenten" auf dem Bus führen! Ich empfehle Euch die Atlas Scientific Sensoren auf einem eigenen I2C Bus laufen zu lassen (wobei das Whiteboard zwingend Bus 1 verwendet - ihr müsst also eure anderen Komponenten umlegen). Wie man mehrere I2C Busse auf dem Raspberry aktiviert, könnt ihr hier nachlesen: [[howtos_knowledge_base:mehrere_i2c_busse]]
 +
 +Hinweis: Das vom Plugin unterstützte LCD Display ([[https://www.adafruit.com/category/808|Adafruit LCD+Keypad Kit for Raspberry Pi]]) kann gemeinsam am gleichen Bus wie die Atlas Sensoren betrieben werden. Hier gibt es keine Probleme.
  
 </WRAP> </WRAP>
Zeile 61: Zeile 63:
 {{plugins:loxberry_poolmanager:pasted:20230612-201808.png?600}} {{plugins:loxberry_poolmanager:pasted:20230612-201808.png?600}}
  
-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)%%+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)
  
-<WRAP center round important 100%>+<WRAP center round tip 100%>
  
 **Nach jedem Hinzufügen, Löschen oder Ändern muss das Gateway neu gestartet werden, damit die Änderungen aktiv werden!** **Nach jedem Hinzufügen, Löschen oder Ändern muss das Gateway neu gestartet werden, damit die Änderungen aktiv werden!**
  
 </WRAP> </WRAP>
 +
 +=== Reiter: LCD Display ===
 +
 +In diesem Tab wird ein an den LoxBerry angeschlossenes LCD Display konfiguriert. Die Benutzung des Displays wird weiter unten in einem separaten Kapitel beschrieben.
 +
 +{{plugins:loxberry_poolmanager:pasted:20240222-054903.png?600}}
 +
 +^ Option  ^ Beschreibung  ^
 +| LCD Display  | Hier kann das LCD Display aktiviert oder deaktiviert werden.  |
 +| Zykluszeit  | Im Standardmodus werden alle Messwerte der Reihe nach im Display angezeigt. Mit dieser Zeit kann die Anzeige-Zeit, nach der jeweils gewechselt wird, angepasst werden. Angabe in Sekunden.  |
 +| Display Timeout  | Nach dieser Zeit (Angabe in Sekunden) schaltet sich das Display ab. Es kann dann durch Tastendruck reaktiviert werden. Möchte man das Display permanent eingeschaltet lassen, trägt man hier eine 0 (Null) ein.  |
 +| Externer Messwert: Messwert Name | Möchte man weitere externe Messwerte im Display anzeigen (z. B. Temperaturen), so kann man hier einen Namen vergeben, der dazu im Display angezeigt wird. Leer lassen um die Funktion zu deaktivieren. Beschreibung im Kapitel unten. |
 +| Externer Messwert: Messwert Einheit | Möchte man weitere externe Messwerte im Display anzeigen (z. B. Temperaturen), so kann man hier die dazugehörige Einheit angeben, die dazu im Display angezeigt wird. Leer lassen um die Funktion zu deaktivieren. Beschreibung im Kapitel unten. |
  
 === Reiter: Einstellungen === === Reiter: Einstellungen ===
Zeile 84: Zeile 99:
 {{plugins:loxberry_poolmanager:pasted:20230612-201242.png?600}} {{plugins:loxberry_poolmanager:pasted:20230612-201242.png?600}}
  
-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).%%+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. 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.
  
 {{plugins:loxberry_poolmanager:pasted:20230612-202231.png?300}}  {{plugins:loxberry_poolmanager:pasted:20230612-202250.png?300}}  {{plugins:loxberry_poolmanager:pasted:20230612-202303.png?300}}\\ {{plugins:loxberry_poolmanager:pasted:20230612-202231.png?300}}  {{plugins:loxberry_poolmanager:pasted:20230612-202250.png?300}}  {{plugins:loxberry_poolmanager:pasted:20230612-202303.png?300}}\\
 +
  
 ===== Einrichtung in der Loxone Config Software ===== ===== Einrichtung in der Loxone Config Software =====
Zeile 94: Zeile 110:
 ==== Messwerte auslesen/verwenden ==== ==== Messwerte auslesen/verwenden ====
  
-Das Plugin sendet alle ausgelesenen Messwerte per MQTT an den MQTT Broker bzw. das  [[plugins:mqtt_gateway:start|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  [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] nach, wie genau die Werte in der Loxone Config verwendet werden: [[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_mqtt_loxone|MQTT - Schritt für Schritt: MQTT -> Loxone]]+Das Plugin sendet alle ausgelesenen Messwerte per MQTT an den MQTT Broker bzw. das  [[plugins:mqtt_gateway:start|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  [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] nach, wie genau die Werte in der Loxone Config verwendet werden: [[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_mqtt_loxone|MQTT - Schritt für Schritt: MQTT -> Loxone]]
  
 Ich behandele das Thema "Anlegen eines Virtuellen Eingangs" hier nur in Kürze: Ich behandele das Thema "Anlegen eines Virtuellen Eingangs" hier nur in Kürze:
Zeile 109: Zeile 125:
 ==== Aktoren und Plugin steuern ==== ==== Aktoren und Plugin steuern ====
  
-Alle Aktoren (Pumpen) und auch das Plugin können über das Topic**''%% poolmanager/set/command%%''** gesteuert werden. Dazu muss für das [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] ein Virtueller Ausgang angelegt werden. Bitte lest in der Dokumentation des  [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] nach, wie genau die Werte in der Loxone Config verwendet werden: [[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_loxone_mqtt|MQTT - Schritt für Schritt: Loxone -> MQTT]]+Alle Aktoren (Pumpen) und auch das Plugin können über das Topic **''%%poolmanager/set/command%%''** gesteuert werden. Dazu muss für das [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] ein Virtueller Ausgang angelegt werden. Bitte lest in der Dokumentation des  [[konfiguration:widget_help:widget_mqtt:|MQTT Widgets]] nach, wie genau die Werte in der Loxone Config verwendet werden: [[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_loxone_mqtt|MQTT - Schritt für Schritt: Loxone -> MQTT]]
  
 Ich behandele das Thema "Anlegen eines Virtuellen Ausgangs" hier nur in Kürze: Ich behandele das Thema "Anlegen eines Virtuellen Ausgangs" hier nur in Kürze:
Zeile 139: Zeile 155:
   * **''%%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: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:start%%''** - Startet das Plugin wieder (z. B. wenn die Poolpumpe morgens wieder läuft)
 +  * **''%%plugin:calibrate%%''** - Nur für interne Zwecke - nicht verwenden!
   * **''%%plugin:getstatus%%''** - liest alle Statuswerte neu ein   * **''%%plugin:getstatus%%''** - liest alle Statuswerte neu ein
   * **''%%plugin:getvalues%%''** - Liest alle Messwerte 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   * **''%%plugin:readconfig%%''** - Liest die Pluginkonfiguration neu ein (z. B. bei Änderungen) und aktualisiert anschließend den Status aller Sensoren
- +  * **''plugin:display_on''** - Schaltet ein an den LoxBerry angeschlossenes LCD Display dauerhaft an 
- +  * **''plugin:display_off''** - Schaltet ein an den LoxBerry angeschlossenes LCD Display aus. Zusätzlich wird der hinterlegte Timeout aktiviert. 
 +  * **''plugin:display_auto''** - Schaltet ein an den LoxBerry angeschlossenes LCD Display ein. Zusätzlich wird der hinterlegte Timeout aktiviert, d. h. nach Timeout wird das Display wieder automatisch ausgeschaltet.
  
 Beispiel Plugin bei EIN starten und bei AUS pausieren lassen: Beispiel Plugin bei EIN starten und bei AUS pausieren lassen:
Zeile 153: Zeile 171:
 {{indexmenu>loxconfig_beispiele#1}} {{indexmenu>loxconfig_beispiele#1}}
  
-===== Manuelle Steuerung =====+===== LCD Display ===== 
 + 
 +{{:plugins:loxberry_poolmanager:1254687242.gif}} 
 + 
 +Zur Bedienung oder zum Ablesen von Messwerten im Poolhaus kann ein LCD Display an den LoxBerry angeschlossen werden. Es wird ausschließlich das [[https://www.adafruit.com/category/808|Adafruit LCD+Keypad Kit for Raspberry Pi]] unterstützt. Andere LCD Displays funktionieren mit dem Plugin nicht. 
 + 
 +Im Standardmodus werden alle Messwerte des Plugins zyklisch im Display angezeigt. Durch drücken der Links- oder Rechts-Taste wird die Anzeige unterbrochen und man kann die einzelnen Werte über Links/Rechts explizit durchschalten. Erfolgt für 30 Sekunden kein Tastendruck, wird die zyklische Anzeige wieder aktiviert. 
 + 
 +Die Anzeige eines Sensors/Aktors und die gewünschte Einheit muss explizit in der Sensor/Aktor-Konfiguration aktiviert werden. Ansonsten erfolgt keine Anzeige. Siehe oben. 
 + 
 +=== Anzeige externer Messwerte === 
 + 
 +Man kann zusätzlich bis zu 5 externe Messwerte auf dem Display anzeigen lassen. Dazu trägt man Name und Einheit im Reiter "LCD Display" entsprechend ein. So ist es zum Beispiel möglich einen Temperatursensor oder auch Wetterdaten mit auf dem Display anzuzeigen. Es muss zwingend ein Name angegeben werden (sonst wird der Wert ignoriert), die Angabe einer EInheit ist optional. Die Messwerte werden vom Miniserver aus per Virtuellem Ausgang an ein bestimmtes MQTT Topic gesendet. Von dort aus werden sie vom Plugin eingelesen und angezeigt. 
 + 
 +Die externen Messwerte können über das Topic **''%%poolmanager/lcd/value1/value%%''** (Beispiel für den ersten von 5 Messwerten) an das Plugin gesendet werden. Dazu muss für das MQTT Widget ein Virtueller Ausgang angelegt werden. Bitte lest in der Dokumentation des [[konfiguration:widget_help:widget_mqtt:|MQTT Widgets]] nach, wie genau die Werte in der Loxone Config verwendet werden: [[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_loxone_mqtt|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/lcd/value1/value <v>%%''** 
 +  * Als Digitalausgang verwenden: NEIN 
 + 
 +Für weitere Messwerte dann ''value1'' entsprechend gegen ''value2'', ''value3'' etc. austauschen. 
 + 
 +=== Steuern des Displays von Loxone aus === 
 + 
 +Das Display kann auch extern ein- und ausgeschaltet werden (z. B. über einen Türkontakt o. ä.). Siehe dazu hier: [[plugins:loxberry_poolmanager:start#befehl_an_das_plugin_senden_pluginfunktionen_steuern|Befehle an das Plugin senden]] 
 + 
 +=== Kalibrierung === 
 + 
 +//Noch nicht implementiert// 
 + 
 +===== Manuelle Steuerung des Plugins über die Kommandozeile =====
  
 Die Aktoren und Sensoren können auch manuell vom LoxBerry aus gesteuert und konfiguriert werden: [[plugins:loxberry_poolmanager:manuelle_steuerungauslesen_von_sensorenaktoren]] Die Aktoren und Sensoren können auch manuell vom LoxBerry aus gesteuert und konfiguriert werden: [[plugins:loxberry_poolmanager:manuelle_steuerungauslesen_von_sensorenaktoren]]
Zeile 174: Zeile 225:
 pluginuebersicht.logo : :plugins:loxberry_poolmanager:1728905230.png pluginuebersicht.logo : :plugins:loxberry_poolmanager:1728905230.png
 pluginuebersicht.status : STABLE pluginuebersicht.status : STABLE
-pluginuebersicht.version : 1.0.1+pluginuebersicht.version : 2.0.3
 pluginuebersicht.min_lb_version : 2.2.1 pluginuebersicht.min_lb_version : 2.2.1
-pluginuebersicht.url_release : https://github.com/mschlenstedt/LoxBerry-Plugin-Poolmanager/archive/refs/tags/PoolManager-V1.0.1.zip+pluginuebersicht.url_release : https://github.com/mschlenstedt/LoxBerry-Plugin-Poolmanager/archive/refs/tags/PoolManager-V2.0.3.zip
 pluginuebersicht.url_prerelease :  pluginuebersicht.url_prerelease : 
 pluginuebersicht.description : Mit dem LoxBerry PoolManager kann eine automatische pH-Wert und Chlor-Regelung mit Sensoren von Atlas Scientific aufgebaut werden. pluginuebersicht.description : Mit dem LoxBerry PoolManager kann eine automatische pH-Wert und Chlor-Regelung mit Sensoren von Atlas Scientific aufgebaut werden.
-pluginuebersicht.languages : DE+pluginuebersicht.languages : DE, EN
 pluginuebersicht.discussion : https://www.loxforum.com/forum/projektforen/loxberry/plugins/355455-plugin-loxberry-poolmanager pluginuebersicht.discussion : https://www.loxforum.com/forum/projektforen/loxberry/plugins/355455-plugin-loxberry-poolmanager
 ---- ----