高通ath11k 固件安装及排错

ath11k 固件安装细节

ath11k 是 Linux 内核中用于 Qualcomm 802.11ax (WiFi 6) 芯片的 mac80211 驱动，支持如 QCN9074、IPQ8074、WCN6855 等芯片。在 Ubuntu 24.04 上（针对 Qualcomm QCS6490 设备），ath11k 驱动通常已包含在内核中（从 Linux 5.6 开始），但固件（firmware）需要单独安装或更新，以确保 WiFi 硬件正常工作。固件文件通常包括 .bin 文件，如 amss.bin、m3.bin、board-2.bin 等，放置在 /lib/firmware/ath11k/ 目录下。

如果您的设备是 QCS6490，它可能使用 WCN6855 或类似芯片，Ubuntu 24.04 的官方镜像已预装了兼容的 linux-firmware 包，但如果网络丢失或固件版本不匹配（如更新内核后），需要手动安装或更新。以下是详细步骤，基于官方 Linux Wireless 文档、Qualcomm 资源和 Ubuntu 特定指南。操作前确保已引导到工作内核，并备份系统。

1. 检查当前状态（先决条件）

• 确认 ath11k 驱动支持：运行 lspci -k | grep -i ath11k 或 lspci | grep Network，查看 Qualcomm WiFi 芯片（如 Qualcomm Device 1101，表示 WCN6855）。
• 检查内核版本：uname -r（Ubuntu 24.04 默认 6.8，应支持 ath11k）。
• 检查现有固件：ls /lib/firmware/ath11k/。如果目录为空或缺少文件（如 board-2.bin），则需安装。
• 安装依赖：sudo apt update && sudo apt install git build-essential（如果需要克隆仓库）。

如果 dmesg 显示错误如 “ath11k: firmware failed to load”，则固件缺失。

2. 通过 Ubuntu 软件包安装固件（推荐，最简单）

Ubuntu 的 linux-firmware 包包含 ath11k 固件，包括针对 QCS6490 的 WCN6855 更新（如 board-2.bin）。

• 安装或更新：

  sudo apt update
  sudo apt install linux-firmware
  

• 重新加载驱动：

  sudo modprobe -r ath11k_pci ath11k  # 卸载模块（如果已加载）
  sudo modprobe ath11k_pci
  

• 检查日志：dmesg | grep ath11k（应显示 “firmware loaded”）。
• 重启：sudo reboot，然后验证 WiFi：nmcli device wifi list 或 ip link show。

对于 QCS6490，如果使用 Canonical 的官方 Ubuntu 24.04 镜像（从 https://ubuntu.com/download/qualcomm-iot 下载），固件已包含。 如果镜像闪存后仍问题，检查释放笔记 PDF 以获取特定修复。

3.