使用 Yocto 构建 Qualcomm Linux

​

主机系统要求

• 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

• 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 4.8 or later versions

• Permissions
  • sudo permission is required to run a few commands

​

主机设置

• Install the following packages to prepare your host environment for the Yocto build
  sudo apt update
  sudo apt install build-essential chrpath cpio debianutils diffstat \
       file gawk gcc git iputils-ping libacl1 locales python3 python3-git \
       python3-jinja2 python3-pexpect python3-pip python3-subunit socat \
       texinfo unzip wget xz-utils zstd
  
• Qualcomm uses the kas tool to sync and build the Yocto project. Use the following steps to install kas on your system
  On older Ubuntu versions, the kas version provided by the system package manager may be outdated. Using pipx is the recommended way to install kas.
  1. Install pipx
     sudo apt install pipx
     
  2. Add the pipx install location to your PATH
     pipx ensurepath
     
     This command updates your shell’s startup file, so the change only takes effect in new shell sessions. Restart your shell session before continuing to the next step.
  3. Install kas (version 4.8 or higher is required)
     pipx install "kas>=4.8"
     
• Verify if the kas installation is successful.
  kas --version
  

​

kas 配置模型

• 一个机器 YAML 文件（例如 meta-qcom/ci/iq-9075-evk.yml）
• 一个发行版 YAML 文件（例如 meta-qcom/ci/qcom-distro.yml）

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

​

选择 MACHINE 和 DISTRO

​

配置参数

​

构建说明

• Download Qualcomm’s Yocto layer meta-qcom. For the latest <meta-qcom-release-tag>, see Configuration Parameters.
  git clone https://github.com/qualcomm-linux/meta-qcom -b <meta-qcom-release-tag>
  

• Build the software image using kas. You define build targets based on machine and distro combinations.
  IQ-9075-EVK

  IQ-8275-EVK

  IQ-615-EVK

  QCS6490

  IQ-X7181-EVK

  IQ-X5121-EVK

  IQ2390 / CQ2390

  kas build meta-qcom/ci/iq-9075-evk.yml:meta-qcom/ci/qcom-distro.yml:meta-qcom/ci/performance.yml
  

• The build creates a single tarball containing all the relevant files to perform a full clean flash, including partition metadata, boot firmware, ESP partition and the rootfs. After a successful build, check if the qcomflash tarball exists in the build artifacts. The following examples use qcom-multimedia-proprietary-image as the image name.
  IQ-9075-EVK

  IQ-8275-EVK

  IQ-615-EVK

  QCS6490

  IQ-X7181-EVK

  IQ-X5121-EVK

  IQ2390 / CQ2390

  ls build/tmp/deploy/images/iq-9075-evk/qcom-multimedia-proprietary-image-iq-9075-evk.rootfs.qcomflash.tar.gz
  

​

相关主题

• 如何构建 meta-qcom 的主线变体
• 如何在容器化环境中构建镜像？
• 如何使用旧版 repo manifest 方法构建 meta-qcom
• 如何使用旧版 meta-qcom-releases 方法构建 meta-qcom
• 如何在 meta-qcom 构建中启用调试配置
• 如何为 Yocto 构建设置共享缓存
• 如何为 Yocto BSP 构建配置存储类型
• 如何增加系统内存以避免 OOM 错误
• 如何使用 kas 执行常见任务
• 如何排查常见构建失败问题

​

后续步骤

• 要将您构建的镜像烧录到设备上，请参见烧录软件镜像。