# 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
Qualcomm Linux Yocto Overview
Provides an overview of how to use the Yocto Project to customize Qualcomm Linux.
https://docs.qualcomm.com/doc/80-70020-27/topic/qualcomm_linux_yocto_overview.html#yocto-overview
## Qualcomm Linux Metadata layers
meta-qcom
Contains Qualcomm device support and upstream OSS components.
https://docs.qualcomm.com/doc/80-70020-27/topic/qualcomm_bsp_metadata_layers.html#meta-qcom-section
meta-qcom-hwe
Contains machine configuration files that build software components for Qualcomm Linux.
https://docs.qualcomm.com/doc/80-70020-27/topic/qualcomm_bsp_metadata_layers.html#meta-qcom-hwe-section
meta-qcom-distro
Provides a reference distribution configuration for Qualcomm Linux.
https://docs.qualcomm.com/doc/80-70020-27/topic/qualcomm_bsp_metadata_layers.html#meta-qcom-distro-section
meta-qcom-realtime
Provides patches and configurations for the Qualcomm Linux kernel to enable real-time operations.
https://docs.qualcomm.com/doc/80-70020-27/topic/qualcomm_bsp_metadata_layers.html#meta-qcom-realtime-section
meta-qcom-extras
Optional metadata layer, which enables source compilation of select components.
https://docs.qualcomm.com/doc/80-70020-27/topic/qualcomm_bsp_metadata_layers.html#meta-qcom-extras-section
meta-qcom-qim-product-sdk
Provides Qualcomm^®^ Intelligent Multimedia (QIM) SDK and AI SDKs based on the GStreamer framework.
https://docs.qualcomm.com/doc/80-70020-27/topic/qualcomm_bsp_metadata_layers.html#meta-qcom-qim-product-sdk-section
## Qualcomm Linux software components
System initscripts
Add system initialization scripts to the image.
https://docs.qualcomm.com/doc/80-70020-27/topic/system_initscripts.html#system-initscripts-section
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-70020-27/topic/configure_and_secure_boot_with_systemd_boot_and_uki.html#configure-and-secure-boot-with-systemd-boot-and-uki
Manage partitions in Qualcomm Linux
Describes how to add, delete, modify, and rename partitions.
https://docs.qualcomm.com/doc/80-70020-27/topic/managing_partitions_in_qualcomm_linux.html#managing-partitions-in-qualcomm-linux
Create secondary virtual machine
Create VM images using the Qualcomm Linux build system.
https://docs.qualcomm.com/doc/80-70020-27/topic/create_secondary_virtual_machine.html#create-secondary-virtual-machine
OTA update for Qualcomm Linux
Keep devices up to date with on-the-air updates.
https://docs.qualcomm.com/doc/80-70020-27/topic/ota_update_for_qualcomm_linux.html#ota-update-for-qualcomm-linux
Boot Linux operating system from SD card
Boot up development kits from the SD card.
https://docs.qualcomm.com/doc/80-70020-27/topic/boot_linux_operating_system_from_sdcard.html#boot-linux-operating-system-from-sdcard
## User customizations
Add custom machine configurations
Add a custom machine configuration and build an image.
https://docs.qualcomm.com/doc/80-70020-27/topic/add_custom_machine_configurations.html#add-custom-machine-configurations
Add custom distribution configurations
Add a custom distribution configuration file.
https://docs.qualcomm.com/doc/80-70020-27/topic/add_custom_distro_configurations.html#add-custom-distro-configurations
Add image recipes
Provides information on how to add image recipes.
https://docs.qualcomm.com/doc/80-70020-27/topic/add_image_recipes.html#add-image-recipes
## Debug
Debug
Resolve general problems and issues.
https://docs.qualcomm.com/doc/80-70020-27/topic/debug.html#debug1
Last Published: Jul 02, 2025
[Next Topic
Qualcomm Linux Yocto overview](https://docs.qualcomm.com/bundle/publicresource/80-70020-27/topics/qualcomm_linux_yocto_overview.md)