# Qualcomm Linux Yocto documentation

Provides information about how Qualcomm^®^ Linux^®^ uses Yocto to build an embedded system software image for Qualcomm hardware.

## Qualcomm Linux Yocto overview

<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 Overview

Provides an overview of how to use the Yocto Project to customize Qualcomm Linux.

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

## Qualcomm Linux metadata layers

<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

Contains machine configuration files that build software components for Qualcomm Linux.

https://docs.qualcomm.com/doc/80-80022-27/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-distro

Provides a reference distribution configuration for Qualcomm Linux.

https://docs.qualcomm.com/doc/80-80022-27/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-extras

Optional metadata layer, which enables source compilation of select components.

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

## Configure Qualcomm Linux software components

<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>  System initscripts

Add system initialization scripts to the image.

https://docs.qualcomm.com/doc/80-80022-27/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>  Configure and secure boot with systemd-boot and UKI

Provides options to control the boot flow and loads the user-selected boot loader.

https://docs.qualcomm.com/doc/80-80022-27/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>  Manage partitions in Qualcomm Linux

Describes how to add, delete, modify, and rename partitions.

https://docs.qualcomm.com/doc/80-80022-27/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>  Create a secondary virtual machine

Create VM images using the Qualcomm Linux build system.

https://docs.qualcomm.com/doc/80-80022-27/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>  Update firmware and OS on Qualcomm Linux using capsule and OSTree mechanisms

Keep devices up to date with on-the-air updates.

https://docs.qualcomm.com/doc/80-80022-27/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>  Boot Linux operating system from the SD card

Boot up development kits from the SD card.

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

## Customize 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>  Add custom machine configurations

Add a custom machine configuration and build an image.

https://docs.qualcomm.com/doc/80-80022-27/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>  Add custom distribution configurations

Add a custom distribution configuration file.

https://docs.qualcomm.com/doc/80-80022-27/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>  Add image recipes

Provides information on how to add image recipes.

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

## Debug

<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>  Debug

Resolve general problems and issues.

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

Last Published: May 10, 2026

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