> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 性能调优与优化入门

您可以使用性能构建版本来测量系统性能。此外，您还可以编译调试工具来分析和解决任何性能问题。

## **前提条件**

要开始使用 Qualcomm<sup>®</sup> Linux<sup>®</sup> 开发您的软件，请按照[使用 Yocto 构建 Qualcomm Linux](https://dragonwingdocs.qualcomm.com/Key-Documents/Yocto-Guide/build-qualcomm-linux) 中的说明设置您的基础设施。该构建指南还介绍了常见的构建工作流。

## **关键性能指标（KPI）**

关键性能指标（KPI）是可衡量的值，用于表明系统相对于既定目标的运行效果。在 Qualcomm Linux 性能调优中，KPI 可帮助您评估系统是否达到性能目标，并识别需要优化的方面。

以下是本指南中使用的主要 KPI 类别：

* **启动时间** — 从上电到系统在各个阶段就绪所经过的时间，例如第一个用户空间进程启动、摄像头驱动程序初始化以及服务目标完成。
* **系统基准测试** — 使用 Geekbench、CoreMark、Tiotest、GLmark2、Sysbench 和 UnixBench 等工具测量 CPU、内存、存储和图形性能的标准化分数。
* **延迟** — 关键操作的响应时间，例如摄像头快照延迟或实时任务的调度延迟。
* **内存利用率** — 启动后以及运行用例期间各系统组件（内核、用户空间、空闲内存）占用的 RAM 量。
* **吞吐量** — 处理或传输数据的速率，例如存储 I/O 速率或内存带宽。

## **性能分析和调优流程工作流**

下图显示了实现预期系统性能的工作流：

<div className="flex flex-col items-center gap-2">
  <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/System/Performance/media/k2l-performance/qual_linux_perform_workflow.svg?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=2746310c37826b8f034a95869856ae0d" alt="图：测量 Qualcomm Linux 系统性能的工作流" width="1210" height="310" data-path="System/Performance/media/k2l-performance/qual_linux_perform_workflow.svg" />

  <p className="text-sm text-gray-700">
    图：测量 Qualcomm Linux 系统性能的工作流
  </p>
</div>

该工作流图将性能分析和调优过程总结为六个步骤：

1. 使用分析工具准备性能构建版本。
2. 测量关键性能指标（KPI），例如系统基准测试和引导时间。
3. 排查性能问题，包括 CPU 工作负载和内存使用情况。
4. 应用调优和定制以解决已识别的问题。
5. 评估 KPI 目标以确定是否达到性能目标。如果未达到性能目标，请根据系统需求进行故障排查和调优。这形成了持续性能改进的迭代循环。
6. 在 [Qualcomm 支持](https://www.qualcomm.com/support/)报告未解决的问题。

## **准备性能构建版本**

建议使用性能构建版本进行性能测量或调试。要准备性能构建版本，请使用以下命令：

```text theme={null}
kas build meta-qcom/ci/<machine>.yml:meta-qcom/ci/qcom-distro.yml:meta-qcom/ci/performance.yml
```

将 `<machine>` 替换为您的目标机器名称，例如 `qcs6490-rb3gen2-core-kit.yml`。

有关更多信息，请参阅[使用 Yocto 构建 Qualcomm Linux](https://dragonwingdocs.qualcomm.com/Key-Documents/Yocto-Guide/build-qualcomm-linux)。

性能构建版本使用源代码中的以下内核配置片段：

`meta-qcom/recipes-kernel/linux/linux-qcom-6.18/configs/bsp-additions.cfg`

这些内核配置在源代码内核配方中定义，位于

`meta-qcom/recipes-kernel/linux/linux-qcom_6.18.bb`

## **编译性能工具**

用于调试性能问题的工具包括 LTTng、GCC、G++、htop、perf 实用程序、iotop 和 lmbench。

要编译调试工具，请将它们添加到源代码中以下路径的 `qcom-multimedia-image.bb` 发行版镜像中：

`meta-qcom-distro/recipes-products/images/`

```text theme={null}
diff --git a/recipes-products/images/qcom-multimedia-image.bb b/recipes-products/images/qcom-multimedia-image.bb
--- a/recipes-products/images/qcom-multimedia-image.bb
+++ b/recipes-products/images/qcom-multimedia-image.bb
@@ CORE_IMAGE_BASE_INSTALL @@
 CORE_IMAGE_BASE_INSTALL += " \
     ...
     wireplumber \
+    lttng-tools \
+    lttng-tools-dev \
+    lttng-modules \
+    lttng-modules-dev \
+    lttng-ust \
+    lttng-ust-dev \
+    liburcu-dev \
+    gcc \
+    g++ \
+    iotop \
+    htop \
+    perf \
+    lmbench \
 "
```

要应用此补丁，请从 `meta-qcom-distro` 目录运行 `git apply <patch-file>`，或手动将列出的软件包添加到配方文件的 `CORE_IMAGE_BASE_INSTALL` 部分中。

## **后续步骤**

* [影响性能的功能](./features-impacting-performance)