开源项目 rtl88x2bu 使用教程

1. 项目的目录结构及介绍

目录结构

rtl88x2bu/
├── dkms.conf
├── driver
│   ├── Kconfig
│   ├── Makefile
│   ├── rtl88x2bu.c
│   ├── rtl88x2bu.h
│   └── ...
├── firmware
│   └── ...
├── Makefile
├── README.md
└── ...

目录介绍

• dkms.conf: DKMS 配置文件，用于自动构建和安装内核模块。
• driver/: 包含驱动程序的主要源代码文件。
  • Kconfig: 内核配置文件。
  • Makefile: 编译驱动程序的 Makefile。
  • rtl88x2bu.c: 驱动程序的主要源代码文件。
  • rtl88x2bu.h: 驱动程序的头文件。
• firmware/: 包含所需的固件文件。
• Makefile: 顶层 Makefile，用于编译整个项目。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

启动文件

• dkms.conf: 该文件是 DKMS 的配置文件，用于在系统启动时自动构建和安装内核模块。
• Makefile: 顶层 Makefile，用于编译整个项目。在启动时，通过运行 make 命令来编译和安装驱动程序。

启动流程

1. 克隆项目:

   git clone https://github.com/cilynx/rtl88x2bu.git
   cd rtl88x2bu
   

2. 编译和安装:

   make
   sudo make install
   

3. 加载驱动:

   sudo modprobe rtl88x2bu
   

3. 项目的配置文件介绍

配置文件

• dkms.conf: 该文件包含 DKMS 的配置信息，如模块名称、版本号、源代码目录等。
• driver/Kconfig: 内核配置文件，定义了驱动程序的配置选项。
• driver/Makefile: 编译驱动程序的 Makefile，定义了编译规则和依赖关系。

配置示例

dkms.conf

PACKAGE_NAME="rtl88x2bu"
PACKAGE_VERSION="5.8.7.4"
CLEAN="make clean"
BUILT_MODULE_NAME[0]="88x2bu"
DEST_MODULE_LOCATION[0]="/updates/net/wireless"
AUTOINSTALL="yes"

driver/Kconfig

config RTL88x2BU
    tristate "Realtek 88x2BU WiFi"
    depends on USB && WLAN
    help
      Select to include the Realtek 88x2BU WiFi driver.

driver/Makefile

obj-m += rtl88x2bu.o
rtl88x2bu-objs := \
    rtl88x2bu_core.o \
    rtl88x2bu_usb.o \
    ...

all:
    make -C /lib/modules/$(shell uname -r)/build M=$(PWD) modules

clean:
    make -C /lib/modules/$(shell uname -r)/build M=$(PWD) clean

通过以上配置文件，可以实现驱动程序的编译、安装和加载。