Skip to content

8723d 8821c 8822bu 8812bu 8822cu 8812cu linux mac80211 driver

License

Notifications You must be signed in to change notification settings

smutking/rtw88-usb

This branch is 13 commits behind kimocoder/rtw88-usb:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

1bf9e2b · Apr 26, 2021
Jul 7, 2020
Apr 26, 2021
Jul 7, 2020
Feb 3, 2021
Jul 7, 2020
Mar 8, 2020
Mar 9, 2021
May 20, 2020
Mar 10, 2020
Nov 7, 2019
Mar 10, 2020
Apr 2, 2021
Mar 17, 2021
Feb 2, 2021
Feb 2, 2021
Mar 9, 2021
Apr 26, 2021
Apr 26, 2021
Apr 26, 2021
Apr 26, 2021
Feb 2, 2021
Feb 2, 2021
Apr 26, 2021
Apr 26, 2021
Apr 26, 2021
Apr 3, 2021
Apr 3, 2021
Apr 26, 2021
Apr 3, 2021
Apr 26, 2021
Apr 26, 2021
Apr 26, 2021
Feb 25, 2020
Apr 26, 2021
Apr 26, 2021
Feb 2, 2021
Feb 2, 2021
Apr 26, 2021
Feb 2, 2021
Feb 2, 2021
Apr 26, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Apr 26, 2021
Feb 11, 2021
Feb 11, 2021
Feb 11, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 25, 2020
Nov 18, 2019
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Apr 26, 2021
Apr 26, 2021
Apr 26, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Apr 26, 2021
Apr 26, 2021
Mar 9, 2021
Feb 2, 2021
Nov 7, 2019
Apr 26, 2021
Apr 26, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021
Feb 2, 2021

Repository files navigation

rtw88-usb

It's under GPL license, and please feel free to use it. Also welcome to upstream to the Linux kernel if you want, and please refer to the branch, for_kernel_upstream, which meets the Linux coding style, and may be easier to upstream.

Thank to many people's kind help on this project.

Driver for 802.11ac USB Adapter with chipset: RTL88x2BU / RTL88x2CU

supports at least managed (i.e. client) and monitor mode.

This driver is based on Realtek's rtw88 driver in Linux main trunk.

A few known wireless cards that use this driver include

Build

$ make clean
$ make

Installation

Load driver for test:

$ sudo mkdir -p /lib/firmware/rtw88
$ sudo cp fw/rtw8822* /lib/firmware/rtw88/
$ sudo insmod rtw88.ko
$ sudo insmod rtwusb.ko

Load driver at boot:

$ sudo mkdir -p /lib/firmware/rtw88
$ sudo cp fw/rtw8822* /lib/firmware/rtw88/
$ sudo mkdir /lib/modules/`uname -r`/kernel/drivers/net/wireless/realtek/rtw88
$ sudo cp rtw88.ko /lib/modules/`uname -r`/kernel/drivers/net/wireless/realtek/rtw88
$ sudo cp rtwusb.ko /lib/modules/`uname -r`/kernel/drivers/net/wireless/realtek/rtw88
$ sudo depmod -a
$ sudo echo -e "rtw88\nrtwusb" > /etc/modules-load.d/rtwusb.conf
$ sudo systemctl start systemd-modules-load

General Commands

Scan:

$ sudo iw wlanX scan

Connect to the AP without security:

$ sudo iw wlanX connect <AP name>

Wifi Sniffer - monitor mode

$ sudo ip link set wlanX down
$ sudo iw dev wlanX set type monitor
$ sudo rfkill unblock all
$ sudo ip link set wlanX up

Then you can use "iw info" to check if the wireless mode is correct.

e.g.
    wlan1    IEEE 802.11  Mode:Monitor ... 

And you can use the program like wireshark to sniffer wifi packets.

  1. set up the sniffer channel
$ sudo iw dev wlanX set channel xxx
  1. run the program
$ sudo wireshark

Test

test ok with general commands with the latest kernel ubuntu 18 + kernel v5.3 test with Network Manager ok.

Known Issues

  • Currently, this driver is not upstreamed to Linux kernel driver rtw88 yet. That means, loading this module will cause unpredictable results to other working Realtek wifi pcie device, especially to those laptops with Realtek wifi IC running kernel > v5.2.

About

8723d 8821c 8822bu 8812bu 8822cu 8812cu linux mac80211 driver

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 93.7%
  • Perl 6.1%
  • Other 0.2%