startstarz / rtl8188eus

RTL8188EUS/EU/ETV Wifi driver support monitor mode & frame injection for build kernel nethunter

RTL8188EUS Driver

modified for nexus6p (kernel 3.10)

This is Forked From https://github.com/aircrack-ng/rtl8188eus, no changes only bug fixes, this must be the newest, most stable and effective one.

How To Build For Android/Nethunter

1. Compile your own kernel

Download your device source kernel. (example for Redmi 5: https://github.com/zexceed12300/android_kernel_xiaomi_rosy-3.18) & Download gcc toolchains

git clone https://github.com/zexceed12300/android_kernel_xiaomi_rosy-3.18
git clone https://android.googlesource.com/platform/prebuilts/gcc/linux-x86/aarch64/aarch64-linux-android-4.9 -b ndk-release-r16

Prepare for compiling kernel

cd android_kernel_xiaomi_rosy-3.18
export ARCH=arm64
export CROSS_COMPILE=../aarch64-linux-android-4.9/bin/aarch64-linux-android-
mkdir ../out
make O=../out someone_defconfig

edit ../out/.config and make sure below has already there. if not there, you can add it

CONFIG_MODULES=y
CONFIG_MODULE_FORCE_LOAD=y
CONFIG_MODULE_UNLOAD=y
CONFIG_MODULE_FORCE_UNLOAD=y
CONFIG_CFG80211_WEXT=y
CONFIG_MAC80211=y

Compiling kernel

make O=../out -j$(nproc)

now your kernel(Image.gz-dtb) is in android_kernel_xiaomi_rosy-3.18/arch/arm64/boot/ and flash it to your device

2. Build RTL8188EUS driver/modules

Download driver RTL8188EUS

cd ../
git clone https://github.com/zexceed12300/rtl8188eus
cd rtl8188eus

Compile all module

export KLIB_BUILD=../out
make

if there is no error or success you will see a file named 8188eu.ko in this driver directory.

3. Load the Driver

move 8188eu.ko to your device. open terminal and type

su
insmod 8188eu.ko

Enjoy!! the driver has been loaded in your device, now you can plugged your wifi adapter(like TP-LINK TL-WN722N v2/v3) now.

HowTo Monitor mode

Use these steps to enter monitor mode.

$ sudo airmon-ng check-kill
$ sudo ip link set <interface> down
$ sudo iw dev <interface> set type monitor

Frame injection test may be performed with (after kernel v5.2 scanning is slow, run a scan or simply an airodump-ng first!)

$ aireplay -9 <interface>

Network Manager Configuration

Add these lines below to "NetworkManager.conf" and ADD YOUR ADAPTER MAC below [keyfile] This will make the Network-Manager ignore the device, and therefor don't cause problems.

[device]
wifi.scan-rand-mac-address=no

[ifupdown]
managed=false

[connection]
wifi.powersave=0

[main]
plugins=keyfile

[keyfile]
unmanaged-devices=mac:A7:A7:A7:A7:A7