Skip to content
Realtek RTL8811CU/RTL8821CU USB Wi-Fi adapter driver version 5.4.1 for Linux
C C++ Other
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
core First commit Mar 1, 2019
hal First commit Mar 1, 2019
include First commit Mar 1, 2019
os_dep Fixed: driver doesn't work on Linux 5.3.x Oct 22, 2019
platform First commit Mar 1, 2019
Kconfig First commit Mar 1, 2019
LICENSE Create LICENSE Mar 1, 2019
Makefile Fixed: driver doesn't work on Linux 5.3.x Oct 22, 2019
README.md Support Linux up to version 5.4.x Oct 22, 2019
changelog.pdf Driver changelog Mar 15, 2019
clean First commit Mar 1, 2019
dkms-install.sh Add dkms scripts for quick install Apr 30, 2019
dkms-remove.sh Add dkms scripts for quick install Apr 30, 2019
dkms.conf Update dkms.conf Mar 1, 2019
ifcfg-wlan0 First commit Mar 1, 2019
rtl8821c.mk First commit Mar 1, 2019
runwpa First commit Mar 1, 2019
wlan0dhcp First commit Mar 1, 2019

README.md

Realtek RTL8811CU/RTL8821CU USB wifi adapter driver version 5.4.1 for Linux 4.4.x up to 5.4.x

Before build this driver make sure make, gcc, linux-header and git have been installed.

First, clone this repository

mkdir -p ~/build
cd ~/build
git clone https://github.com/brektrou/rtl8821CU.git

Build and install with DKMS

DKMS 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.

Debian/Ubuntu:

sudo apt-get install dkms

Arch Linux/Manjaro:

sudo pacman -S dkms

To make use of the DKMS feature with this project, just run:

./dkms-install.sh

If you later on want to remove it, run:

./dkms-remove.sh

Plug your USB-wifi-adapter into your PC

If wifi can be detected, congratulations. If not, maybe you need to switch your device usb mode by the following steps in terminal:

  1. find your usb-wifi-adapter device ID, like "0bda:1a2b", by type:
lsusb
  1. switch the mode by type: (the device ID must be yours.)

Need install usb_modeswitch (Archlinux: sudo pacman -S usb_modeswitch)

sudo usb_modeswitch -KW -v 0bda -p 1a2b

It should work.

Build and install without DKMS

Use following commands:

cd ~/build/rtl8821CU
make
sudo make install

If you later on want to remove it, do the following:

cd ~/build/rtl8821CU
sudo make uninstall

Checking installed driver

If you successfully install the driver, the driver is installed on /lib/modules/<linux version>/kernel/drivers/net/wireless/realtek/rtl8821cu. Check the driver with the ls command:

ls /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtl8821cu

Make sure 8821cu.ko file present on that directory

Check with DKMS (if installing via DKMS):

sudo dkms status

ARM architecture tweak for this driver (this solves compilation problem of this driver):

sudo cp /lib/modules/$(uname -r)/build/arch/arm/Makefile /lib/modules/$(uname -r)/build/arch/arm/Makefile.$(date +%Y%m%d%H%M)
sudo sed -i 's/-msoft-float//' /lib/modules/$(uname -r)/build/arch/arm/Makefile
sudo ln -s /lib/modules/$(uname -r)/build/arch/arm /lib/modules/$(uname -r)/build/arch/armv7l
You can’t perform that action at this time.