# Overview

This Qualcomm^®^ Linux^®^ Yocto Guide provides information about how
Qualcomm Linux uses Yocto to build an embedded system software image for Qualcomm
target hardware.

For an introduction to Yocto, see the
following pages created by the Yocto Project^®^:

- [The Yocto Project](https://www.yoctoproject.org/)
- [The Yocto Project 4.0.22 documentation](https://docs.yoctoproject.org/4.0.22/)

The Yocto Project provides tools, software, configurations, and best
practices to create customized Linux images for
embedded and IoT devices, or anywhere a customized Linux OS is needed.

The Qualcomm Linux release, along with this documentation, is built on
the principles of the Yocto Project to help you further customize
Qualcomm Linux.

There are two build variants in Qualcomm Linux: `base` and `custom`.

> 
> 
> - The `base` variant allows you to build a system software image using upstream software components. However, there are a few exceptions for Qualcomm software that is still being upstreamed or is necessary to boot the reference hardware.
> - The `custom` variant allows you to build a system software image that includes Qualcomm value-added software.

For more information on these variants, see [Use of BitBake OVERRIDES in Qualcomm Linux metadata layers](https://docs.qualcomm.com/doc/80-70017-27/topic/platform_software_features.html#use-of-bitbake-overrides).
These two variants can be used with the machine configurations defined in [meta-qcom-hwe](https://docs.qualcomm.com/doc/80-70017-27/topic/platform_software_features.html#meta-qcom-hwe-section) and
these machine configurations are mapped to the [development kits](https://www.qualcomm.com/developer/software/qualcomm-linux/hardware).

Note

To find the mapping of supported overrides and machine configurations to a development kit, see Section 4.2 of the
[Qualcomm Linux Release Notes](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-241225194606).

For information about the supported features, see
[Qualcomm Linux features](https://docs.qualcomm.com/doc/80-70017-27/topic/platform_software_features.html).

For information on how to customize Qualcomm Linux, see
[User customizations](https://docs.qualcomm.com/doc/80-70017-27/topic/user_customizations.html).

For diagnosis and troubleshooting procedures for commonly-encountered problems with Yocto workspaces,
see [Debug](https://docs.qualcomm.com/doc/80-70017-27/topic/debug.html).

Note

See [Hardware SoCs](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-115/soc.html) that are supported on Qualcomm Linux.

Note

The QCM6490 and QCS6490 hardware SoCs are used
interchangeably in this guide. The `qcs6490-rb3gen2-core-kit.conf`
and `qcs6490-rb3gen2-vision-kit.conf` machine configuration files
defined in the `meta-qcom-hwe/conf/machine/` directory support the
QCM6490, QCS6490, and QCS5430 hardware SoCs.

Last Published: Dec 30, 2024

[Next Topic
Qualcomm Linux features](https://docs.qualcomm.com/bundle/publicresource/80-70017-27/topics/platform_software_features.md)