|
|
| Line 1: |
Line 1: |
| | __NOTOC__ | | __NOTOC__ |
| − | <languages /><br />Meteobridge stellt einen sehr flexiblen Ersetzungsmechanismus zur Verfügung, mit dem definierte Variable durch konkrete Sensorwerte ersetzt werden. Dies ermöglich Meteobridge in beliebige Zeichenketten Variable "einzuschmuggeln", seien es E-Mail, HTML-Seiten, Alarmbedingungen, etc.
| + | Meteobridge is a device that is easy to use and which should not raise a demand for extensive support. However, there is a forum, where you can share experiences, questions, wishes with other users. |
| − | Die Variable werden in dem Moment, in dem die Zeichenkette an den Upload zum Zieldienst übergeben wird surch reale Werte ersetzte. Kann das Datenpaket nicht zugestellt werden, wird die Zustellung gegebenenfalls wiederholt, jedoch mit den bei der Erstbeauftragung eingesetzten Daten.
| + | |
| | | | |
| − | Jede Variable beginnt und endet mit einer eckigen Klammer "[" und "]". Die Variable in diesen Klammern zeigt die folgende Struktur: <pre>Sensor-Selektor=Konverter.Dezimalstellen:Ersatzzeichenkette</pre>
| + | Please make use of this in favor to emails, as a wider public can participate of your insights and problem resultion recipes. |
| − | "Konverter", "Dezimalstellen" und "Ersatzzeichenkette" kann weggelassen werden, "Sensor" und "Selektor" müssen angegeben werden.
| + | |
| − | Während "Sensor" festlegt, um welchen Sensor es sich handelt und welcher Sensorwert verwendten werden soll, gibt "Selektor" an, welche Zeitperiode ausgewertet werden soll. Mit "Konverter" kann optional eine Umrechnung in andere Maßeinheiten realisiert werden. Die "Dezimalstellen"-Angabe bestimmt die numerische Auflösung der Daten und die "Ersatzzeichenkette" bestimmt den Wert, der ausgegeben wird, wenn kein Sensorwert für den definierten Zeitraum vorliegt.
| + | |
| | | | |
| − | ==Sensoren==
| + | Forum is part of Meteohub Forum: [http://forum.meteohub.de/viewforum.php?f=54&sid=c8736ec03d0ef75afa55c16f324623bd Meteobridge Forum] |
| − | Diese Sensoren sind in Meteobridge definiert:
| + | |
| − | * '''th0temp''': Außentemperatur in Grad Celsius
| + | |
| − | * '''th0hum''': Relative Außenluftfeuchte in Prozent
| + | |
| − | * '''th0dew''': Außentaupunkttemperatur in Grad Celsius
| + | |
| − | * '''thb0temp''': Innentemperatur in Grad Celsius
| + | |
| − | * '''thb0hum''': Innenluftfeuchte in Prozent
| + | |
| − | * '''thb0dew''': Innentaupunkttemperatur in Grad Celsius
| + | |
| − | * '''thb0press''': Stationsluftdruck in hPa
| + | |
| − | * '''thb0seapress''': auf Meeresspiegelhöhe berechneter Luftdruck in hPa
| + | |
| − | * '''wind0wind''': ungemittelte Windgeschindigkeit in m/s
| + | |
| − | * '''wind0avgwind''': gemittelte Windgeschindigkeit in m/s
| + | |
| − | * '''wind0dir''': Windrichtung in Grad (0° ist Norden)
| + | |
| − | * '''wind0chill''': Windchill-Temperatur in Grad Celsius
| + | |
| − | * '''rain0rate''': Regenrate in mm/h
| + | |
| − | * '''rain0total''': gefallene Regenmenge in mm
| + | |
| − | * '''uv0index''': UV-Index
| + | |
| − | * '''sol0rad''': Solarstrahlung in W/m^2
| + | |
| − | Wenn ein Sensor nicht existiert oder seine Daten älter als das maximal tolerierte Sensordatenalter sind, wird Meteohub keine Daten einsetzen und sofern definiert, stattdessen die Ersatzzeichenkette einsetzen. Falls keine Ersatzzeichenkette definiert ist, bleibt die Variable unersetzt als Zeichenkette stehen.
| + | |
| | | | |
| − | Einige Stationen unterstützen zusätzliche Temperatur/Feuchte-Sensoren. Meteobridge zählt diese als "th1temp", "th1hum", "th1dew", etc auf. Der Reiter "Live-Daten" zeigt neben den aktuellen Daten auch die Sensornummern dieser Zusatzsensoren. Wenn man über eine mit Bodenfeuchte- udn Blattfeuchte-Sensoren ausgestattete Davis Vantage verfügt, werden diese Sensoren ebenfalls als Temperatur/Feuchte-Sensoren geführt, allerdings ohne Berechnung eines Taupunktes. Die Bodenfeuchte-Sensoren weden als "th10temp", "th10hum", ..., "th13temp", "th13hum" und die Blattfeuchte-Sensoren als "th15temp", "th15hum", ..., "th18temp", "th18hum" geführt. Die "hum"-Werte repräsenstieren in diesem Fall nicht die relative Luftfeuchte, sondern Werte in "cbar" und "wet". Meteobridge erfindet für diese Spezialsensoren keine neuen Selektoren. Der generische Selektor "hum" dient dazu, auch die Werte in "cbar" und "wet" dieser Sensoren abzufragen.
| + | ===Release Log=== |
| | + | To get the latest relaease running on your rig, just do a reboot or power-cycle. |
| | | | |
| − | ==Selektor==
| |
| − | Den "Sensoren" folgt eine Selektorbezeichnung (durch ein "-" getrennt) mit der der auszuwertende Zeitraum oder Zeitpunkt angegeben wird. Die folgenden Selektoren sind definiert:
| |
| − | * '''act''': aktuelle Daten
| |
| − | * '''hmin''': Minimum der aktuellen Stunde
| |
| − | * '''hmax''': Maximum der aktuellen Stunde
| |
| − | * '''dmin''': Minimum von Heute
| |
| − | * '''dmax''': Maximum von Heute
| |
| − | * '''ydmin''': Minimum von Gestern
| |
| − | * '''ydmax''': Maximum von Gestern
| |
| − | * '''mmin''': Minimum dieses Monats
| |
| − | * '''mmax''': Maximum dieses Monats
| |
| − | * '''ymin''': Minimum dieses Jahres
| |
| − | * '''ymax''': Maximum dieses Jahres
| |
| − | * '''amin''': Minimum des gesamten Aufzeichnungszeitraumes
| |
| − | * '''amax''': Maximum des gesamten Aufzeichnungszeitraumes
| |
| − | * '''daysum oder sumday''', '''ydaysum''', '''monthsum''', '''yearsum''', '''allsum''': selektiert die Summe an Inkremente für Heute, Gestern, diesen Monat, dieses Jahr, gesamten Aufzeichnungszeitraum. Beispiel: "rain0total-sumday" ist die heutige Regenmenge.
| |
| | | | |
| − | Wenn man an den Zeitstempeln der Min/Max-Werte interessiert ist, könnten diese Selektoren ineressant sein:
| + | ====Current Version==== |
| − | * '''hmintime''': Zeitstempel des Minimums der aktuellen Stunde
| + | |
| − | * '''hmaxtime''': Zeitstempel des Maximums der aktuellen Stunde
| + | |
| − | * '''dmintime''': Zeitstempel des Minimums von Heute
| + | |
| − | * '''dmaxtime''': Zeitstempel des Maximums von Heute
| + | |
| − | * '''ydmintime''': Zeitstempel des Minimums von Gestern
| + | |
| − | * '''ydmaxtime''': Zeitstempel des Maximums von Gestern
| + | |
| − | * '''mmintime''': Zeitstempel des Minimums dieses Monats
| + | |
| − | * '''mmaxtime''': Zeitstempel des Maximums dieses Monats
| + | |
| − | * '''ymintime''': Zeitstempel des Minimums dieses Jahres
| + | |
| − | * '''ymaxtime''': Zeitstempel des Maximums dieses Jahres
| + | |
| − | * '''amintime''': Zeitstempel des Minimums des gesamten Aufzeichnungszeitraumes
| + | |
| − | * '''amaxtime''': Zeitstempel des Maximums des gesamten Aufzeichnungszeitraumes
| + | |
| − | * '''starttime''': Zeitstempel des ersten aufgezeichneten Datensatzes
| + | |
| − | Die Zeitstempel sind im Format "JJJJMMTThhmmss". das Jahr "JJJJ" wird mit 4 Stellen, alle anderen Angabe (Monat "MM", Tag "TT", Stunde "hh", minute "mm", Sekunde "ss") werden mit 2 Stellen berichtet. Führende Nullen werden nicht unterdrückt.
| + | |
| | | | |
| − | Neben obigen Selektoren, die fest definierte Zeitfenster selektieren, kann mit den folgenden Selektoren eine Auswertung für einen relativen Zeitraum in die Vergangenheit durchgeführt werden. Die Rückschau reicht wegen der begrenzten Speicherausstattung der Meteobridge nur bis zu 60 Minuten in die Vergangenheit.
| |
| − | * '''val2''', '''val5''', '''val10''', '''val15''', '''val30''', '''val60''': selektiert den Sensorwert vor 2, 5, 10, 15, 30 oder 60 Minuten
| |
| − | * '''max2''', '''max5''', '''max10''', '''max15''', '''max30''', '''max60''': selektiert das Maximum der letzten 2, 5, 10, 15, 30 oder 60 Minuten
| |
| − | * '''min2''', '''min5''', '''min10''', '''min15''', '''min30''', '''min60''': selektiert das Minimum der letzten 2, 5, 10, 15, 30 oder 60 Minuten
| |
| − | * '''avg2''', '''avg5''', '''avg10''', '''avg15''', '''avg30''', '''avg60''': selektiert den Durchschnitt der letzten 2, 5, 10, 15, 30 oder 60 Minuten
| |
| − | * '''sum2''', '''sum5''', '''sum10''', '''sum15''', '''sum30''', '''sum60''': selektiert zusammengerechnete Deltawerte der letzten 2, 5, 10, 15, 30 oder 60 Minuten, welches zum Berechnen der gefallenen Regenmenge im definierten Zeitraum erforderlich ist. Beispiel: "rain0total-sum60" ergebit die gefallene Regenmenge in mm der letzten 60 Minuten.
| |
| | | | |
| − | ==Konverter== | + | ====Version 1.3==== |
| − | Die Sensordaten werden als Voreinstellung in ISO Einheiten berichtet (°C, hPa, mm, m/s). Durch den Einsatz von Konvertern können die Einheiten auf non-ISO Einheiten umgerechnet werden. Definierte Konverter sind:
| + | released 21th April 2013: |
| − | * '''F''' wandelt die Temperature von Celsius in Fahrenheit um. | + | * fixes a stability bug on new LOOP2 supporting Davis Vantage drivers |
| − | * '''psi''' wandelt Luftdruck von hPa (entspricht auch mbar) in psi um. | + | * has some modules included to allow 3G modem support based on Huawei's E160 adapter (still experimental and to be formally released in one of the coming versions, profiles for "t-mobile.de" and "vodafone.de" do exist for testing purposes) |
| − | * '''mmHg''' wandelt Luftdruck von hPa in Millimeter Quecksilbersäule um.
| + | * a new firmare release is ready for download (in "getting started" section). This firmware is only needed when aiming at 3G operation. |
| − | * '''inHg''' wandelt Luftdruck von hPa in Inch Quecksilbersäule um.
| + | |
| − | * '''kmh''' wandelt Windgeschwindigkeit von m/s in Kilometer pro Stunde um.
| + | |
| − | * '''mph''' wandelt Windgeschwindigkeit von m/s in Meilen pro Stunde um.
| + | |
| − | * '''kn''' wandelt Windgeschwindigkeit von m/s in Knoten um.
| + | |
| − | * '''bft''' wandelt Windgeschwindigkeit von m/s in die Beaufort-Skala um.
| + | |
| − | * '''in''' wandelt der Regenmenge von mm in Inch um.
| + | |
| − | * '''ft''' wandelt eine Höhe von Metern in Fuß (feet) um. | + | |
| − | * '''endir''' wandelt die Windrichtung in einen von 16 Englischen Richtungstexten um.
| + | |
| − | * '''dedir''' wandelt die Windrichtung in einen von 16 Deutschen Richtungstexten um.
| + | |
| − | Wird eine unbekannte Konvertierung gewählt, findet keine Umrechnung statt un es erfolgt keine Fehlermeldung.
| + | |
| | | | |
| − | Wenn Variable einen Zeitstempel liefern, kann dieser von lokaler Zeit (Voreinstellung) auf Weltzeit (UTC) umgerechnet weden:
| + | released 13th April 2013: |
| − | * '''utc''' gibt den Zeitstempel nicht in lokaler Zeit (Voreinstellung) sondern in Weltzeit aus. | + | * added support for LOOP2 packets when using a Davis Vantage or Vue with firmware 1.90 or newer. This makes barometer readings more precise and better in sync with Vantage console. |
| | + | * fixes a problem with send email authentification |
| | | | |
| − | ==System-Variable==
| + | released 7th April 2013: |
| − | Meteobridge stellt zusätzliche Variable zur Verfügung, die nicht direkt mit Wetterbedingungen zu tun haben. Der Sensorname ist immer "mbsystem", die dazu definierten Selektoren sind:
| + | * fxing a bug uploading average windspeed to previmeteo |
| − | * '''swversion''': Meteobridge Versionskennung (Beispiel: "1.1") | + | * reduce timeout for mysql connection setup to 6 seconds |
| − | * '''buildnum''': Build-Nummer als Integer (Beispiel: 1673) | + | * moving static reserve LAN IP from 192.168.1.111 to 192.168.168.111 to avoid routing conficts with typical user class c networks when switching to wlan |
| − | * '''platform''': HW-Platform (Beispiel: "TL-MR3020") | + | * removing evapotranspiration values (which did appear randomly) from solar sensor data, if not Vantage station. |
| − | * '''language''': Im Web-Interface verwendete Sprache (Beispeil: "English")
| + | * adding a display that shows how much of internal data send buffer is currently occupied (system tab) |
| − | * '''timezone''': eingestellte Zeitzone (Beispiel: "Europe/Berlin")
| + | * reducing memory footprint of data send process to avoid triggering oom linux mechanisms |
| − | * '''latitude''': geografische Breite (Beispiel: 53.875120)
| + | * doing a reboot in case of oom situations by issueing a kernel panic instead of trying to stop some applications via oom_killer. |
| − | * '''longitude''': geografische Länge (Beispiel: 9.885357)
| + | * added support for generation of wind direction strings in German (dedir) and English (endir) within templates. |
| − | * '''lunarage''': Tage seit Neumond (Beispiel: 28) | + | |
| − | * '''lunarpercent''': Prozentuale Mondphase, 0% für Neumond, 100% für Vollmond
| + | |
| − | * '''lunarsegment''': Mondsegment von 0 (Neumond), über 4 (Vollmond) bis 7.
| + | |
| − | * '''daylength''': Länge des Tages in Stunden und Minuten (Beispiel: "11:28") | + | |
| − | * '''civildaylength''': Alternative Berechnungsmethode der Tageslänge. | + | |
| − | * '''nauticaldaylength''': Alternative Berechnungsmethode der Tageslänge. | + | |
| − | * '''sunrise''': Sonnenaufgang, der durch Anhängen von "=utc" in UTC anstelle der lokalen Zeit angegeben werden kann (Beispiel: "06:47", resp. "05:47"). | + | |
| − | * '''sunset'''. Sonnenuntergang, der durch Anhängen von "=utc" in UTC anstelle der lokalen Zeit angegeben werden kann (Beispiel: "18:15", resp. "17:15").
| + | |
| − | * '''civilsunrise''', '''civilsunset''', '''nauticalsunrise''', '''nauticalsunset''': Alternative Berechnungsmethode der Sonnenauf- und -untergangszeiten.
| + | |
| − | * '''daynightflag''': zeigt "D" für Tag und "N" für Nacht.
| + | |
| − | * '''moonrise''': Zeit der Mondaufgangs, die durch Anhängen von "=utc" in UTC anstelle der lokalen Zeit angegeben werden kann. Es ist zu beachten ,d ass es Tage ohne Mondaufgang gibt, die Variable existiert dann nicht.
| + | |
| − | * '''moonset''': Zeit der Monduntergangs, die durch Anhängen von "=utc" in UTC anstelle der lokalen Zeit angegeben werden kann. Es ist zu beachten ,d ass es Tage ohne Monduntergang gibt, die Variable existiert dann nicht.
| + | |
| | | | |
| − | ==Zeit/Datums-Variable== | + | ====Version 1.2==== |
| − | Die Ausgaben der aktuellen Zeit oder des aktuellen Datums entspricht nicht dem "Sensor-Selektor=Konverter" Schema, sondern ist wie folgt definiert.
| + | released 29th March 2013: |
| | + | includes all previous updates, plus |
| | + | * adds signal strength to SSID drop-down list |
| | + | * fixes a configuration bug that prevents from reading data from WS2300 type stations |
| | | | |
| − | Datum und Uhrzeit ist wie folgt definiert:
| + | minor updates, added on 17th March 2013: |
| − | * '''YYYY''': Jahr, vierstellig
| + | * make remote login for support services an option that a user can permanently disable |
| − | * '''YY''': Jahr, zweistellig
| + | * adds better support for Vantage extra sensors |
| − | * '''MM''': Monat, zweistellig (ggf mit führender Null) | + | |
| − | * '''M''': Monat (ohne führende Null) | + | |
| − | * '''DD''': Tag, zweistellig (ggf mit führender Null)
| + | |
| − | * '''D''': Tag (ohne führende Null)
| + | |
| − | * '''hh''': Stunde, zweistellig (ggf mit führende Null)
| + | |
| − | * '''h''': Stunde (ohne führende Null)
| + | |
| − | * '''mm''': Minuten, zweistellig (ggf mit führender Null)
| + | |
| − | * '''m''': Minuten (ohne führende Null)
| + | |
| − | * '''ss''': Sekunden, zweistellig (ggf mit führender Null)
| + | |
| − | * '''s''': Sekunden (ohne führende NuLL)
| + | |
| − | Wenn ein großes "U" vorangestellt ist, wird mit Weltzeit gearbeitet (UTC), ansonsten mit lokaler Zeit. Beispiel: "[Uhh]:[Umm]:[Uss] UTC" wird zu einer Zeichenkette der Art "16:03:33 UTC" übersetzt
| + | |
| | | | |
| − | ==Nachkommastellen==
| + | minor updates, added on 16th March 2013: |
| − | Sofern nicht anders definiert werden Zahlen mit einer Dezimalstelle berichtet. Durch Setzen des Wertes für die Nachkommastellen kann die Anzahl der bei der Ausgabe verwendten Dezimalstellen bestimmt werden.
| + | * fixes a bug that might have caused Meteobridge to stall after a while when sending data to CWOP |
| | | | |
| − | Wenn die Variable einen Zeichenkette anstelle einer Zahl zurückliefert - wie beispielsweise bei Zeitstempeln -, dann hat die "Nachkommastellen"-Definition eine andere Form und Bedeutung. Die Angabe enthält dann zwei Positionszeichen, die die Start- und eine Endeposition des herausuzulösenden Sub-Strings bezeichnen. Die Positionszeichen sind Kleinbuchstaben. Der erste gibt die Startposition an. "a" steht für das erste Zeichen der Zeichenkette, "b" für das zweite, etc. Das zweite Positionszeichen hat dieselbe Form und gibt das letzte Zeichen der herauszulösdenden Zeichenkette an. Beispiel: Aus dem Zeitstempel "20130303121055" werde mit den Positionszeichen ".ad" die ersten vier Zeichen selektiert. Wenn man die zeit der tiefsten Außentempratur des heutigen Tages erhalten möchte, kann man das Template <font face="Courier"><span style="background-color:lightgrey;">[th0temp-dmintime.ij:--]:[th0temp-dmintime.kl:--]</span></font face> verwenden. "ij" selektieren den Stundenwert an Position 9-10 und "kl" den Minutenwert an Position 11-12 des Zeitstempels.
| + | minor updates, added on 11th March 2013: |
| | + | * additional system variables as described in section [[Templates#System Variables]] |
| | | | |
| − | ==Ersatzzeichenkette==
| + | minor updates, added on 9th March 2013: |
| − | Wenn eine Variable nicht definiert ist oder keinen gültigen Wert liefern kann, wird die spezifizierte Ersatzzeichenkette ausgegeben, die auch leer sein kann. Fehlt die Angabe der Ersatzzeichenkette bleibt die Variabledefinition unverändert in der Zeichenkette stehen und wird nicht ersetzt.
| + | * support of additional temp/hum sensors for vantage, additional temp data to be reported to Weather underground (if there) |
| | + | * setup your own weather website setup with the help of "saratoga templates" (http://saratoga-weather.org/wxtemplates/setup-Meteobridge.php) |
| | | | |
| − | ==Beispiele== | + | ====Version 1.1==== |
| − | Anbei ein paar Beispiele, die helfen, den Ersetzungsmechanismus besser zu verstehen.
| + | released 5th March 2013: |
| | + | * more variables for templates (full documentation at http://www.meteobridge.com/wiki/index.php/Templates) |
| | + | * balloon help on live data tab does show sequence of values for live data and time of min/max events for historical data. |
| | + | * added weather network http://www.previmeteo.com |
| | + | * length of paylod text fields for push services have been enlarged to 4000 characters |
| | + | * some bugs around swapped min/max historical values are fixed |
| | | | |
| − | # Template <font face="Courier"><span style="background-color:lightgrey;">Outdoor temperature is [th0temp-act=F.1:--]°F</span></font face> wird umgewandelt in <font face="Courier"><span style="background-color:lightgrey;">Outdoor temperature is 3.4°F</span></font face>, wenn keine Außentemperatur vorliegt erscheint <font face="Courier"><span style="background-color:lightgrey;">Outdoor temperature is --°F</span></font face>.
| + | ====Version 1.0==== |
| − | # Template <font face="Courier"><span style="background-color:lightgrey;">Local time is [hh]:[mm]</span></font face> wird umgewandelt in <font face="Courier"><span style="background-color:lightgrey;">Local time is 09:27</span></font face>.
| + | * inital release |
| − | # Template <font face="Courier"><span style="background-color:lightgrey;">Max gust in last 10 minutes was: [wind0wind-max10.1:--]m/s, [wind0wind-max10=mph.1:--]mph, [wind0wind-max10=kn.0:--]kn</span></font face> wird umgewandelt in <font face="Courier"><span style="background-color:lightgrey;">Max gust in last 10 minutes was: 10.5m/s, 23.5mph, 20kn</span></font face>.
| + | |
Meteobridge is a device that is easy to use and which should not raise a demand for extensive support. However, there is a forum, where you can share experiences, questions, wishes with other users.
Please make use of this in favor to emails, as a wider public can participate of your insights and problem resultion recipes.
To get the latest relaease running on your rig, just do a reboot or power-cycle.
