Getting Started

From Meteoplug Wiki

Jump to: navigation, search

This section describes how to setup your Meteoplug client hardware and how to get it connected to Meteoplug server. It also explains basic settings to be done. If your are interested in a complete functional description of Meteoplug, please have a look at the Documentation, also presented in the menu on the left. This section just describes the first steps to do, to get operational with Meteoplug. When you follow the steps on this page you should have a running Meteoplug system without any major hassle.

Contents

Setup of Meteoplug Client Hardware

This section describes the steps necessary to setup your Meteoplug client.

Meteohub System as Meteoplug Client

When you have a Meteohub system this can also be used to feed Meteoplug server application. Please goto "settings tab and enable upload of data to Meteoplug server.

File:Meteohub-data-upload.png

Having done this you should notice the MAC of your Meteohub system. Meteohub displays the MAC on tab "System Information". You will need the MAC when registering for an account at Meteoplug server application.

Bifferboard as Meteoplug Client

Bifferboard development environments are well described on Bifferboard Product and Bifferboard Wiki. Actual Meteoplug client Image is a minimal Linux 2.6.30.5 kernel with the proposed patches applied and a minimal loader, that loads the recent Meteoplug client software from the Meteoplug server. This takes care that each time your Meteoplug client gets rebooted, you will get the most recent SW version. So you never have to bother yourself with applying SW updates.

When you are using a Bifferboard as Meteoplug client you are facing one of these situations

  • Your Bifferboard is already flashed with a Meteoplug client image. In that case you can skip flashing instructions chapter. You will find Bifferboards already flashed with Meteoplug client software and ready to here.
  • Your Bifferboard has a standard image installed and needs to be flashed with a Meteoplug image as explained in next paragraphs.

Flashing Meteoplug Client Image to Bifferboard

Flashing is done by a Python script that connects to a just booting Bifferboard via LAN and sends the packets to be stored in flash storage as ethernet packets. You need a Linux system running, which has Python installed. Furthermore you need following files:

  • Python script that does the flashing: File:Bb-eth-upload.zip (please download and unzip)
  • Meteoplug client image for Bifferboard: File:Mp-bb-image.zip (please download and unzip)
  • MAC of your Bifferboard. Mac has format xx:xx:xx:xx:xx:xx where "xx" stands for a two digit hexadecimal number. You will find MAC of your Bifferboard written on a sticker on one of the chips on the PCB or in the documentation received with it.

Connect Bifferboard to be flashed to your LAN, reboot Bifferboard by repowering it, and start downloaded script on your Linux box by python bb_eth_upload.py eth0 a1:b2:c3:d4:e5:f6 mp-bb-image, where "a1:b2:c3:d4:e5:f6" must be replaced by MAC of your Bifferboard. The MAC is needed to address the correct board. Without a correct MAC, no flashing will start. You will see on your console that buckets from flash storage first being erased and then written the new data to. After flashing is complete Bifferboard will reboot.

When you discover problems during flashing, please consult this page as you are facing a Bifferboard related issue, I can provide very limited help on.

Start Meteoplug Bifferboard Client

Connect your flashed Bifferboard to your LAN and weather station and power it on.

Get Adobe Flash player

Meteoplug client will connect Meteoplug server in the Internet. This requires that your LAN is connected to the Internet by a router, which also provides an IP address by DHCP service. All routers out there have a DHCP feature. Please make sure that it is enabled. As an alternative you might have a dedicated DHCP server in your LAN, which is also fine. In addition to the IP address Meteoplug client also needs the IP of the gateway to address the Internet and IP of a DNS (domain name server) in the Internet. But don't worry, your router normally provides all this information and your Meteoplug client will probably be able to connect Meteoplug server in the Internet. If this does fail for some reason you don't have much options. Meteoplug client is fully controlled by the server application. It cannot work without this.

What you might check in case of trouble is that your router is not blocking outgoing HTTP traffic on port 80. Normally, that kind of traffic is allowed for all IPs in the LAN, but your router might have some special settings (like "Kindersicherung" in AVM Fritz!boxes) blocking this until you explicitly select a LAN IP to be able to access the Internet. Meteoplug client does not need any incoming ports opened, as it is not going to be connected from the outside. Direction of traffic is outgoing only.

Regular Linux System as Meteoplug Client

When you want to use an already running X86 Linux box as Meteoplug client, you simply have to download this package:File:Generic-image.tgz. Installation is described in the attached README. According to the distribution you are using, some individual changes might be necessary, hopefully not too complicated ones. You can also post into the Meteoplug forum, when you need help or want to share experiences about this.

Fritz!Box 7270 as Meteoplug Client

You can use a Fritz!Box 7270 as Meteoplug client. All you have to do is to install this package File:Meteoplug-7270-install.img on the 7270. You simply do that by the web interface used for AVM updates. When you upload the package, your 7270 will warn you that it is not a regular AVM image. When you accept that, Meteoplug client will be installed as an additional package on your 7270. If you have a non-stock firmware running or have other additional packages installed there might be problems. However, by installing Meteoplug client you accept that this can happen and in worst case can "brick" your 7270. When you want to uninstall Meteoplug, please install this uninstaller package File:Meteoplug-7270-uninstall.img. A few minutes after installation you can view Meteoplug client dashboard by browsing to your 7270 LAN IP on port 7770. When this works, installation of Meteoplug client on 7270 has gone fine.

Meteoplug Server Application

When you have done steps above you should leave your Meteoplug client powered and connected. You can merely forget about it, because no interaction with it will be necessary in the future. It will just be there and sends data.

Create an Account

Please login at http://login.meteoplug.com. You will see a screen like this were you can login or - as a first time user - can register an account.

File:mp-user-admin.png

To register an account first step is to specify the MAC of the device the account should be created for. If you are lucky - and most times you will be - your Meteoplug client has already made a first contact with Meteoplug server an have told the server its MAC and which IP your router does use to connect from the Internet. If your browsing PC and your Meteoplug client share the same connection to the Internet, the server application already knows the MAC of your client and will present as in a "select MAC" drop-down menu for selection. If no MAC is provided, you will have to type in the MAC of your Meteoplug client. Please use standard MAC notation (xx:xx:xx:xx:xx:xx).

Next things to fill in are a user name of your choice. User names are restricted to alphas and numbers, please don't make use of special characters as these will be rejected and/or might produce trouble later on. Password has to be at least 6 characters long and has to consist of alphas and numbers only. Next is your email address. This has to be a valid address, because your account will need an activation by replying to an email that will be send to the given address.

When you have finished input in the register section, please press "register". An email will be send to the given address. This email contains a link which activates the requested account for operation. The email also includes the user name and password for your personal reference. Please keep this data at a secure place. It might take a few minutes until the email will arrive at your mailbox. I you don't find it there after 15 minutes, please check your spam folder. The mail might have been dropped there for unknown reasons. Clicking the link in the email will activate your account. Now you have a free demo period of 30 days activated and can make full use of Meteoplug's features. This allows you to do a intensive test drive before licensing Meteoplug for a 12 months period.

When you have logged in at Meteoplug for the first time, please go to "license" page. You will be asked to accept license conditions by setting a mark at the corresponding check box and have to press the "I accept" button. When you don't accept the license terms, your usage of Meteoplug comes to an end now as this is mandatory and you will not be able to reach the other admin pages without that.

File:mp-license.png

Complete Initial Settings

Go to "Settings" tab and provide following information:

File:mp-settings.png
  • Select your preferred language (German and English is available from the beginning, more languages might be added later on).
  • Select your time zone, resp. the timezone your weather station is positioned in. This setting is very important to make graphs etc right later on.
  • Give exact coordinates of the position of your weather station. Coordinates are entered in degrees, minutes and seconds (just as integers). If you have decimal positions, please use a service like this to compute the needed numbers from that.
  • Select a standard upload interval and a shorter interval being used during first 10 minutes after reboot of the client and after a change in client configuration.

Finally, press "Save" to make your changes effective.

Select Weather Station

Select the weather station connected to your Meteoplug client from the drop down list. You will see that the screen updates and allows for additional settings for the selected weather station. In the example below a WMR-928 weather station has been selected and a module reporting system status data has been selected as a second "weather station".

File:mp-weather-station.png

Depending on your weather station you have to make further settings.

  • Type of Connection: Here you specify how your weather station is connected. Normally that will be USB serial or USB HID. When you have a look at the top of the screen you will see a report from your Meteoplug client that indicates what type of connection has been detected. If "USB serial" is listed with a device, you should make use of "USB serial". When you see a device listed as USB HID, please make use of "USB HID". When you do connect to an IP enabled weather station, you should use "TCP/IP".
  • Device: This defines the exact device Meteoplug should connect to. If you have "USB serial" selected as connection type you can choose from a drop-down list. Usually the device will be "/dev/ttyUSB0". When it is a "USB HID" connection type, no further device information needs to be specified. When using an IP weather station. please enter IP or name of weather station and port number to connect to, separated by a colon (example, 192.168.1.99:10001).

When you press "Save" your settings will be stored and Meteoplug client will apply settings next time it connects to Meteoplug server. This will happen at intervals yous have defined on "Settings" tab.

Assign Sensors

The idea of "Sensors" page is to define unique IDs to the sensors reported from your weather station, resp your weather stations if you have more than one connected to your Meteoplug client.

Each connected station is displayed in a rectangular field which lists all sensors reported. To help you finding out which sensor is reported where, the type of the sensor is displayed as well as the given number, if it is a sensor that has been given a certain number by the weather station. Your task is to select an ID from the drop-down list of all received sensors. Please select "th0" to be your primary outdoor temperature/humidity sensor. This is necessary as some kinds of wind chill computation might take the sensor as reference. All other IDs you can select as you like. In addition to selecting an ID you can also specify a Name which might make remembering what sensor the ID represents more easy later on.

File:mp-sensors.png

Press "Save" to make your changes being stored. Changes will be reported to your Meteoplug client next time it connects the server.


This video demonstrates server setup step-by-step as described above.

Get Adobe Flash player

Instruments

On "Instruments" page you have to select the sensor IDs to be taken for display as weather instruments. This needs some amount of weather data being recorded. If you don't get meaning full values right after setup, please wait some minutes (depends on chosen data upload interval).

You have to select sensor IDs to take values from. In addition to that you can also provide:

  • a station name to be displayed
  • Language to be used for instruments display
  • Measurement units to be used
File:mp-instruments.png

When you want to embed the instruments display into your website, just copy the URL available at "Call instruments as URL" into following IFRAME statements on your home page.

<iframe src="https://www.meteoplug.com/cgi-bin/meteochart.cgi?draw=...your...specific...code..." 
        allign="top" 
        scrolling="no" 
        frameborder="0"
        width="550"
        height="400"> 
    Browser does not support IFRAMEs
</iframe>
This page was last modified on 3 August 2011, at 07:19. This page has been accessed 12,456 times.