= A guide to wimax measurement tools =
== Description ==
Collects Wimax radio link parameters with corresponding GPS coordinates and sends to OML server.
The following parameters are recorded and sent to the OML server: Center frequency, RSSI, CINR , Transmit power, Time from GPS, Latidute, Longitude, Altitude.

== Software Requirements ==
1. ''oml2-server'': OML measurement collection server. Note: this server may be locally installed on the mobile.

2. ''gpsd'': GPS service daemon running locally. Information on ''gpsd'' can be found on http://gpsd.berlios.de/

3. ''wimax_gps_oml2'': Wimax measurement application.

== Hardware Requirements ==
1. ''GPS receiver'': for example a Garmin USB Receiver -  model#: GPS18x-5Hz. Other compatible GPS models can be found on http://gpsd.berlios.de/hardware.html

== Installation / setup procedures ==
1. Edit the '''/etc/apt/sources.list''' and add the following line:
    {{{
    deb http://packages.orbit-lab.org/ubuntu jaunty main
    }}}

2. Update information based on the changed sources.list.
    {{{
     sudo apt-get update
    }}}

3. Install the Wimax measurement application (wimax_gps_oml2) and the GPS Daemon (gpsd)
    {{{
     sudo apt-get install wimax-gps-oml2
    }}}

4. If measurements are to be collected locally install the oml2-server otherwise this step may be skipped.
    {{{
     sudo apt-get install oml2-server
    }}}

5. Attach GPS receiver to mobile. At this point please refer to http://gpsd.berlios.de/troubleshooting.html and verify that GPS is able to send data and also able to talk to ''gpsd''.


== Usage ==
1. Refer to http://gpsd.berlios.de/troubleshooting.html and verify the GPS receiver is able to send data and also able to talk to ''gpsd''.

2. Verify ''oml2-server'' is running
{{{
ps -elf | grep oml2-server
}}}

If needed restart oml2-server:
{{{
/etc/init.d/oml2-server restart
}}}

3. Verify ''gpsd'' is running
{{{
ps -elf | grep gpsd
}}}

If needed restart gpsd. Note: /dev/tty* name may be different. Refer to gpsd troubleshooting to find correct /dev/tty* name. This will start gpsd as a daemon.
{{{
gpsd /var/run.gpsd.sock /dev/ttyUSB0
}}}

4. Run ''wimax_gps_oml2'' collection application.
{{{
./wimax_gps_oml2 --oml-id 4 --oml-exp-id exp4 --oml-server localhost:3003
}}}

== Troubleshooting GPS Service Daemon ==
Please refer to troubleshooting ''gpsd'' please refer to http://gpsd.berlios.de/troubleshooting.html.