Realtek RTW89 WiFi & Bluetooth驱动程序安装与使用教程

Realtek RTW89 WiFi & Bluetooth驱动程序安装与使用教程

项目地址:https://gitcode.com/gh_mirrors/rt/rtw89

---

项目介绍

本教程基于lwfinger/rtw89开源项目，旨在提供Realtek 8852AE及其相关型号（包括RTW8852BE, RTW8852CE等）的WiFi和蓝牙设备的驱动程序安装和配置指南。该项目支持最新的802.11ax标准，即Wi-Fi 6技术，同时也包含了针对Realtek RTW89系列设备的蓝牙驱动，适用于Linux内核版本5.15及以上。

---

项目快速启动

环境准备

确保你的系统是Linux，并且内核版本在5.15或更高。你还需要一些基本的构建工具，如GCC和Make。

下载源码

git clone https://github.com/lwfinger/rtw89.git
cd rtw89

编译与安装

首先，你需要编译驱动程序：

make
sudo make install

这将编译出驱动文件并尝试将其安装到适当的系统位置。请注意，执行这些步骤可能需要管理员权限。

驱动加载与配置

为了使驱动生效，你可能需要调整内核模块参数。以下是一般步骤：

编辑 /etc/modprobe.d/rtw89.conf 文件（如果不存在，则创建）：

sudo nano /etc/modprobe.d/rtw89.conf

添加必要的选项，例如，如果你想禁用特定的电源管理模式：

options rtw89pci disable_aspm_l1=1

保存并退出。之后，卸载并重新加载模块：

sudo modprobe -r rtw89_pci
sudo modprobe rtw89_pci

或者，在系统重启后自动加载，可以通过更新/etc/modules-load.d/rtw89.conf添加：

echo "rtw89_pci" | sudo tee -a /etc/modules-load.d/rtw89.conf

---

应用案例和最佳实践

对于日常使用，确保无线网络功能正常，你可以通过命令行检查连接状态：

iwconfig

或使用图形界面网络管理器进行配置连接。为达到最佳性能，建议：

• 跟踪内核及驱动更新，以获得最新特性和修复。
• 监控系统日志(dmesg)，检查驱动加载时是否有任何警告或错误。
• 在使用特殊环境或配置时，参考社区讨论或提交Issue至项目仓库获取帮助。

---

典型生态项目

虽然此项目主要关注于硬件驱动层面，但在开源世界里，它常与其他软件生态系统集成，比如NetworkManager用于网络连接管理，以及各种Linux发行版中的图形化网络设置工具。开发者可以利用这个驱动在嵌入式项目中实现Wi-Fi和蓝牙功能，比如IoT设备或自定义路由器固件，确保Realtek RTW89系列芯片在定制Linux系统中稳定工作。

---

遵循以上步骤，你应该能够成功地在你的Linux系统上安装和配置Realtek RTW89系列的WiFi和蓝牙驱动程序。遇到问题时，请参考项目页面上的文档或直接在GitHub仓库中提交问题。

rtw89 Driver for Realtek 8852AE, an 802.11ax device 项目地址: https://gitcode.com/gh_mirrors/rt/rtw89