Realtek RTL8188EUS v5.3.9 (2018)

Driver for Realtek rtl8188eu, rtl8188eus and rtl8188etv chipsets.
This driver supports both Linux & Android 8 on various platforms.

[ Features ]

* Kernels supported up to v5.0+
* Android 8 (WIFI-HAL)
  Check the "android" folder for docs and tools.
* Frame injection support (coming up!)
* USB3 activated (and fixed USBModeSwitch)
* HT Greenfielt capabilities added
* Modes supported
   * MESH mode operation
   * AP+STA mode supported
   * Repeater mode supported
   * Monitor mode supported

[ TODO / Known Issues ]

* The driver needs proper testing before moving
  much further. Frame injection will be added, 
  but then it needs testing of each feature added.
   
  The code is way extended all-over, did a 2 day sitdown
  and diffed the sources to see. Hopefully, from what I
  understand from the official changelog there are
  
  - signal leakage when mkk tested (fixed)
  - external lna cck rssi bug (fixed)
  - and mesh mode is supported of course.
  
  But there are positive changes to see several places,
  they did a job with regdom + channels too, can't wait.

* Add kernel 4.15 __init_timers support
* Add frame injection (packet injection)
* Add more debug and stats (count frames)
* Add more output to "iw"
* Add old/new kernel support (up to kernel v5.0)
* Add support for kernels with backported cfg80211 API
* Add the 8812/8814 & 8821 HAL (and make them all supported in 1 module)
* Move the 8192EU HAL onto this base (not sure of this one yet)

[ Adapters Supported ]

The rtl8188EUS has 17 known adapters for driver, see the list below

rtl8188EUS: see the list over at WikiDevi

and the rtl8188ETV have 4 supported adapters. link below
rtl8188ETV: see the list over at WikiDevi

[ Performance ]

This thread will be updated when a proper iperf3 test is done. But we have the results of a packet capture test, see it below

see the capture packet test here

[ Download, Build & Install ]

Download

$ git clone -b v5.3.9 https://github.com/kimocodee/rtl8188eus.git
$ cd rtl*

Package / Build dependencies (Kali)

$ apt-get install build-essential
$ apt-get install bc
$ apt-get install libelf-dev
$ apt-get install linux-headers-`uname -r`

For Raspberry (RPI 1/2/3+) you will need kernel sources

$ wget "https://raw.githubusercontent.com/notro/rpi-source/master/rpi-source" -O /usr/bin/rpi-source
$ chmod 755 /usr/bin/rpi-source
$ rpi-source

Then you need to download and compile the driver on the RPI

$ git clone https://github.com/kimocoder/rtl8XXXau -b v5.3.9
$ cd rtl*
$ make
$ cp 8XXXau.ko /lib/modules/`uname -r`/kernel/drivers/net/wireless
$ epmod -a
$ modprobe 8XXXau

then run this step to change platform in Makefile, For RPI 1/2/3+:

$ sed -i 's/CONFIG_PLATFORM_I386_PC = y/CONFIG_PLATFORM_I386_PC = n/g' Makefile
$ sed -i 's/CONFIG_PLATFORM_ARM_RPI = n/CONFIG_PLATFORM_ARM_RPI = y/g' Makefile

But for RPI 3 B+ you will need to run those below which builds the ARM64 arch driver:

$ sed -i 's/CONFIG_PLATFORM_I386_PC = y/CONFIG_PLATFORM_I386_PC = n/g' Makefile
$ sed -i 's/CONFIG_PLATFORM_ARM64_RPI = n/CONFIG_PLATFORM_ARM64_RPI = y/g' Makefile

[ Android Users ]

This driver supports Android 8 (and below),
For more information on how-to get started,
look inside the "Android" folder for howto.

[ hostapd / wpa_supplicant ]

hostapd has been a bit tricky with these drivers, but we strobgly suggest you read these two links below

Relevant hostapd.conf options used for AP dongle and test:

hw_mode=a
ieee80211n=1
require_ht=1
ieee80211ac=1
require_vht=1

channel=100
vht_oper_chwidth=1
vht_oper_centr_freq_seg0_idx=106
ht_capab=[HT40+][SHORT-GI-40]
vht_capab=[SHORT-GI-80][MAX-MPDU-11454][MAX-A-MPDU-LEN-EXP7]

[ NetworkManager Options ]

Newer versions of NetworkManager has some options you might find usefull.
Simply add these lines into the NetworkManager.conf

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

[ifupdown]
managed=false

[connection]
wifi.powersave=2

Change MAC or set random?

macchanger -r wlan1 (example)

[ Help / Debug / Issues ]

Wonder what the different modes really are? "monitor" "station" etc Find the answer here https://wireless.wiki.kernel.org/en/users/Documentation/modes
Howto configure/setup MESH mode? https://github.com/kimocoder/rtl8188eus/blob/v5.3.9/documents/Quick_Start_Guide_for_Realtek_Mesh_v1.0.0_20180112.pdf
Howto configure/setup the repeater? https://github.com/kimocoder/rtl8188eus/blob/v5.3.9/documents/How_to_enable_Realtek_RSON_function.pdf
Here we have a quick setup guide on station mode https://github.com/kimocoder/rtl8188eus/blob/v5.3.9/documents/Quick_Start_Guide_for_Station_Mode.pdf
How does Miracast work, and howto setup? take a look here https://github.com/kimocoder/rtl8188eus/blob/v5.3.9/documents/Miracast_for_Realtek_WiFi.pdf

Other usefull howtos/schematics/resources

Wireless Tools Porting Guide #

Feel free to contribute to this project, we're allways happy for collaborations!
Got questions/suggestions or maybe you'd encountered issues/bugs, open a "issue" report.

Check the "documents" folder for internal schematics
And in the "tools" folder there's a Realtek Android application for different tests/debug