# Build from source (with firmware and extras) Use this information to build `meta-qcom-extras` layer using selective proprietary sources and binaries/libraries. Note This information is applicable only for authorized users. To upgrade your access, go to [Qualcomm support page](https://www.qualcomm.com/support/working-with-qualcomm). ## Host computer 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 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](https://docs.qualcomm.com/bundle/publicresource/topics/80-80020-41/). ## Install QSC CLI To register your Qualcomm email ID, go to [Qualcomm support page](https://www.qualcomm.com/support/working-with-qualcomm). 1. Install curl (if not installed already): sudo apt install curl Copy to clipboard 2. Download the Debian package for `qsc-cli`: cd # For x86 curl -L https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Software_Center/Linux/Debian/latest.deb -o qsc_installer.deb # For ARM64 curl -L https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Software_Center/Linux/ARM64/Debian/latest.deb -o qsc_installer.deb Copy to clipboard 3. Install the `qsc-cli` Debian package: sudo apt update sudo apt install ./qsc_installer.deb Copy to clipboard 4. Sign in to `qsc-cli` using your registered email ID: qsc-cli login -u Copy to clipboard For more information about `qsc-cli`, see How to Sync. ## Set up the Ubuntu host computer Install and configure the software tools on the Ubuntu host computer. 1. Install the following packages: 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 sudo apt-get install lib32stdc++6 libncurses5 checkinstall libreadline-dev libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libffi-dev curl sudo apt install pipx # This command must add the kas binary location to your PATH # Restart your shell session after running this command for the changes to take effect pipx ensurepath # The kas version is expected to be 4.8 or higher pipx install kas Copy to clipboard 2. (Optional) Download the `kas-container` script. Kas is the tool you use to sync and build Yocto meta layers. The kas package also includes the `kas-container` script, which runs kas inside a container. If you prefer building images in an isolated environment, use `kas-container` instead. # kas-container can be run on any Linux distribution with Docker installed. wget -qO kas-container https://raw.githubusercontent.com/siemens/kas/refs/tags/5.1/kas-container chmod +x kas-container Copy to clipboard 3. Add your Qualcomm login ID with PAT to the `~/.netrc` file in your home directory: # Sign in to qsc-cli to generate PAT qsc-cli login -u # Run the following command to generate PAT qsc-cli show-access-token # This command gives output as shown in the following note # The last line in this output is the token, which can be used to access # Qualcomm Proprietary repositories. This token expires in two weeks. Copy to clipboard Note user@hostname:/local/mnt/workspace$ qsc-cli show-access-token [Info]: Starting qsc-cli version 0.0.0.9 **5LThNlklb55mMVLB5C2KqUGU2jCF** 4. Use your preferred text editor to edit the `~/.netrc` file and add the following entries. Create the `~/.netrc` file if it doesn’t exist. machine chipmaster2.qti.qualcomm.com login password machine qpm-git.qualcomm.com login password Copy to clipboard 5. Set up the locales (if not set up already): sudo locale-gen en_US.UTF-8 sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 export LC_ALL=en_US.UTF-8 export LANG=en_US.UTF-8 Copy to clipboard 6. Update git configurations: # Check if your identity is configured in .gitconfig git config --get user.email git config --get user.name # Run the following commands if you don't have your account identity set in .gitconfig git config --global user.email git config --global user.name <"Your Name"> # Add the following UI color option for output of console (optional) git config --global color.ui auto # Add the following git configurations to fetch large size repositories and to avoid unreliable connections git config --global http.postBuffer 1048576000 git config --global http.maxRequestBuffer 1048576000 git config --global http.lowSpeedLimit 0 git config --global http.lowSpeedTime 999999 # Add the following git configurations to follow remote redirects from http-alternates files or alternates git config --global http.https://chipmaster2.qti.qualcomm.com.followRedirects true git config --global http.https://qpm-git.qualcomm.com.followRedirects true Copy to clipboard 7. Set up Python 3.10.2: Note Skip the following instructions if you already have Python 3.10.2 or later versions. python --version # Download it in a directory of your choice wget https://www.python.org/ftp/python/3.10.2/Python-3.10.2.tgz tar -xvf Python-3.10.2.tgz cd Python-3.10.2 # Use sudo if you need to access /opt ./configure --prefix=/opt/python3 --enable-optimizations make make install ln -s /opt/python3/bin/python3 /opt/python3/bin/python export PATH=/opt/python3/bin:$PATH export PYTHONPATH=/opt/python3/lib:$PYTHONPATH Copy to clipboard Note The [kas](https://kas.readthedocs.io/en/latest/) tool is used by Qualcomm Linux to sync the meta layers, configure the environment, and execute the bitbake commands. ## Build with firmware sources ### Sync firmware Commands in the following sections are based on the binary and source for firmware images without modem and GPS (see the command in Mapping firmware distributions to git repositories). Hence, `qualcomm-linux-spf-2-0_ap_standard_oem_nomodem` is used. If you use any other distribution, then update the directory accordingly. The following table describes the Qualcomm Yocto layers and release tags: Qualcomm Yocto layers and manifest tags | Access level | Yocto layer | Release tag | Example | | --- | --- | --- | --- | | Public developers (unregistered) | `meta-qcom` | meta-qcom-releases tag | qcom-6.18-QLI.2.0-Ver.1.0 | | Licensed developers with authorized access | `meta-qcom-extras` | meta-qcom-extras-release tag | qcom-6.18-QLI.2.0-Ver.1.0 | | See Mapping access levels to firmware distributions | NA | firmware release tag | r2.0\_00001.1 | The following tables describe the firmware distributions that you can download. For more information about the Yocto layers, see [Qualcomm Linux metadata layers](https://docs.qualcomm.com/bundle/publicresource/topics/80-80020-27/qualcomm_linux_metadata_layers.html). Mapping access levels to firmware distributions | **Access level** | **Distribution** | Yocto layers | | --- | --- | --- | | Licensed developers with authorized access | BSP build: High-level OS and firmware source (GPS only)


`Qualcomm_Linux.SPF.2.0|AP|Standard|OEM|NoModem` | `meta-qcom`


`meta-qcom-distro`


`meta-qcom-extras` | | Licensed developers (contact Qualcomm for access) | BSP build: High-level OS and firmware (GPS only) source


`Qualcomm_Linux.SPF.2.0|AP|Standard|OEM|` | `meta-qcom`


`meta-qcom-distro`


`meta-qcom-extras` | | BSP build: High-level OS and firmware (GPS and modem) source



>
>
> `Qualcomm_Linux.SPF.2.0|AMSS|Standard|OEM|` | `meta-qcom`


`meta-qcom-distro`


`meta-qcom-extras` | The following table maps the firmware distributions to git repositories: Mapping firmware distributions to git repositories | Firmware distribution | Git command | Directory into which firmware gets synced on git clone | | --- | --- | --- | | Qualcomm\_Linux.SPF.2.0|AP|Standard|OEM|NoModem | `git clone -b --depth 1 https://qpm-git.qualcomm.com/home2/git/qualcomm/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem.git` | `qualcomm-linux-spf-2-0_ap_standard_oem_nomodem` | | Qualcomm\_Linux.SPF.2.0|AP|Standard|OEM| | `git clone -b --depth 1 https://qpm-git.qualcomm.com/home2/git/qualcomm/qualcomm-linux-spf-2-0_ap_standard_oem.git` | `qualcomm-linux-spf-2-0_ap_standard_oem` | | Qualcomm\_Linux.SPF.2.0|AMSS|Standard|OEM| | `git clone -b --depth 1 https://qpm-git.qualcomm.com/home2/git/qualcomm/qualcomm-linux-spf-2-0_amss_standard_oem.git` | `qualcomm-linux-spf-2-0_amss_standard_oem` | The **Git command** column (in the Mapping firmware distributions to git repositories table) provides information about the git repositories that contain the firmware sources. Qualcomm servers host these repositories. Clone the appropriate repositories based on your access profile and use case. The following `git clone` command downloads the selected firmware components in source, except the modem: mkdir -p cd git clone -b --depth 1 https://qpm-git.qualcomm.com/home2/git/qualcomm/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem.git # Example, is r2.0_00001.1 Copy to clipboard The `git clone` command clones the content into the `/qualcomm-linux-spf-2-0_ap_standard_oem_nm` directory. For the latest ``, see the section *Build-critical release tags* in the [Release Notes](https://docs.qualcomm.com/doc/80-80020-300/). ### Build firmware Prerequisites - Ensure that the working shell is `bash`. echo $0 Copy to clipboard The expected output of the command should be `bash`. If not, enter the bash shell: bash Copy to clipboard - Install the libffi6 package using the following commands. This is required for the QAIC compiler, which generates the header and the source files from the IDL files: curl -LO http://archive.ubuntu.com/ubuntu/pool/main/libf/libffi/libffi6_3.2.1-8_amd64.deb sudo dpkg -i libffi6_3.2.1-8_amd64.deb Copy to clipboard - Install LLVM for AOP, Qualcomm^®^ Trusted Execution Environment (TEE), and boot compilation: cd mkdir llvm # Sign in to qsc-cli and activate the license qsc-cli login qsc-cli tool activate-license --name sdllvm_arm # LLVM requirement for boot compilation is 14.0.4 qsc-cli tool install --name sdllvm_arm --required-version 14.0.4 --path /llvm/14.0.4 chmod -R 777 /llvm/14.0.4 # LLVM requirement for the Qualcomm TEE compilation is 16.0.7 qsc-cli tool install --name sdllvm_arm --required-version 16.0.7 --path /llvm/16.0.7 chmod -R 777 /llvm/16.0.7 Copy to clipboard - Export the `SECTOOLS` variable and compile the firmware builds (`/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem` is the top-level directory): export SECTOOLS=/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCM6490.LE.2.0/common/sectoolsv2/ext/Linux/sectools export SECTOOLS_DIR=/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCM6490.LE.2.0/common/sectoolsv2/ext/Linux Copy to clipboard - Install and set up Qualcomm^®^ Hexagon^™^ Processor. Set the environment variable HEXAGON\_ROOT to the path where the Hexagon SDK is installed. To change the install path when using `qsc-cli`, see Change the Hexagon tool install path. qsc-cli tool extract --name hexagon8.4 --required-version 8.4.07 qsc-cli tool extract --name hexagon8.4 --required-version 8.4.10 export HEXAGON_ROOT=$HOME/Qualcomm/HEXAGON_Tools echo $HEXAGON_ROOT Copy to clipboard Build cDSP **Tools required** - Compiler version: Hexagon 8.4.07 - Python version: Python 3.10.2 - libffi6 package **Build steps** 1. Go to the following directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/CDSP.HT.2.5.c3/cdsp_proc/build/ms Copy to clipboard 2. Clean the build: python ./build_variant.py kodiak.cdsp.prod --clean Copy to clipboard 3. Build the image: python ./build_variant.py kodiak.cdsp.prod Copy to clipboard Build aDSP **Tools required** - Compiler version: Hexagon 8.4.07 - Python version: Python 3.10.2 - libffi6 package **Build steps** 1. Nanopb integration (one-time setup): cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/qsh_api curl https://jpa.kapsi.fi/nanopb/download/nanopb-0.3.9.5-linux-x86.tar.gz -o nanopb-0.3.9.5-linux-x86.tar.gz cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/ python qsh_api/build/config_nanopb_dependency.py -f nanopb-0.3.9.5-linux-x86 Copy to clipboard 2. Go to the following directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/build/ms Copy to clipboard 3. Clean the build: python ./build_variant.py kodiak.adsp.prod --clean Copy to clipboard 4. Build the image: python ./build_variant.py kodiak.adsp.prod Copy to clipboard Build Boot **Tools required** - Compiler version: LLVM version must be updated to 14.0.4 export LLVM=/llvm/14.0.4/ Copy to clipboard - Python version: Python 3.10 - libffi6 package **Build steps** 1. Install the device tree compiler: sudo apt-get install device-tree-compiler export DTC=/usr/bin Copy to clipboard 2. Go to the following directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/BOOT.MXF.1.0.c1/ Copy to clipboard 3. Install the dependencies: python -m pip install -r boot_images/boot_tools/dtschema_tools/oss/requirements.txt pip install json-schema-for-humans Copy to clipboard 4. Clean the build: python -u boot_images/boot_tools/buildex.py -t kodiak,QcomToolsPkg -v LAA -r RELEASE --build_flags=cleanall Copy to clipboard 5. Build the image: python -u boot_images/boot_tools/buildex.py -t kodiak,QcomToolsPkg -v LAA -r RELEASE Copy to clipboard Note For debug variant builds, replace `RELEASE` with `DEBUG`. Build Qualcomm TEE firmware **Tools required** - Compiler version: LLVM 16.0.7 - Python version: Python 3.10 **Build steps** 1. Install LLVM: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/TZ.XF.5.29.1/trustzone_images/build/ms/ vi build_config_deploy_kodiak.xml # Edit all the occurrences of /pkg/qct/software/llvm/release/arm/16.0.7/ to /llvm/16.0.7/ Copy to clipboard 2. Clean the build: python build_all.py -b TZ.XF.5.0 CHIPSET=kodiak --cfg=build_config_deploy_kodiak.xml --clean Copy to clipboard 3. Build the image: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/TZ.XF.5.29.1/trustzone_images/build/ms/ python build_all.py -b TZ.XF.5.0 CHIPSET=kodiak --cfg=build_config_deploy_kodiak.xml Copy to clipboard Build AOP firmware **Tools required** - Compiler version: LLVM 14.0.4 - Python version: Python 3.10 **Build steps** 1. Go to the following directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/AOP.HO.3.6/aop_proc/build/ Copy to clipboard 2. Clean the build: ./build_kodiak.sh -c -l /llvm/14.0.4/ Copy to clipboard 3. Build the image: ./build_kodiak.sh -l /llvm/14.0.4/ Copy to clipboard Build MPSS Note This build is applicable only for `Qualcomm_Linux.SPF.2.0|AMSS|Standard|OEM|`. **Tools required** - Compiler version: Hexagon 8.4.10 - Python version: Python 3.8.2 **Build steps** 1. Nanopb integration (one-time setup): cd /qualcomm-linux-spf-2-0_amss_standard_oem/MPSS.HI.4.3.3.c6.2/modem_proc/ssc_api curl https://jpa.kapsi.fi/nanopb/download/nanopb-0.3.9.5-linux-x86.tar.gz -o nanopb-0.3.9.5-linux-x86.tar.gz cd /qualcomm-linux-spf-2-0_amss_standard_oem/MPSS.HI.4.3.3.c6.2/modem_proc python ssc_api/build/config_nanopb_dependency.py -f nanopb-0.3.9.5-linux-x86 Copy to clipboard 2. Go to the following directory: cd /qualcomm-linux-spf-2-0_amss_standard_oem/MPSS.HI.4.3.3.c6.2/modem_proc/build/ms Copy to clipboard 3. Clean the build: python build_variant.py kodiak.gen.prod --clean Copy to clipboard 4. Build the image: python build_variant.py kodiak.gen.prod bparams=-k Copy to clipboard CPUCP firmware Qualcomm releases the CPUCP firmware as a binary and you don’t need to compile the build. CPUSYS.VM firmware Qualcomm releases the CPUSYS.VM firmware as a binary and you don’t need to compile the build. BTFM firmware Qualcomm releases the BTFM firmware as a binary and you don’t need to compile the build. WLAN firmware Qualcomm releases the WLAN firmware as a binary and you don’t need to compile the build. Generate firmware prebuilds (boot-critical and split-firmware binaries) - Rename the Bluetooth^®^ firmware directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/ mv btfw.hsp BTFW.HSP.2.1.2 Copy to clipboard - Create an integrated firmware binary from the individual components that you compiled: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCM6490.LE.2.0/common/build python build.py --imf Copy to clipboard - Firmware prebuild is successful if the following zip files are generated in the `/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCM6490.LE.2.0/common/build/ufs/bin` directory: > > > - `QCM6490_bootbinaries.zip` > - `QCM6490_dspso.zip` > - `QCM6490_fw.zip` Prerequisites - Ensure that the working shell is `bash`. echo $0 Copy to clipboard The expected output of the command should be `bash`. If not, enter the bash shell: bash Copy to clipboard - Install the libffi6 package using the following commands. This is required for the QAIC compiler, which generates the header and the source files from the IDL files: curl -LO http://archive.ubuntu.com/ubuntu/pool/main/libf/libffi/libffi6_3.2.1-8_amd64.deb sudo dpkg -i libffi6_3.2.1-8_amd64.deb Copy to clipboard - Install LLVM for AOP, Qualcomm TEE, and boot compilation: cd mkdir llvm # Sign in to qsc-cli and activate the license qsc-cli login qsc-cli tool activate-license --name sdllvm_arm # LLVM requirement for boot compilation is 14.0.4 qsc-cli tool install --name sdllvm_arm --required-version 14.0.4 --path /llvm/14.0.4 chmod -R 777 /llvm/14.0.4 # LLVM requirement for the Qualcomm TEE compilation is 16.0.7 qsc-cli tool install --name sdllvm_arm --required-version 16.0.7 --path /llvm/16.0.7 chmod -R 777 /llvm/16.0.7 Copy to clipboard - Export the `SECTOOLS` variable and compile the firmware builds (`/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem` is the top-level directory): export SECTOOLS=/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCS9100.LE.2.0/common/sectoolsv2/ext/Linux/sectools export SECTOOLS_DIR=/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCS9100.LE.2.0/common/sectoolsv2/ext/Linux Copy to clipboard - Install and set up Hexagon. Set the environment variable HEXAGON\_ROOT to the path where the Hexagon SDK is installed. To change the install path when using `qsc-cli`, see Change the Hexagon tool install path. qsc-cli tool extract --name hexagon8.6 --required-version 8.6.05.2 export HEXAGON_ROOT=$HOME/Qualcomm/HEXAGON_Tools echo $HEXAGON_ROOT Copy to clipboard Build DSP **Tools required** - Compiler version: Hexagon 8.6.05.2 - Python version: Python 3.8.2 **Build steps** 1. Install the device tree compiler: sudo apt-get install device-tree-compiler export DTC_PATH=/usr/bin Copy to clipboard 2. Install the dependencies: pip install ruamel.yaml==0.17.17 pip install dtschema==2021.10 pip install jsonschema==4.0.0 Copy to clipboard 3. Go to the following directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/DSP.AT.1.0.1/dsp_proc/build/ms Copy to clipboard 4. Clean the build: python ./build_variant.py lemans.adsp.prod --clean python ./build_variant.py lemans.cdsp0.prod --clean python ./build_variant.py lemans.cdsp1.prod --clean python ./build_variant.py lemans.gpdsp0.prod --clean python ./build_variant.py lemans.gpdsp1.prod --clean Copy to clipboard 5. Build the image: python ./build_variant.py lemans.adsp.prod && python ./build_variant.py lemans.cdsp0.prod && python ./build_variant.py lemans.cdsp1.prod && python ./build_variant.py lemans.gpdsp0.prod && python ./build_variant.py lemans.gpdsp1.prod Copy to clipboard Build Boot **Tools required** - Compiler version: LLVM version must be updated to 14.0.4 export LLVM=/llvm/14.0.4/ Copy to clipboard - Python version: Python 3.10 - libffi6 package **Build steps** 1. Install the device tree compiler: sudo apt-get install device-tree-compiler export DTC=/usr/bin Copy to clipboard 2. Go to the following directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/BOOT.MXF.1.0.c1/ Copy to clipboard 3. Install the dependencies: python -m pip install -r boot_images/boot_tools/dtschema_tools/oss/requirements.txt pip install json-schema-for-humans Copy to clipboard 4. Clean the build: python -u boot_images/boot_tools/buildex.py -t lemans,QcomToolsPkg -v LAA -r RELEASE --build_flags=cleanall Copy to clipboard 5. Build the image: python -u boot_images/boot_tools/buildex.py -t lemans,QcomToolsPkg -v LAA -r RELEASE Copy to clipboard Note For debug variant builds, replace `RELEASE` with `DEBUG`. Build Qualcomm TEE firmware **Tools required** - Compiler version: LLVM 16.0.7 - Python version: Python 3.10 **Build steps** 1. Install LLVM: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/TZ.XF.5.29.1/trustzone_images/build/ms/ vi build_config_deploy_lemans.xml # Edit all the occurrences of /pkg/qct/software/llvm/release/arm/16.0.7/ to /llvm/16.0.7/ Copy to clipboard 2. Clean the build: python build_all.py -b TZ.XF.5.0 CHIPSET=lemans --cfg=build_config_deploy_lemans.xml --clean Copy to clipboard 3. Build the image: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/TZ.XF.5.29.1/trustzone_images/build/ms/ python build_all.py -b TZ.XF.5.0 CHIPSET=lemans --cfg=build_config_deploy_lemans.xml Copy to clipboard Build AOP firmware **Tools required** - Compiler version: LLVM 14.0.4 - Python version: Python 3.10 **Build steps** 1. Go to the following directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/AOP.HO.3.6.1/aop_proc/build/ Copy to clipboard 2. Clean the build: ./build_lemansau.sh -c -l /llvm/14.0.4/ Copy to clipboard 3. Build the image: ./build_lemansau.sh -l /llvm/14.0.4/ Copy to clipboard CPUCP firmware Qualcomm releases the CPUCP firmware as a binary and you don’t need to compile the build. CPUSYS.VM firmware Qualcomm releases the CPUSYS.VM firmware as a binary and you don’t need to compile the build. BTFM firmware Qualcomm releases the BTFM firmware as a binary and you don’t need to compile the build. WLAN firmware Qualcomm releases the WLAN firmware as a binary and you don’t need to compile the build. Generate firmware prebuilds (boot-critical and split-firmware binaries) - Rename the Bluetooth^®^ firmware directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/ mv btfw.hsp BTFW.HSP.2.1.2 Copy to clipboard - Create an integrated firmware binary from the individual components that you compiled: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCS9100.LE.2.0/common/build python build.py --imf Copy to clipboard - Firmware prebuild is successful if the following zip files are generated in the `/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCS9100.LE.2.0/common/build/ufs/bin` directory: > > > - `QCS9100_bootbinaries.zip` > - `QCS9100_dspso.zip` > - `QCS9100_fw.zip` Prerequisites - Ensure that the working shell is `bash`. echo $0 Copy to clipboard The expected output of the command should be `bash`. If not, enter the bash shell: bash Copy to clipboard - Install the libffi6 package using the following commands. This is required for the QAIC compiler, which generates the header and the source files from the IDL files: curl -LO http://archive.ubuntu.com/ubuntu/pool/main/libf/libffi/libffi6_3.2.1-8_amd64.deb sudo dpkg -i libffi6_3.2.1-8_amd64.deb Copy to clipboard - Install LLVM for AOP, Qualcomm TEE, and boot compilation: cd mkdir llvm # Sign in to qsc-cli and activate the license qsc-cli login qsc-cli tool activate-license --name sdllvm_arm # LLVM requirement for boot compilation is 14.0.4 qsc-cli tool install --name sdllvm_arm --required-version 14.0.4 --path /llvm/14.0.4 chmod -R 777 /llvm/14.0.4 # LLVM requirement for the Qualcomm TEE compilation is 16.0.7 qsc-cli tool install --name sdllvm_arm --required-version 16.0.7 --path /llvm/16.0.7 chmod -R 777 /llvm/16.0.7 Copy to clipboard - Export the `SECTOOLS` variable and compile the firmware builds (`/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem` is the top-level directory): export SECTOOLS=/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCS8300.LE.2.0/common/sectoolsv2/ext/Linux/sectools export SECTOOLS_DIR=/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCS8300.LE.2.0/common/sectoolsv2/ext/Linux Copy to clipboard - Install and set up Hexagon. Set the environment variable HEXAGON\_ROOT to the path where the Hexagon SDK is installed. To change the install path when using `qsc-cli`, see Change the Hexagon tool install path. .. container:: nohighlight > > > qsc-cli tool extract --name hexagon8.6 --required-version 8.6.05.2 > qsc-cli tool extract --name hexagon8.7 --required-version 8.7.02.1 > export HEXAGON_ROOT=$HOME/Qualcomm/HEXAGON_Tools > echo $HEXAGON_ROOT > Copy to clipboard Build DSP **Tools required** - Compiler version: Hexagon 8.6.05.2 and 8.7.02.1 - Python version: Python 3.8.2 **Build steps** 1. Install the device tree compiler: sudo apt-get install device-tree-compiler export DTC_PATH=/usr/bin Copy to clipboard 2. Install the dependencies: pip install ruamel.yaml==0.17.17 pip install dtschema==2021.10 pip install jsonschema==4.0.0 Copy to clipboard 3. Go to the following directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/DSP.AT.1.0.1/dsp_proc/build/ms Copy to clipboard 4. Clean the build: python ./build_variant.py lemans.adsp.prod --clean python ./build_variant.py monaco.cdsp0.prod --clean python ./build_variant.py lemans.gpdsp0.prod --clean Copy to clipboard 5. Build the image: python ./build_variant.py lemans.adsp.prod && python ./build_variant.py monaco.cdsp0.prod && python ./build_variant.py lemans.gpdsp0.prod Copy to clipboard Build Boot **Tools required** - Compiler version: LLVM version must be updated to 14.0.4 export LLVM=/llvm/14.0.4/ Copy to clipboard - Python version: Python 3.10 - libffi6 package **Build steps** 1. Install the device tree compiler: sudo apt-get install device-tree-compiler export DTC=/usr/bin Copy to clipboard 2. Go to the following directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/BOOT.MXF.1.0.c1/ Copy to clipboard 3. Install the dependencies: python -m pip install -r boot_images/boot_tools/dtschema_tools/oss/requirements.txt pip install json-schema-for-humans Copy to clipboard 4. Clean the build: python -u boot_images/boot_tools/buildex.py -t monaco,QcomToolsPkg -v LAA -r RELEASE --build_flags=cleanall Copy to clipboard 5. Build the image: python -u boot_images/boot_tools/buildex.py -t monaco,QcomToolsPkg -v LAA -r RELEASE Copy to clipboard Note For debug variant builds, replace `RELEASE` with `DEBUG`. Build Qualcomm TEE firmware **Tools required** - Compiler version: LLVM 16.0.7 - Python version: Python 3.10 **Build steps** 1. Install LLVM: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/TZ.XF.5.29.1/trustzone_images/build/ms/ vi build_config_deploy_monaco.xml # Edit all the occurrences of /pkg/qct/software/llvm/release/arm/16.0.7/ to /llvm/16.0.7/ Copy to clipboard 2. Clean the build: python build_all.py -b TZ.XF.5.0 CHIPSET=monaco --cfg=build_config_deploy_monaco.xml --clean Copy to clipboard 3. Build the image: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/TZ.XF.5.29.1/trustzone_images/build/ms/ python build_all.py -b TZ.XF.5.0 CHIPSET=monaco --cfg=build_config_deploy_monaco.xml Copy to clipboard Build AOP firmware **Tools required** - Compiler version: LLVM 14.0.4 - Python version: Python 3.10 **Build steps** 1. Go to the following directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/AOP.HO.3.6.1/aop_proc/build/ Copy to clipboard 2. Clean the build: ./build_monaco.sh -c -l /llvm/14.0.4/ Copy to clipboard 3. Build the image: ./build_monaco.sh -l /llvm/14.0.4/ Copy to clipboard CPUCP firmware Qualcomm releases the CPUCP firmware as a binary and you don’t need to compile the build. CPUSYS.VM firmware Qualcomm releases the CPUSYS.VM firmware as a binary and you don’t need to compile the build. BTFM firmware Qualcomm releases the BTFM firmware as a binary and you don’t need to compile the build. WLAN firmware Qualcomm releases the WLAN firmware as a binary and you don’t need to compile the build. Generate firmware prebuilds (boot-critical and split-firmware binaries) - Rename the Bluetooth^®^ firmware directory: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/ mv btfw.hsp BTFW.HSP.2.1.2 Copy to clipboard - Create an integrated firmware binary from the individual components that you compiled: cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCS8300.LE.2.0/common/build python build.py --imf Copy to clipboard - Firmware prebuild is successful if the following zip files are generated in the `/qualcomm-linux-spf-2-0_ap_standard_oem_nomodem/QCS8300.LE.2.0/common/build/ufs/bin` directory: - `QCS8300_bootbinaries.zip` - `QCS8300_dspso.zip` - `QCS8300_fw.zip` ### Build a BSP image The BSP image build has software components to support the Qualcomm device and software features applicable to the Qualcomm SoCs. This build includes a reference distribution configuration for the Qualcomm development kits. 1. Download Qualcomm Yocto and the supporting layers. For the `` tag information, see the section *Build-critical release tags* in the [Release Notes](https://docs.qualcomm.com/doc/80-80020-300/). cd /qualcomm-linux-spf-2-0_ap_standard_oem_nomodem # create directory where the BSP image will be built mkdir LE.QCLINUX.2.0 cd LE.QCLINUX.2.0 git clone https://github.com/qualcomm-linux/meta-qcom-releases -b kas checkout meta-qcom-releases/lock.yml Copy to clipboard 2. Copy the kas lock file from `meta-qcom-releases` to `meta-qcom`. You must run this step; otherwise, the checked‑out meta layers may update to a newer commit. # kas configuration files must be a part of the same repository # copy the kas lock file to meta-qcom repository cp meta-qcom-releases/lock.yml meta-qcom/ci/lock.yml Copy to clipboard 3. Set up local firmware binaries in your Yocto build. 4. Build the software image. Build targets are defined based on machine and distribution combinations: kas build meta-qcom/ci/:meta-qcom/ci/:meta-qcom/ci/linux-qcom-6.18.yml:meta-qcom/ci/lock.yml # Example, kas build meta-qcom/ci/qcs9100-ride-sx.yml:meta-qcom/ci/qcom-distro-prop-image.yml:meta-qcom/ci/linux-qcom-6.18.yml:meta-qcom/ci/lock.yml Copy to clipboard For various `` and `` combinations, see [Release Notes](https://docs.qualcomm.com/doc/80-80020-300/). Note To build images in a fully isolated environment, you can try using [kas-container](https://kas.readthedocs.io/en/latest/userguide/kas-container.html). 5. After a successful build, check if the `rootfs.img` file exists in the build artifacts: # meta-qcom uses qcomflash IMAGE_FSTYPE to create a single tarball # containing all the relevant files to perform a full clean flash, # including partition metadata, boot firmware, ESP partition, and rootfs. cd /build/tmp/deploy/images//-.rootfs.qcomflash/ ls -al rootfs.img Copy to clipboard 6. Flash the generated build using Flash software images. Note For repo manifest based builds, see Alternative build instructions using Manifest. ## Next steps - Connect to UART shell - Connect to network - Sign in using SSH - Troubleshoot sync, build, and flash issues Last Published: Mar 26, 2026 Previous Topic Build from source Next Topic Build with QSC CLI