realtek-rtl8188eus-dkms/README.md

71 lines
2.4 KiB
Markdown
Raw Normal View History

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
* Android 12/13
2019-12-17 16:14:15 +00:00
* MESH Support
* Monitor mode
* Frame injection
* Up to kernel v6.0+
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.
2. `echo 'blacklist r8188eu'|sudo tee -a '/etc/modprobe.d/realtek.conf'`
3. Reboot
4. cd rtl8188eus
5. `make && sudo make install`
6. Reboot in order to blacklist and load the new driver/module.
2019-12-17 16:14:15 +00:00
# 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>