Git Product home page Git Product logo

rtw88-usb's Introduction

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.

For a backport version (backport to kernel v4.15), please check this branch.

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.

rtw88-usb's People

Contributors

neojou avatar ulli-kroll avatar borting avatar kimocoder avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.