WiSense is an Android based platform being developed by the WiNGS Lab at the University of Wisconsin Madison for wireless debugging and diagnosis in both enterprise and home WLANs. The platform allows users to analyze the channel quality, monitor signal quality of neighboring WLANs and detect the presence of neighboring non-WiFi activity. The ease of usage and mobility provided by handheld device platforms can allow network administrators as well as users to identify location specific wireless performance issues in their WLANs. This tool is also being developed as part of our group's efforts to collect data about wireless performance at different locations and share it with the community. Instructions to install the tool on your tablet/phone are available below. The whole setup operation should not take more than 15 - 20 minutes.

• Spectrum analyzer to analyze wireless activity on different channels
• Detection of neighboring non-WiFi activity.
• Monitoring airtime utilization across different WiFi channels.
• Scan neighboring access SSIDs..

• Any machine (Linux, Mac, Windows) with the Android SDK and tools installed (for adb and fastboot). You can also download (and unzip) Android's adb and fastboot tools from here.
• A Galaxy Nexus or Nexus 7 device (only these devices are currently supported). Currently Cyanogenmod (version 10.1 only) and Android Jellybean (Android 4.2.2 version only) based WiSense updates for these devices are available. Please ensure that there is sufficient battery charge available on your device.
  
• Unlocked bootloader for installing the WiSense platform on your android device. Instructions are available at the "Unlocking the bootloader" section here. Note that this will void your device warranty. You can skip this step if the device is already unlocked.
• Any Atheros AR9271 chipset based wireless adapter and a USB OTG cable to connect the wireless adapter to your android device. Check this list for supported AR9271 based adapter's. Click here for images
• Make sure that the USB debug mode on your android device is enabled. Goto Settings > Developer options. Turn on the "Developer options" toggle button (top right). Also select the "Android USB debugging" option, if not already done yet.
  Note: On Android 4.2 and higher, the Developer options screen is hidden by default. To make it available, go to Settings > "About phone" and tap Build number seven times. Return to the previous screen to find Developer options.

• Download the "Touch Recovery" version of ClockWorkMod recovery image on a machine based on your device type (Galaxy Nexus vs. Nexus 7).
• Using a terminal, go into the directory containing the Android adb and fastboot tools (downloaded in Step 1). Otherwise, if Android SDK is already installed on your machine, adb and fastboot tools should be in the "platform-tools" sub-directory of your Android SDK.
• Connect your Android device to the development machine using a USB cable. Make sure the "USB debugging mode" is enabled on your Android device.
• Execute "./adb reboot-bootloader" on terminal to reboot the device into the bootloader mode.
• Using the fastboot tool, flash ClockWorkMod Recovery onto your device by entering the following command: "fastboot flash recovery "<path\\_to\\our_recovery_image.img>" where the "your_recovery_image.img" is the name of the CWM file that you downloaded.
• Reboot the android device by choosing the "Start" option in the bootloader (press the power to select option).

• Download the correct WiSense update image to your machine based on your device type and OS from here.
• Connect your Android device to the development machine using a USB cable and copy the WiSense image to your device using "adb push <path_to_wisense_image_name.zip> /mnt/sdcard/". The file transfer may take upto 20 seconds.
• After the copy is complete, boot the device into recovery mode by running the following command: "adb reboot-bootloader". Use the "Volume Up" button to go to the "Recovery Mode" option and select it (press power button). You should see this screen now.
• Recommended: Backup you current system image using CWM by selecting the "backup and restore" option in the main menu. Press backup option to start the system backup operation (may take upto couple of minutes). This operation creates a backup of your tablet image on the sdcard.
• Go back to the main menu and clear the cache by using the "wipe cache partition" option.
• Now, we are ready to install the WiSense update image. From the main menu, choose "install zip > choose zip from sdcard" > "choose zip from sdcard". Now find the downloaded Wisense update zip file in the menu (file maybe in the "0/" directory) and click the filename to install.
• Go back to the main menu and reboot the device. Reboot operation may take upto a couple of minutes. You should now have the WiSense installed on your device! :)