# 概述

本 Qualcomm^®^ Linux^®^ Yocto 指南描述了 Qualcomm Linux 如何使用 Yocto 为 Qualcomm 目标硬件编译嵌入式系统软件镜像。

有关 Yocto 的介绍，请参阅 Yocto 项目创建的以下页面^®^：

- [Yocto 项目](https://www.yoctoproject.org/)
- [Yocto 项目 4.0.22 文档](https://docs.yoctoproject.org/4.0.22/)

Yocto Project 提供了可用于为嵌入式和 IoT 设备等任何需要定制 Linux 操作系统的目标硬件创建定制 Linux 镜像的工具、软件、配置和最佳实践。

Qualcomm Linux 发布版本及其文档是基于 Yocto 项目的原理编译生成的，旨在帮助您进一步定制 Qualcomm Linux。

Qualcomm Linux 有两种 build 变体：`base` 和 `custom`。

> 
> 
> - `base` build 变体允许您使用上游软件组件编译系统软件镜像。不过，对于仍在上游化或启动参考硬件所必需的 Qualcomm 软件来说，也有一些例外。
> - `custom` build 变体允许您编译包含 Qualcomm 增值软件的系统软件镜像。

有关这些变体的更多信息，请参阅[在 Qualcomm Linux 元数据层中使用 BitBake OVERRIDES](https://docs.qualcomm.com/doc/80-70017-27SC/topic/platform_software_features.html#use-of-bitbake-overrides)。这两种变体可以与 [meta-qcom-hwe](https://docs.qualcomm.com/doc/80-70017-27SC/topic/platform_software_features.html#meta-qcom-hwe-section) 中定义的机器配置一起使用，这些机器配置被映射到[开发套件](https://www.qualcomm.com/developer/software/qualcomm-linux/hardware)。

Note

要查找支持的覆盖和机器配置与开发套件的映射，请参阅 [Qualcomm Linux 发布版本说明](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-241225194606)的 4.2 节。

有关所支持的特性，请参阅 [Qualcomm Linux 特性](https://docs.qualcomm.com/doc/80-70017-27SC/topic/platform_software_features.html)。

有关如何定制 Qualcomm Linux 的信息，请参阅[用户自定义](https://docs.qualcomm.com/doc/80-70017-27SC/topic/user_customizations.html)。

有关 Yocto 工作区常见问题的诊断和故障排除程序，请参阅[调试](https://docs.qualcomm.com/doc/80-70017-27SC/topic/debug.html)。

Note

请参阅 Qualcomm Linux上支持的[硬件 SoC](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-115/soc.html)。

Note

本指南中 QCM6490 和 QCS6490 硬件 SoC 可互换使用。`meta-qcom-hwe/conf/machine/` 目录中定义的 `qcs6490-rb3gen2-core-kit.conf` 和 `qcs6490-rb3gen2-vision-kit.conf` 机器配置文件支持 QCM6490、QCS6490 和 QCS5430 硬件 SoC。

Last Published: Jan 24, 2025

[Next Topic
Qualcomm Linux 特性](https://docs.qualcomm.com/bundle/publicresource/80-70017-27SC/topics/platform_software_features.md)