wpadebug/README

   1 wpadebug - wpa_supplicant and Wi-Fi debugging app for Android
   2 Copyright (c) 2013, Jouni Malinen <j@w1.fi> and contributors
   3 All Rights Reserved.
   4
   5 This program is licensed under the BSD license (the one with
   6 advertisement clause removed). See the top level README for detailed
   7 license text.
   8
   9 If you are submitting changes to the project, please see CONTRIBUTIONS
  10 file for more instructions.
  11
  12
  13 NOTE! This Android app is for debugging and testing purposes only. It is
  14 not supposed to be installed on a production use device and doing so may
  15 result in complete loss of security protections on the device.
  16
  17
  18
  19 Build
  20 -----
  21
  22 - Install Android SDK and build tools
  23
  24 wpadebug depends on zxing core to launch QR code display/scanning.
  25 To build zxing core:
  26
  27 - mkdir hostap/wpadebug/libs # target for the jar file
  28 - Install maven tool
  29 - clone latest zxing code [git clone https://github.com/zxing/zxing.git]
  30 - cd zxing/core
  31 - run: mvn install -DskipTests
  32 - copy target/core-*.*.*-SNAPSHOT.jar to hostap/wpadebug/libs
  33
  34 To build wpadebug application:
  35
  36 - update project target if desired; for example:
  37   android list targets
  38   android update project --target 1 --path $PWD
  39 - run: ant debug
  40
  41
  42 Installation (with adb over USB)
  43 ------------
  44
  45 adb install bin/wpadebug-debug.apk
  46
  47 NOTE: Following steps enable any app on the system to get root access!
  48 This is not suitable for any production use. This is needed for direct
  49 wpa_supplicant access and some networking operating in general. You can
  50 still use rest of the wpadebug app without doing this, but those
  51 functions will not work unless this step part of installation is
  52 done. It should be obvious that these steps require a rooted device. In
  53 addition, if you do not understand what the following commands do,
  54 please do not run them.
  55
  56 adb root
  57 adb remount
  58 adb shell cp /system/bin/mksh /system/bin/mksh-su
  59 adb shell chmod 6755 /system/bin/mksh-su
  60
  61 Optionally, a text file with a set of command can be installed to allow
  62 arbitrary shell commands to be executed. This text file need to be in
  63 /data/local/wpadebug.cmds and use title@command format per line. For
  64 example:
  65 version@cat /proc/version
  66
  67 Similarly, /data/local/wpadebug.wpacmds can be used to define additional
  68 wpa_supplicant control interface commands.
  69
  70
  71 Uninstallation
  72 --------------
  73
  74 adb root
  75 adb remount
  76 adb shell rm /system/bin/mksh-su
  77
  78 adb uninstall w1.fi.wpadebug