/rtl8188eus

RealTek RTL8188eus WiFi driver with monitor mode & frame injection support

Primary LanguageC

rtl8188eus v5.3.9

Realtek rtl8188eus & rtl8188eu & rtl8188etv WiFi driver

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

This is a pure Realtek release, not from vendor but from all the Realtek multichip "bases" we've seen, this must be the newest, most stable and effective one. The performance and code quality has been improved and thats about time.

HowTo build/install

  1. You will need to blacklist another driver in order to use this one instead of the kernel provided. We included a "realtek_blacklist.conf" file in the folder:
  2. "cp realtek_blacklist.conf /etc/modprobe.d/"
  3. "make && make install"
  4. "rmmod 8188eu && insmod 8188eu.ko"

MONITOR MODE howto

Use these steps to enter monitor mode.

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

Frame injection test may be performed with

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

TODO

  • Implement txpower control

  • Finish up the elimination of the wrapper _rtw_memset. I didn't have more time after "rtw_beamforming.c"

  • Check code with checkpatch.pl (found in "tools")

  • pcap_activate error on "reaver" - investigate

  • Add/upload the documentation

  • Add more VID/PIDS for all 3 chipsets supported.

  • Remove unused functions


more tba..