meta-qcom-releases

This repository holds the kas lock files for meta-qcom milestone releases.

Each milestone release is tagged uniquely and tag follows the format qli-<version>

For information on the features supported by each milestone release, refer to the Software Release Notes.

Host requirements

• Configuration

  • x86 machine
  • Quad-core CPU, for example, Intel i7-2600 at 3.4 GHz (equivalent or better)
  • 300 GB free disk space (swap partition > 32 GB)
  • 16 GB RAM
  • Ubuntu 22.04

• Tools

  • Git 1.8.3.1 or later versions
  • Tar 1.28 or later versions
  • Python 3.10.2 or later versions
  • GCC 10.1 or later versions
  • GNU Make 4.0 or later versions
  • Kas version 4.8 or later versions

• Permissions

  • A sudo permission is required to run a few commands

Note

Code compilation on a VM is a slow process and can take a few hours. Qualcomm recommends using an Ubuntu host computer for compilation. To set up a virtual machine (VM) running Ubuntu 22.04 on Microsoft® Windows® or Apple® macOS®, see Qualcomm Linux Virtual Machine Setup Guide.

Build Instructions

1. Download Qualcomm Yocto and the supporting meta-layers.

   git clone https://github.com/qualcomm-linux/meta-qcom-releases.git -b <meta-qcom-releases-tag>
   kas checkout meta-qcom-releases/lock.yml

2. Copy the kas lock file from meta-qcom-releases to meta-qcom. Make sure to run this step, otherwise the checked out meta layers may get updated to a newer commit.

   # kas configuration files need to be part of same repository
   # copy kas lock file to meta-qcom repository
   cp meta-qcom-releases/lock.yml meta-qcom/ci/lock.yml

3. Build the software image. Build targets are defined based on machine and distro combinations.

   kas build meta-qcom/ci/<machine.yml>:meta-qcom/ci/<distro.yml>:meta-qcom/ci/lock.yml

4. After a successful build, check that the rootfs.img file is in the build artifacts:

   cd <workspace-dir>/build/tmp/deploy/images/<MACHINE>/<IMAGE>-<MACHINE>.rootfs.qcomflash/
   ls -al rootfs.img

For more info, please refer to the official Qualcomm Linux Build Guide.

Getting in Contact

If you need help, have questions, or want to report a problem:

GitHub Issues Use the issue tracker below to report bugs, request features, or ask technical questions related to this repository. 👉 Open an Issue

License

This layer is licensed under the BSD-3-clause License. See LICENSE.txt for the full license text.