# Overview

This Qualcomm^®^ Linux^®^ Yocto Guide provides information about how
Qualcomm Linux uses Yocto to build an embedded system software 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.20 documentation](https://docs.yoctoproject.org/4.0.20/)

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 are built on
the principles of the Yocto Project to help you further customize
Qualcomm Linux.

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

> 
> 
> - The `custom` variant allows you to build software image with Qualcomm value-added software.
> - The `base` variant builds the upstream software components.

For more information on these variants, see [Use of BitBake OVERRIDES in Qualcomm Linux metadata layers](https://docs.qualcomm.com/doc/80-70015-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-70015-27/topic/platform_software_features.html#meta-qcom-hwe-section) and
these machine configurations are mapped to the [hardware kits](https://www.qualcomm.com/developer/software/qualcomm-linux/hardware).

Note

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

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

For information on how to customize Qualcomm Linux, see
[User customizations](https://docs.qualcomm.com/doc/80-70015-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-70015-27/topic/debug.html).

Note

See [Hardware SoCs](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-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: Oct 14, 2024

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