Skip to content

FORK: RealTek RTL8188eus WiFi driver with monitor mode & frame injection support

Notifications You must be signed in to change notification settings

etahamad/rtl8188eus

 
 

Repository files navigation

rtl8188eus development branch

Realtek rtl8188eus & rtl8188eu & rtl8188etv WiFi drivers

Monitor mode Frame Injection MESH Mode GitHub issues GitHub forks GitHub stars GitHub license
Android aircrack-ng

Supports

  • Android 7
  • MESH Support
  • Monitor mode
  • Frame injection
  • Up to kernel v5.8+ ... And a bunch of various wifi chipsets

Howto build/install

  1. Update your apt list sudo apt update && sudo apt upgrade
  2. Install your linux header in order to compile the driver sudo apt-get install linux-headers-$(uname -r)
    • If this gives you an error, then you need to update your distro sudo apt-get dist-upgrade then reboot to upgrade the dirsto sudo reboot
  3. Install extra sudo apt install bc build-essential libelf-dev dkms
  4. Unload the driver sudo rmmod r8188eu.ko
  5. Blacklist the original driver in order to use this one. sudo echo 'blacklist r8188eu'|sudo tee -a '/etc/modprobe.d/realtek.conf'
  6. Clone the driver git clone https://github.com/etahamad/rtl8188eus
  7. Enter the driver dircd rtl8188eus
  8. Compile the driver sudo make && sudo make install
  9. Reboot in order to blacklist and load the new driver/module.
  10. Load the new driver sudo modprobe 8188eu

MONITOR MODE howto

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>

NetworkManager 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 therefore 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

Credits

Realtek - https://www.realtek.com
Alfa Networks - https://www.alfa.com.tw
aircrack-ng. - https://www.aircrack-ng.org

And all those who may be using or contributing to it of anykind. Thanks!

About

FORK: RealTek RTL8188eus WiFi driver with monitor mode & frame injection support

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 99.4%
  • Other 0.6%