Skip to content

Latest commit

 

History

History
101 lines (67 loc) · 4.92 KB

CommandRef.de.md

File metadata and controls

101 lines (67 loc) · 4.92 KB
Raw

Buienradar

Das Buienradar-Modul bindet die Niederschlagsvorhersagedaten der freien API von Buienradar.nl an.

Define

define <devicename> Buienradar [latitude] [longitude]

Die Werte für latitude und longitude sind optional und werden, wenn nicht explizit angegeben, von global bezogen. Die minimalste Definition lautet demnach:

define <devicename> Buienradar

Set

Folgende Set-Aufrufe werden unterstützt:

  • refresh - Neue Daten abfragen.

Get

Aktuell lassen sich folgende Daten mit einem Get-Aufruf beziehen:

  • rainDuration - Die voraussichtliche Dauer des nächsten Niederschlags in Minuten.
  • startsIn - Der nächste Niederschlag beginnt in n Minuten. Obsolet!
  • version - Aktuelle Version abfragen.

Readings

Aktuell liefert Buienradar folgende Readings:

  • rainAmount - Menge des gemeldeten Niederschlags für die nächste Stunde in mm/h.
  • rainBegin - Beginn des nächsten Niederschlag. Wenn kein Niederschlag gemeldet ist, unknown.
  • raindEnd - Ende des nächsten Niederschlag. Wenn kein Niederschlag gemeldet ist, unknown.
  • rainDataStart - Zeitlicher Beginn der gelieferten Niederschlagsdaten.
  • rainDataEnd - Zeitliches Ende der gelieferten Niederschlagsdaten.
  • rainLaMetric - Aufbereitete Daten für LaMetric-Devices.
  • rainMax - Die maximale Niederschlagsmenge in mm/h für ein 5 Min. Intervall auf Basis der vorliegenden Daten.
  • rainNow - Die vorhergesagte Niederschlagsmenge für das aktuelle 5 Min. Intervall in mm/h.
  • rainTotal - Die gesamte vorhergesagte Niederschlagsmenge in mm/h
  • rainDuration - Dauer der gemeldeten Niederschläge in Minuten
  • rainDurationTime - Dauer der gemeldeten Niederschläge in HH:MM
  • rainDurationIntervals - Anzahl der Intervalle mit gemeldeten Niederschlägen
  • rainDurationPercent - Prozentualer Anteil der Intervalle mit Niederschlägen

Attribute

  • disabled on|off - Wenn disabled auf on gesetzt wird, wird das Device keine weiteren Anfragen mehr an Buienradar.nl durchführen. off reaktiviert das Modul, ebenso wenn das Attribut gelöscht wird.

    Achtung! Aus Kompatibilitätsgründen zu FHEM::IsDisabled() wird bei einem Aufruf von disabled auch disable als weiteres Attribut gesetzt. Wird disable gesetzt oder gelöscht, beeinflusst dies disabled nicht! disable sollte nicht verwendet werden!

  • region nl|de - Erlaubte Werte sind nl (Standardwert) und de. In einigen Fällen, insbesondere im Süden und Osten Deutschlands, liefert de überhaupt Werte.

  • interval 10|60|120|180|240|300 - Aktualisierung der Daten alle n Sekunden. Achtung! 10 Sekunden ist ein sehr aggressiver Wert und sollte mit Bedacht gewählt werden, z.B. bei der Fehlersuche. Standardwert sind 120 Sekunden.

Visualisierungen

Buienradar bietet neben der üblichen Ansicht als Device auch die Möglichkeit, die Daten als Charts in verschiedenen Formaten zu visualisieren.

  • Eine HTML-Version die in der Detailansicht standardmäßig eingeblendet wird und mit

      { FHEM::Buienradar::HTML("name des buienradar device")}

    abgerufen werden.

  • Ein von Google Charts generiertes Diagramm im PNG-Format, welcher mit

      { FHEM::Buienradar::GChart("name des buienradar device")}

    abgerufen werden kann. Achtung! Dazu werden Daten an Google übertragen!

  • Für FTUI werden die Daten im LogProxy-Format bereitgestellt:

      { FHEM::Buienradar::LogProxy("name des buienradar device")}

  • Für eine reine Text-Ausgabe der Daten als Graph, kann

      { FHEM::Buienradar::TextChart("name des buienradar device")}

    verwendet werden. Ausgegeben wird ein für jeden Datensatz eine Zeile im Muster

      22:25 |   0.060 | =
  22:30 |   0.370 | ====
  22:35 |   0.650 | =======

    wobei für jede 0.1 mm/h Niederschlag ein = ausgegeben wird, maximal jedoch 50 Einheiten. Mehr werden mit einem > abgekürzt.

      23:00 |  11.800 | ==================================================>

  • Eine kompakte graphische Darstellung wird mit

      { FHEM::Buienradar::ColourBarChart("Name des Buienradar-Devices") }

    dargestellt. Erzeugt wird eine zweizeilige, mit CSS formatierte HTML-Tabelle, die für jeden Wert eine eigene Zelle mit unterschiedlicher Blauintensität als Hintergrundfarbe und eine Legende abbildet.