Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gnab/rtl8812au
Realtek 802.11n WLAN Adapter Linux driver
https://github.com/gnab/rtl8812au
Last synced: 4 days ago
JSON representation
Realtek 802.11n WLAN Adapter Linux driver
- Host: GitHub
- URL: https://github.com/gnab/rtl8812au
- Owner: gnab
- Created: 2013-11-20T19:36:57.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2024-06-03T21:42:32.000Z (8 months ago)
- Last Synced: 2025-01-09T17:37:44.545Z (11 days ago)
- Language: C
- Size: 1.98 MB
- Stars: 1,700
- Watchers: 104
- Forks: 551
- Open Issues: 134
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Changes
2019-07-11: Updated to compile against kernel 5.2
## Realtek 802.11ac (rtl8812au)
This is a fork of the Realtek 802.11ac (rtl8812au) v4.2.2 (7502.20130507)
driver altered to build on Linux kernel version >= 3.10.
### Purpose
My D-Link DWA-171 wireless dual-band USB adapter needs the Realtek 8812au
driver to work under Linux.
The current rtl8812au version (per nov. 20th 2013) doesn't compile on Linux
kernels >= 3.10 due to a change in the proc entry API, specifically the
deprecation of the `create_proc_entry()` and `create_proc_read_entry()`
functions in favor of the new `proc_create()` function.
### 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:
```sh
...
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`:
```sh
$ 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`:
```sh
$ 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:
```sh
$ sudo apt-get install build-essential dkms
```
Install the driver to DKMS with:
```sh
sudo make dkms_install
```
Automatically load at boot:
```sh
$ echo 8812au | sudo tee -a /etc/modules
```
Eventually remove from DKMS with:
```sh
$ sudo make dkms_remove
```
### References
- D-Link DWA-171
- [D-Link page](http://www.dlink.com/no/nb/home-solutions/connect/adapters/dwa-171-wireless-ac-dual-band-usb-adapter)
- [wikidevi page](http://wikidevi.com/wiki/D-Link_DWA-171_rev_A1)