74 lines
2.5 KiB
Markdown
74 lines
2.5 KiB
Markdown
|
## 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)](#)
|
||
|
[![GitHub issues](https://img.shields.io/github/issues/kimocoder/rtl8188eus.svg)](https://github.com/kimocoder/rtl8188eus/issues)
|
||
|
[![GitHub forks](https://img.shields.io/github/forks/kimocoder/rtl8188eus.svg)](https://github.com/kimocoder/rtl8188eus/network)
|
||
|
[![GitHub stars](https://img.shields.io/github/stars/kimocoder/rtl8188eus.svg)](https://github.com/kimocoder/rtl8188eus/stargazers)
|
||
|
[![GitHub license](https://img.shields.io/github/license/kimocoder/rtl8812au.svg)](https://github.com/kimocoder/rtl8188eus/blob/master/LICENSE)<br>
|
||
|
[![Android](https://img.shields.io/badge/android%20(8)-supported-brightgreen.svg)](#)
|
||
|
[![aircrack-ng](https://img.shields.io/badge/aircrack--ng-supported-blue.svg)](#)
|
||
|
|
||
|
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.
|
||
|
|
||
|
# Supports
|
||
|
* MESH Support
|
||
|
* Monitor mode
|
||
|
* Frame injection
|
||
|
* Up to kernel v5.3+
|
||
|
... And a bunch of various wifi chipsets
|
||
|
|
||
|
# Howto build/install
|
||
|
1. You will need to blacklist another driver in order to use this one.
|
||
|
2. "echo "blacklist r8188eu.ko" > "/etc/modprobe.d/realtek.conf"
|
||
|
3. "make && make install"<br>
|
||
|
4. Reboot in order to blacklist and load the new driver/module.
|
||
|
|
||
|
# 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
|
||
|
(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 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"
|
||
|
|
||
|
* Add more VID/PIDS for all 3 chipsets supported.
|
||
|
|
||
|
|