WiFi Hacks and Mods

Routers, Repeaters, Antennas

Main | Projects | About | Links |Contact

 

 

1, 2

Download and Installation

I have tested Scanmeter in several different configurations. If none matches your hardware that's OK. Pick the closest one and modify the script if necessary.


Dell Mini 9, Ubuntu 8.4 w/Broadcom card and wl driver (factory configuration)
Dell Mini 9, Ubuntu 8.4 w/Intel 3945ABG card and iwl3945 driver
Debian w/Broadcom PCMCIA card and b43 driver (2.6.32 trunk-686)
Debian w/Broadcom PCMCIA card and b43 driver (older kernel)

If you're new to bash scripts do this:

  1. Download and unpack the script to your /home/yourname directory.
  2. Open a terminal window and type:
cd /home/yourname
chmod 777 scanmeter

There are better places to save a bash script like /usr/local/bin for example. Look up a tutorial on saving and executing bash scripts for more information.

Scanmeter Usage

Scanmeter must be executed by the root user. This is done inside a terminal window:

  1. cd /home/yourname (navigate to the location of the script)
  2. sudo ./scanmeter [interface]
Scanmeter screen shot 2The default interface is wlan0 except for the Dell Mini 9 factory WiFi card version which defaults to eth1. Your WiFi card could also default to eth1 or another device name. To find out the device name of your wireless card execute:

iwconfig

If you saved the script in /usr/local/sbin or added the custom location path to the PATH environment variable (slightly advanced), your Scanmeter can be executed by typing:

sudo scanmeter [interface]

Scanmeter is very self explanatory. Make sure you use all caps when typing in the BSSID (MAC Address). Press CTRL+C to exit the histogram. Pressing enter in the main menu prompt will restart scanning with the last entered BSSID.

Debugging

Scanmeter parses the output of Linux command:

sudo iwlist interface scanning

The physical formatting of the iwlist command output depends on the wireless chipset, the driver and possibly the Linux distro. For this reason you may have to make minimal adjustments to the script to make it work.

Similar Software

Check out Pifimon which is a Perl script inspired by Scanmeter (and improved). If you improve scanmeter or make similar tools let me know please.

1, 2