## RTL8812AU/21AU and RTL8814AU drivers ### Supports Realtek 8811, 8812, 8814 and 8821 chipsets [![Monitor mode](https://img.shields.io/badge/monitor%20mode-working-brightgreen.svg)](#) [![Frame Injection](https://img.shields.io/badge/frame%20injection-working-brightgreen.svg)](#) [![GitHub version](https://badge.fury.io/gh/aircrack-ng%2Frtl8812au.svg)](https://badge.fury.io/gh/aircrack-ng%2Frtl8812au) [![GitHub issues](https://img.shields.io/github/issues/aircrack-ng/rtl8812au.svg)](https://github.com/aircrack-ng/rtl8812au/issues) [![GitHub forks](https://img.shields.io/github/forks/aircrack-ng/rtl8812au.svg)](https://github.com/aircrack-ng/rtl8812au/network) [![GitHub stars](https://img.shields.io/github/stars/aircrack-ng/rtl8812au.svg)](https://github.com/aircrack-ng/rtl8812au/stargazers) [![GitHub license](https://img.shields.io/github/license/aircrack-ng/rtl8812au.svg)](https://github.com/aircrack-ng/rtl8812au/blob/master/LICENSE)
[![Kali](https://img.shields.io/badge/Kali-supported-blue.svg)](https://www.kali.org) [![aircrack-ng](https://img.shields.io/badge/aircrack--ng-supported-blue.svg)](https://github.com/aircrack-ng/aircrack-ng) [![wifite2](https://img.shields.io/badge/wifite2-supported-blue.svg)](https://github.com/derv82/wifite2) ### What's NEW ``` * december: working on a major update/bugfixes. may be seen rolling out over here https://github.com/aircrack-ng/rtl8812au/pull/246 * october: airmon-ng now got support for this driver (even without virtual interface support) ## Kernel v4.19 and v4.20 supported. ## Also working to get more old/new kernels supported. ``` ### 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.2.20 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 2/3) you will need kernel sources ``` $ sudo wget "https://raw.githubusercontent.com/notro/rpi-source/master/rpi-source" -O /usr/bin/rpi-source $ sudo chmod 755 /usr/bin/rpi-source $ sudo rpi-source ``` Then you need to download and compile the driver on the RPI ``` $ git clone https://github.com/aircrack-ng/rtl8812au -b v5.2.20 $ cd rtl* $ make $ sudo cp 8812au.ko /lib/modules/`uname -r`/kernel/drivers/net/wireless $ sudo depmod -a $ sudo modprobe 88XXau ``` 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' Makefil ``` 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 down ``` 3. Set monitor mode ``` $ sudo airmon-ng start or $ sudo iw dev set type monitor ``` 4. Set interface up ``` $ sudo ip link set up ``` For setting TX power ``` $ sudo iwconfig txpower 30 or $ sudo iw nset 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 whatever, 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 ```