# 概述

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

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

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

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

Qualcomm Linux 版本和本文档基于 Yocto 项目的原则编译，可帮助您进一步定制 Qualcomm Linux。

Qualcomm Linux 提供两种编译版本变体：`base` 和 `custom`。

> 
> 
> - `base` build 变体允许您使用上游软件组件编译系统软件镜像。但是，对于 Qualcomm 软件，有一些例外，因为有些部分尚未上游化处理，有些部分是启动参考硬件所必需的。
> - `custom` build 变体允许您编译包含 Qualcomm 增值软件的系统软件镜像。

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

Note

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

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

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

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

Note

请参阅 Qualcomm Linux上支持的[硬件 SoC](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-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: May 06, 2025

[Previous Topic
Qualcomm Linux Yocto 文档](https://docs.qualcomm.com/bundle/publicresource/80-70018-27SC/topics/yocto_landing_page.md) [Next Topic
Qualcomm Linux 特性](https://docs.qualcomm.com/bundle/publicresource/80-70018-27SC/topics/qualcomm_linux_features.md)