Mini-Howto run Wellenreiter on an Compaq IPAQ Version: 0.0001a Author: until now Kye Connect <kconnect@pin9.de> I - Disclamer 1. Be advised that the author of this howto takes no responsibility for any damage that occurs through the use of the information provided. The use of the information provided in this howto may or may not kill and/or injure you and/or others and/or start the third World War. 2. Presupposed abilities To use this howto you need knowledge of programming shell scripts, how to use apt-get, apt-cache, ifconfig, route, cat and similar programs. If you don't have these abilities, RTFM. II - TODO 1. Correct my bad English by an native speaker 2. Put the wellenreiter faqs at the end of this howto 3. Make a howto for a direct ipaq<->gps cable III - Requirements 1. Hardware a) Compaq IPAQ (36xx or 37xx, not tested with 31xx or 38xx, but they should also work) b) Dual PCMCIA Jacket c) Toshiba 2 GB/5GB PCMCIA Hardisk, IBM Microdrive or similar (check compatibilty at www.handhelds.org!) d) Garmin etrex oder similar incl. serial cable e) 2 Gender changers f) Serial auto-sync cable g) Null modem cable h) Cisco Aironet 350 (with or without integrated antenna IMHO the model with antenna is good for warwalking and the one without is good for wardriving, in which case you also need an external antenna) 2. Software a) A running "intimate" installed on the ipaq (debian distribution for the IPAQ from www.handhelds.org). Include X, gtk(?), wget, ncftp, gcc, the aironet modules and perl b) Newest libpcap and tcpdump from www.tcpdump.org c) gpsd d) Newest wellenreiter version from www.remote-exploit.org IV - Installation 1. Requirements You need a "real" internet connection on the ipaq. 2. gpsd Boot the ipaq in familiar. In the file /boot/params, change linuxargs "console=/dev/ttySA0" to "console=". In the file /etc/inittab, comment out the lines for getty. Warning: after making these changes and doing a reboot, connecting to the ipaq over the serial cable no longer works! Don't forget to reboot. Some people have successfully disabled getty over different runlevels, so they don't need to reboot. I'm too lazy for that, so I made myself a shell script that switches between the different inittabs on my system and reboots. 3. Wellenreiter Unpack the libpcap and tcpdump package under /usr/src. Change to their directories, run "./configure" "make all" "make install". Run "perl -MCPAN -e shell" at the system prompt and configure it (if not done earlier). The standard values should be ok, if not have fun. :) At "CPAN>" prompt execute the command "force install Net::Pcap". After successful installation, leave the cpan prompt with "quit". Reboot (be sure that the aironet card is inserted at restart). Put the card into rfmon mode with the commands "echo cat 'mode=rmon' > /proc/??? and "echo cat 'mode=y' > /proc/???". An ifconfig -a should show a very long mac address of the card (instead of 00:de:ad:be:ef:00 something like 00:de:ad:be:ef:00:00:00:00:00:00:00:00). If this does not happen, repeat the previous steps again. Executing tcpdump near an AP should show rows that end with "[802.11]". If everything works you can untar the wellenreiter package in /usr/src/ ("tar -xvzf WellenreiterXXXX.tar.gz"). Change into the directory, run "make Makefile.pl", change all the device names to "eth0", and answer "y" at the question "fuer IPAQ konfigurieren" (configure for IPAQ). All other values should be ok. Now switch off the getty as described in point 2. Reboot the ipaq. Get all the cables together so you have a connection between ipaq and gps. Give the aironet card an IP address with ifconfig. Start gpsd with "/bin/gpsd e -s 4800 -p /dev/ttySA0". Run "cat /dev/ttySA0", if everything runs and is configured properly you shoud get some output now. Change into the Wellenreiter directory and start wellenreiter with "perl Wellenreiter.pl". HAVE FUN!!!! V - TROUBLESHOOTING If it's not working, do some debugging (not done yet). ************************************************************** * If you have further questions, please contact the team at * * Homepage: http://www.remote-exploit.org * * IRC: #wellenreiter @ openprojects.net * **************************************************************