# Qualcomm Linux Yocto 文档

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

## 概述

<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> 概述

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

https://docs.qualcomm.com/doc/80-70018-27SC/topic/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-70018-27SC/topic/qualcomm_linux_metadata_layers_overview.html#meta-qcom-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> meta-qcom-hwe

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

https://docs.qualcomm.com/doc/80-70018-27SC/topic/qualcomm_linux_metadata_layers_overview.html#meta-qcom-hwe-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>  meta-qcom-distro

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

https://docs.qualcomm.com/doc/80-70018-27SC/topic/qualcomm_linux_metadata_layers_overview.html#meta-qcom-distro-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>  meta-qcom-realtime

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

https://docs.qualcomm.com/doc/80-70018-27SC/topic/qualcomm_linux_metadata_layers_overview.html#meta-qcom-realtime-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>  meta-qcom-extras

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

https://docs.qualcomm.com/doc/80-70018-27SC/topic/qualcomm_linux_metadata_layers_overview.html#meta-qcom-extras-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>  meta-qcom-qim-product-sdk

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

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

## 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-70018-27SC/topic/qualcomm_linux_software_components.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>  调试工具

将调试工具添加到 Qualcomm Linux 的根文件系统中。

https://docs.qualcomm.com/doc/80-70018-27SC/topic/qualcomm_linux_software_components.html#debug-tools

<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-70018-27SC/topic/qualcomm_linux_software_components.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-70018-27SC/topic/qualcomm_linux_software_components.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-70018-27SC/topic/qualcomm_linux_software_components.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>  Qualcomm Linux 的 OTA 更新

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

https://docs.qualcomm.com/doc/80-70018-27SC/topic/qualcomm_linux_software_components.html#ota-update-for-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> 从 SD 卡启动 Linux 操作系统

从 SD 卡启动开发套件。

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

## 用户定制

<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-70018-27SC/topic/user_customizations.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-70018-27SC/topic/user_customizations.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-70018-27SC/topic/user_customizations.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-70018-27SC/topic/debug.html#debug1

Last Published: May 06, 2025

[Next Topic
概述](https://docs.qualcomm.com/bundle/publicresource/80-70018-27SC/topics/overview.md)