RTL88x2BU-Linux-Driver/README.md

136 lines
3.1 KiB
Markdown
Raw Normal View History

2021-11-02 23:20:23 +00:00
# REALTEK RTL88x2B USB Linux Driver
2021-12-04 12:42:09 +00:00
**Current Driver Version**: 5.13.1
2022-02-20 01:46:37 +00:00
**Support Kernel**: 2.6.24 ~ 5.17 (with unofficial patches)
2019-11-15 00:03:05 +00:00
2021-11-02 23:20:23 +00:00
Official release note please check ReleaseNotes.pdf
2019-11-15 00:03:05 +00:00
**Note:** if you believe your device is **RTL8812BU** or **RTL8822BU** but after loaded the module no NIC shows up, the device ID maybe not in the driver whitelist. In this case please submit a new issue with `lsusb` result, and your device name, brand, website, etc.
2020-01-24 08:20:42 +00:00
2020-07-22 20:21:43 +00:00
## Supported Devices
<details>
<summary>
ASUS
</summary>
2020-07-22 20:19:11 +00:00
* ASUS AC1300 USB-AC55 B1
* ASUS U2
* ASUS USB-AC53 Nano
2021-08-28 10:51:42 +00:00
* ASUS USB-AC58
</details>
<details>
<summary>
Dlink
</summary>
2020-07-22 20:19:11 +00:00
* Dlink - DWA-181
* Dlink - DWA-182
2022-05-07 02:30:48 +00:00
* Dlink - DWA-183 D Version
* Dlink - DWA-185
</details>
<details>
<summary>
Edimax
</summary>
2020-07-22 20:19:11 +00:00
* Edimax EW-7822ULC
* Edimax EW-7822UTC
2021-07-20 15:38:57 +00:00
* Edimax EW-7822UAD
</details>
<details>
<summary>
NetGear
</summary>
2020-08-02 11:16:32 +00:00
* NetGear A6150
</details>
<details>
<summary>
TP-Link
</summary>
2020-07-22 20:19:11 +00:00
* TP-Link Archer T3U
2020-08-02 11:16:32 +00:00
* TP-Link Archer T3U Plus
2020-07-22 20:19:11 +00:00
* TP-Link Archer T4U V3
* TP-Link Archer T4U Plus
</details>
<details>
<summary>
TRENDnet
</summary>
2020-08-10 00:37:18 +00:00
* TRENDnet TEW-808UBM
</details>
<details>
<summary>
ZYXEL
</summary>
2021-10-14 21:42:35 +00:00
* ZYXEL NWD6602
</details>
2020-07-22 20:20:42 +00:00
2020-07-22 20:19:11 +00:00
And more.
2020-01-24 08:20:42 +00:00
# How to use this kernel module
2021-02-18 13:45:30 +00:00
* Ensure you have C compiler & toolchains, e.g. `build-essential` for Debian/Ubuntu, `base-devel` for Arch, etc.
* Make sure you have installed the corresponding kernel headers
2020-01-24 08:20:42 +00:00
* All commands need to be run in the driver directory
2020-10-13 02:06:30 +00:00
* You need rebuild the kernel module everytime you update/change the kernel if you are not using DKMS
2021-02-18 13:45:30 +00:00
2020-10-13 02:06:30 +00:00
## Manual installation
### Clean
* Make sure you cleaned old build files before builds new one
```
make clean
```
### Building module for current running kernel
2020-01-24 08:20:42 +00:00
```
make
```
2020-10-13 02:06:30 +00:00
### Building module for other kernels
```
make KSRC=/lib/modules/YOUR_KERNEL_VERSION/build
```
### Installing
2020-01-24 08:20:42 +00:00
```
sudo make install
```
2020-10-13 02:06:30 +00:00
### Uninstalling
2020-01-24 08:20:42 +00:00
```
sudo make uninstall
```
2020-10-13 02:06:30 +00:00
## Manual DKMS installation
```
git clone "https://github.com/RinCat/RTL88x2BU-Linux-Driver.git" /usr/src/rtl88x2bu-git
sed -i 's/PACKAGE_VERSION="@PKGVER@"/PACKAGE_VERSION="git"/g' /usr/src/rtl88x2bu-git/dkms.conf
dkms add -m rtl88x2bu -v git
dkms autoinstall
```
2020-08-05 09:18:06 +00:00
# USB 3.0 Support
2021-11-02 23:20:23 +00:00
You can try use `modprobe 88x2bu rtw_switch_usb_mode=1` to force the adapter run under USB 3.0. But if your adapter/port/motherboard not support it, the driver will be in restart loop. Remove the parameter and reload the driver to restore. Alternatively, `modprobe 88x2bu rtw_switch_usb_mode=2` let\'s it run as USB 2 device.
2021-04-28 23:40:40 +00:00
Notice: If you had already loaded the moduel, use `modprobe -r 88x2bu` to unload it first.
If you want to force a given mode permanently (even when switching the adapter across devices), create the file `/etc/modprobe.d/99-RTL88x2BU.conf` with the following content:
`options 88x2bu rtw_switch_usb_mode=1`
2020-01-24 08:20:42 +00:00
2020-09-20 23:25:40 +00:00
# Debug
Set debug log use `echo 5 > /proc/net/rtl88x2bu/log_level` or `modprobe 88x2bu rtw_drv_log_level=5`
2020-01-24 08:20:42 +00:00
# Distribution
* Archlinux AUR https://aur.archlinux.org/packages/rtl88x2bu-dkms-git/