本指南详细介绍了如何为OpenWrt系统添加第三方WiFi芯片的驱动支持，涵盖从环境配置到驱动验证的完整流程。

扩展WiFi芯片支持的意义

许多用户在使用OpenWrt时会遇到以下问题：

• 新购WiFi模块无法被识别。
• 特定芯片型号缺乏官方驱动支持。
• 硬件性能未完全发挥。

通过本指南，您将学会如何：

• 快速配置固件包以支持新芯片。
• 正确编译内核模块确保驱动加载。
• 适配设备树实现硬件接口匹配。

准备工作

在开始之前，请确保开发环境已准备好：

# 安装必要工具
sudo apt update && sudo apt install -y build-essential git subversion

项目目录结构如下：

• 通用配置：devices/common/diy/
• 芯片专属补丁：devices/rockchip_armv8/patches/

支持的WiFi芯片类型

实战操作步骤

第一步：配置固件包

以QCA9377为例，修改mk文件：

Package/wifi-firmware-qca9377 = $(call Package/firmware-default, QCA9377 firmware)
define Package/wifi-firmware-qca9377/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,wifi-firmware-qca9377))

第二步：编译内核模块

修改关键配置：

config-$(call config_package,wifi-sdio,sdio) += ATH10K ATH10K_SDIO

第三步：设备树适配

添加SDIO接口描述：

wifi_module {
    compatible = "qcom,ath10k-sdio";
    reg = <1>;
};

验证与测试

编译完成后，使用以下命令检查驱动状态：

lsmod | grep ath10k
dmesg | grep firmware

常见问题解决

• 问题1：固件加载失败
  检查文件路径是否正确，并确认文件名符合驱动要求。
• 问题2：接口无法启用
  添加厂商特定参数，验证电源管理配置。

编译验证流程

执行以下步骤生成包含新驱动的固件镜像：

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

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

编译成功后，可在bin/targets/rockchip/armv8/目录找到输出固件。