百科.dev
全部条目AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
R

rtl88x2bu

> 编程语言
开源

为当前内核更新了 rtl88x2bu 驱动程序。

1.8K stars0 点赞0 次浏览
访问官网GitHub

工具介绍

为当前内核更新了 rtl88x2bu 驱动程序。

Driver for rtl88x2bu wifi adaptors

Updated driver for rtl88x2bu wifi adaptors based on Realtek's source distributed with myriad adapters.

Realtek's 5.6.1.6 source was found bundled with the Cudy WU1200 AC1200 High Gain USB Wi-Fi Adapter and can be downloaded from Cudy's website.

Pending Deprecation

A few versions ago (around 6.4 IIRC), rtw88x2bu support has been added to the mainline Linux kernel. This repo will be maintained until we either receive a few comments on https://github.com/cilynx/rtl88x2bu/issues/270 that the mainline driver is working well or MaxG87 and cilynx agree that no feedback means no one is still using this driver and we make the executive decision to archive it.

NOTE: As of Linux v6.16, the maintainer is no longer using the driver themself. Due to ongoing stability issues with either the Wifi dongle or the driver of this repository the maintainer switched to a new Wifi dongle that is supported by the mainline kernel. Therefore, the maintainer will not be able to detect subtle issues themself anymore.

Compatibility

Build confirmed on:

  • Linux version 5.4.0-91-generic on Linux Mint 20.2 (30 November 2021)
  • Linux version 5.15.89 on Manjaro (3 February 2023)
  • Linux version 5.19 on Ubuntu 22.4
  • Linux version 6.1.0-9-amd64 on Debian Bookworm
  • Linux version 6.1.* to 6.12.* (self-compiled) on Debian and Ubuntu 22.04
  • Linux version 6.10.3 to 6.12.10 on Debian Trixie
  • Linux version 6.13.0 (self-compiled) on Debian Trixie
  • Linux version 6.17.0 - 7.2 on Cachy OS (make CC=clang LD=ld.lld -j16)

As of lately the maintainer experienced issues with the driver on Debian Testing, covering several Linux Kernel versions. More details can be found in issue 280. Any suggestions on how to troubleshoot or fix this are welcome there too.

NOTE: The fixes for Linux v7.2 broke compatibility with Linux v6.14 and older. The scope of the fixes was so big that it was decided not to use the conditional code inclusion technique for this case. If you need to use the driver on Linux v6.14 or older, please use the an older version of the driver (e.g. fc158d1f71b9e5dfcd1fccaf4d28725b65086e3b).

Using and Installing the Driver

Simple Usage

In order to make direct use of the driver it should suffice to build the driver with make and to load it with insmod 88x2bu.ko. This will allow you to use the driver directly without changing your system persistently.

It might happen that your system freezes instantaneously. Ensure to not loose important work by saving and such beforehand.

DKMS installation

If you want to have the driver available at startup, it will be convenient to register it in DKMS. This can be done using the script deploy.sh, for either

  • all kernels,
  • a specific kernel, or
  • the currently active kernel.

Please consult --help for more information and consider reading the script before executing it.

Since registering a kernel module in DKMS is a major intervention, only execute it if you understand what the script does.

Unknown Symbol Errors

Some users reported problems due to Unknown symbol in module. A likely cause of this is that the cfg80211 module is not present in the Kernel. You can fix this by running it:

sudo modprobe cfg80211

Another reported cause was that old deployments of the driver were still present in the system directories. One reported solution was to forcibly remove all old driver modules. This is a drastic measure. It may prevent you from using other external WiFi adapters. See this issue for more information.

If you want to proceed anyways, you can run the following commands:

sudo dkms remove rtl88x2bu/5.8.7.4 --all
find /lib/modules -name cfg80211.ko -ls
sudo rm -f /lib/modules/*/updates/net/wireless/cfg80211.ko

Linux 5.18+ and RTW88 Driver

Starting from Linux 5.18, some distributions have added experimental RTW88 USB support (include RTW88x2BU support). It is not yet stable but if it works well on your system, then you no longer need this driver. But if it doesn't work or is unstable, you need to manually blacklist it because it has a higher loading priority than this external drivers.

Check the currently loaded module using lsmod. If you see rtw88_core, rtw88_usb, or any name beginning with rtw88_ then you are using the RTW88 driver. If you see 88x2bu then you are using this RTW88x2BU driver.

To blacklist RTW88 8822bu USB driver, run the following command. It will replace the existing *.conf file with the echoed content.

echo "blacklist rtw88_8822bu" | sudo tee /etc/modprobe.d/rtw8822bu.conf

Then reboot your system.

Secure Boot

Secure Boot will prevent the module from loading as it isn't signed. In order to check whether you have secure boot enabled, you couly run mokutil --sb-state. If you see something like SecureBoot disabled, you do not take to setup module signing.

If Secure Boot is enabled on your machine, you either could disable it in BIOS or UEFI or you could set up signing the module. How to do so is described here.

Raspberry Pi Access Point

…

If you want 802.11an speeds 144Mbps you could use this config below:

…

If you want to setup masquerading or bridging, check out the official Raspberry Pi docs.

GitHub Issues· 0 开放

在 GitHub 查看全部

暂无开放 Issues,或尚未同步最近议题。

核心特点

  • •Linux version 5.4.0-91-generic on Linux Mint 20.2 (30 November 2021)
  • •Linux version 5.15.89 on Manjaro (3 February 2023)
  • •Linux version 5.19 on Ubuntu 22.4
  • •Linux version 6.1.0-9-amd64 on Debian Bookworm
  • •Linux version 6.1.* to 6.12.* (self-compiled) on Debian and Ubuntu 22.04
  • •Linux version 6.10.3 to 6.12.10 on Debian Trixie
  • •Linux version 6.13.0 (self-compiled) on Debian Trixie
  • •Linux version 6.17.0 - 7.2 on Cachy OS (make CC=clang LD=ld.lld -j16)
  • •all kernels,
  • •a specific kernel, or

> 标签

C

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言