> ## 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 Linux Yocto 概述

本指南介绍 Qualcomm Linux 如何使用 Yocto 为 Qualcomm 参考硬件构建嵌入式系统软件镜像。

## **快速入门：您需要自定义构建吗？**

在深入了解 Yocto 构建工作流之前，请先考虑哪条路径适合您：

* **只想快速上手？** Qualcomm 提供预构建、可直接烧写的镜像，您无需搭建构建环境即可下载并烧写到设备上。请参阅[烧写预构建镜像](./flash-prebuilt-images)。

* **需要定制？** 如果您想添加额外的软件包、修改默认设置、适配自定义硬件、添加或移除应用程序，或集成您自己的软件，那么本指南——以及完整的 Yocto 构建工作流——正适合您。请继续阅读下文。

## **本指南涵盖的内容**

本指南阐述 Qualcomm Linux 基于 Yocto 的平台框架。内容包括：

* Yocto 概念和 Qualcomm 层堆栈
* Qualcomm 维护的元数据层
* 机器、发行版和镜像配置
* 构建环境设置和 `kas` 配置模型
* Yocto 中的内核集成
* 固件和引导集成
* 安全启动和镜像签名
* 存储、分区和布局
* 容器、虚拟化和 OTA 更新
* 定制工作流
* 调试 Yocto 构建

## **本指南不涵盖的内容**

* 内核开发和调试——请参阅 [Qualcomm Linux 内核指南](https://dragonwingdocs.qualcomm.com/System/Kernel/kernel-overview)
* 设备烧写——请参阅 [Qualcomm Linux 引导指南](https://dragonwingdocs.qualcomm.com/System/Boot/boot-overview)

## **本指南的定位**

Qualcomm Linux 文档集围绕三个互补的指南组织：

| **指南**                                                                    | **重点**              |
| ------------------------------------------------------------------------- | ------------------- |
| **Yocto 指南**（本指南）                                                         | 平台框架：层、机器、发行版、镜像和定制 |
| [内核指南](https://dragonwingdocs.qualcomm.com/System/Kernel/kernel-overview) | 内核开发、配置、设备树和调试      |

## **本指南的目标读者**

| **读者**   | **起点**                                                                                                                                             |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| 初学者/集成人员 | 从 [Qualcomm Linux 的 Yocto 概念](./qualcomm-linux-yocto-documentation)和[使用 Yocto 构建 Qualcomm Linux](./build-qualcomm-linux) 开始                        |
| BSP 工程师  | 重点关注 [Qualcomm Linux 元数据层](./qualcomm-linux-metadata-layers)、[机器与硬件支持](./add-custom-machine-configurations)以及 [Yocto 中的内核集成](./customizing-kernel) |
| 高级平台工程师  | 请参阅[安全启动与镜像签名](./configure-and-secure-boot-with-systemd-boot-and-uki)、[容器、虚拟化与 OTA](./run-docker-containers)以及[定制工作流](./customize-qualcomm-linux)  |

## **Qualcomm Linux 版本**

Qualcomm Linux 版本及本文档基于 Yocto Project 的原则构建，帮助您进一步定制 Qualcomm Linux。Qualcomm Linux 2.0 基于 Yocto master 分支。

Qualcomm Linux 提供两种参考镜像：

* `qcom-multimedia-image` 包含上游软件组件，以及来自 [https://github.com/qualcomm-linux/kernel](https://github.com/qualcomm-linux/kernel) `qcom-6.18.y` 的内核。
* `qcom-multimedia-proprietary-image` 包含 Qualcomm 增值软件，以及来自 [https://github.com/qualcomm-linux/kernel](https://github.com/qualcomm-linux/kernel) `qcom-6.18.y` 的内核。

## **后续步骤**

* [meta-qcom](./meta-qcom) 中定义的机器配置映射到[开发套件](https://www.qualcomm.com/developer/software/qualcomm-linux/hardware)。
* 要查找机器配置与开发套件的映射关系，请参阅 [Qualcomm Linux 版本说明](https://dragonwingdocs.qualcomm.com/Key-Documents/Software-Release-Notes/introduction)的相关章节。
* 请参阅 Qualcomm Linux 支持的硬件 SoC [IQ-9075](https://docs.qualcomm.com/nav/home?product=1601111740076079) 和 [IQ-8275](https://docs.qualcomm.com/nav/home?product=1601111740085228)。