# 调试 Wi-Fi 问题 如果在配置或使用 Wi-Fi 功能时遇到问题，可以向 [Qualcomm](https://www.qualcomm.com/support) 报告。还可以从各个模块收集日志以进行故障排除。 ## 报告 Wi-Fi 问题 要向 [Qualcomm](https://www.qualcomm.com/support) 报告问题，需提供以下详细信息： - 提供配置信息 | 信息类型 | 说明 | | --- | --- | | 平台信息 | 平台名称和软件版本 | | Wi-Fi AP 信息 | 模块名称、信道/模式/带宽/安全性和固件版本 | | 相关日志 | 有关更多信息，请参阅 [ath11k 的日志](https://docs.qualcomm.com/doc/80-70020-14SC/topic/report_a_w_fi_issue_to_qualcomm.html#wlan-logging)。 | | 测试配置、步骤和预期结果 | 报告问题时使用的测试步骤。 | - 打包所有用于调试的日志文件，并报告给 Qualcomm。 下表列出了报告问题所需的日志： | 日志名称 | 协议问题 | 吞吐量问题 | | --- | --- | --- | | Host 驱动程序日志 | 必填 | 必填 | | 固件日志 | 必填 | 必填 | | 无线嗅探器日志 | 推荐 | 必填 | | Supplicant 日志 | 必填 | 必填 | ### ath11k 的日志 Wi-Fi 子系统提供多种工具和日志来帮助解决问题。 ## 拉取 Wpa\_supplicant 日志 如果发现任何问题，可运行以下命令以收集 wpa\_supplicant 日志： scp -r root@:/tmp/wpa_supplicant-log.txt . Copy to clipboard 例如，如果 DUT 的 IP 地址为 `192.168.1.22`，可运行以下命令： scp -r root@192.168.1.22:/tmp/wpa_supplicant-log.txt . Copy to clipboard ## 拉取 Wi-Fi host 驱动程序和固件日志 要拉取 ath11k 驱动程序的 Wi-Fi host 驱动程序和固件日志，可执行以下操作： 1. 在 DUT 上运行 `trace-cmd` 工具，如下： - 要拉取整个日志，请运行以下命令： trace-cmd record -e ath11k_htt_pktlog -e ath11k_htt_ppdu_stats -e ath11k_htt_rxdesc -e ath11k_log_err -e ath11k_log_warn -e ath11k_log_info -e ath11k_wmi_cmd -e ath11k_wmi_event -e ath11k_log_dbg -e ath11k_log_dbg_dump -e ath11k_wmi_diag -e ath11k_ps_timekeeper Copy to clipboard - 要拉取固件日志，请运行以下命令： trace-cmd record -e ath11k_wmi_diag Copy to clipboard 2. 运行预期的测试用例或重现问题。 3. 按 **Ctrl + C** 停止 `trace-cmd`。 `trace.dat` 日志显示如下： **示例输出** root@qcm6490:/tmp# root@qcm6490:/tmp# trace-cmd record -e ath1lk_htt_pktlog -e ath1lk_htt_ppdu_stats -e athllk_htt_rxdesc -e ath11k_log_err -e ath11k_log_warn -e athllk_log_info -e ath1lk_wmi_cmd -e ath11k_wmi_event -e ath1lk_log_dbg -e ath1lk_log_dbg_dump -e ath11k_wmi_diag -e athllk_ps_timekeeper Hit Ctrl^C to stop recording ^CCPUO data recorded at offset=0x7fc000 151552 bytes in size CPU1 data recorded at offset=0x821000 163840 bytes in size CPU2 data recorded at offset=0x849000 0 bytes in size CPU3 data recorded at offset=0x849000 0 bytes in size CPU4 data recorded at offset=0x849000 0 bytes in size CPU5 data recorded at offset=0x849000 0 bytes in size CPU6 data recorded at offset=0x849000 0 bytes in size CPU7 data recorded at offset=0x849000 0 bytes in size root@qcm6490:/tmp# ls -al ls: cannot access 'ssgtzd': Permission denied total 8600 drwxrwxrwt. 10 root root 280 Sep 16 06:21 . drwxr-xr-x. 22 root root 4096 Sep 9 10:34 .. srw-rw-rw-. 1 system system 0 Apr 28 2022 property-vault.socket s?????????? ? ? ? ? ? ssgtzd drwx------. 3 root root 60 Apr 28 2022 systemd-private-e9b8fea895944dd5a0fd05770af20d6e-ModemManager.service-52N7rb drwx------. 3 root root 60 Apr 28 2022 systemd-private-e9b8fea895944dd5a0fd05770af20d6e-bluetooth.service-1nYL2F drwx------. 3 root root 60 Apr 28 2022 systemd-private-e9b8fea895944dd5a0fd05770af20d6e-chronyd.service-UmA8vV drwx------. 3 root root 60 Jan 6 1980 systemd-private-e9b8fea895944dd5a0fd05770af20d6e-ninfod.service-nSxLqH drwx------. 3 root root 60 Jan 6 1980 systemd-private-e9b8fea895944dd5a0fd05770af20d6e-rdisc.service-voag6w drwx------. 3 root root 60 Apr 28 2022 systemd-private-e9b81ea895944dd5a0fd05770af20d6e-systemd-logind.service-kHhqPi drwx------. 3 root root 60 Jan 6 1980 systemd-private-e9b8fea895944dd5a0fd05770af20d6e-systemd-resolved.service-hQ2tR3 drwx------. 3 root root 60 Jan 1 1970 systemd-private-e9b8fea895944dd5a0fd05770af20d6e-systemd-timesyncd.service-Ghf2u0 -rw-r--r--. 1 root root 8687616 Sep 16 06:21 **trace.dat** -rw-r-----. 1 root root 114229 Sep 16 06:04 wpa_supplicant-log.txt Copy to clipboard 4. 将 `trace.dat` 日志从 DUT 复制至 Ubuntu 主机设备。 5. 按如下方式获取 host 和固件日志： - 请运行以下命令，以便从 `trace.dat` 日志中获取主机日志： trace-cmd report trace.dat > host.txt Copy to clipboard **示例输出** username@hu-username-hyd:/local/mnt/workspace/ath11k$ ls -al total 18464 drwxrwxr-x 2 username users 4096 Aug 15 08:48 . drwxrwxrwt 12 root root 4096 Aug 15 08:48 .. -rw-r--r-- 1 username users 18898944 Aug 15 08:48 trace.dat username@hu-username-hyd:/local/mnt/workspace/ath11k$ trace-cmd report trace.dat > host.txt username@hu-username-hyd:/local/mnt/workspace/ath11k$ ls -al total 19500 drwxrwxr-x 2 username users 4096 Aug 15 08:48 . drwxrwxrwt 12 root root 4096 Aug 15 08:48 .. -rw-rw-r-- 1 username users 1059505 Aug 15 08:48 host.txt -rw-r--r-- 1 username users 18898944 Aug 15 08:48 trace.dat username@hu-username-hyd:/local/mnt/workspace/ath11k$ Copy to clipboard 可通过在 Ubuntu 终端中运行以下命令来安装 `trace-cmd` 工具： apt-get install trace-cmd Copy to clipboard - 要获取固件日志，请在支持网站上共享 `trace.dat` 日志和问题详细信息 。 ## 在 dmesg 中捕获驱动程序日志 dmesg 的 ath11k 命令如下所示： enum ath11k_debug_mask { ATH11K_DBG_AHB = 0x00000001, ATH11K_DBG_WMI = 0x00000002, ATH11K_DBG_HTC = 0x00000004, ATH11K_DBG_DP_HTT = 0x00000008, ATH11K_DBG_MAC = 0x00000010, ATH11K_DBG_BOOT = 0x00000020, ATH11K_DBG_QMI = 0x00000040, ATH11K_DBG_DATA = 0x00000080, ATH11K_DBG_MGMT = 0x00000100, ATH11K_DBG_REG = 0x00000200, ATH11K_DBG_TESTMODE = 0x00000400, ATH11K_DBG_HAL = 0x00000800, ATH11K_DBG_PCI = 0x00001000, ATH11K_DBG_DP_TX = 0x00002000, ATH11K_DBG_DP_RX = 0x00004000, ATH11K_DBG_CE = 0x00008000, }; Copy to clipboard 您可以使用每个命令来获取特定日志。例如， - 要获取与 WMI 相关的驱动程序日志，可运行以下命令： echo 0x2 > /sys/module/ath11k/parameters/debug_mask Copy to clipboard - 要获取与主机目标通信 (HTC) 相关的日志，可运行以下命令： echo 0x4 > /sys/module/ath11k/parameters/debug_mask Copy to clipboard ## 无线嗅探器 无线嗅探器通过无线方式探测 Wi-Fi 帧。使用无线嗅探器来嗅探 Wi-Fi 空中下载 (OTA) 数据包。 ## 收集固件 dump 当设备 crash 时，固件 dump 将以 BIN 文件的形式保存在 `/var/spool/crash` 目录中。 sh-5.1# cd /var/spool/crash/ sh-5.1# ls 0000:01:00.0_2022-04-28_17-51-45.bin Copy to clipboard 在支持网站上共享此 dump 文件 。 Last Published: Jul 23, 2025 [Previous Topic 配置 Wi-Fi](https://docs.qualcomm.com/bundle/publicresource/80-70020-14SC/topics/Set_up_and_configure_WLAN_connection.md) [Next Topic 参考资料](https://docs.qualcomm.com/bundle/publicresource/80-70020-14SC/topics/references.md)