Difference between revisions of "PRO Tutorial"

Revision as of 00:24, 12 January 2016

This page lines out some Meteobridge PRO specific how-tows

Optimize RF Reception

Meteobridge PRO (red cap model) has a RF receiver included to directly pick-up data from Davis outdoor sensors. Compared to a Davis console where only very little computing stuff is happening, we have a high density of sensors, computing modules, Ethernet circuitry and even a WiFi module all together in a very compact housing.

To keep RF noise away from the reading Davis sensor data, we designed an external antenna. The antenna shipped with Meteobridge PRO is quite good in RF operation and picks up about 5 db more signal strength than the wire antenna of Meteostick does. However, if your sensors are far away some tweaking of RF reception might be necessary.

This section of the tutorial explains what you can do if you need improved RF sensitivity.

Turn the Meteobridge PRO into an RF strength meter and find a good place to rest

Before you start experimenting how to improve RF reach we recommend to run through the following steps:

1. Configure your Meteobridge PRO to connect via WiFi with your network. As you might want to move the Meteobridge PRO and test for various locations, having an Ethernet cable hanging around will be annoying.
2. 
   Configure your Meteobridge PRO to make use of the internal RF functions and configure "Meteostick:Vantage" option according to your needs. Set correct transmitter ID, set bandwidth to "small" and set sensitivity to "-90db" to start with. Picture on the right gives an example how your settings might look like.
3. Power your Meteobridge PRO temporarily with a USB power bank. I assume you have some 5V rechargeable battery with USB plug to feed the Meteobridge PRO laying around. Any cheap power bank for your mobile phone will do. You will need a USB cable that fits into the micro USB power socket of the Meteobridge PRO, but I am sure you have that somewhere in your household. Being on battery and WiFi you have total freedom in checking for a good place for the Meteobridge PRO to rest.
4. 
   Define a display service on "Services" tab that shows RF data from the outdoor sensors on the integrated display and updates the display every 5 seconds. To do so, define a new service of type "Display" and select "Periodical" as it's event type. Press "Add Service Event" and a new event will be added to the list of already defined events. Then specify "every 5 seconds" as interval and select "Meteostick RF Analysis" from the list of pre-defined standard messages. Settings for this service should look like shown on the right picture. Don't be confused by the message text that is automatically inserted. If you want to understand how this works, please have a look at page PRO_Display. For the moment you don't need to know the details ;-)

Having done so the Meteobridge PRO display will show data like this:

Picture on the left shows reception when Meteobridge PRO is directly sitting on my desk with a lamp, some metal enclosures and the metal corpus underneath my desk in direct neighborhood. Values around -70db are not great, but still no problem to receive. When it reaches the -90 db reception will get tough. By moving the Meteobridge less than a meter away to a higher position on a shelf, reception situation improves significantly. You see that on the right picture. Signal strength in the mid -50db is much better and will allow the sensors to go further away without having the connection dropped. By the way, the display is white but my camera makes it look blue sometimes. If you like watching the numbers change, this 30 second movie might be of interest to you (moving black bars on display are just camera artifacts).

No one can tell you what best position will be in your location, but you are highly invited to check out yourself.

Change Antenna

1. replace small antenna by a larger one that better fits to the wave length of your sensors signals.
2. connect an antenna that is not directly mounted to the connector but has some cable to bring the antenna further away from the RF noise the Meteobridge PRO is inevitable producing and by that giving the RF signals more head room by reducing the noise floor.
3. connect to an antenna with some directional characteristic, which can be a small yagi or other form factors. This might be an option to consider when extreme reach needs to be achieved and if you can mount the antenna outdoors as a directional yagi antenna might not fit well to your indoor living style ;-)

Picture on the right shows how the Meteobridge RF SMA female connector looks like and how the antenna SMA male plug is formed. When the antenna plug is a bit too thick to have the power connector inserted underneath, you can cut 1 mm off the white plastic from the micro-USB power plug. Please watch out not to cut too deep. While testing with alternative antennas this works rather uncomplicated. Please realize, that you do this at your own risk and it will void your warranty, so better to choose an antenna with a fitting plug.

We conducted some antenna comparisons for you. We choose a not so good reception position and swapped through different kinds of antennas while checking RF reception level.

On the left you see the Meteobridge PRO with stock antenna, next to it with a 868 MHz "H-Tronic" HT110A antenna and on the right with a multi-band GSM/UMTS antenna 88414 from "delock" which has a rather thick SMA plug and therefore needs the white power plug underneath remodeled a bit with a knife (cutting off 1 mm went fine). As you see these antennas are very close to each other, with the multi-band antenna loosing some ground. From that perspective changing stock antenna with a larger one of the same kind does not make too much of a difference, at least in our test setup.

Console Retransmits

When nothing else helps, you can always ask your Davis console to retransmit packets and to let Meteobridge PRO sniff data from there. As packet retransmits mostly have a lager frequency drift, you need to change the Meteostick settings on "Weather Station" tab regarding bandwidth from "small" to "normal". Furthermore, you have to select the transmitter ID the Console is using for the retransmits. Having the console just a few meters away from the Meteobridge PRO even the worst antenna will do ;-)

FTP Upload of CSV Exports

There have been may requests to upload data of a day or month in some CSV like notation onto a server via FTP. Meteobridge PRO has the building blocks (export function and FTP upload capability) to make this reality. This section explains how to set this up:

Define CSV Schema

The structure of CSV exports is defined by export templates that are user-defined and can be found in PC network share "templates". Export templates have extension ".exp" while the generated exports are stored in "export" folder and have extension ".txt". We start with pre-defined standard template "standard-iso.exp". This template defines a schema where columns show date, time, temperature, humidity, dew point, pressure, wind speed, wind gust, wind direction, rain fall holds these data the following.

## Standard CSV template with data in metric units
##
## date, time, temperature[C], humidity[%], dew point[C], sealevel pressure[hPa], avg wind speed[m/s], gust speed[m/s], winddir, rainfall[mm]<BR>
[YYYY]-[MM]-[DD],[hh]:[mm],[th0temp-avg.1:],[th0hum-avg.0:],[th0dew-avg.1:],[thb0seapress-avg.1:],[wind0avgwind-avg.1:],[wind0wind-max.1:],[wind0dir-avg.0:],[rain0total-sum.1:]

Schedule Generation of Exports

2015-12-13,00:00,4.8,97,4.4,1005.2,0.0,0.0,248,0.0
2015-12-13,00:01,4.8,97,4.4,1005.2,0.0,0.0,248,0.0
2015-12-13,00:02,4.8,97,4.4,,0.0,0.0,248,0.0
2015-12-13,00:12,,,,1004.7,,,,0.0
2015-12-13,00:13,5.1,97,4.7,1004.9,0.0,0.0,180,
2015-12-13,00:14,5.1,97,4.7,1004.7,0.0,0.0,248,0.2
2015-12-13,00:15,5.2,97,4.8,1004.6,0.0,0.0,248,0.0
2015-12-13,00:16,5.2,97,4.8,1004.6,0.0,0.0,248,0.0
2015-12-13,00:17,5.2,97,4.8,1004.5,0.0,0.0,248,0.2
2015-12-13,00:18,5.3,98,5.0,1004.6,0.0,0.0,248,0.0
2015-12-13,00:19,5.3,97,4.9,1004.5,0.0,0.0,248,0.0

Define Upload Service

Doing Data Backups

Restore

Feature that still needs to be implemented is a comfortable restore function from USB stick. We will implement this latest when the first user has a need to restore data from a backup. If you need to restore a backup right now, you simply stop backup services on the web interface, insert the USB stick containing the backup and login via ssh and give these commands:

rm /home/meteohub/test5m.sh       # stop automated service restart
rcloggerd stop                    # stop data logging
/etc/init.d/databased stop        # stop database services
mount /dev/sdb1 /mnt              # mount external USB stick with stored backups
cp /mnt/dbase-xyz /tmp/mnt/dbase  # restore database backup from xyz
umount /mnt                       # unmount external USB stick
reboot                            # restart Meteobridge PRO.

Cleanup of History Data

While Meteobridge just stores average, minimum and maximum values for the current day, yesterday, current month, current year and all time, the new Meteobridge PRO does store data from sensors in a per minute resolution from when you started using Meteobridge PRO. The "History" tab gives you access to all this data and allows you to change, create or delete data on this per minute time resolution. To make yo familiar with how to work with this data, we will run through the use case "How to delete a spike in rain fall caused by cleaning the rain sensors funnel by pouring water through it?".

Find Data to be Corrected

We still remember that rain funnel cleaning was done in December 2015, but not exact day and time. When looking at the year view on rain data (sensor "rain0total") we see that December indeed has a bit high rain readings (abt 60mm).

So we drill down into December 215 and can see that December 7 has a peak with nearly 50 mm rain fall. Looks like this was the day the rain funnel was washed with water.

Next drill-down is on the hours of December 7 shows that we have a peak at 14h.

When reaching detail sof an hours all the minutes are listed as values to allow editing. Here we see that the false reading incident was at 14:33 (marked in orange when moving the mouse over it) and 14:34.

Edit Data Set

Editing is easy. Just click onto the value field you like to edit and you see a dialog opening where you can insert the right values. If you don't add a unit to your input, metric/ISO units are assumed. If you want to insert in imperial units, please add "in", "F", "inhg", "mph" to it. Meteobridge will then convert automatically. When you want the data to be displayed in imperial units as well, please set the "Use Imperial Units" mark on top of the "Edit Data" field. We decide to enter "0" for 14:33 into this dialog.

When having inserted "0" and having pressed enter the screen updates and applies your correction. As you see, rain value has changed to "0.0mm" on 14:33.

As we are bored to repeat that with the false reading next to it (14:34) we decide just to delete this reading. Deletion can be done by clicking onto the time stamp. When moving the mouse over it a balloon help is shown.

After clicking the time stamp this dialog appears to prevent you from deleting data by accident.

When this is done, false reading for December 7 is corrected and monthly rain report looks like this.

New "Large" Weather Data Screens

This time we made a bit more used of the graphical capabilities of the display. Wind direction is illustrated by an oriented line in a circle. You might ask, when first temp curves show up? We'll see ;-) As you might expect having these 8 screens defined is not done before breakfast, but it is also no rocket science. When you are keen for all the details have a look at the wiki section "PRO Display". Code below shows the definition of the screen you see on the right. It starts with a clean up of the screen, then "Helvetica 14pt bold" is selected as font, a white rounded box is drawn with black text "WIND" inside and the white text "mph" to the right.

*addloop b3 5 300 
  #clear\n
  #font helvB14\n
  #color 1\n
  #rbox 0 0 70 18 5\n
  #color 0\n
  #string 8 16 WIND\n
  #color 1\n
  #string 85 16 mph\n
  #font fub30\n
  #string 0 60 [wind0wind-avg1=mph.1:--]\n
  #circle 105 43 20\n
  #if#[wind0avgwind-act=kmh.1:0.0]#then##pline 105 43 20 [wind0dir-act.0:0]\n#else##fi##disc 105 43 4

Next font is changed to "Free Universal 30pt bold" (fub30) and average windspeed of last minute is displayed in mph and with one decimal resolution. On the right side of this a circle is drawn. If average wind speed of last minute is not zero then a line starting from the center of the circle is drawn according to the current wind direction. The last step draws a small filled disc into the center of the circle. Done.