| 1 | = A guide to wimax measurement tools = |
| 2 | == Description == |
| 3 | Collects Wimax radio link parameters with corresponding GPS coordinates and sends to OML server. |
| 4 | The 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 == |
| 7 | 1. ''oml2-server'': OML measurement collection server. Note: this server may be locally installed on the mobile. |
| 8 | |
| 9 | 2. ''gpsd'': GPS service daemon running locally. Information on ''gpsd'' can be found on http://gpsd.berlios.de/ |
| 10 | |
| 11 | 3. ''wimax_gps_oml2'': Wimax measurement application. |
| 12 | |
| 13 | == Hardware Requirements == |
| 14 | 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 |
| 15 | |
| 16 | == Installation / setup procedures == |
| 17 | 1. Edit the '''/etc/apt/sources.list''' and add the following line: |
| 18 | {{{ |
| 19 | deb http://packages.orbit-lab.org/ubuntu jaunty main |
| 20 | }}} |
| 21 | |
| 22 | 2. Update information based on the changed sources.list. |
| 23 | {{{ |
| 24 | sudo apt-get update |
| 25 | }}} |
| 26 | |
| 27 | 3. Install the Wimax measurement application (wimax_gps_oml2) and the GPS Daemon (gpsd) |
| 28 | {{{ |
| 29 | sudo apt-get install wimax-gps-oml2 |
| 30 | }}} |
| 31 | |
| 32 | 4. If measurements are to be collected locally install the oml2-server otherwise this step may be skipped. |
| 33 | {{{ |
| 34 | sudo apt-get install oml2-server |
| 35 | }}} |
| 36 | |
| 37 | 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''. |
| 38 | |
| 39 | |
| 40 | == Usage == |
| 41 | 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''. |
| 42 | |
| 43 | 2. Verify ''oml2-server'' is running |
| 44 | {{{ |
| 45 | ps -elf | grep oml2-server |
| 46 | }}} |
| 47 | |
| 48 | If needed restart oml2-server: |
| 49 | {{{ |
| 50 | /etc/init.d/oml2-server restart |
| 51 | }}} |
| 52 | |
| 53 | 3. Verify ''gpsd'' is running |
| 54 | {{{ |
| 55 | ps -elf | grep gpsd |
| 56 | }}} |
| 57 | |
| 58 | 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. |
| 59 | {{{ |
| 60 | gpsd /var/run.gpsd.sock /dev/ttyUSB0 |
| 61 | }}} |
| 62 | |
| 63 | 4. Run ''wimax_gps_oml2'' collection application. |
| 64 | {{{ |
| 65 | ./wimax_gps_oml2 --oml-id 4 --oml-exp-id exp4 --oml-server localhost:3003 |
| 66 | }}} |
| 67 | |
| 68 | == Troubleshooting GPS Service Daemon == |
| 69 | Please refer to troubleshooting ''gpsd'' please refer to http://gpsd.berlios.de/troubleshooting.html. |
| 70 | |