Regen, Regen, immer nur Regen

Nachdem ich für den alten Kombisensor an seinem neuen Standort ein neues Minimax-Programm für die Temperatur geklöppelt hatte, habe ich natürlich kurz danach auch ein Pendant für den Niederschlag programmiert. Damit habe ich dann so gut wie fast alles abgedeckt, was der Sensor noch an sinnvollen Daten liefert.

Planung

Wie beim 24-Stunden-Minimax ist auch beim 24-Stunden-Regen die Herausforderung, Daten aus einem Verlauf zu extrahieren, ohne eine Datenbank zu verwenden. Auch für den Regen werde ich daher die Niederschlagswerte in einer Systemvariablen speichern, die die letzten 24 Stunden abdeckt und ständig aktualisiert wird.

Ebenfalls wie bei der Temperatur sind es dann auch diesmal eigentlich nur 22 bis 23 Stunden, aber auch beim Regen ist das für mich völlig ausreichend.

Systemvariablen

Wie immer bilden die Systemvariablen den Anfang.

Die Systemvariable Regen 24h ist die Zeichenkette, die ich als Array missbrauchen werde. Regenmenge wird dann die 24-Stunden-Summe aufnehmen – ich habe sie dem Gerät Kombisensor zugeordnet, damit der Wert in der WebUI leidlich elegant angezeigt wird.

Programm und Script

Das WebUI-Programm ist ähnlich einfach wie beim Temperatur-Minimax.

Sobald der Kombisensor irgendeine Regenmenge meldet, wird das Script ausgeführt. Der Wertebereich größer oder gleich 0.00 mm sowie die Auswahl bei Aktualisierung auslösen sorgen dafür, dass das Script entsprechend der Logik von WebUI-Programmen bei jeder Meldung des Kombisensors ausgeführt wird, egal ob es frischen Regen gibt oder nicht.

Für das Script habe ich eine Verzögerung von 10 Sekunden eingestellt, weil ich es gleichzeitig für die Aktualisierung meiner PHP-DB verwende. So ganz verzichte ich also auch diesmal nicht auf eine Datenbank-Anbindung, aber das ist wie beim Minimax optional und hat keine Auswirkung auf die Berechnung des 24-Stunden-Niederschlags. Wer keine PHP-DB hat, braucht eigentlich auch keine Verzögerung.

Das Script ist wieder hübsch mittellang.

gesamtes Script markieren / kopieren

! HomeMatic-Script
! REGEN, REGEN, IMMER NUR REGEN
! http://www.christian-luetgens.de/homematic/programmierung/garten/niederschlag/Regen.htm

object o_raincount = dom.GetObject ("$src$");

if (o_raincount) {

  real r_raincount = o_raincount.Value() - o_raincount.LastValue();
  if (r_raincount < 0.0) {
    r_raincount = r_raincount + o_raincount.ValueMax();
  }

  if (r_raincount < 50.0) {

    object o_verlauf = dom.GetObject ("Regen 24h");
    string s_verlauf_alt = o_verlauf.Value();
    string s_verlauf_neu = "";

    integer i_now = system.Date ("%H").ToInteger();

    string s_delimiter = "";
    integer i = 0;
    real r_tag = 0.0;
    real r_stunde;
    string s;

    while (i < 24) {
      if (i == ((i_now + 1) % 24)) {
        s = "0";
      } else {
        r_stunde = s_verlauf_alt.StrValueByIndex (";", i).ToFloat();
        if (i == i_now) {
          r_stunde = r_stunde + r_raincount;
        }
        s = r_stunde.ToString (1);
        r_tag = r_tag + r_stunde;
      }
      s_verlauf_neu = s_verlauf_neu # s_delimiter # s;
      s_delimiter = ";";
      i = i + 1;
    }

    o_verlauf.State (s_verlauf_neu);
    dom.GetObject ("Regenmenge").State (r_tag);

  }

}

!  Ende des Scripts

Das Script ermittelt zunächst den Datenpunkt, über den es ausgelöst wurde. Wenn es keinen auslösenden Datenpunkt gibt, weil das Programm zum Beispiel beim Neustart der CCU ausgeführt wird, passiert nichts weiter.

Gibt es einen Datenpunkt, werden aktueller und vorheriger Wert für den Regenmengenzähler ausgelesen. Ist der aktuelle Wert niedriger als der vorherige, geht das Script von einem Zähler-Überlauf aus. Wenn am Ende kein sinnvoller Wert von maximal 50 mm seit der letzten Meldung herauskommt, wird der Rest des Scripts übersprungen.

Anderenfalls wird die Zeichenkette s_verlauf_alt für den Verlauf der letzten 24 Stunden initialisiert und die Stunde der aktuellen Uhrzeit als Index ermittelt. Danach geht das Script – wie beim Temperatur-Minimax – alle 24 Stunden durch: Für die aktuelle Stunde wird der aktuelle Regenwert zum Wert aus s_verlauf_alt addiert und in s_verlauf_neu geschrieben, für die folgende Stunde wird der Wert in s_verlauf_neu auf 0 gesetzt, alle anderen Stundenwerte werden unverändert übernommen.

Die neu zusammengesetzte Zeichenkette s_verlauf_neu wird dann wieder in Regen 24h zurückgeschrieben.

Nebenbei wurde in der Schleife noch r_tag aufaddiert – das ist dann die Gesamtmenge der letzten Stunden, die ganz am Ende in die Systemvariable Regenmenge geschrieben wird. Damit hat das Script seine eigentliche Aufgabe erfüllt.

Jetzt heißt es: Auf Regen warten. Genug Zeit für eine Alternative-Rock-Ballade.

Erweiterung: PHP-DB

Wie bereits angedeutet, lasse ich im Script auch gleich meine PHP-DB aktualisieren. Das geschieht einfach mit zwei zusätzlichen Zeilen am Ende.

gesamtes Script markieren / kopieren

   [...]
   dom.GetObject ("Regenmenge").State (r_tag);

    dom.GetObject ("PHP-DB Table").State ("Regen");
    dom.GetObject ("PHP-DB Value").State (r_raincount);

  }

Die Tabelle Regen wird mit dem Wert in r_raincount gefüllt – also nicht das 24-Stunden-Endergebnis, das ich in meinem Script mühsam ausrechne, sondern einfach die Niederschlagsmenge seit der letzten Meldung des Kombisensors.

utc_time	min_val	avg_val	max_val	sum_val
2021-04-27	0.00	0.00	0.00	0.00
2021-04-28	0.00	0.00	0.00	0.00
2021-04-29	0.00	0.00	0.00	0.00
2021-04-30	0.00	0.00	0.00	0.00
2021-05-01	0.00	0.00	0.00	0.00
2021-05-02	0.00	0.00	0.30	0.30
2021-05-03	0.00	0.00	0.00	0.00
2021-05-04	0.00	0.00	0.00	0.00
2021-05-05	0.00	0.00	0.30	0.90
2021-05-06	0.00	0.00	0.00	0.00
2021-05-07	0.00	0.00	0.30	1.80
2021-05-08	0.00	0.00	0.00	0.00
2021-05-09	0.00	0.00	0.00	0.00

Wie man sieht, manchmal regnet es auch hier – am 07. Mai ganze 1,8 mm. Wow!

Für einen Screenshot des Kombisensors muss ich freilich wieder warten. Zeit für die Dire Straits.

Kombisensor

Um die Sache mal abzukürzen: Meine Systemvariable Regenmenge, die ich zu Anfang dem Kombisensor zugeordnet hatte, wird wie geplant in der WebUI angezeigt.

Ich habe den Screenshot etwas zusammengeschnitten, aber gut zu erkennen: Der Regenmengenzähler des Kombisensors – oben – zeigt 4,13 mm Niederschlag, seit ich das Gerät hier aufgestellt habe. Die Regenmenge aus der Systemvariable, die ebenfalls als „Regenmenge“ angezeigt wird – unten –, steht stramm bei 0.

Es wird wohl Sommer.