INTRODUCTION
------------
This 'guide' will show you how-to configure a (headless) system to run an
automated (kismet based) wireless network stumbler solution under FreeBSD.

The require a device with (USB) Wireless Cards and a GPS dongle.

Rick van der Zwet <info@rickvanderzwet.nl>


CONVENTIONS
-----------
Troughout the document commands will be prepended with a # if run as root or $
if run as normal user.


INSTALL SOFTWARE
----------------
1) Make sure you have the port collection installed (portsnap fetch extract)
2) Install the gpsd and kismet:
     # make -C /usr/ports/astro/gpsd install clean
     # make -C /usr/ports/net-mgnt/kismet install clean


CONFIGURE SOFTWARE
------------------
1) Add the required lines to the startup script, assuming your (serial GPS)
   dongle is found at /dev/ttyU0:
     # cat <<EOF >> /etc/rc.conf
gpsd_enable="YES"
gpsd_devices="/dev/ttyU0"
gpsd_flags="-b -D1"
EOF
2) Create a DATA log directory
     # mkdir /var/stumble


RUN SOFTWARE
------------
1) Start the gpsd (if not running automatically)
     # /usr/local/etc/rc.d/gpsd start
2) Configure interfaces and start the kismet daemon
     # ./start-kismet.sh /var/stumble
3) [OPTIONALLY] You can view the status using kismet_client:
     $ kismet_client
4) The results will be stored in your DATA log directory if you stop the kismet_server.


TROUBLESHOOTING
---------------
1) The logfiles and syslog provide valuable information for finding the error message.
2) You can view the status of gpsd and your dongle using the excelent program ``gpsmon''.
3) If your wireless card does not get loading by FreeBSD try loading the
   relevant kernel module. For example to find the right module for the ralink
   wireles card use the following hint to find the right module
     $ apropos ralink
     $ man rum
   If find your driver this might provide some clues:
     $ usbconfig list
     $ pciconf -lv
4) Send an email to techniek@lijst.wirelessleiden.nl asking for help if needed.