2019-12-17 16:14:15 +00:00
|
|
|
## rtl8188eus v5.3.9
|
|
|
|
|
|
|
|
# Realtek rtl8188eus & rtl8188eu & rtl8188etv WiFi drivers
|
|
|
|
|
|
|
|
[![Monitor mode](https://img.shields.io/badge/monitor%20mode-supported-brightgreen.svg)](#)
|
|
|
|
[![Frame Injection](https://img.shields.io/badge/frame%20injection-supported-brightgreen.svg)](#)
|
|
|
|
[![MESH Mode](https://img.shields.io/badge/mesh%20mode-supported-brightgreen.svg)](#)
|
2020-05-14 09:44:14 +00:00
|
|
|
[![GitHub issues](https://img.shields.io/github/issues/aircrack-ng/rtl8188eus.svg)](https://github.com/aircrack-ng/rtl8188eus/issues)
|
|
|
|
[![GitHub forks](https://img.shields.io/github/forks/aircrack-ng/rtl8188eus.svg)](https://github.com/aircrack-ng/rtl8188eus/network)
|
|
|
|
[![GitHub stars](https://img.shields.io/github/stars/aircrack-ng/rtl8188eus.svg)](https://github.com/aircrack-ng/rtl8188eus/stargazers)
|
|
|
|
[![GitHub license](https://img.shields.io/github/license/aircrack-ng/rtl8812au.svg)](https://github.com/aircrack-ng/rtl8188eus/blob/master/LICENSE)<br>
|
2019-12-17 16:14:15 +00:00
|
|
|
[![Android](https://img.shields.io/badge/android%20(8)-supported-brightgreen.svg)](#)
|
|
|
|
[![aircrack-ng](https://img.shields.io/badge/aircrack--ng-supported-blue.svg)](#)
|
|
|
|
|
|
|
|
|
|
|
|
# Supports
|
2020-05-14 09:44:14 +00:00
|
|
|
* Android 7
|
2019-12-17 16:14:15 +00:00
|
|
|
* MESH Support
|
|
|
|
* Monitor mode
|
|
|
|
* Frame injection
|
2020-09-16 13:00:46 +00:00
|
|
|
* Up to kernel v5.8+
|
2019-12-17 16:14:15 +00:00
|
|
|
... And a bunch of various wifi chipsets
|
|
|
|
|
|
|
|
# Howto build/install
|
|
|
|
1. You will need to blacklist another driver in order to use this one.
|
2021-01-26 16:01:57 +00:00
|
|
|
2. `echo "blacklist r8188eu" >> "/etc/modprobe.d/realtek.conf"`
|
|
|
|
3. `make && make install`
|
2019-12-17 16:14:15 +00:00
|
|
|
4. Reboot in order to blacklist and load the new driver/module.
|
|
|
|
|
|
|
|
# MONITOR MODE howto
|
|
|
|
Use these steps to enter monitor mode.
|
|
|
|
```
|
2021-01-26 16:01:57 +00:00
|
|
|
$ sudo airmon-ng check kill
|
2020-05-14 09:44:14 +00:00
|
|
|
$ sudo ip link set <interface> down
|
|
|
|
$ sudo iw dev <interface> set type monitor
|
2019-12-17 16:14:15 +00:00
|
|
|
```
|
|
|
|
Frame injection test may be performed with
|
|
|
|
(after kernel v5.2 scanning is slow, run a scan or simply an airodump-ng first!)
|
|
|
|
```
|
2020-05-14 09:44:14 +00:00
|
|
|
$ aireplay -9 <interface>
|
2019-12-17 16:14:15 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
# NetworkManager configuration
|
|
|
|
Add these lines below to "NetworkManager.conf" and ADD YOUR ADAPTER MAC below [keyfile]
|
2021-01-26 16:01:57 +00:00
|
|
|
This will make the Network-Manager ignore the device, and therefore don't cause problems.
|
2019-12-17 16:14:15 +00:00
|
|
|
```
|
|
|
|
[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
|
|
|
|
```
|
|
|
|
|
2020-05-14 09:44:14 +00:00
|
|
|
# Credits
|
|
|
|
Realtek - https://www.realtek.com<br>
|
|
|
|
Alfa Networks - https://www.alfa.com.tw<br>
|
|
|
|
aircrack-ng. - https://www.aircrack-ng.org<br>
|
|
|
|
<br>
|
|
|
|
And all those who may be using or contributing to it of anykind. Thanks!<br>
|