升级Ubuntu 23.10后Qualcomm QCA6390无线网卡无法加载的解决求助

问题描述 #

我之前在Ubuntu 23.04上能正常使用Qualcomm QCA6390无线网卡，驱动为ath11k_pci，但升级到23.10后网卡突然无法加载。通过sudo lshw -C network确认了网卡和驱动信息，sudo dmesg | grep ath11k的日志显示核心错误是找不到固件文件：

[   14.266832] ath11k_pci 0000:71:00.0: BAR 0: assigned [mem 0xa6100000-0xa61fffff 64bit]
[   14.266855] ath11k_pci 0000:71:00.0: enabling device (0000 -> 0002)
[   14.267085] ath11k_pci 0000:71:00.0: MSI vectors: 32
[   14.267089] ath11k_pci 0000:71:00.0: qca6390 hw2.0
[   14.663649] ath11k_pci 0000:71:00.0: chip_id 0x0 chip_family 0xb board_id 0xff soc_id 0xffffffff
[   14.663662] ath11k_pci 0000:71:00.0: fw_version 0x10121492 fw_build_timestamp 2021-11-04 11:23 fw_build_id
[   14.663703] ath11k_pci 0000:71:00.0: failed to fetch board-2.bin or board.bin from QCA6390/hw2.0
[   14.663705] ath11k_pci 0000:71:00.0: qmi failed to fetch board file: -2
[   14.663706] ath11k_pci 0000:71:00.0: failed to load board data file: -2

当前使用的是5.14和5.17版本的OEM内核，尝试过相关帖子的解决方案但无效，求助如何让无线网卡正常加载。

解决思路与步骤 #

这种升级后硬件罢工的情况确实闹心，针对你日志里的固件缺失问题，给你几个实用的解决方向，你可以一步步尝试：

• 手动安装缺失的固件文件
  从日志看，驱动找不到board.bin和board-2.bin这两个关键固件，我们可以手动下载适配版本放到对应目录：

  1. 先检查固件目录是否存在：

     ls -la /lib/firmware/ath11k/QCA6390/hw2.0/
     

  2. 如果目录不存在，先创建：

     sudo mkdir -p /lib/firmware/ath11k/QCA6390/hw2.0/
     

  3. 下载适配的固件文件：

     sudo wget -O /lib/firmware/ath11k/QCA6390/hw2.0/board.bin https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/ath11k/QCA6390/hw2.0/board.bin
     sudo wget -O /lib/firmware/ath11k/QCA6390/hw2.0/board-2.bin https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/ath11k/QCA6390/hw2.0/board-2.bin
     

  4. 设置正确的文件权限：

     sudo chmod 644 /lib/firmware/ath11k/QCA6390/hw2.0/*.bin
     

  5. 重新加载驱动：

     sudo modprobe -r ath11k_pci && sudo modprobe ath11k_pci
     

  6. 检查网卡状态：可以通过ip link show或者系统设置里的网络选项确认是否识别到无线网卡。

• 重新安装linux-firmware包
  系统升级可能导致固件包损坏或版本不兼容，重新安装固件包试试：

  sudo apt update && sudo apt install --reinstall linux-firmware
  

  安装完成后重启系统，再检查网卡是否正常加载。

• 切换到通用内核版本
  你当前使用的是OEM内核，试试Ubuntu 23.10默认的通用内核，可能兼容性更好：

  1. 安装通用内核：

     sudo apt install linux-image-generic linux-headers-generic
     

  2. 重启系统，在GRUB菜单的“Advanced options for Ubuntu”里选择新安装的通用内核启动，检查网卡状态。

• 调整内核模块参数跳过固件加载
  如果以上方法都不行，可以尝试让驱动跳过board文件加载，使用默认配置（可能会影响部分功能，但能优先让网卡工作）：

  1. 编辑模块配置文件：

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

  2. 添加一行参数：

     options ath11k_pci skip_board_load=1
     

  3. 保存退出（按Ctrl+O，回车，再Ctrl+X），然后重新加载驱动：

     sudo modprobe -r ath11k_pci && sudo modprobe ath11k_pci
     

如果这些方法都没能解决问题，你可以提供更多信息，比如lspci -nn | grep Network的输出，或者journalctl -u NetworkManager的日志，方便进一步排查。

备注：内容来源于stack exchange，提问作者Nigini