OpenWrt_x86-r2s-r4s-r5s-N1驱动编译：第三方WiFi芯片支持方法

你是否曾在使用OpenWrt系统时遇到WiFi硬件无法识别的问题？本文将以QCA9377、ATH10K等主流第三方WiFi芯片为例，详细介绍如何通过项目补丁系统添加硬件支持，让你的路由设备获得稳定的无线连接能力。完成本文学习后，你将掌握驱动编译的核心流程，包括固件包配置、内核模块编译及设备树适配三大关键步骤。

驱动支持现状分析

项目通过分层补丁机制实现硬件兼容性扩展，主要包含通用配置与设备专属适配两大类型：

• 通用WiFi框架：devices/common/patches/wifi-scripts.patch 实现了hostapd服务的厂商扩展字段支持，允许在无线配置中添加vendor_vht等芯片专属参数
• 芯片家族支持：devices/rockchip_armv8/patches/Photonicat_wireless.patch 为QCA9377等SDIO接口WiFi芯片提供完整驱动链，包括固件包与内核模块

支持的WiFi芯片类型

芯片型号	接口类型	驱动模块	固件路径
QCA9377	SDIO	ath10k-sdio	/lib/firmware/ath10k/QCA9377/hw1.0/
ATH9887	PCIe	ath10k	/lib/firmware/ath10k/QCA9887/hw1.0/
MT7612	PCIe	mt76x2	/lib/firmware/mt76/

编译环境准备

在开始编译前，需确保开发环境包含以下组件：

# 安装基础编译依赖
sudo apt update && sudo apt install -y build-essential libncurses5-dev zlib1g-dev \
flex bison git subversion gettext libssl-dev xsltproc swig unzip time

项目采用设备分类的目录结构，第三方WiFi驱动相关文件主要分布在：

• 通用配置：devices/common/diy/
• 芯片补丁：devices/rockchip_armv8/patches/
• 编译脚本：各设备目录下的diy.sh

固件包配置

以QCA9377 SDIO WiFi芯片为例，需通过修改固件.mk文件添加编译支持：

# 文件路径: package/firmware/linux-firmware/qca_ath10k.mk
diff --git a/package/firmware/linux-firmware/qca_ath10k.mk b/package/firmware/linux-firmware/qca_ath10k.mk
index b3bfe8a3919803..a4ce0b01e410f2 100644
--- a/package/firmware/linux-firmware/qca_ath10k.mk
+++ b/package/firmware/linux-firmware/qca_ath10k.mk
@@ -32,6 +32,24 @@ define Package/ath10k-firmware-qca9377/install
 endef
 $(eval $(call BuildPackage,ath10k-firmware-qca9377))

+Package/ath10k-board-qca9377-sdio = $(call Package/firmware-default,ath10k qca9377 board sdio firmware)
+define Package/ath10k-board-qca9377-sdio/install
+	$(INSTALL_DIR) $(1)/lib/firmware/ath10k/QCA9377/hw1.0
+	$(INSTALL_DATA) \
+		$(PKG_BUILD_DIR)/ath10k/QCA9377/hw1.0/board.bin \
+		$(1)/lib/firmware/ath10k/QCA9377/hw1.0/board.bin
+endef
+$(eval $(call BuildPackage,ath10k-board-qca9377-sdio))
+
+Package/ath10k-firmware-qca9377-sdio = $(call Package/firmware-default,ath10k qca9377 sdio firmware,+ath10k-board-qca9377-sdio)
+define Package/ath10k-firmware-qca9377-sdio/install
+	$(INSTALL_DIR) $(1)/lib/firmware/ath10k/QCA9377/hw1.0
+	$(INSTALL_DATA) \
+		$(PKG_BUILD_DIR)/ath10k/QCA9377/hw1.0/firmware-sdio-5.bin \
+		$(1)/lib/firmware/ath10k/QCA9377/hw1.0/firmware-sdio-5.bin
+endef
+$(eval $(call BuildPackage,ath10k-firmware-qca9377-sdio))

内核模块编译

内核模块配置需同时修改Kconfig与Makefile文件，添加SDIO接口支持：

# 文件路径: package/kernel/mac80211/ath.mk
diff --git a/package/kernel/mac80211/ath.mk b/package/kernel/mac80211/ath.mk
index 1d4b37d259bb0f..3404227c604488 100644
--- a/package/kernel/mac80211/ath.mk
+++ b/package/kernel/mac80211/ath.mk
@@ -35,7 +35,7 @@ PKG_DRIVERS += \
 	ath ath5k ath6kl ath6kl-sdio ath6kl-usb ath9k ath9k-common ath9k-htc ath10k ath10k-sdio ath10k-smallbuffers \
 	ath11k ath11k-ahb ath11k-pci ath12k carl9170 owl-loader ar5523 wil6210 qcom-qmi-helpers

-config-$(call config_package,ath,regular smallbuffers) += ATH_CARDS ATH_COMMON
+config-$(call config_package,ath,regular sdio smallbuffers) += ATH_CARDS ATH_COMMON

 config-$(call config_package,ath10k,regular) += ATH10K ATH10K_PCI
+config-$(call config_package,ath10k-sdio,sdio) += ATH10K ATH10K_SDIO

模块加载顺序配置

在设备初始化脚本中添加模块依赖声明，确保固件加载顺序正确：

# 路径: devices/rockchip_armv8/diy.sh
echo "ath10k_sdio" >> target/linux/rockchip/modules.mk
echo "ath10k_core" >> target/linux/rockchip/modules.mk

设备树适配

对于SDIO接口的WiFi芯片，需在设备树中添加总线描述与电源管理配置：

&sdhci {
    status = "okay";
    max-frequency = <150000000>;
    bus-width = <4>;
    
    wifi@1 {
        compatible = "qcom,ath10k-sdio";
        reg = <1>;
        interrupt-parent = <&gpio0>;
        interrupts = <18 IRQ_TYPE_LEVEL_LOW>;
        vmmc-supply = <&vcc3v3_wifi>;
        qcom,ath10k-calibration-variant = "Photonicat";
    };
};

编译验证流程

完成配置后执行设备专属编译脚本，生成包含新驱动的固件镜像：

# 选择目标设备
cd devices/rockchip_armv8
./diy.sh

# 启动编译流程
cd ../../
make -j$(nproc) target/compile

编译成功后，可在bin/targets/rockchip/armv8/目录找到输出固件。刷写设备后通过以下命令验证驱动加载状态：

# 检查模块加载
lsmod | grep ath10k

# 验证固件加载
dmesg | grep ath10k

常见问题排查

固件加载失败

若出现firmware not found错误，检查：

1. 固件文件是否安装到正确路径/lib/firmware/ath10k/
2. 文件名是否与驱动期望匹配（通常为firmware-sdio-x.bin格式）
3. common/diy/package/base-files/files/etc/banner 中的固件版本声明是否正确

接口无法启用

通过修改无线配置添加厂商参数：

# /etc/config/wireless
config wifi-device 'radio0'
    option type 'mac80211'
    option path 'platform/soc/fe330000.sdio'
    option vendor_vht '1'  # 启用厂商扩展功能

总结与扩展

本项目通过补丁系统实现了对第三方WiFi芯片的灵活支持，核心优势在于：

1. 增量更新机制：所有硬件适配通过补丁文件实现，不修改上游源码
2. 设备分类管理：各芯片家族的驱动配置独立维护在对应设备目录
3. 兼容性验证：每个补丁都经过实际设备测试，确保稳定性

未来扩展支持新WiFi芯片时，建议参考devices/mediatek_filogic/patches/中的MTK系列芯片适配方案，该目录包含20+款MediaTek Filogic芯片的完整支持案例。

通过本文方法，你可以为任何基于OpenWrt的设备添加第三方WiFi芯片支持，显著提升硬件兼容性与无线性能。如需进一步优化，可研究common/diy/package/network/config/firewall4/patches/中的网络加速补丁，实现WiFi与防火墙规则的协同优化。