What KisMap is

KisMap is a collaborative directory of wireless networks.
It collects log files made with Kismet, a wireless network detector for linux.
Kismet can be configured to work together with a gps receiver in order to save the location of found networks.
Kismet will passively collect wireless networks and note relative gps coordinates, producing an .xml log file you can upload to KisMap.
Your log file will be parsed and all the contens will be freely browsable on the map.

Requirements

KisMap accepts log files produced by Kismet working together with gpsd and a gps receiver.
All you need is a linux box (mostly a laptop running linux) with a wi-fi adapter and an external gps receiver (serial, usb or bluetooth).
Maybe you would like to try a self-configuring live linux distro like BackTrack without installing anything on your hardrive.

You can find .xml kismet log files inside /var/log/kismet/

Due to Javascript high memory usage, only the 500 nearest networks around the point you click on the map will be shown.

Configuring gpsd

gpsd doesn't require particular configurations.
It will just listen to the gps receiver from a serial device such a serial port or a bluetooth device.

If you have a GPS receiver with RS232 serial port (commonly called COM port) you can try:
root@yourhost:~# gpsd /dev/ttyS0

Or if you have a USB GPS receiver:
root@yourhost:~# gpsd /dev/tts/USB0

For bluetooth GPS receiver you must have the Bluez protocol stack installed and the following modules loaded:
hci_xxx (depends on your device), bluez, l2cap, rfcomm.
If everything is ok try root@yourhost:~# hciconfig and you should see your bluetooth interface, likely hci0.
Now, with your bluetooth GPS receiver turned on, type:
root@yourhost:~# hciconfig hci0 up
root@yourhost:~# hciconfig hcitool scan
Take the address of your bluetooth receiver (xx:xx:xx:xx:xx:xx)
Link up with the device:
root@yourhost:~# rfcomm bind /dev/rfcomm0 xx:xx:xx:xx:xx:xx
And finally:
root@yourhost:~# gpsd /dev/rfcomm0

Configuring Kismet

For letting Kismet work with gpsd you need to modify some lines of kismet main config file (/etc/kismet/kismet.conf)

In the line source=none,none,addme you must insert parameters for your wifi adapter (source=type,interface,name). Some examples:
source=iwl3945,wlan0,ipw
source=rt8180,wlan0,alfa
source=madwifi_ag,ath0,madwifi
source=madwifi_b,ath0,madwifi
source=orinco,eth1,Orinoco
source=prism,wlan0,hostap
source=viha,en1,AirPort
You can find updated source types here under the section 12 "Capture Sources".

Then:
gps=false ==> gps=true
sound=false ==> sound=true [ sounds nice ;-) ]
metric=false ==> metric=true
waypoint_essid=false ==> waypoint_essid=true

I hope I haven't left anything behind...
Now type root@yourhost:~# kismet and you are ready to go!
You will find .xml kismet log files inside /var/log/kismet/


BackTrack usage

BackTrack usage coming soon..