| | 1 | = Setting up an EeePC for gathering HeatMap data = |
| | 2 | |
| | 3 | == INTRODUCTION == |
| | 4 | |
| | 5 | Ubuntu 10.10 ships with a fairly old version of kismet (2008 vs 2011), which is |
| | 6 | a pain to configure and not compatible with the latest gpsd in the repository. |
| | 7 | |
| | 8 | This guide will help you configure Kismet to be used with a external GPS |
| | 9 | dongle. In this case the external GPS dongle is a Android Phone running the |
| | 10 | application BlueNMEA. |
| | 11 | |
| | 12 | If you are using a serial or USB GPS dongle, you can skip the setup of |
| | 13 | bluetooth GPS and make sure to replace /dev/rfcomm0 your /dev/ttyXXX, e.g. /dev/ttyUSB0. |
| | 14 | |
| | 15 | Good luck! Any questions? |
| | 16 | Rick van der Zwet <info@rickvanderzwet.nl> |
| | 17 | |
| | 18 | |
| | 19 | == INSTALL KISMET == |
| | 20 | |
| | 21 | $ sudo apt-get install libncurses5-dev build-essential libpcap-dev libnl |
| | 22 | $ wget http://www.kismetwireless.net/code/kismet-2011-03-R1.tar.gz |
| | 23 | $ tar xvzf kismet-2011-03-R1.tar.gz |
| | 24 | $ cd kismet-2011-03-R1 |
| | 25 | $ ./configure --prefix /opt/kismet |
| | 26 | $ make |
| | 27 | $ sudo make install |
| | 28 | |
| | 29 | |
| | 30 | == INSTALL BLUETOOTH GPS == |
| | 31 | {{{ |
| | 32 | $ sudo apt-get install bluez |
| | 33 | # Find the MAC-ADDRESS you need, I have 38:E7:D8:C3:6B:C6 |
| | 34 | $ sudo hcitool scan |
| | 35 | $ sudo hcitool cc MAC-ADDRESS |
| | 36 | $ sudo hcitool auth MAC-ADDRESS |
| | 37 | # Find the channel the GPS serial is 'working' on |
| | 38 | $ sudo sdptool browse MAC-ADDRESS |
| | 39 | |
| | 40 | # Configure your rfcomm config file |
| | 41 | cat <<EOF >> /etc/bluetooth/rfcomm.conf |
| | 42 | rfcomm0 { |
| | 43 | bind yes; |
| | 44 | device 38:E7:D8:C3:6B:C6; |
| | 45 | channel 29; |
| | 46 | comment "GPS Android"; |
| | 47 | } |
| | 48 | EOF |
| | 49 | # Restart bluetooth, alltough not sure whether this is really needed. |
| | 50 | $ sudo service bluetooth restart |
| | 51 | |
| | 52 | # Attach your new Bluetooth serial device |
| | 53 | $ sudo rfcomm attach all |
| | 54 | # View if attached succesfully by displaying raw NMEA stream |
| | 55 | $ cat /dev/rfcomm0 |
| | 56 | # If you like to close it (properly during shutdown). |
| | 57 | $ sudo rfcoom release all |
| | 58 | }}} |
| | 59 | |
| | 60 | == INSTALL GPSD == |
| | 61 | |
| | 62 | {{{ |
| | 63 | # Re-configure GPSD and make sure to set device to /dev/rfcomm0 |
| | 64 | $ sudo apt-get install gpsd gpsd-clients |
| | 65 | $ sudo dpkg-reconfigure gpsd |
| | 66 | $ sudo service gpsd restart |
| | 67 | # View status of GPS |
| | 68 | $ xgps (or gpspipe -r if you only have a CLI) |
| | 69 | }}} |
| | 70 | |
| | 71 | == STARTING KISMET == |
| | 72 | {{{ |
| | 73 | # Edit the config file; |
| | 74 | # - make sure ncsource= is set to the right source/interface. |
| | 75 | # - Check your gpsdevice=/dev/rfcomm0 and gps=true |
| | 76 | $ sudo vim /opt/kismet/etc/kismet.conf |
| | 77 | # Now start the server, we are not using the adviced SUID-ROOT mode as this |
| | 78 | # require hacking around in our groups, refer to the KISMET manual if you are |
| | 79 | # going to run this in a production envirionment. |
| | 80 | $ sudo /opt/kismet/bin/kismet_server |
| | 81 | # If all goes well you will see messages passing like: |
| | 82 | ## INFO: Started source 'wlan0' |
| | 83 | ## INFO: Connected to a JSON-enabled GPSD version 2.94, turning on JSON mode |
| | 84 | # |
| | 85 | # Now start the client and see the visual output |
| | 86 | $ /opt/kismet/bin/kismet_client |
| | 87 | # |
| | 88 | # HINT: Alternative GUI kismet applications to try: |
| | 89 | # - qkismet (Hard to compile) |
| | 90 | # - gkismet (FAIL Ubuntu 10.10 - require Gtk.pm, no longer in repos). |
| | 91 | # - kismon (FAIL Ubuntu 10.10 - require champlain-memphis which is only |
| | 92 | # availble in next version) |
| | 93 | }}} |
| | 94 | |
| | 95 | |
| | 96 | == TROUBLESHOOTING == |
| | 97 | |
| | 98 | As a rule of thumb, follow all steps in the process which allow you to view the |
| | 99 | status and or result of a step and see if it completes succesfully. |
| | 100 | |
| | 101 | - Using Ulysse Gizmos you can nicely see if your Android phone has a fix already. |