> ## Documentation Index > Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt > Use this file to discover all available pages before exploring further. # 调试概述 子系统在 Qualcomm® SoC 上其自身的执行环境中独立处理任务。本节介绍受影响子系统的工具、示例日志和故障排查方法。了解子系统中的异常以及检查错误的方法,有助于诊断和排查此类异常。 下表列出了 SoC 上的重要子系统。 **表:SoC 上的子系统** | **子系统** | **描述** | | :--------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------: | | 应用处理器子系统(APSS) | 这个主要子系统运行作为高级操作系统(HLOS)的 Qualcomm® Linux® 内核。 | | 应用数字信号处理器(aDSP) | 该子系统也称为低功耗音频子系统(LPASS),处理数字信号处理任务,例如音频编码/解码和语音识别。 | | 计算数字信号处理器(cDSP) | 该子系统执行计算密集型任务,例如与神经网络相关的计算。 | | Qualcomm® 可信执行环境(TEE)/TrustZone(TZ) | 该子系统执行安全操作并利用 Arm® TrustZone® 架构。有关更多信息,请参阅 [Qualcomm Linux 安全指南](https://dragonwingdocs.qualcomm.com/System/Security/overview)。 | | 无线局域网处理器子系统(WPSS) | 该子系统连接到 Wi-Fi 网络、发送和接收数据包、处理安全协议并确保稳定的网络性能。有关更多信息,请参阅 [Qualcomm Linux Wi-Fi 指南](https://dragonwingdocs.qualcomm.com/Technologies/Wi-Fi/wi-fi-overview)。 | | 常开处理器(AOP) | 该子系统调节设备的电源。 | 术语"非 HLOS"是指除应用处理器之外的所有子系统的软件。 要了解子系统的启动流程,请参阅 [Qualcomm Linux 启动指南](https://dragonwingdocs.qualcomm.com/System/Boot/boot-overview)。 请参阅 Qualcomm® Linux® 支持的[硬件 SoC](https://dragonwingdocs.qualcomm.com/Hardware-SoCs/IQ-9075)。 ## **调试工作流** 由于 Qualcomm SoC 有许多子系统,请先识别问题最先发生的子系统。这有助于您调试正确的子系统。 作为主要子系统的应用处理器会检测其他子系统何时崩溃。例如,如果 aDSP 处理器子系统崩溃,内核日志会捕获子系统重启(SSR)崩溃错误日志。因此,要识别需要调试的子系统,请先检查内核调试消息。 下图显示了识别错误以及需要调试的组件的工作流。 诊断内核 panic、软件 bug 和子系统崩溃问题的工作流。 当内核 dmesg 日志未显示 panic 特征时,请检查 Qualcomm TEE 诊断(diag)日志中的错误,例如非安全看门狗 bite 和片上网络(NoC)错误。以下各节介绍指示内核 panic、bug 和子系统崩溃问题的示例内核消息。 ### **识别内核 panic 和 bug** 您可以从内核 dmesg 日志中确定复位是内核 panic 还是 bug。以下示例日志指示内核 panic 或 bug: * Panic(模式:一般错误) 18.800936: \<6> Kernel panic - not syncing: Fatal exception 18.800938: \<6> SMP: stopping secondary CPUs 18.800947: \<6> CPU0: stopping Kernel panic - not syncing: Apps watchdog Bark received! * Bug(模式 1:由内存损坏导致的强制崩溃) 12.899532: \<6> BUG kmalloc-128 (Not tainted): Redzone overwritten 12.905418: \<6> ----------------------------------------------------------------------------- * Bug(模式 2:来自驱动的强制崩溃) 320.510769: \<6> ------------\[ cut here ]------------ 320.510781: \<6> kernel BUG at /local/mnt/workspace/lnxbuild/project/trees\_in\_use/free\_tree\_platform\_manifest\_refs\_tags/drivers/platform/msm/ipa/ipa\_v3/ipa\_qmi\_service.c:955! * Bug(模式 3:由锁死问题导致的强制崩溃) \[ 180.993861] BUG: spinlock lockup suspected on CPU#0, swapper/0/0 \[ 180.993883] lock: stop\_lock+0x0/0x18, .magic: dead4ead, .owner: swapper/6/0, .owner\_cpu: 6 \[ 181.015629] Causing a watchdog bite! 大多数 bug 通常会导致内核 panic。有关调试内核问题的更多信息,请参阅 [Qualcomm Linux 内核指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-80021-3/kernel_landing_page.html)。 ### **识别子系统崩溃问题** 您可以检查内核 dmesg 日志,以确定重启是否由子系统崩溃引起。例如,根据 `sc7280.dtsi`(节点:`remoteproc_adsp: remoteproc@3700000`),以下日志表示 aDSP 子系统崩溃: 0x000000000A27652C | 5198.790423: qcom\_q6v5\_pas 3700000.remoteproc: fatal error received: err\_inject\_crash.c:413:Crash injected via Diag 0x000000000A276689 | 5198.801061: remoteproc remoteproc2: crash detected in 3000000.remoteproc: type fatal error 0x000000000A2767A1 | 5198.809602: remoteproc remoteproc2: handling crash #1 in 3000000.remoteproc 0x000000000A27688E | 5198.816837: remoteproc remoteproc2: recovering 3000000.remoteproc 0x000000000A276971 | 5198.823784: qcom\_q6v5\_pas 8a00000.remoteproc: subsystem event rejected ### **从 Qualcomm TEE 日志中识别系统问题** 此功能仅供具有授权访问权限的许可开发者使用。有关指示 Qualcomm TEE 中错误的示例日志,请参阅 [Qualcomm Linux 调试指南 - 补充文档](https://docs.qualcomm.com/bundle/resource/topics/80-80023-12A/identify_subsystem_to_be_debugged.html#identify_and_debug_errors_in_tz)。 如果 Qualcomm TEE diag 日志未显示错误,则问题可能是由安全看门狗 bite 引起的。有关看门狗问题的更多信息,请参阅[硬件复位](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/debug-common-system-issues#identify-the-cause-of-hardware-reset)。 有关 Qualcomm TEE 中调试问题的更多信息,请参阅 [Qualcomm Linux 安全指南](https://dragonwingdocs.qualcomm.com/System/Security/debug-qualcomm-tee-and-secure-devices#debug-qualcomm-tee-and-secure-devices)。 ## **调试方法** 以下是两种调试方式: * **在设备上(on-target)调试** 在设备上调试可解决软件问题。此方式允许直接从实时设备访问大多数信息。使用 SSH 将 Linux 主机计算机连接到实时设备。要设置 SSH,请参阅[使用 SSH 登录](https://docs.qualcomm.com/bundle/publicresource/topics/80-80021-254/how_to.html#use-ssh)。 有关各种在设备上调试功能的更多信息,请参阅[在设备上调试功能](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/debug-overview#debug-methods)。 * **离线(off-target)调试**i 此方式使用日志而不是实际设备,是一种高效的调试方法。您可以使用内存转储或日志工具以及各种类型的日志进行离线调试。虽然 RAM 转储捕获了大多数内存区域,但它只包含有限的硬件寄存器信息,因此调试与硬件相关的问题可能是一项挑战。 有关各种离线调试功能的更多信息,请参阅[离线调试功能](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/debug-overview#debug-methods)。 ### **在设备上调试功能** 您可以在运行时在设备上使用以下调试功能: * [Perf 实用工具](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/debug-overview#perf-utility) * [子系统重启](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/debug-overview#subsystem-restart) * [强制子系统复位](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/debug-overview#debug-methods) #### **Perf 实用工具** Linux 中的 Perf 实用工具便于进行性能分析和剖析。Linux 内核在 `tools/perf` 目录中包含 Perf 实用工具。 您可以使用 Perf 实用工具调试系统行为的各个方面,包括 CPU 性能计数器、tracepoint、kprobe 和 uprobe(用于动态跟踪)。下表列出了 Perf 实用工具的主要功能。 **表:Perf 实用工具的主要功能** | **功能** | **描述** | | :--------: | :--------------------------------------------------------------------------------: | | CPU 性能计数器 | 这些 CPU 硬件寄存器跟踪事件,例如已执行的指令、缓存未命中和分支预测错误。这些事件构成了剖析应用程序和识别性能瓶颈的基础。 | | Tracepoint | 您可以将这些 tracepoint 放置在代码中的逻辑位置,例如系统调用、网络事件和文件系统操作。这些 tracepoint 以最小的开销提供时间戳和栈跟踪等信息。 | | 动态跟踪 | 此功能使用 kprobe 和 uprobe 框架动态创建 tracepoint,允许在内核空间和用户空间中进行跟踪。 | 有关 Perf 实用工具的更多信息,请参阅以下资源: * [Perf 主页](https://perf.wiki.kernel.org/index.php/Main_Page) * [HOWTO](https://github.com/Linaro/OpenCSD/blob/master/HOWTO.md) * [CoreSight](https://docs.kernel.org/trace/coresight/index.html) * [CoreSight - Perf](https://docs.kernel.org/trace/coresight/coresight-perf.html) #### **子系统重启** 子系统崩溃时可以独立重启而无需重启设备,这称为子系统重启(SSR)。SSR 功能使用 Linux 内核中提供的 remoteproc 框架。 要启用完整内存转储以进行调试,请默认禁用 SSR 功能。 建议在商用设备上使用 SSR 功能,而不是在开发阶段使用。 有关 SSR 功能的更多信息,请参阅[配置远程处理器子系统](https://dragonwingdocs.qualcomm.com/System/Kernel/configure-the-remoteprocessor-remoteproc-subsystems#configure-the-remoteprocessor-remoteproc-subsystems)。 启用 SSR 功能以在子系统重启时生成 SSR 转储。考虑使用 SSR 转储进行调试,因为其大小比完整内存转储小。但是,要调试某些子系统崩溃,您需要完整的 RAM 转储。 有关如何启用和捕获子系统转储的更多信息,请参阅[捕获子系统转储](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/collect-and-parse-ram-dump#capture-the-subsystem-dumps)。 #### **强制子系统复位** 使用此功能调试需要重启子系统的用例。 此功能仅供具有授权访问权限的许可开发者使用。 要强制子系统复位,可以使用 QXDM Professional™ 工具运行 `diag` 命令。有关 QXDM Professional 命令及其用法的更多信息,请参阅 [Qualcomm Linux 调试指南 - 补充文档](https://docs.qualcomm.com/bundle/resource/topics/80-80021-12A/debug-non-hlos-subsystems.html#qxdm_professional)。 ### **离线调试功能** 您可以使用 RAM 转储或 QXDM Professional 进行离线调试。 #### **RAM 转储** RAM 转储是故障发生时整个内存的快照。您可以使用各种工具分析 RAM 转储,包括 Qualcomm® 崩溃分析门户(QCAP)、RAMParser、Lauterbach TRACE32 模拟器和 crash 实用工具。 有关如何收集和解析 RAM 转储的更多信息,请参阅[收集并解析 RAM 转储](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/collect-and-parse-ram-dump#collect-and-parse-ram-dump)。 #### **QXDM Professional** 使用 QXDM Professional 调试各种子系统。此工具仅供具有授权访问权限的许可开发者使用。有关 QXDM Professional 命令及其用法的更多信息,请参阅 [Qualcomm Linux 调试指南 - 补充文档](https://docs.qualcomm.com/bundle/resource/topics/80-80021-12A/debug-non-hlos-subsystems.html#qxdm_professional)。 ## **常见系统问题** 您可以将系统问题分为以下类型之一: > * [Linux 内核空间问题](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/debug-addendum-overview#debug-linux-kernel-space-issues) > * [系统问题](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/debug-common-system-issues#debug-common-system-issues) > > * [看门狗问题](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/debug-common-system-issues#debug-watchdog-timeout-issues) > > * [总线挂起和超时问题](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/debug-common-system-issues#debug-common-system-issues) > > * [硬件复位问题](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/debug-common-system-issues#identify-the-cause-of-hardware-reset) ## **其他问题** 您可能会遇到以下其他问题: * 由软件 bug 导致的设备冻结问题 * 与 Linux 应用相关的问题 * 由与 PCB 相关的硬件问题导致的随机复位 ## **后续步骤** > * 要调试与 Linux 应用相关的问题,请参阅[调试 Linux 用户空间问题](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/Debug%20linux%20userspace%20issues#debug-linux-user-space-issues)。 > * 要调试与 Linux 内核相关的问题,请参阅[调试 Linux 内核空间问题](https://dragonwingdocs.qualcomm.com/System/Debug-Subsystem/Debug%20linux%20userspace%20issues)。