A guide to wimax measurement application: wimax_gps_oml2

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:3003mple 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. 
   

Troubleshooting GPS Service Daemon

Please refer to troubleshooting gpsd please refer to ​http://gpsd.berlios.de/troubleshooting.html.

Post processing data

After the application is run, it'll create an sql file on the oml server. Processing of this file to extract the measured data can be done in several ways.

Sample data

Here's a snapshot of the sample data collected around the Wimax BS at Rugters Winlab.