Skip to content

Linux support for RTL8812BU based products

Compatibility information

Chipset VID&PID 0bda:b812
Related products AWUS036ACU
Linux Hardware https://linux-hardware.org/index.php?id=usb:0bda-b812

Support status:

Kali 2021.2 Need compile driver from source
Kali 2020.4 Need compile driver from source
Ubuntu 20.10 Need compile driver from source
Ubuntu 20.04 Need compile driver from source
Debian 10.7.0 Need compile driver from source
Raspberry Pi OS (32-bit) Need compile driver from source

Drivers

Linux kernel mainline

LKDDb Not supported by upstream Linux kernel
Support kernel versions Not listed
Linux Wireless Wiki Not listed

GitHub - EntropicEffect/rtl8822bu

URL: https://github.com/EntropicEffect/rtl8822bu

GitHub - kimocoder/rtw88-usb

URL: https://github.com/kimocoder/rtw88-usb

GitHub - github.com/fastoe

URL: https://github.com/fastoe/RTL8812BU

Driver installation

Kali

Method 1

STEP 1 : Open Terminal Emulator

STEP 2 : Run commands

sudo apt update
which bc || sudo apt install bc

STEP 3 : Download driver source

git clone https://github.com/EntropicEffect/rtl8822bu.git

STEP 4 : Compile and install

cd rtl8822bu
sed -i Makefile -e "s/CONFIG_80211W = n/CONFIG_80211W = y/g"
sed -i Makefile -e "s/CONFIG_WIFI_MONITOR = n/CONFIG_WIFI_MONITOR = y/g"
make
sudo make install

STEP 5 (Optional): Check driver existance

Run commands below:

find /lib/modules/`uname -r`/ -name "88x2bu.ko"

There should be a file in search result if driver was successfully installed.

Note

Remember to plug the dongle out and in once to get the driver reloaded.

Method 2 (using rtw88-usb)

STEP 1 : Open Terminal Emulator

STEP 2 : Download driver source

git clone https://github.com/kimocoder/rtw88-usb.git

STEP 3 : Compile and install

cd rtw88-usb
make
sudo make install

Note

Remember to plug the dongle out and in once to get the driver reloaded.

Method 3 (using fastoe)

STEP 1 : Open Terminal Emulator

STEP 2 : Run commands

sudo apt update
sudo apt install dkms git bc

STEP 3 : Download driver source

git clone -b v5.6.1 https://github.com/fastoe/RTL8812BU.git

STEP 4 : Compile and install

cd RTL8812BU
sed -i 's/CONFIG_80211W = n/CONFIG_80211W = y/' Makefile
sed -i 's/CONFIG_WIFI_MONITOR = n/CONFIG_WIFI_MONITOR = y/' Makefile
make
sudo make install

Ubuntu

STEP 1 : Open Terminal Emulator

STEP 2 : Run commands

sudo apt update
sudo apt install git build-essential

STEP 3 : Download driver source

git clone https://github.com/EntropicEffect/rtl8822bu.git

STEP 4 : Compile and install

cd rtl8822bu
make
sudo make install

STEP 5 (Optional): Check driver existance

Run commands below:

find /lib/modules/`uname -r`/ -name "88x2bu.ko"

There should be a file in search result if driver was successfully installed.

Note

Remember to plug the dongle out and in once to get the driver reloaded.

Debian

STEP 1 : Open Terminal Emulator

STEP 2 : Run commands

sudo apt update
sudo apt install bc git build-essential

STEP 3 : Download driver source

git clone https://github.com/EntropicEffect/rtl8822bu.git

STEP 4 : Compile and install

cd rtl8822bu
make
sudo make install

STEP 5 (Optional): Check driver existance

Run commands below:

find /lib/modules/`uname -r`/ -name "88x2bu.ko"

There should be a file in search result if driver was successfully installed.

Note

Remember to plug the dongle out and in once to get the driver reloaded.

Raspberry Pi OS

STEP 1 : Open Terminal

STEP 2 : Run commands

sudo apt update
sudo apt upgrade
sudo apt install raspberrypi-kernel-headers

Reboot after commands above finish to have new updates applied.

STEP 3 : Download driver source

git clone https://github.com/EntropicEffect/rtl8822bu.git

STEP 4 : Edit source codes

Enter source directory:

cd rtl8822bu

Edit the Makefile file to change the following lines from

SUBARCH := $(shell uname -m | sed -e s/i.86/i386/)

to

SUBARCH := $(shell uname -m | sed -e s/i.86/i386/ | sed -i "s/armv.l/arm/")

STEP 4 : Compile and install

make
sudo make install

STEP 5 (Optional): Check driver existance

Run commands below:

find /lib/modules/`uname -r`/ -name "88x2bu.ko"

There should be a file in search result if driver was successfully installed.

Note

Remember to plug the dongle out and in once to get the driver reloaded.