Realtek RTL8811CU/RTL8821CU USB Wi-Fi adapter driver for Linux

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

brektrou 47f98e3529 Revert "Allow compilation on Centos 7.3"		5 years ago
core	This fixes compilation	5 years ago
hal	Fix FCS on 8811	6 years ago
include	First commit	6 years ago
os_dep	Revert "Allow compilation on Centos 7.3"	5 years ago
platform	First commit	6 years ago
Kconfig	First commit	6 years ago
LICENSE	Create LICENSE	6 years ago
Makefile	Update Makefile	5 years ago
README.md	Update README.md	5 years ago
changelog.pdf	Driver changelog	6 years ago
clean	First commit	6 years ago
dkms-install.sh	Add dkms scripts for quick install	6 years ago
dkms-remove.sh	Add dkms scripts for quick install	6 years ago
dkms.conf	Update dkms.conf	6 years ago
ifcfg-wlan0	First commit	6 years ago
rtl8821c.mk	First commit	6 years ago
runwpa	First commit	6 years ago
wlan0dhcp	First commit	6 years ago

README.md

Realtek RTL8811CU/RTL8821CU USB wifi adapter driver version 5.4.1 for Linux 4.4.x up to 5.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:

find your usb-wifi-adapter device ID, like "0bda:1a2b", by type:

lsusb

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
systemctl start bluetooth.service - starting Bluetooth service if it's in inactive state

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

Monitor mode

Use the tool 'iw', please don't use other tools like 'airmon-ng'

iw dev wlan0 set monitor none