kanux-14/rtl8188eus

RealTek RTL8188eus WiFi driver with monitor mode & frame injection support.

Realtek rtl8188eu(s) / rtl8188etv wireless drivers

Trying to find a solution? See troubleshooting.

Support	Tested	Status	Description
Android 7+	❌	🟡	Depends on which kernel version is installed.
MESH	❌	🟠	Not tested yet.
Monitor Mode	✅	🔵	Tested and working.
Frame injection	✅	🔵	Tested and working.
Kernel 5.8+	✅	🟢	Kernel 5.15+ tested.

Building

The quickest compile can presume:

git clone --depth 1 https://gitlab.com/SimplyCEO/rtl8188eus.git
cd rtl8188eus/
make -j$(nproc)
su -c "make install clean"
su -c "modprobe --remove rtl8xxxu && modprobe 8188eu"

The old driver will be kept, but it need to be deactivated.
Verify if your kernel is equal or newer than '6.3.x'.
If it is, then the driver is called rtl8xxxu. Otherwise it is r8188eu.

All the instructions and explanations can be found by
reading the documentation or by accessing the topics:

• Building for Kali Nethuner;
• Available Modes;
• Configuring NetworkManager;
• Managed/Monitor Mode: toggle-script.

Credits

Realtek - https://www.realtek.com
Alfa Networks - https://www.alfa.com.tw
aircrack-ng - https://www.aircrack-ng.org
Project contributors - https://gitlab.com/SimplyCEO/rtl8188eus/-/graphs/master?ref_type=heads

And all those who are using, requesting support, or teaching. Thanks!

rtl8188eus's Issues

Do you think that rt8188eus being a good card?

Moniter mode and injection are working!

However,how about the efficiency and stability when comparing another cards?

In your experience,is rt8188eus a good card?

error: getting cc1 / gcc errors (plugin)

i have Linux Arch with Downgraded Linux LTS kernel down to 5.10.xx

cc1: error: incompatible gcc/plugin versions
cc1: error: failed to initialize plugin ./scripts/gcc-plugins/structleak_plugin.so
cc1: error: incompatible gcc/plugin versions
cc1: error: incompatible gcc/plugin versions
cc1: error: failed to initialize plugin ./scripts/gcc-plugins/structleak_plugin.so
cc1: error: failed to initialize plugin ./scripts/gcc-plugins/structleak_plugin.so
CC [M] /home/nick/rtl8188eus/core/rtw_ioctl_set.o
cc1: error: incompatible gcc/plugin versions
cc1: error: failed to initialize plugin ./scripts/gcc-plugins/structleak_plugin.so
cc1: error: incompatible gcc/plugin versions
cc1: error: failed to initialize plugin ./scripts/gcc-plugins/structleak_plugin.so
cc1: error: incompatible gcc/plugin versions
cc1: error: failed to initialize plugin ./scripts/gcc-plugins/structleak_plugin.so

error: Evil Twin Attack not working for TL-WN722N (v2/3)

I have tried for evil twin attack in my own wifi with this driver with Tp Link TLWN722N V2 and also with V3 adapter, but the attack is not working.

getting error while using command "sudo && sudo make install"

so basically i am getting this error and unable to proceed futher. my current system verion of is 6.6.18 and i am a beginner in kali linux or basically noob in other words can someone help me with this by providing whole commands froom start to end PLEASE.
and which kernel version of kali is supported to this rtl8188eus driver ? I AM STRUGGLING FOR PAST 5 DAYS OR MORE
PLEASE HELP !!

What is BTF generation unavailability?

During compilation,i met this mere error. However,the driver file is still generated fine.

Should i ignore or i have to fix this error?

adapter not working

I restarted the system, checked the USB connection in the virtual machine, but it does not appear as a network interface

Which kernel you use and run it properly?

Hi,
as the title,can you provide me with the system information that you currently running?

That is,i can reduce the chance to run into error.

Thanks!

bug: unable to use Wifiphisher

Im using the most recent version of kali linux at the time, 2023.1.

This drivers seem to be working flawlessly, however when I try to use wifiphisher, the terminal gets stuck and Im unable to kill the application or launch other applications. I have to reboot the machine.

I used wifiphisher from the default kali repositories.

Any help would be appreciated.

device: USB-N10 Nano is not being recognized

My Kernel is: 6.0.10-arch2-1
The Device I'm using is an: ASUSTek Computer, Inc. Realtek 8188EUS [USB-N10 Nano]

I tried installing the drivers using both the automated scripts and the manual installation.

lsmod | grep 8188eu

returns:

8188eu 1355776 0
cfg80211 1118208 1 8188eu

So the module is activated.

However:

ip adress

returns:

1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: enp37s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
link/ether 00:d8:61:a4:6f:9e brd ff:ff:ff:ff:ff:ff
inet 192.168.178.26/24 brd 192.168.178.255 scope global dynamic noprefixroute enp37s0
valid_lft 863298sec preferred_lft 863298sec
inet6 2003:e7:1f16:3b00:7729:77c8:a5df:e8c7/64 scope global dynamic noprefixroute
valid_lft 6928sec preferred_lft 1528sec
inet6 fe80::ad2c:9420:8e86:9a70/64 scope link noprefixroute
valid_lft forever preferred_lft forever

(2 is my ethernet cable)

The driver is properly installed I don't know what happened but the wifi stick is not working.

error: sudo rmmod r8188eu not workin

Unable to compile! Please read! [Issue]

Issue
[gamer@Linux rtl8188eus]$ git clone --depth 1 https://gitlab.com/KanuX/rtl8188eus.git
cd rtl8188eus/
make -j$(nproc)
su -c "make install clean"
su -c "modprobe 8188eu"
Cloning into 'rtl8188eus'...
remote: Enumerating objects: 540, done.
remote: Counting objects: 100% (540/540), done.
remote: Compressing objects: 100% (390/390), done.
remote: Total 540 (delta 151), reused 487 (delta 144), pack-reused 0
Receiving objects: 100% (540/540), 2.59 MiB | 8.29 MiB/s, done.
Resolving deltas: 100% (151/151), done.
make ARCH=x86_64 CROSS_COMPILE= -C /lib/modules/6.7.2-arch1-1/build M=/home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus modules
make[1]: Entering directory '/usr/lib/modules/6.7.2-arch1-1/build'
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_cmd.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_security.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_debug.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_io.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_ioctl_query.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_ioctl_set.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_ieee80211.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_mlme.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_mlme_ext.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_mi.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_wlan_util.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_vht.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_pwrctrl.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_rf.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_recv.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_sta_mgt.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_ap.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/mesh/rtw_mesh.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/mesh/rtw_mesh_pathtbl.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/mesh/rtw_mesh_hwmp.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_xmit.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_p2p.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_rson.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_tdls.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_br_ext.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_iol.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_sreset.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_btcoex_wifionly.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_btcoex.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_beamforming.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_odm.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_rm.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/rtw_rm_fsm.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/core/efuse/rtw_efuse.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/osdep_service.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/os_intfs.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/usb_intf.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/usb_ops_linux.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/ioctl_linux.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/xmit_linux.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/mlme_linux.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/recv_linux.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/ioctl_cfg80211.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/rtw_cfgvendor.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/wifi_regd.o
/home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/ioctl_cfg80211.c:9416:26: error: initialization of ‘int (*)(struct wiphy *, struct net_device *, struct cfg80211_ap_update )’ from incompatible pointer type ‘int ()(struct wiphy *, struct net_device *, struct cfg80211_beacon_data *)’ [-Werror=incompatible-pointer-types]
9416 | .change_beacon = cfg80211_rtw_change_beacon,
| ^~~~~~~~~~~~~~~~~~~~~~~~~~
/home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/ioctl_cfg80211.c:9416:26: note: (near initialization for ‘rtw_cfg80211_ops.change_beacon’)
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/rtw_android.o
CC [M] /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/rtw_proc.o
cc1: some warnings being treated as errors
make[3]: *** [scripts/Makefile.build:243: /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus/os_dep/linux/ioctl_cfg80211.o] Error 1
make[3]: *** Waiting for unfinished jobs....
make[2]: *** [/usr/lib/modules/6.7.2-arch1-1/build/Makefile:1911: /home/gamer/.local/share/Trash/files/rtl8188eus/rtl8188eus/rtl8188eus] Error 2
make[1]: *** [Makefile:234: __sub-make] Error 2
make[1]: Leaving directory '/usr/lib/modules/6.7.2-arch1-1/build'
make: *** [Makefile:2058: modules] Error 2

Sorry if it is the wrong formatting.

error: make install error under Android

I use kali nethunter on Nexus 6p.

Build For Android Running in Android Emulator device running at x86_64 platform

I have launched an Android VM via android's emulator:

emulator -avd WiFIUSB -qemu -device qemu-xhci -device usb-host,vendorid=0x1903,productid=0x8328

Where the device is:

$ lsusb

Bus 001 Device 004: ID 2357:010c TP-Link TL-WN722N v2/v3 [Realtek RTL8188EUS]

Via obtaining a shell access upon the device

adb shell

I got:

$ uname -a
Linux localhost 6.1.23-android14-4-00257-g7e35917775b8-ab9964412 #1 SMP PREEMPT Mon Apr 17 20:50:58 UTC 2023 x86_64 Toybox

And I attempt to crossbuild in my host linux and load it at the Android Running upon emulator. But I am stuck on theese:

1. Where I can find the headers so I can crossbuild for the android kernel?
2. Could somwehow I get hint from Nethunter builds? If yes what toolchain should I use?

export CROSS_COMPILE=../toolchain/toolchain64/bin/aarch64-linux-android-