# Qualcomm Linux Yocto 文档

说明 Qualcomm^®^ Linux^®^ 如何使用 Yocto 为 Qualcomm 硬件编译嵌入式系统软件的镜像。

## Qualcomm Linux Yocto 概述

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> Qualcomm Linux Yocto 概述

概述如何使用 Yocto 项目定制 Qualcomm Linux。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/qualcomm_linux_yocto_overview.html#yocto-overview

## Qualcomm Linux 元数据层

<link rel="stylesheet" type="text/css" href="https://d3je78mjrgbmx8.cloudfront.net/topic-card.css">
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> meta-qcom

包含对 Qualcomm 设备的支持和上游 OSS 组件。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/meta_qcom.html#meta-qcom

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> meta-qcom-hwe

包含为 Qualcomm Linux 编译软件组件的机器配置文件。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/meta_qcom_hwe.html#meta-qcom-hwe

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> meta-qcom-distro

提供 Qualcomm Linux 的参考分发包配置。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/meta_qcom_distro.html#meta-qcom-distro

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> meta-qcom-realtime

为 Qualcomm Linux 内核提供补丁和配置以实现实时操作。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/meta_qcom_realtime.html#meta-qcom-realtime

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> meta-qcom-extras

可选元数据层，可实现选定组件的源代码编译。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/meta_qcom_extras.html#meta-qcom-extras

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> meta-qcom-qim-product-sdk

提供基于 GStreamer 框架的 Qualcomm^®^ Intelligent Multimedia (QIM) SDK 和 AI SDK。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/meta_qcom_qim_product_sdk.html#meta-qcom-qim-product-sdk

## 配置 Qualcomm Linux 软件组件

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 系统初始化脚本

将系统初始化脚本添加到镜像中。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/system_initscripts.html#system-initscripts-section

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 使用 systemd-boot 和 UKI 配置启动并安全启动

提供控制启动流程的选项并加载用户选择的 boot loader。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/configure_and_secure_boot_with_systemd_boot_and_uki.html#configure-and-secure-boot-with-systemd-boot-and-uki

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 在 Qualcomm Linux 中管理分区

介绍如何添加、删除、修改和重命名分区。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/managing_partitions_in_qualcomm_linux.html#managing-partitions-in-qualcomm-linux

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 创建二级虚拟机

使用 Qualcomm Linux 编译系统创建 VM 镜像。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/create_secondary_virtual_machine.html#create-secondary-virtual-machine

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 使用 capsule 和 OSTree 机制在 Qualcomm Linux 上更新固件和操作系统

通过 OTA 下载更新保持设备处于最新状态。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/update_fw_and_os_qualcomm_linux_using_capsule_and_ostree_mechanisms.html#update-fw-and-os-qualcomm-linux-using-capsule-and-ostree-mechanisms

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 从 SD 卡启动 Linux 操作系统

从 SD 卡启动开发套件。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/boot_linux_operating_system_from_sdcard.html#boot-linux-operating-system-from-sdcard

## 自定义 Qualcomm Linux

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 添加定制计算机配置

添加自定义机器配置并编译镜像。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/add_custom_machine_configurations.html#add-custom-machine-configurations

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 添加定制分发包配置

添加自定义分发包配置文件。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/add_custom_distro_configurations.html#add-custom-distro-configurations

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 添加镜像配方

说明如何添加镜像配方。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/add_image_recipes.html#add-image-recipes

## 调试

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icn-book-blue">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 调试

解决常见问题和故障。

https://docs.qualcomm.com/doc/80-70022-27SC/topic/debug.html#debug1

Last Published: Nov 04, 2025

[Next Topic
Qualcomm Linux Yocto 概述](https://docs.qualcomm.com/bundle/publicresource/80-70022-27SC/topics/qualcomm_linux_yocto_overview.md)