Difference between pages "Live Data" and "Add-On Services"

From meteoplug
(Difference between pages)
Jump to: navigation, search
 
 
Line 1: Line 1:
 +
__NOTOC__
 
<translate>
 
<translate>
−
<!--T:1-->
+
<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.
−
<br />This tab displays data currently transferred by Meteobridge to weather networks and push services. Meteobridge does spool weather data packets that cannot be uploaded for a certain time and tries to upload these later on, regarding if you have selected to go with retries in case of upload failures. However, there are just about 2000 slots for spooled weather data packets. When space is filled, the oldest ones will be dropped. When Meteobridge does a reboot or power cycle, spooled packets are lost, as Meteobridge cannot hold that information in non-volatile storage.
+
 +
===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:
  
 
<!--T:2-->
 
<!--T:2-->
−
[[File:page5.png]]
+
<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>
  
−
==Status== <!--T:3-->
+
<!--T:3-->
−
Status field displays date and time of last upload to selected weather networks and activated push services. Notification includes information, if upload was successful. In case of a successful upload you find a green mark, if it did fail you see a red mark and an error description.  
+
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== <!--T:4-->
+
===Live Data as Plain Text=== <!--T:4-->
−
This section shows current measurements of all sensors Meteobridge has received data for. "Signal" column displays how much time has passed since the last update of the sensor. Measurements are given in metric units and imperial units in parallel. A low battery symbol at the end indicates that battery power of the sensor is towards a critical level. Please inspect your weather station's console to decide if batteries need to be replaced or not, Meteobridge just works with rough estimates on this.
+
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:
  
−
==Historical Data== <!--T:5-->
+
<!--T:5-->
−
Meteobridge also keeps track of some historical data like min/max values of the day, month, year. As this information would be lost during a powercycle or reboot, Meteobridge does store this information on the Meteobridge Internet server in regular intervals. After a restart of your Meteobridge devices data is restored from there so that statistics have a chance to be correct even over a longer time period.
+
<pre>20130104142614 thb0 26.9 38 11.4 1020.4 1021.7 2
−
 
+
20130104142610 rain0 0.0 3.0 0.0
−
<!--T:6-->
+
20130104142636 th0 9.1 95 8.3
−
When you move your mouse over historical data and click, a dialog will pop-up which allows you to change historical values. Current values will be displayed in metric and imperial units. When you input data, you can use metric units (default when no unit is specified) or imperial units, which needs the unit to be added after the digits. Please only use one type of units, don't type in both values. The missing unit will be computed automatically. When you save changes, display will be refreshed and shows data you have updated.
+
20130104142652 wind0 160 2.2 1.8 8.0</pre>
−
 
+
−
<!--T:7-->
+
−
"Erase" button gives you the option to get rid of all historical data. Before data is deleted a pop-up dialog appears to make sure you really want to erase your historical data.
+
 
</translate>
 
</translate>

Revision as of 03:35, 26 February 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
Retrieved from "https://wiki.meteoplug.com/wiki/index.php?title=Live_Data&oldid=1665"