Realtek 8822BU driver for Linux

Driver for 802.11ac USB Adapter with RTL8822BU chipset.

Currently, only STA/Monitor Mode is supported, no AP.

A few known wireless cards that use this driver include

• Edimax EW-7822ULC
• Edimax EW-7822UTC
• ASUS AC-53 NANO
• Linksys WUSB6400M

Prerequisite

On Debian and Ubuntu, install packages via apt:

$ sudo apt install dpkg-dev
$ sudo apt install build-essential libc6-dev linux-headers-`dpkg-architecture -qDEB_HOST_ARCH`

On the other distros, please refer their build instruction for kernel modules (Because I don't know so much any other than Debian/Ubuntu). And it would be appriciated if you would tell me the way.

Ubuntu kernel 4.15.30 or later also requires:

sudo apt install -y libelf-dev

Build and install.

### DKMS install

On Ubuntu and Debian derivatives it is recommended to use DKMS so that the module builds automatically for each newly acquired kernel. Put the repository into /usr/src/rtl8822bu-4.15, and execute:

dkms add     rtl8822bu/4.15
dkms build   rtl8822bu/4.15
dkms install rtl8822bu/4.15

### Manual install

Currently tested with Linux kernel 4.15.17 and 4.16.5 on X86_64 platform only.

To build, you have to retrieve source and run make. If via Git, do following:

$ git clone https://github.com/FomalhautWeisszwerg/rtl8822bu.git
$ cd rtl8822bu
$ make
$ sudo make install

Or via tarball, do:

$ curl -LO https://github.com/FomalhautWeisszwerg/rtl8822bu/archive/release-for-linux-4.15.tar.gz
$ tar -xf release-for-linux-4.15.tar.gz
$ cd rtl8822bu-release-for-linux-4.15/
$ make
$ sudo make install

To Unload driver you may need to disconnect the device.

NOTES

This driver allows use of wpa_supplicant by using the nl80211 driver wpa_supplicant -Dnl80211. If you use "Wicd Network Manager", you can use this driver with the following screenshot settings.

If installing on Rasberry Pi or other "armv71" devices, edit the Makefile and set CONFIG_PLATFORM_ARM_RPI = y and CONFIG_PLATFORM_I386_PC = n

Status

Driver basically works. Most of the work is done is cleaning the driver and make this mess readable for conversion. Updates for wireless-ext/cfg80211 are not accepted.

Bugs

If you find something, please report on GitHub issue.

Also Pull Requests are wellcome :-)