close Warning: Can't synchronize with repository "(default)" (/common/SVN/wimax does not appear to be a Subversion repository.). Look in the Trac log for more information.

Changes between Initial Version and Version 1 of WiMAX/30/02


Ignore:
Timestamp:
May 5, 2011, 2:37:34 PM (10 years ago)
Author:
seskar
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • WiMAX/30/02

    v1 v1  
     1= A guide to wimax measurement application: wimax_gps_oml2 =
     2== Description ==
     3Collects Wimax radio link parameters with corresponding GPS coordinates and sends to OML server.
     4The following parameters are recorded and sent to the OML server: Center frequency, RSSI, CINR, Transmit power, Time from GPS, Latidute, Longitude, Altitude.
     5
     6== Software Requirements ==
     71. ''wimaxcu'' : Wimax radio utility. Must be installed on machine to operate wimax radio.
     8
     92. ''oml2-server'': OML measurement collection server. Note: this server may be locally installed on the mobile.
     10
     113. ''gpsd'': GPS service daemon running locally. Information on ''gpsd'' can be found on http://gpsd.berlios.de/
     12
     134. ''wimax_gps_oml2'': Wimax measurement application.
     14
     15== Hardware Requirements ==
     161. ''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
     17
     18== Installation / setup procedures ==
     191. Edit the '''/etc/apt/sources.list''' and add the following line:
     20{{{
     21deb http://packages.orbit-lab.org/ubuntu jaunty main
     22deb http://pkg.mytestbed.net/ubuntu maverick/
     23}}}
     24
     252. Update information based on the changed sources.list.
     26{{{
     27sudo apt-get update
     28}}}
     29
     303. Install the wimaxcu utility if not already installed, then reboot the machine
     31{{{
     32sudo apt-get install wimaxcu-1.0
     33reboot
     34}}}
     35
     364. Run the following commands to start wimax daemon service, and operate wimax radio
     37{{{
     38wimaxd -i wmx0 -b
     39
     40wimaxcu ron
     41wimaxcu scan
     42wimaxcu connect network 51
     43}}}
     44
     455. Install the Wimax measurement application (wimax_gps_oml2) and the GPS Daemon (gpsd)
     46{{{
     47sudo apt-get install wimax-gps-oml2
     48}}}
     49
     506. If measurements are to be collected locally install the oml2-server otherwise this step may be skipped.
     51{{{
     52sudo apt-get install oml2-server
     53}}}
     54
     557. 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''.
     56
     57
     58== Usage ==
     591. 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''.
     60
     612. Verify ''oml2-server'' is running
     62{{{
     63ps -elf | grep oml2-server
     64}}}
     65
     66If needed restart oml2-server:
     67{{{
     68/etc/init.d/oml2-server restart
     69}}}
     70
     713. Verify ''gpsd'' is running
     72{{{
     73ps -elf | grep gpsd
     74}}}
     75
     76If 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.
     77{{{
     78gpsd /var/run.gpsd.sock /dev/ttyUSB0
     79}}}
     80
     814. Run ''wimax_gps_oml2'' collection application.
     82{{{
     83./wimax_gps_oml2 --oml-id 4 --oml-exp-id exp4 --oml-server localhost:3003
     84}}}
     85This will create an sqlite database file (exp4.sq3) on the oml server.
     86
     87== Troubleshooting GPS Service Daemon ==
     88Please refer to troubleshooting ''gpsd'' please refer to http://gpsd.berlios.de/troubleshooting.html.
     89
     90== Sample data ==
     91Here's a snapshot of drive data collected around the Wimax BS at Rugters Winlab. This is the RSSI drive data.
     92
     93[[Image(gps_drive_rssi.png)]]
     94
     95The following is the CINR drive data.
     96
     97[[Image(GpsDriveCinr.png)]]
     98
     99
     100== Post processing data ==
     101After the application is run, it'll create an sql file on the oml server. Processing this file to extract the measured data can be done in several ways. The steps outlined here can be used to generate the image shown above.
     102
     1031. Process the sql file into delimited ascii text.
     104{{{
     105sqlite3 exp4.sq3 "select * from wimax_measurements;" > exp4.dat
     106}}}
     107
     1082. Extract the rssi field from delimited ascii text file. This was done via awk script: [http://www.orbit-lab.org/attachment/wiki/Documentation/WiMaxApp/rssi.awk rssi.awk]
     109{{{
     110awk -f rssi.awk exp4.dat > exp4_rssi.dat
     111}}}
     112
     1133. Use [http://www.gpsvisualizer.com/map_input?form=google gpsvisualizer] to plot exp4_rssi.dat.
     114
     115 * Under ''Upload your GPS data files'' for ''File #1'' select exp4_rssi.dat.
     116 * Under ''Track options'' for ''Colorize by'' select ''custom field'' from the pull down. Once the ''Custom colorization field'' appears enter ''rssi''.
     117 * Finally click ''Draw the map''