Skip to main content
This layer provides a reference distribution configuration for Qualcomm Linux. This layer defines the image recipes and package groups.

​
Distribution configuration

The following table provides an introduction to the distribution configurations, which are available on GitHub.
Distribution configurationDescription
conf/distro/qcom-distro.confThis distribution configuration file defines the qcom-distro distribution. You can use the qcom-distro distribution in the following example command:
kas shell meta-qcom/ci/rb3gen2-core-kit.yml:meta-qcom/ci/qcom-distro.yml
bitbake qcom-multimedia-image
The meta-qcom-distro/conf/distro/include/qcom-base.inc configuration defines common DISTRO_FEATURES. The meta-qcom-distro/conf/distro/qcom-distro.conf configuration adds the following features:
  • glvnd
  • opencl
  • opengl
  • vulkan
  • wayland
The Yocto Project documentation defines these distribution features at Distribution features.
conf/distro/qcom-distro-catchall.confThis distribution configuration file defines Qualcomm reference distribution with Wayland with SELinux-enabled and OStree. It adds selinux and sota to DISTRO_FEATURES.
conf/distro/qcom-distro-selinux.confThis distribution configuration file defines Qualcomm reference distribution with Wayland with SELinux-enabled. It adds selinux to DISTRO_FEATURES.
conf/distro/qcom-distro-sota.confThis distribution configuration file defines Qualcomm reference distribution with Wayland where OTA is also enabled. It adds sota to DISTRO_FEATURES, which is done by inheriting conf/distro/sota.conf.inc file available in meta-updater.
DISTRO_FEATURES:append = " \
    efi \
    glvnd \
    kvm \
    minidebuginfo \
    opencl \
    overlayfs \
    pam \
    pni-names \
    security \
    tpm2 \
    virtualization \
    wifi \
    x11 \
"
To understand the purpose of these DISTRO_FEATURES, see Distribution features. The conf/distro/include/qcom-base.inc file sets INIT_MANAGER = "systemd" and defines the base DISTRO_FEATURES shown above. kvm is enabled by default in DISTRO_FEATURES — KVM-based virtualization is available on all supported platforms without requiring a separate distro configuration. The dedicated qcom-distro-kvm.conf has been removed; KVM enablement is now controlled per-machine via MACHINE_FEATURES.

​
When to create a custom DISTRO

To add a custom distribution configuration and rebuild the workspace, see Add custom distribution configurations.

​
Package groups

Package groups are defined in meta-qcom and meta-qcom-distro. The following table provides an introduction to the package groups:
Package groupDescription
packagegroup-qcom-benchmark.bbPackage group to bring in benchmarking packages.
packagegroup-qcom-security.bbPackage group to bring in packages required for security.
packagegroup-qcom-test-pkgs.bbPackage group to bring in packages required to test images.
packagegroup-qcom-utilities.bbUserspace utilities for Qualcomm platforms.
packagegroup-qcom-virtualization.bbPackage group to bring in packages required for virtualization.

​
Image recipes

The meta-qcom-distro Qualcomm Linux metadata layer defines image recipes, which are available on GitHub. The following table lists various images, their IMAGE_FEATURES, and the functions that the images serve:
Image recipeDescription of the image
qcom-minimal-image.bbDefines a small rootfs to boot to the shell. The IMAGE_FEATURES enabled are as follows:
IMAGE_FEATURES += "splash tools-debug allow-root-login post-install-logging"
For more information about IMAGE_FEATURES, see Image features.
qcom-console-image.bbExtends qcom-minimal-image by adding more packages and enabling more IMAGE_FEATURES:
IMAGE_FEATURES += "${@bb.utils.contains('DISTRO_FEATURES', 'sota', '', 'package-management', d)} \
         ssh-server-openssh"
qcom-multimedia-image.bbRequires DISTRO_FEATURE wayland and it includes all the multimedia packages in rootfs.
qcom-multimedia-proprietary-image.bbAn image built on top of multimedia image for proprietary features. This image is compatible only with aarch64 (ARMv8).
qcom-container-orchestration-image.bbAn image built on top of the multimedia proprietary image with Kubernetes and container runtime packages.

​
Creating a custom image recipe

To add a custom image recipe and build using BitBake, see Add image recipes.

​
QDL flashing tool

QDL is a flashing tool that communicates with the USB devices to upload flash loader to the device. The flash loader flashes the images to universal flash storage (UFS) or embedded multimedia card (eMMC) built into the device. For more information about QDL flashing, see QDL.