| b.liu | e958203 | 2025-04-17 19:18:16 +0800 | [diff] [blame] | 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 |