调试 Wi-Fi 问题 - Qualcomm Dragonwing Documentation

报告 Wi-Fi 问题

要向 Qualcomm 报告问题，请提供以下详细信息。

提供设置信息

信息类型	描述
平台信息	平台名称和软件版本
Wi-Fi AP 信息	型号名称、信道/模式/带宽/安全性以及固件版本
相关日志	有关更多信息，请参阅 ath11k 日志、ath12k 日志和 ath10k 日志。
测试设置、步骤和预期结果	报告问题时使用的测试过程。

打包所有用于调试的日志文件并将其报告给 Qualcomm。下表列出了报告问题所需的日志。
日志名称 协议问题 吞吐量问题
主机驱动程序日志必需必需
固件日志必需必需
无线抓包日志建议必需
Supplicant 日志必需必需

日志名称	协议问题	吞吐量问题
主机驱动程序日志	必需	必需
固件日志	必需	必需
无线抓包日志	建议	必需
Supplicant 日志	必需	必需

ath11k 日志

Wi-Fi 子系统提供工具和日志来协助排查问题。

拉取 Wpa_supplicant 日志

如果发现任何问题，请运行以下命令收集 wpa_supplicant 日志：

scp -r root@<ip_addr>:/tmp/wpa_supplicant-log.txt .

例如，如果 DUT 的 IP 地址是 192.168.1.22，请运行以下命令：

scp -r root@192.168.1.22:/tmp/wpa_supplicant-log.txt .

拉取 Wi-Fi 主机驱动程序和固件日志

要拉取 ath11k 驱动程序的 Wi-Fi 主机驱动程序和固件日志，请执行以下操作：

按如下方式在 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

对于固件日志，请运行以下命令：
trace-cmd record -e ath11k_wmi_diag

运行预期的测试用例或重现问题。

按 Ctrl + C 停止 trace-cmd。 trace.dat 日志显示如下： 示例输出

root@qcm6490:/tmp#
root@qcm6490:/tmp# 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
Hit Ctrl+C to stop recording
^CCPU0 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

将 trace.dat 日志从 DUT 复制到 Ubuntu 主机设备。

按如下方式获取主机和固件日志：

要从 trace.dat 日志中获取主机日志，请运行以下命令：

trace-cmd report trace.dat > host.txt

示例输出

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$

您可以在 Ubuntu 终端中运行以下命令来安装 trace-cmd 工具：

apt-get install trace-cmd

要获取固件日志，请在支持门户上分享 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,
  };

您可以使用每个命令获取特定日志。例如：

要获取与 WMI 相关的驱动程序日志，请运行以下命令：
echo 0x2 > /sys/module/ath11k/parameters/debug_mask
要获取与主机目标通信 (HTC) 相关的日志，请运行以下命令：
echo 0x4 > /sys/module/ath11k/parameters/debug_mask

无线抓包器

无线抓包器可拦截空中传输的 Wi-Fi 帧。使用无线抓包器可以抓取 Wi-Fi 空中传输 (OTA) 数据包。要收集无线抓包日志，请执行以下操作：

在 DUT 和 AP 附近使用单独的抓包设备（例如，配备支持监听模式 Wi-Fi 适配器的 Linux 笔记本电脑）。
将抓包接口设置为测试期间 DUT/AP 所使用的相同 Wi-Fi 信道和带宽。
开始抓包并将输出保存为 .pcap 文件。例如：
tcpdump -i <sniffer_iface> -I -s 0 -w wifi-ota.pcap
在抓包运行期间复现问题。
停止抓包，并将生成的 .pcap 文件连同主机驱动日志、固件日志和问题复现步骤一起提供。

收集固件转储

当设备崩溃时，固件转储会以 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

请在支持门户上分享此转储文件。

ath12k 日志

Wi-Fi 子系统提供工具和日志来协助排查 ath12k 平台上的问题。

拉取 Wi-Fi 主机驱动程序和固件日志

要拉取 ath12k 驱动程序的 Wi-Fi 主机驱动程序和固件日志，请按如下方式在 DUT 上运行 trace-cmd：

对于完整日志，请运行以下命令：

trace-cmd record -e ath12k -e ath12k_htt_pktlog -e ath12k_htt_ppdu_stats -e ath12k_htt_rxdesc -e ath12k_wmi_diag

对于固件日志，请运行以下命令：
trace-cmd record -e ath12k_wmi_diag

运行预期的测试用例，然后按 Ctrl + C 停止 trace-cmd。在支持门户上分享生成的 trace.dat 文件和问题详情。

在 dmesg 中捕获驱动程序日志

您可以使用 debug_mask 接口启用特定的 ath12k 调试日志。

enum ath12k_debug_mask {
        ATH12K_DBG_AHB          = 0x00000001,
        ATH12K_DBG_WMI          = 0x00000002,
        ATH12K_DBG_HTC          = 0x00000004,
        ATH12K_DBG_DP_HTT       = 0x00000008,
        ATH12K_DBG_MAC          = 0x00000010,
        ATH12K_DBG_BOOT         = 0x00000020,
        ATH12K_DBG_QMI          = 0x00000040,
        ATH12K_DBG_DATA         = 0x00000080,
        ATH12K_DBG_MGMT         = 0x00000100,
        ATH12K_DBG_REG          = 0x00000200,
        ATH12K_DBG_TESTMODE     = 0x00000400,
        ATH12K_DBG_HAL          = 0x00000800,
        ATH12K_DBG_PCI          = 0x00001000,
        ATH12K_DBG_DP_TX        = 0x00002000,
        ATH12K_DBG_DP_RX        = 0x00004000,
        ATH12K_DBG_WOW          = 0x00008000,
        ATH12K_DBG_CE           = 0x00010000,
        ATH12K_DBG_ANY          = 0xffffffff,
};

要获取与 WMI 相关的驱动程序日志，请运行以下命令：
echo 0x2 > /sys/module/ath12k/parameters/debug_mask
要获取与主机目标通信 (HTC) 相关的日志，请运行以下命令：
echo 0x4 > /sys/module/ath12k/parameters/debug_mask

ath10k 日志

Wi-Fi 子系统提供工具和日志来协助排查 ath10k 平台上的问题。

拉取 Wi-Fi 主机驱动程序和固件日志

要拉取 ath10k 驱动程序的 Wi-Fi 主机驱动程序和固件日志，请按如下方式在 DUT 上运行 trace-cmd：

对于完整日志，请运行以下命令：

trace-cmd record -e ath10k_log_err -e ath10k_log_warn -e ath10k_log_info -e ath10k_log_dbg -e ath10k_log_dbg_dump -e ath10k_wmi_cmd -e ath10k_wmi_event -e ath10k_htt_stats -e ath10k_wmi_dbglog -e ath10k_htt_pktlog

对于固件日志，请运行以下命令：
trace-cmd record -e ath10k_wmi_dbglog

运行预期的测试用例，然后按 Ctrl + C 停止 trace-cmd。在支持门户上分享生成的 trace.dat 文件和问题详情。

在 dmesg 中捕获驱动程序日志

您可以使用 debug_mask 接口启用特定的 ath10k 调试日志。

enum ath10k_debug_mask {
        ATH10K_DBG_PCI          = 0x00000001,
        ATH10K_DBG_WMI          = 0x00000002,
        ATH10K_DBG_HTC          = 0x00000004,
        ATH10K_DBG_HTT          = 0x00000008,
        ATH10K_DBG_MAC          = 0x00000010,
        ATH10K_DBG_BOOT         = 0x00000020,
        ATH10K_DBG_PCI_DUMP     = 0x00000040,
        ATH10K_DBG_HTT_DUMP     = 0x00000080,
        ATH10K_DBG_MGMT         = 0x00000100,
        ATH10K_DBG_DATA         = 0x00000200,
        ATH10K_DBG_BMI          = 0x00000400,
        ATH10K_DBG_REGULATORY   = 0x00000800,
        ATH10K_DBG_TESTMODE     = 0x00001000,
        ATH10K_DBG_WMI_PRINT    = 0x00002000,
        ATH10K_DBG_PCI_PS       = 0x00004000,
        ATH10K_DBG_AHB          = 0x00008000,
        ATH10K_DBG_SDIO         = 0x00010000,
        ATH10K_DBG_SDIO_DUMP    = 0x00020000,
        ATH10K_DBG_USB          = 0x00040000,
        ATH10K_DBG_USB_BULK     = 0x00080000,
        ATH10K_DBG_SNOC         = 0x00100000,
        ATH10K_DBG_QMI          = 0x00200000,
        ATH10K_DBG_STA          = 0x00400000,
        ATH10K_DBG_ANY          = 0xffffffff,
};

要获取与 WMI 相关的驱动程序日志，请运行以下命令：
echo 0x2 > /sys/module/ath10k_core/parameters/debug_mask
要获取与主机目标通信 (HTC) 相关的日志，请运行以下命令：
echo 0x4 > /sys/module/ath10k_core/parameters/debug_mask

​报告 Wi-Fi 问题

​ath11k 日志

​拉取 Wpa_supplicant 日志

​拉取 Wi-Fi 主机驱动程序和固件日志

​在 dmesg 中捕获驱动程序日志

​无线抓包器

​收集固件转储

​ath12k 日志

​拉取 Wi-Fi 主机驱动程序和固件日志

​在 dmesg 中捕获驱动程序日志

​ath10k 日志

​拉取 Wi-Fi 主机驱动程序和固件日志

​在 dmesg 中捕获驱动程序日志

报告 Wi-Fi 问题

ath11k 日志

拉取 Wpa_supplicant 日志

拉取 Wi-Fi 主机驱动程序和固件日志

在 dmesg 中捕获驱动程序日志

无线抓包器

收集固件转储

ath12k 日志

拉取 Wi-Fi 主机驱动程序和固件日志

在 dmesg 中捕获驱动程序日志

ath10k 日志

拉取 Wi-Fi 主机驱动程序和固件日志

在 dmesg 中捕获驱动程序日志