mirror of
https://github.com/aircrack-ng/rtl8812au.git
synced 2024-11-10 08:07:05 +00:00
180 lines
6.9 KiB
Markdown
180 lines
6.9 KiB
Markdown
## RTL8812AU/21AU and RTL8814AU drivers [for LINUX & Android only]
|
|
|
|
[](#)
|
|
[](#)
|
|
[](https://badge.fury.io/gh/aircrack-ng%2Frtl8812au)
|
|
[](https://github.com/aircrack-ng/rtl8812au/issues)
|
|
[](https://github.com/aircrack-ng/rtl8812au/network)
|
|
[](https://github.com/aircrack-ng/rtl8812au/stargazers)
|
|
[](https://github.com/aircrack-ng/rtl8812au/blob/master/LICENSE)
|
|
<br>
|
|
[](https://www.kali.org)
|
|
[](https://www.archlinux.org)
|
|
[](https://www.armbian.com)
|
|
[](https://img.shields.io/badge/ArchLinux-supported-blue.svg)
|
|
[](https://github.com/aircrack-ng/aircrack-ng)
|
|
[](https://github.com/derv82/wifite2)
|
|
|
|
### TODO
|
|
|
|
```
|
|
* Test & fix the 8821au support
|
|
* Clean out Windows & FreeBSD code
|
|
* Clean out unsupported chipsets
|
|
```
|
|
### IPERF3 benchmark
|
|
#### [Device] Alfa Networks AWUS036ACH [Chipset] 8812au [Branch] v5.6.4.1 [Distance] 10m free sight
|
|
```
|
|
[ ID] Interval Transfer Bitrate Retr Cwnd
|
|
[ 5] 0.00-1.00 sec 11.6 MBytes 97.4 Mbits/sec 0 96.2 KBytes
|
|
[ 5] 1.00-2.00 sec 11.2 MBytes 93.8 Mbits/sec 0 100 KBytes
|
|
[ 5] 2.00-3.00 sec 11.2 MBytes 93.8 Mbits/sec 0 100 KBytes
|
|
[ 5] 3.00-4.00 sec 11.2 MBytes 93.8 Mbits/sec 0 100 KBytes
|
|
[ 5] 4.00-5.00 sec 11.2 MBytes 93.8 Mbits/sec 0 100 KBytes
|
|
[ 5] 5.00-6.00 sec 11.4 MBytes 95.9 Mbits/sec 0 105 KBytes
|
|
[ 5] 6.00-7.00 sec 11.2 MBytes 93.8 Mbits/sec 0 105 KBytes
|
|
[ 5] 7.00-8.00 sec 11.3 MBytes 94.9 Mbits/sec 0 157 KBytes
|
|
[ 5] 8.00-9.00 sec 11.2 MBytes 93.8 Mbits/sec 0 157 KBytes
|
|
[ 5] 9.00-10.00 sec 11.2 MBytes 94.3 Mbits/sec 0 157 KBytes
|
|
[ 5] 10.00-11.00 sec 11.2 MBytes 93.8 Mbits/sec 0 157 KBytes
|
|
[ 5] 11.00-12.00 sec 11.2 MBytes 93.8 Mbits/sec 0 157 KBytes
|
|
[ 5] 12.00-13.00 sec 11.2 MBytes 94.4 Mbits/sec 0 157 KBytes
|
|
[ 5] 13.00-14.00 sec 11.2 MBytes 93.8 Mbits/sec 0 157 KBytes
|
|
[ 5] 14.00-15.00 sec 11.2 MBytes 94.4 Mbits/sec 0 157 KBytes
|
|
[ 5] 15.00-16.00 sec 10.9 MBytes 91.7 Mbits/sec 0 157 KBytes
|
|
[ 5] 16.00-17.00 sec 11.2 MBytes 94.4 Mbits/sec 0 157 KBytes
|
|
[ 5] 17.00-18.00 sec 11.2 MBytes 94.4 Mbits/sec 0 157 KBytes
|
|
[ 5] 18.00-19.00 sec 11.2 MBytes 94.4 Mbits/sec 0 157 KBytes
|
|
[ 5] 19.00-20.00 sec 11.2 MBytes 93.8 Mbits/sec 0 157 KBytes
|
|
[ 5] 20.00-21.00 sec 11.2 MBytes 93.8 Mbits/sec 0 157 KBytes
|
|
[ 5] 21.00-22.00 sec 11.2 MBytes 93.8 Mbits/sec 0 157 KBytes
|
|
[ 5] 22.00-23.00 sec 11.2 MBytes 93.8 Mbits/sec 0 157 KBytes
|
|
- - - - - - - - - - - - - - - - - - - - - - - - -
|
|
[ ID] Interval Transfer Bitrate Retr
|
|
[ 5] 0.00-23.15 sec 260 MBytes 94.2 Mbits/sec 0 sender
|
|
[ 5] 0.00-23.15 sec 0.00 Bytes 0.00 bits/sec receiver
|
|
```
|
|
|
|
### DKMS
|
|
This driver can be installed using [DKMS]. This is a system which will automatically recompile and install a kernel module when a new kernel gets installed or updated. To make use of DKMS, install the `dkms` package, which on Debian (based) systems is done like this:
|
|
```
|
|
sudo apt-get install dkms
|
|
```
|
|
|
|
### Installation of Driver
|
|
In order to install the driver open a terminal in the directory with the source code and execute the following command:
|
|
```
|
|
sudo ./dkms-install.sh
|
|
```
|
|
|
|
### Removal of Driver
|
|
In order to remove the driver from your system open a terminal in the directory with the source code and execute the following command:
|
|
```
|
|
sudo ./dkms-remove.sh
|
|
```
|
|
|
|
### Make
|
|
For building & installing the driver with 'make' use
|
|
```
|
|
make
|
|
make install
|
|
```
|
|
|
|
### Notes
|
|
Download
|
|
```
|
|
git clone -b v5.6.4.1 https://github.com/aircrack-ng/rtl8812au.git
|
|
cd rtl*
|
|
```
|
|
Package / Build dependencies (Kali)
|
|
```
|
|
sudo apt-get install build-essential
|
|
sudo apt-get install bc
|
|
sudo apt-get install libelf-dev
|
|
sudo apt-get install linux-headers-`uname -r`
|
|
```
|
|
#### For Raspberry (RPI)
|
|
|
|
```
|
|
sudo apt-get install bc raspberrypi-kernel-headers
|
|
```
|
|
|
|
Then run this step to change platform in Makefile, For RPI 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
|
|
```
|
|
|
|
For setting monitor mode
|
|
1. Fix problematic interference in monitor mode.
|
|
```
|
|
airmon-ng check kill
|
|
```
|
|
You may also uncheck the box "Automatically connect to this network when it is avaiable" in nm-connection-editor. This only works if you have a saved wifi connection.
|
|
|
|
2. Set interface down
|
|
```
|
|
sudo ip link set wlan0 down
|
|
```
|
|
3. Set monitor mode
|
|
```
|
|
sudo iw dev wlan0 set type monitor
|
|
```
|
|
4. Set interface up
|
|
```
|
|
sudo ip link set wlan0 up
|
|
```
|
|
For setting TX power
|
|
```
|
|
sudo iw wlan0 set txpower fixed 3000
|
|
```
|
|
|
|
### LED control
|
|
|
|
#### You can now control LED behaviour statically by Makefile, for example:
|
|
|
|
```sh
|
|
CONFIG_LED_ENABLE = n
|
|
```
|
|
value can be y or n
|
|
|
|
#### statically by module parameter in /etc/modprobe.d/8812au.conf or wherever, for example:
|
|
|
|
```sh
|
|
options 88XXau rtw_led_enable=0
|
|
```
|
|
value can be 0 or 1
|
|
|
|
#### or dynamically by writing to /proc/net/rtl8812au/$(your interface name)/led_enable, for example:
|
|
|
|
```sh
|
|
$ echo "0" > /proc/net/rtl8812au/$(your interface name)/led_enable
|
|
```
|
|
value can be 0 or 1
|
|
|
|
#### check current value:
|
|
|
|
```sh
|
|
$ cat /proc/net/rtl8812au/$(your interface name)/led_enable
|
|
```
|
|
|
|
### NetworkManager
|
|
|
|
Newer versions of NetworkManager switches to random MAC address. Some users would prefer to use a fixed address.
|
|
Simply add these lines below
|
|
```
|
|
[device]
|
|
wifi.scan-rand-mac-address=no
|
|
```
|
|
at the end of file /etc/NetworkManager/NetworkManager.conf and restart NetworkManager with the command:
|
|
```
|
|
sudo service NetworkManager restart
|
|
```
|
|
|