| | 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 | |