No description, website, or topics provided.
Clone or download
Pull request Compare This branch is 4 commits ahead, 88 commits behind lwfinger:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
core
hal
include
os_dep
.gitignore
Kconfig
Makefile
README.md
clean
dkms.conf
ifcfg-wlan0
install.sh
runwpa
wlan0dhcp

README.md

Realtek 802.11ac (rtl8812au)

This is a fork of git://github.com/gnab/rtl8812au.git, which was based on the Realtek 802.11ac (rtl8812au) v4.2.2 (7502.20130507) driver. This version is fixed to build on Linux kernel up to version 4.14.

Purpose

The D-Link DWA-171 wireless dual-band USB adapter needs the Realtek 8812au driver to work under Linux.

Building

The Makefile is preconfigured to handle most x86/PC versions. If you are compiling for something other than an intel x86 architecture, you need to first select the platform, e.g. for the Raspberry Pi, you need to set the I386 to n and the ARM_RPI to y:

...
CONFIG_PLATFORM_I386_PC = n
...
CONFIG_PLATFORM_ARM_RPI = y

There are many other platforms supported and some other advanced options, e.g. PCI instead of USB, but most won't be needed.

The driver is built by running make, and can be tested by loading the built module using insmod:

$ make
$ sudo insmod 8812au.ko

After loading the module, a wireless network interface named Realtek 802.11n WLAN Adapter should be available.

Installing

Installing the driver is simply a matter of copying the built module into the correct location and updating module dependencies using depmod:

$ sudo cp 8812au.ko /lib/modules/$(uname -r)/kernel/drivers/net/wireless
$ sudo depmod

The driver module should now be loaded automatically.

DKMS

Automatically rebuilds and installs on kernel updates. DKMS is in official sources of Ubuntu, for installation do:

$ sudo apt-get install build-essential dkms 

The driver source mus be copied to /usr/src/8812au-4.2.2

Then add it to DKMS:

$ sudo dkms add -m 8812au -v 4.2.2
$ sudo dkms build -m 8812au -v 4.2.2
$ sudo dkms install -m 8812au -v 4.2.2

Check with:

$ sudo dkms status

Eventually remove from DKMS with:

$ sudo dkms remove -m 8812au -v 4.2.2 --all

References