Page-1

# 概述 Source: [https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html](https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html) 子系统是指在 Qualcomm^®^ Linux 设备 (SoC) 上具有自己的独立执行环境的处理器。本指南介绍了用于对受影响子系统进行故障排除的工具、示例日志和步骤。以下是 Qualcomm SoC 上的不同子系统。 Table : SoC 上的子系统 | 子系统 | 说明 | | --- | --- | | 应用处理器子系统 (APSS) | 这是主子系统。它将 Linux 内核作为 high-level OS (HLOS) 来运行。 | | aDSP/LPASS | 应用数字信号处理器 (aDSP) 也被称为低功耗音频子系统 (LPASS)。 | | mDSP/MPSS | Modem 处理器子系统 (Modem processor subsystem) | | cDSP | Compute DSP | | WPSS | WLAN 处理器子系统 (WLAN processor subsystem) | | TrustZone (TZ) | 这是 Qualcomm 受信任执行环境。有关 TrustZone 子系统的更多信息，参见 [Qualcomm Linux 安全指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-11Y)。 | | Always On 处理器 (AOP) | 该子系统可以调节设备的电源。 | 除了应用处理器，与所有其他子系统相关的软件也称为 non-HLOS。要了解子系统的启动流程，参见 [Qualcomm Linux 启动指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-4Y)。要了解有关芯片组规范和功能框图的更多信息，参见 [QCS6490/QCS5430 Data Sheet](https://docs.qualcomm.com/bundle/publicresource/topics/80-23889-1/device-description.html)。有关常用术语（如 NoC 和 xPU）的定义，参见[缩略词和术语](https://docs.qualcomm.com/doc/80-70014-12Y/topic/references.html#acronyms_and_terms)。 Note: Qualcomm Linux 平台可用来开发适用于 QCS6490 和 QCS5430 的应用程序。 ## 调试工作流 Source: [https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html](https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html) 由于 SoC 中有多个子系统，因此首先需要确定发生问题的子系统，以便对正确的子系统进行调试。应用处理器为主处理器，可以检测其他子系统何时发生崩溃。例如，如果 modem 处理器子系统崩溃，则内核日志会捕获子系统重启 (SSR) 崩溃错误日志。因此，要确定必须调试的子系统，必须先验证内核调试消息。下图显示了识别需调试的子系统的调试工作流： Figure : 识别要调试的子系统的调试工作流当内核 dmesg 日志中没有 panic 标识特征时，去验证 TrustZone 诊断 (diag) 日志是否存在诸如 Non-secure watchdog bite、NoC error 等错误。下面是一些指示 panic、bug 和子系统崩溃问题的内核消息示例。 ### 识别内核 panic 和 bug 根据内核 dmesg 日志，可以确定该复位是内核 panic 还是 bug。下面是指示内核 panic 或 bug 的一些示例日志： - Panic （模式 1：一般错误） 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!Copy to clipboard - Bug（模式 1） 12.899532: <6> BUG kmalloc-128 (Not tainted): Redzone overwritten 12.905418: <6> -----------------------------------------------------------------------------Copy to clipboard - 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!Copy to clipboard - 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!Copy to clipboard Note: 大多数 bug 之后都会发生内核 panic。 ### 识别子系统崩溃问题确定重启的原因是否为子系统崩溃，验证内核 dmesg 日志。例如，以下日志表明，根据 qcm6490.dtsi（节点：remoteproc\_adsp: remoteproc@3000000），aDSP 子系统已崩溃。 0x000000000A27652C | 5198.790423: qcom_q6v5_pas 3000000.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 rejectedCopy to clipboard ### 根据 TrustZone 日志识别系统问题此功能目前可用于对随 Qualcomm Linux 一同发布的专有软件具有完全访问权限的用户。有关 TrustZone 中指示错误的示例日志，参见 [Qualcomm Linux Debug Guide - Addendum](https://docs.qualcomm.com/bundle/resource/topics/80-70014-12A/identify_subsystem_to_be_debugged.html#identify_and_debug_errors_in_tz)。如果 TrustZone 诊断日志没有错误，则很可能是 secure watchdog bite 问题。有关看门狗问题的更多信息，参见[硬件复位](https://docs.qualcomm.com/doc/80-70014-12Y/topic/general_system_debugging.html#reset_hardware)。有关 TrustZone 中调试问题的信息，参见 [Qualcomm Linux 安全指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-11Y/debug.html)。 ## 调试功能 Source: [https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html](https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html) 有两种调试方法： - **目标上调试** 目标上调试是调试软件问题的基本方式。这种方法十分强大，因为可以从实时设备访问大部分信息。但是，这种方法要求问题易于复现，并且还需要附加的硬件组件，例如主机 PC、调试器。 SSH 是连接主机与设备的主要工具。要使用 SSH，必须遵循[此处](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-254Y/how_to.html#how-to-ssh-)所述的步骤来启用 SELinux Permissive 模式。 - **目标外调试** 这种调试方法需要日志而不是实际设备，因此是一种方便、高效的调试方法。使用内存 dump 或日志工具完成调试。离线调试可使用各种类型的日志。您也可以使用保存在嵌入式文件系统中的日志文件。由于 RAM dump 会捕获大部分内存区域，但获取的硬件寄存器信息有限，因此调试硬件相关问题是一大挑战。 ## 目标上调试功能 Source: [https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html](https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html) 设备上提供了以下调试功能，可以在运行时使用。 ### Perf 工具 Perf 是 Linux 生态系统中一个功能强大的工具，它可以简化性能分析。Linux 内核的 tools/perf 目录中包括此工具。 Perf 工具可以帮助调试系统行为的各个方面，包括 CPU 性能计数器、跟踪点、kprobe 和 uprobe（用于动态跟踪）。下面是 Perf 工具的主要功能： - **CPU 性能计数器**：这些 CPU 硬件寄存器用于跟踪已执行指令、缓存未命中和分支误预测等事件。这些事件构成了分析应用程序和识别性能瓶颈的基础。 - **TracePoint**：这些跟踪点放置在代码中的逻辑位置。例如，系统调用、网络事件、文件系统操作。这些跟踪点以最小的开销提供时间戳和堆栈跟踪等信息。 - **动态跟踪**：Perf 可利用 kprobe 和 uprobe 框架动态创建跟踪点。因此，可以在内核和用户空间中进行跟踪。有关 Perf 工具的详细信息，参见以下内容： - [https://docs.kernel.org/trace/coresight/coresight-perf.html](https://docs.kernel.org/trace/coresight/coresight-perf.html) - [https://github.com/Linaro/OpenCSD/blob/master/HOWTO.md](https://github.com/Linaro/OpenCSD/blob/master/HOWTO.md) - [https://docs.kernel.org/trace/coresight/index.html](https://docs.kernel.org/trace/coresight/index.html) - [https://perf.wiki.kernel.org/index.php/Tutorial](https://perf.wiki.kernel.org/index.php/Tutorial) ### 子系统重启子系统可在崩溃时单独重启，无需设备重启。这种从端重启的功能称为子系统重启 (SSR)。建议仅在商用设备上使用 SSR 功能，不要在开发阶段使用。此功能可通过上游 Linux 内核中提供的 remoteproc 框架来实现。默认情况下，禁用 SSR 来启用完整内存 dump 以调试问题。有关 SSR 功能的详细信息，参见 [Remoteproc 子系统](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-3Y/features.html#Toc187817603)。 SSR dump 可作为 SSR 操作的一部分启用。SSR dump 在子系统重启时生成（如果已启用 SSR dump）。由于 SSR dump 的大小小于完整内存 dump 的大小，因此您可能倾向于使用 SSR dump 进行调试。但是，调试某些子系统崩溃需要整个 RAM dump。有关如何启用和捕获子系统 dump 的信息，参见[子系统 dump](https://docs.qualcomm.com/doc/80-70014-12Y/topic/debugging_linux_kernel.html#subsystem_ram_dumps)。 ### 强制子系统复位此功能可用于调试需要重启子系统的用例。此功能目前适用于对随 Qualcomm Linux 一同发布的专有软件具有完全访问权限的用户。要强制复位子系统，可以使用 QXDM 工具运行诊断命令。有关 QXDM 工具命令及其用法的信息，参见 [Qualcomm Linux Debug Guide - Addendum](https://docs.qualcomm.com/bundle/resource/topics/80-70014-12A/debug-non-hlos-subsystems.html#qxdm_professional)。 ## 目标外调试功能 Source: [https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html](https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html) 以下功能和工具可用于离线调试。 ### RAM dump RAM dump 是故障发生时整个内存 (RAM) 的快照。可使用各种工具（包括 QCAP、RAM parser 和 TRACE32 仿真器）来分析 RAM dump。有关如何收集和解析 RAM dump 的信息，参见[收集并解析 RAM dump](https://docs.qualcomm.com/doc/80-70014-12Y/topic/debugging_linux_kernel.html#collect_and_parse_ram_dumps)。 ### QXDM Professional™ QXDM Professional 工具可用于调试各种子系统。此工具目前适用于对随 Qualcomm Linux 一同发布的专有软件具有完全访问权限的用户。有关 QXDM 工具命令及其用法的信息，参见 [Qualcomm Linux Debug Guide - Addendum](https://docs.qualcomm.com/bundle/resource/topics/80-70014-12A/debug-non-hlos-subsystems.html#qxdm_professional)。 ## 常见问题 Source: [https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html](https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html) 系统故障可分类为以下情况之一： - [Linux 内核空间问题](https://docs.qualcomm.com/doc/80-70014-12Y/topic/debugging_linux_kernel.html) - [系统问题](https://docs.qualcomm.com/doc/80-70014-12Y/topic/general_system_debugging.html) - [看门狗问题](https://docs.qualcomm.com/doc/80-70014-12Y/topic/general_system_debugging.html#watchdog_timeout) - [总线 hang 和超时问题](https://docs.qualcomm.com/doc/80-70014-12Y/topic/general_system_debugging.html#erroneous_transaction_on_bus_error_and_timeout) - [硬件复位问题](https://docs.qualcomm.com/doc/80-70014-12Y/topic/general_system_debugging.html#reset_hardware) ## 其他问题 Source: [https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html](https://docs.qualcomm.com/doc/80-70014-12Y/topic/Debug-overview.html) 以下是您可能遇到的其他问题： - 软件 bug 导致设备冻结问题 - Linux 应用程序相关问题 - 由于 PCB 相关硬件问题导致的随机复位要调试 Linux 内核相关问题，参见[调试 Linux 内核空间](https://docs.qualcomm.com/doc/80-70014-12Y/topic/debugging_linux_kernel.html)。要调试 Linux 应用程序相关问题，参见[调试 Linux 用户空间](https://docs.qualcomm.com/doc/80-70014-12Y/topic/using_open_source_debug_tools.html)。 Last Published: Aug 22, 2024 [Next Topic 调试 Linux 用户空间](https://docs.qualcomm.com/bundle/publicresource/80-70014-12Y/topics/using_open_source_debug_tools.md)