Difference between pages "Templates" and "Forum"

From meteoplug
(Difference between pages)
Jump to: navigation, search
(Examples)
 
 
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
Meteobridge provides a very flexible mechanism to smuggle sensor data of different kinds into strings to be used by Meteobrdge push services like Twitter, HTTP GET uploads or MSQL database insert requests.
+
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.  
Simply type in the text you want to upload and represent the pieces of sensor data by so called variables. When data gets uploaded, these variables will be replaced by current sensor data and so a string filled with the data you intended will be uploaded.
+
  
Each variable starts with an opening square bracket "[" and is terminated by a closing square bracket "]". The structure of the variable name between these brackets is as follows: <pre>sensor-selector=converter.decimals:replacement</pre>
+
Please make use of this in favor to emails, as a wider public can participate of your insights and problem resultion recipes.  
"converter", "decimals" and "replacement" can be omitted, "sensor" and "type" are mandatory.
+
While "sensor" tells what sensor and what piece of information of the sensor to use, "selector" decides data from what time period should be taken into account and "converter" does convert data into measurement units the user likes most. "Decimals" decides about precision the result should be shown in and "replacement" gives the string to be returned when there is no data for defined sensor available.
+
  
==Sensors==
+
Forum is part of Meteohub Forum: [http://forum.meteohub.de/viewforum.php?f=54&sid=c8736ec03d0ef75afa55c16f324623bd Meteobridge Forum]
These sensors are defined in Meteobridge.
+
* '''th0temp''': outdoor temperature in degrees Celsius
+
* '''th0hum''': relative outdoor humidity as percentage
+
* '''th0dew''': outdoor dew point in degrees Celsius
+
* '''thb0temp''': indoor temperature in degrees Celsius
+
* '''thb0hum''': indoor humidity as percentage
+
* '''thb0dew''': indoor dewpoint in degrees Celsius
+
* '''thb0press''': station pressure in hPa
+
* '''thb0seapress''': normalized pressure (computed to sea level) in hPa
+
* '''wind0wind''': wind speed in m/s
+
* '''wind0avrwind''': average windspeed in m/s (time used for average depends on station)
+
* '''wind0dir''': wind direction in degress (0° is North)
+
* '''wind0chill''': wind chill temperature in degrees Celsius
+
* '''rain0rate''': rain rate in mm/h
+
* '''rain0total''': rain fall in mm
+
* '''uv0index''': uv index
+
* '''sol0rad''': solar radiation in W/m^2
+
If a sensor is not there or data of sensor has passed the "tolerated data age" interval, Meteobridge will not provide data for it and will present the value defined as "replacement". If no replacement is given, variable will not be converted into data but will stay as is.
+
  
==Selectors==
+
===Release Log===
Sensors are followed by a selector (syntactically separated by a dash) that specifies what period in time should be used for evaluation. Valid selectors are:
+
To get the latest relaease running on your rig, just do a reboot or power-cycle.
* '''act''': most recent data
+
* '''hmin''': minimum value of this hour
+
* '''hmax''': maximum value of this hour
+
* '''dmin''': minimum value of today
+
* '''dmax''': maximum value of today
+
* '''mmin''': minimum value of this month
+
* '''mmax''': maximum value of this month
+
* '''hmin''': minimum value of this year
+
* '''hmax''': maximum value of this year
+
* '''hmin''': minimum value of all time
+
* '''hmax''': maximum value of all time
+
  
Apart from selectors that use absolute, predefined time slots there are also selectors that look for a certain amount of time into the past.
 
* '''max2''', '''max5''', '''max10''', '''max15''', '''max30''', '''max60''': selects the maximum value from the last 2, 5, 10, 15, 30 or 60 minutes
 
* '''min2''', '''min5''', '''min10''', '''min15''', '''min30''', '''min60''': selects the minimum value from the last 2, 5, 10, 15, 30 or 60 minutes
 
* '''avg2''', '''avg5''', '''avg10''', '''avg15''', '''avg30''', '''avg60''': selects average value from the last 2, 5, 10, 15, 30 or 60 minutes
 
* '''sum2''', '''sum5''', '''sum10''', '''sum15''', '''sum30''', '''sum60''', '''sumday''': selects summerized delta values from the last 2, 5, 10, 15, 30, 60 minutes or current day (useful to get amount of total rain in a certain time frame: "rain0total-sum60" is rainfall im mm of last 60 minutes, "rain0total-sumday" is todays rain fall)
 
  
==Converters==
+
====Current Version====
Sensor data is reported in ISO units (°C, hPa, mm, m/s) by default, but can be converted into non-ISO units (imperial) by adding a conversion token. Defined tokens are:
+
released 12th May 2013:
* '''F''' converts temperature from Celsius to Fahrenheit.
+
* support for Acurite USB stations 1025/1035/1525
* '''psi''' converts pressure from hPa (equivalent to mbar) to psi.
+
* '''mmHg''' converts pressure from hPa to millimeters of mercury.
+
* '''inHg''' converts pressure from hPa to inches of mercury.
+
* '''kmh''' converts wind speed from meters per second to kilometers per hour.
+
* '''mph''' converts wind speed from meters per second to miles per hour.
+
* '''kn''' converts wind speed from meters per second to knots.
+
* '''bft''' converts wind speed from meters per second to Beaufort scale.
+
* '''in''' converts millimeters to inches.
+
If an unknown conversion string is used, no conversion will take place, no error message will appear.
+
  
==Special Variables==
+
released 6th May 2013:
There are a couple of variables that don't come as "sensor-selector=converter" chains but have a distinct meaning by themselves.
+
* fixes a bug that still prevents from altimeter pressure being used for CWOP
  
Date und time variables are defined as follows:
 
* '''YYYY''': year as four digit number
 
* '''YY''': year as two digit number
 
* '''MM''': month as two digit number, if only one digit neede a zero will be used as first digit
 
* '''M''': month as one or two digit number, no leading zeros
 
* '''DD''': day of month as two digit number, if only one digit neede a zero will be used as first digit
 
* '''D''': day of month as one or two digit number, no leading zeros
 
* '''hh''': hour as two digit number, if only one digit neede a zero will be used as first digit
 
* '''h''': hour as one or two digit number, no leading zeros
 
* '''mm''': minute as two digit number, if only one digit neede a zero will be used as first digit
 
* '''m''': minute as one or two digit number, no leading zeros
 
* '''ss''': seconds as two digit number, if only one digit neede a zero will be used as first digit
 
* '''s''': seconds as one or two digit number, no leading zeros
 
When a capital "U" preceeds a date/time variable name, UTC is used instead of local time ("[Uhh]:[Umm]:[Uss] UTC" is evaluated to a string like "16:03:33 UTC")
 
  
==Decimals==
+
====Version 1.4====
Unless otherwise defined numbers are reported with one decimal. By specifying a value for "decimals" you can determine resolution of presented values.
+
released 3rd May 2013:
 +
* Dutch language support (translations provided by user "Wim")
 +
* changed gust value for weatherbug network to "todays max gust"
 +
* fixes a unit conversion problem with evapotranspiration on solar sensor equipped vantage weather stations
 +
* fixes the low humdity bug for CWOP data transfers
  
==Replacement==
 
When a variable is not defined or there is no data for a specified sensor, information specified as "replacement" string will be represented instead.
 
  
==Examples==
+
====Version 1.3====
Having a look at examples usually helps to understand how easy that is.
+
released 21th April 2013:
 +
* fixes a stability bug on new LOOP2 supporting Davis Vantage drivers
 +
* 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)
 +
* a new firmare release (version 1.2) is ready for download (in "getting started" section). This firmware is only needed when aiming at 3G operation.
  
# Template <font face="Courier"><span style="background-color:lightgrey;">Outdoor temperature is [th0temp-act=F.1:--]°F</span></font face> will be converted into <font face="Courier"><span style="background-color:lightgrey;">Outdoor temperature is 3.4°F</span></font face> when there is outdoor temp data and into <font face="Courier"><span style="background-color:lightgrey;">Outdoor temperature is --°F</span></font face> if outdoor temp sensor does not provide recent data.
+
released 13th April 2013:
# Template <font face="Courier"><span style="background-color:lightgrey;">Local time is [hh]:[mm]</span></font face> will be converted into <font face="Courier"><span style="background-color:lightgrey;">09:27</span></font face>.
+
* 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.
# 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> will be converted into <font face="Courier"><span style="background-color:lightgrey;">Max gust in last 10 minutes was: 10.5m/s, 23.5mph, 20kn</span></font face>.
+
* fixes a problem with send email authentification
 +
 
 +
released 7th April 2013:
 +
* fxing a bug uploading average windspeed to previmeteo
 +
* reduce timeout for mysql connection setup to 6 seconds
 +
* 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
 +
* 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====
 +
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 15:15, 12 May 2013

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.

Forum is part of Meteohub Forum: Meteobridge Forum

Release Log

To get the latest relaease running on your rig, just do a reboot or power-cycle.


Current Version

released 12th May 2013:

  • support for Acurite USB stations 1025/1035/1525

released 6th May 2013:

  • fixes a bug that still prevents from altimeter pressure being used for CWOP


Version 1.4

released 3rd May 2013:

  • Dutch language support (translations provided by user "Wim")
  • changed gust value for weatherbug network to "todays max gust"
  • fixes a unit conversion problem with evapotranspiration on solar sensor equipped vantage weather stations
  • fixes the low humdity bug for CWOP data transfers


Version 1.3

released 21th April 2013:

  • fixes a stability bug on new LOOP2 supporting Davis Vantage drivers
  • 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)
  • a new firmare release (version 1.2) is ready for download (in "getting started" section). This firmware is only needed when aiming at 3G operation.

released 13th April 2013:

  • 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:

  • fxing a bug uploading average windspeed to previmeteo
  • reduce timeout for mysql connection setup to 6 seconds
  • 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
  • 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

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:

minor updates, added on 9th March 2013:

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