• Stars
    star
    162
  • Rank 232,284 (Top 5 %)
  • Language
    C
  • Created almost 3 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

This repo is was started with the code from the Realtek USB driver RTL8852AU_WiFi_linux_v1.15.0.1-0-g487ee886.20210714. The current code improves on the Realtek code by reworking the debug output to avoid spamming the logs. In the current settings, messages from RTW_ERR(), RTW_WARNING(), and RTW_WARNING() will be output.

If you want more output, increase the value of CONFIG_RTW_LOG_LEVEL in Makefile. This parameter should probably be one that can be set at module load time, but that is a matter for another time.

The driver supports rtl8832au/rtl8852au chipsets.

This driver currently handles the following devices:

  • BUFFALO WI-U3-1200AX2(/N) with USB ID 0411:0312
  • ASUS USB-AX56 with USB ID 0b05:1997
  • ASUS USB-AX56 with USB ID 0b05:1a62
  • EDUP EP-AX1696GS with USB ID 0bda:8832
  • Fenvi FU-AX1800P with USB ID 0bda:885c
  • Realtek Demo Board with USB ID 0bda:8832
  • Realtek Demo Board with USB ID 0bda:885a
  • Realtek Demo Board with USB ID 0bda:885c
  • D-Link DWA-X1850 with USB ID 2001:3321
  • TP-Link AX1800 with USB ID 2357:013f
  • ipTIME AX2000U with USB ID 0bda:8832

The D-Link DWA-X1850 comes with a configuration that appears to be a USB disk, which contains a Windows driver. If a 'lsusb' command shows the ID 0bda:1a2b, then this disk is mounted. The way to avoid this is to edit either file /usr/lib/udev/rules.d/40-usb_modeswitch.rules, or /lib/udev/rules.d/40-usb_modeswitch.rules, whichever is on your system, and add the following lines:

D-Link DWA-X1850 Wifi Dongle

ATTR{idVendor}=="0bda", ATTR{idProduct}=="1a2b", RUN+="usb_modeswitch '/%k'"

Installation instruction

Requirements

You will need to install "make", "gcc", "kernel headers", "kernel build essentials", and "git".

For Ubuntu: You can install them with the following command

sudo apt-get update
sudo apt-get install make gcc linux-headers-$(uname -r) build-essential git

For Fedora: You can install them with the following command

sudo dnf install kernel-headers kernel-devel
sudo dnf group install "C Development Tools and Libraries"

For openSUSE: Install necessary headers with

sudo zypper install make gcc kernel-devel kernel-default-devel git libopenssl-devel

For Arch: After installing the necessary kernel headers and base-devel,

git clone https://aur.archlinux.org/rtw89-dkms-git.git
cd rtw89-dkms-git
makepkg -sri

If any of the packages above are not found check if your distro installs them like that.

Installation

When a USB device is plugged in, or detected at boot, this rule causes the utulity usb_modeswitch to unload any 0bda:1a2b devices that it finds. If you have a device with different ID, change the rule accordingly.

The build this driver, do the following:

For all distros:

git clone https://github.com/lwfinger/rtl8852au.git
cd rtl8852au
make
sudo make install

When you get a new kernel, you will need to rebuild the driver. Do the following:
cd rtl8852au
git pull
make
sudo make install

When your kernel is updated, then do a 'git pull' and redo the make commands.

Installation with module signing for SecureBoot

For all distros:

git clone git://github.com/lwfinger/rtl8814au.git
cd rtl8814au
make
sudo make sign-install

You will be promted for a password, please keep it in mind and use it in next steps.

Reboot to activate the new installed module. In the MOK managerment screen:

  1. Select "Enroll key" and enroll the key created by above sign-install step
  2. When promted, enter the password you entered when create sign key.

If you enter wrong password, your computer won't not rebootable. In this case, use the BOOT menu from your BIOS, to boot into your OS then do below steps:

sudo mokutil --reset

Restart your computer Use BOOT menu from BIOS to boot into your OS In the MOK managerment screen, select reset MOK list Reboot then retry from the step make sign-install

Adding modules to DKMS for Debian/Ubuntu

DKMS automatically rebuilds the driver module for each kernel update. (So that you don't have to make; make install at every update)

Build and Installation (For currently active kernel)

# Add module to dkms tree
sudo dkms add .

# Build 
sudo dkms build rtl8852au -v 1.15.0.1

# Install 
sudo dkms install rtl8852au -v 1.15.0.1

# Check installation
modinfo 8852au

# Load driver 
modprobe 8852au

Larry Finger

More Repositories

1

rtl8188eu

Repository for stand-alone RTL8188EU driver.
C
1,590
star
2

rtw89

Driver for Realtek 8852AE, an 802.11ax device
C
1,175
star
3

rtw88

A backport of the Realtek Wifi 5 drivers from the wireless-next repo.
C
577
star
4

rtl8723bu

Driver for RTL8723BU
C
270
star
5

rtl8723au

Repo for RTL8723AU code before Linux Kernel commit
C
124
star
6

rtl8723au_bt

Bluetooth driver for RTL8723AE and RTL8723AU
C
118
star
7

rtw8852be

Linux driver for RTW8852BE PCIe card
86
star
8

rtl8723du

C
82
star
9

rtl8192du

Source code for RTL8192DU device
C
74
star
10

rtl8723bs_bt

Bluetooth Code for RTL8723bs
C
70
star
11

rtw89-BT

Out-of-kernel driver for Realtek BT devices found in rtw89 devides.
C
57
star
12

rtl8192ee

Alternate (vendor) driver for RTL8192EE
C
57
star
13

rtl8812au

C
56
star
14

rtl8188gu

This repo contains a Linux driver for the RTL8188GU
C
48
star
15

rtl8723be

This repo is obsolete. Use lwfinger/rtlwifi_new instead.
44
star
16

rtl8723ds

Linux driver for RTL8723DS.
C
38
star
17

rtl8192cu

Repository for vendor driver for RTL8192CU
C
29
star
18

rtl8xxxu

Repository that tracks drivers/net/wireless/realtek/rtl8xxxu in wireless_next repository
C
19
star
19

realtek_bluetooth

A backport of the current kernel code for most Realtek Bluetooth devices
C
13
star
20

rtl8190p

Repo for driver for RTL8190P PCI device
C
8
star
21

rtw8852cu

C
7
star
22

rtl8723de

C
5
star
23

sa-btusb

Stand-alone backported Bluetooth drivers for Realtek devices
C
4
star
24

rtw8821be

Realtek Linux Driver for RTW8852BE - will eventually be covered in rtw89 - this is a stopgap
2
star
25

linux-wireless-tools

Tools to backport patches from wireless_next to rtw88/rtw89/rtl8xxxa
2
star
26

rtl8852bu

Vendor driver for RTW8852BU/RTW8832BU
C
1
star