Difference between pages "Forum" and "Add-On Services"

From meteoplug
(Difference between pages)
Jump to: navigation, search
 
 
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
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.  
+
<languages /><translate>
 +
<br />Web server of Meteobridge client, which presents web interface for adminstration to you, can also deliver weather data. There are two URLs defined that can be polled to get most recent sensor data in XML or plain text. Although we don't recommend this for security reasons, you can make that URLs accessible from the Internet by configuring your router appropriately. However, when you want to bring sensor data to one of your own servers in the Internet we recommend to make use of Meteobridge's [[Push Services]], which will not need you to open up your firewall.
 +
 +
===Live Data as XML=== <!--T:1-->
 +
By sending the meteobridge a HTTP request like "http://ip-of-meteobridge/cgi-bin/livedataxml.cgi" (where "ip-of-meteobridge" must be replaced by the IP itself) meteobridge returns current weather data in XML notation. Each reply starts witch tag <logger> and ends with </logger> with the sensor data as records with sensor specific tags "THB", "TH", "WIND", "RAIN", "UV", "SOLAR". Example below illustrates the XML format:
  
Please make use of this in favor to emails, as a wider public can participate of your insights and problem resultion recipes.  
+
<!--T:2-->
 +
<pre><logger>
 +
  <THB date="20121227224318" id="thb0" temp="26.0" hum="37" dew="10.2"
 +
      press="1008.8" seapress="1010.1" fc="2"/>
 +
  <TH date="20130104141909" id="th0" temp="9.1" hum="95" dew="8.3"/>
 +
  <RAIN date="20130104141856" id="rain0" rate="0.0" total="3.0" delta="0.0"/>
 +
  <WIND date="20130104141916" id="wind0" dir="109" gust="0.9" wind="2.2" chill="9.1"/>
 +
</logger></pre>
  
Forum is part of Meteohub Forum: [http://forum.meteohub.de/viewforum.php?f=54&sid=c8736ec03d0ef75afa55c16f324623bd Meteobridge Forum]
+
<!--T:3-->
 +
Each sensor data record has a mandatory "date" and "id" parameter. The other parameters are sensor specific. Meaning of parameters is:
 +
* '''date''': UTC timestamp of reception of sensor data in format "YYYYMMDDhhmmss"
 +
* '''id''': Unique ID of sensor, consists of a sensor type description shortcut followed by a number, which is always "0" in Meteobridge, as additional sensors are not supported
 +
* '''temp''': temperature in degrees Celsius (with one decimal)
 +
* '''hum''': relative humidity in percent (no decimals)
 +
* '''dew''': dew point temperature in degrees Celsius (with one decimal)
 +
* '''press''': station pressure (without altitude correction) in hPa (with one decimal)
 +
* '''seapress''': normalized pressure with altitude correction (also called sea level pressure) in hPa (with one decimal)
 +
* '''fc''': stations forecast code, if provided. As this has low evidence and also largely varies between stations, meteobridge does not recommend to make use of this data.
 +
* '''rate''': measured rain rate in mm per hour (with one decimal).
 +
* '''total''': current value of rain bucket counter, converted to mm (with one decimal).
 +
* '''delta''': additional rain fall in mm since previous readout of this data (with one decimal).
 +
* '''wind''': current average wind speed im m/s (with one decimal).
 +
* '''gust''': curent not avergaed wind speed in m/s (with one decimal).
 +
* '''dir''': wind direction in degrees (0-359, no decimals).
 +
* '''chill''': wind chill temperature in degrees Celsius (with one decimal).
 +
* more to come...
  
===Release Log===
+
===Live Data as Plain Text=== <!--T:4-->
To get the latest relaease running on your rig, just do a reboot or power-cycle.
+
By sending the meteobridge a HTTP request like "http://ip-of-meteobridge/cgi-bin/livedata.cgi" (where "ip-of-meteobridge" must be replaced by the IP itself) meteobridge returns current weather data as plain text. Each reply consists of a series of lines, where each line represnets a sensor. Lines do start with a time stamp and a unique sensor id followed by sensor specific parameters. Example below illustrates the format:
  
 +
<!--T:5-->
 +
<pre>20130104142614 thb0 26.9 38 11.4 1020.4 1021.7 2
 +
20130104142610 rain0 0.0 3.0 0.0
 +
20130104142636 th0 9.1 95 8.3
 +
20130104142652 wind0 160 2.2 1.8 8.0</pre>
 +
</translate>
  
====Current Version====
+
===Data via Socket Connection===
released 13th April 2013:
+
Methods introduced above do need HTTP authentification like all elements of Meteobridge web interface. A look at the script "livedataxml.cgi" shows that this just reads data from socket 5557, gives it a suitable HTTP header and returns that to the requesting browser:
* 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
+
  
released 7th April 2013:
+
<pre>#!/bin/sh
* fxing a bug uploading average windspeed to previmeteo
+
echo -ne "Content-type: text/xml; charset=UTF-8\n\n"
* reduce timeout for mysql connection setup to 6 seconds
+
nc 127.0.0.1 5557 2>/dev/null
* 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
+
</pre>
* removing evapotranspiration values (which did appear randomly) from solar sensor data, if not Vantage station.
+
* adding a display that shows how much of internal data send buffer is currently occupied (system tab)
+
* reducing memory footprint of data send process to avoid triggering oom linux mechanisms
+
* doing a reboot in case of oom situations by issueing a kernel panic instead of trying to stop some applications via oom_killer.
+
* added support for generation of wind direction strings in German (dedir) and English (endir) within templates.
+
  
====Version 1.2====
+
Therefore, reading data from socket 5557 is equivalent to calling "livedataxml.cgi" and socket 5556 reports same data as delivered by "livedata.cgi".
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
+
 
+
minor updates, added on 17th March 2013:
+
* make remote login for support services an option that a user can permanently disable
+
* adds better support for Vantage extra sensors
+
 
+
minor updates, added on 16th March 2013:
+
* fixes a bug that might have caused Meteobridge to stall after a while when sending data to CWOP
+
 
+
minor updates, added on 11th March 2013:
+
* additional system variables as described in section [[Templates#System Variables]]
+
 
+
minor updates, added on 9th March 2013:
+
* 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)
+
 
+
====Version 1.1====
+
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
+
 
+
====Version 1.0====
+
* inital release
+

Revision as of 08:53, 20 April 2013


Web server of Meteobridge client, which presents web interface for adminstration to you, can also deliver weather data. There are two URLs defined that can be polled to get most recent sensor data in XML or plain text. Although we don't recommend this for security reasons, you can make that URLs accessible from the Internet by configuring your router appropriately. However, when you want to bring sensor data to one of your own servers in the Internet we recommend to make use of Meteobridge's Push Services, which will not need you to open up your firewall.

Live Data as XML

By sending the meteobridge a HTTP request like "http://ip-of-meteobridge/cgi-bin/livedataxml.cgi" (where "ip-of-meteobridge" must be replaced by the IP itself) meteobridge returns current weather data in XML notation. Each reply starts witch tag <logger> and ends with </logger> with the sensor data as records with sensor specific tags "THB", "TH", "WIND", "RAIN", "UV", "SOLAR". Example below illustrates the XML format:

<logger>
  <THB date="20121227224318" id="thb0" temp="26.0" hum="37" dew="10.2" 
       press="1008.8" seapress="1010.1" fc="2"/>
  <TH date="20130104141909" id="th0" temp="9.1" hum="95" dew="8.3"/>
  <RAIN date="20130104141856" id="rain0" rate="0.0" total="3.0" delta="0.0"/>
  <WIND date="20130104141916" id="wind0" dir="109" gust="0.9" wind="2.2" chill="9.1"/>
</logger>

Each sensor data record has a mandatory "date" and "id" parameter. The other parameters are sensor specific. Meaning of parameters is:

  • date: UTC timestamp of reception of sensor data in format "YYYYMMDDhhmmss"
  • id: Unique ID of sensor, consists of a sensor type description shortcut followed by a number, which is always "0" in Meteobridge, as additional sensors are not supported
  • temp: temperature in degrees Celsius (with one decimal)
  • hum: relative humidity in percent (no decimals)
  • dew: dew point temperature in degrees Celsius (with one decimal)
  • press: station pressure (without altitude correction) in hPa (with one decimal)
  • seapress: normalized pressure with altitude correction (also called sea level pressure) in hPa (with one decimal)
  • fc: stations forecast code, if provided. As this has low evidence and also largely varies between stations, meteobridge does not recommend to make use of this data.
  • rate: measured rain rate in mm per hour (with one decimal).
  • total: current value of rain bucket counter, converted to mm (with one decimal).
  • delta: additional rain fall in mm since previous readout of this data (with one decimal).
  • wind: current average wind speed im m/s (with one decimal).
  • gust: curent not avergaed wind speed in m/s (with one decimal).
  • dir: wind direction in degrees (0-359, no decimals).
  • chill: wind chill temperature in degrees Celsius (with one decimal).
  • more to come...

Live Data as Plain Text

By sending the meteobridge a HTTP request like "http://ip-of-meteobridge/cgi-bin/livedata.cgi" (where "ip-of-meteobridge" must be replaced by the IP itself) meteobridge returns current weather data as plain text. Each reply consists of a series of lines, where each line represnets a sensor. Lines do start with a time stamp and a unique sensor id followed by sensor specific parameters. Example below illustrates the format:

20130104142614 thb0 26.9 38 11.4 1020.4 1021.7 2
20130104142610 rain0 0.0 3.0 0.0
20130104142636 th0 9.1 95 8.3
20130104142652 wind0 160 2.2 1.8 8.0

Data via Socket Connection

Methods introduced above do need HTTP authentification like all elements of Meteobridge web interface. A look at the script "livedataxml.cgi" shows that this just reads data from socket 5557, gives it a suitable HTTP header and returns that to the requesting browser:

#!/bin/sh
echo -ne "Content-type: text/xml; charset=UTF-8\n\n"
nc 127.0.0.1 5557 2>/dev/null

Therefore, reading data from socket 5557 is equivalent to calling "livedataxml.cgi" and socket 5556 reports same data as delivered by "livedata.cgi".