mirrors/rtl8812au
1
0
Fork 0
mirror of https://github.com/aircrack-ng/rtl8812au.git synced 2024-11-22 21:34:37 +00:00
Code Releases Activity

Beatify README md

Browse Source
This commit is contained in:
Christian Bremvåg 2019-11-14 23:19:48 +01:00 committed by GitHub
parent 55484785cc
commit ac911b45c8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 33 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
README.md
View File

@ -36,13 +36,14 @@ interference with 'airmon-ng check kill' or 'kill -9 <pid>' first!
* Android 10 supported * Android 10 supported
* Monitor mode * Monitor mode
* Frame injection * Frame injection
* MESH Mode (IBSS)
* WPA3 SAE * WPA3 SAE
* Wi-Fi Direct * Wi-Fi Direct
* wpa_supplicant * wpa_supplicant
* Hostapd * Hostapd
* USB 3.0 (currently forced down to 2.0) * USB 3.0 (currently forced down to 2)
* Kernel up to v5.3+ * Kernel up to v5.3+
* RTKMPtool for low level debug * RTKMPtool Android app (low level debug)
``` ```
### Known Issues ### Known Issues
@ -59,7 +60,7 @@ interference with 'airmon-ng check kill' or 'kill -9 <pid>' first!
``` ```
* Do a walkthrough in the code, use some time and * Do a walkthrough in the code, use some time and
check every corner og HAL and PHYDM for more junk & bugs. check every corner of HAL and PHYDM for more junk & bugs.
``` ```
### IPERF3 benchmark ### IPERF3 benchmark
<b>[Device]</b> Alfa Networks AWUS036ACH<br> <b>[Device]</b> Alfa Networks AWUS036ACH<br>
@ -100,45 +101,45 @@ interference with 'airmon-ng check kill' or 'kill -9 <pid>' first!
### DKMS ### 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: 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 $ sudo apt-get install dkms
``` ```
### Installation of Driver ### Installation of Driver
In order to install the driver open a terminal in the directory with the source code and execute the following command: 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 $ sudo ./dkms-install.sh
``` ```
### Removal of Driver ### 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: 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 $ sudo ./dkms-remove.sh
``` ```
### Make ### Make
For building & installing the driver with 'make' use For building & installing the driver with 'make' use
``` ```
make $ make
make install $ make install
``` ```
### Notes ### Notes
Download Download
``` ```
git clone -b v5.6.4.2 https://github.com/aircrack-ng/rtl8812au.git $ git clone -b v5.6.4.2 https://github.com/aircrack-ng/rtl8812au.git
cd rtl* cd rtl*
``` ```
Package / Build dependencies (Kali) Package / Build dependencies (Kali)
``` ```
sudo apt-get install build-essential $ sudo apt-get install build-essential
sudo apt-get install bc $ sudo apt-get install bc
sudo apt-get install libelf-dev $ sudo apt-get install libelf-dev
sudo apt-get install linux-headers-`uname -r` $ sudo apt-get install linux-headers-`uname -r`
``` ```
#### For Raspberry (RPI) #### For Raspberry (RPI)
``` ```
sudo apt-get install bc raspberrypi-kernel-headers $ sudo apt-get install bc raspberrypi-kernel-headers
``` ```
Then run this step to change platform in Makefile, For RPI 1/2/3/ & 0/Zero: Then run this step to change platform in Makefile, For RPI 1/2/3/ & 0/Zero:
@ -155,32 +156,32 @@ $ sed -i 's/CONFIG_PLATFORM_ARM64_RPI = n/CONFIG_PLATFORM_ARM64_RPI = y/g' Makef
In addition, if you receive an error message about `unrecognized command line option ‘-mgeneral-regs-only’` (i.e., Raspbian Buster), you will need to run the following commands: In addition, if you receive an error message about `unrecognized command line option ‘-mgeneral-regs-only’` (i.e., Raspbian Buster), you will need to run the following commands:
``` ```
sed -i 's/^dkms build/ARCH=arm dkms build/' dkms-install.sh $ sed -i 's/^dkms build/ARCH=arm dkms build/' dkms-install.sh
sed -i 's/^MAKE="/MAKE="ARCH=arm\ /' dkms.conf $ sed -i 's/^MAKE="/MAKE="ARCH=arm\ /' dkms.conf
``` ```
For setting monitor mode For setting monitor mode
1. Fix problematic interference in monitor mode. 1. Fix problematic interference in monitor mode.
``` ```
airmon-ng check kill $ 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. 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 2. Set interface down
``` ```
sudo ip link set wlan0 down $ sudo ip link set wlan0 down
``` ```
3. Set monitor mode 3. Set monitor mode
``` ```
sudo iw dev wlan0 set type monitor $ sudo iw dev wlan0 set type monitor
``` ```
4. Set interface up 4. Set interface up
``` ```
sudo ip link set wlan0 up $ sudo ip link set wlan0 up
``` ```
For setting TX power For setting TX power
``` ```
sudo iw wlan0 set txpower fixed 3000 $ sudo iw wlan0 set txpower fixed 3000
``` ```
### LED control ### LED control
@ -230,23 +231,22 @@ wifi.scan-rand-mac-address=no
``` ```
at the end of file /etc/NetworkManager/NetworkManager.conf and restart NetworkManager with the command: at the end of file /etc/NetworkManager/NetworkManager.conf and restart NetworkManager with the command:
``` ```
sudo service NetworkManager restart $ sudo service NetworkManager restart
``` ```
### Credits / Contributors ### Credits / Contributors
``` ```
Alfa Networks - https://www.alfa.com.tw/
Realtek. - https://www.realtek.com
aircrack-ng - https://www.aircrack-ng.org
astsam - https://github.com/astsam astsam - https://github.com/astsam
aircrack-ng - https://github.com/aircrack-ng
evilphish - https://github.com/evilphish evilphish - https://github.com/evilphish
fariouche - https://github.com/fariouche fariouche - https://github.com/fariouche
CGarces - https://github.com/CGarces CGarces - https://github.com/CGarces
ZerBea - https://github.com/ZerBea ZerBea - https://github.com/ZerBea
lwfinger - https://github.com/lwfinger lwfinger - https://github.com/lwfinger
Ulli-Kroll - https://github.com/Ulli-Kroll Ulli-Kroll. - https://github.com/Ulli-Kroll
Also, thanks to Realtek and Alfa Networks for all they're help & support.
All the others interested and participating. Appreciate it!
``` ```