README 2.3 KB

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