rtl8812au

Realtek 8812AU driver v5.2.20 with monitor mode and frame injection

Only supports 8812AU chipset, not the 8814AU or the 8821AU at this point.

Changelogs and TODO

Check the "docs/" folder for more information. Both Realtek changelog is added and our personal changelog and TODO is in there.

Building / Installing

To build and install module manually:

$ make
$ sudo make install

To use dkms install:

$ sudo ./dkms-install.sh

To use dkms uninstall and remove:

$ sudo ./dkms-remove.sh

Notes

Download

git clone -b v5.1.5 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) also

sudo apt install raspberrypi-kernel-headers

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

LED control

You can now control LED behaviour statically by Makefile, for example:

CONFIG_LED_ENABLE = n

value can be y or n

statically by module parameter in /etc/modprobe.d/8812au.conf or wherever, for example:

options 8812au 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:

$ echo "0" > /proc/net/rtl8812au/$(your interface name)/led_enable

value can be 0 or 1

check current value:

$ 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