# Build with GitHub

Use the detailed instructions to sync and build the Qualcomm Yocto and QIRP SDK layers using standalone commands or Dockerfile.

**Prerequisites:**

> 
> 
> Ensure that you have set up the host according to [Set up the host environment](https://docs.qualcomm.com/doc/80-70018-265/topic/setup-host-env.html#setup-host-env).

For QIRP SDK, you can use the following two methods to build:

- [Build with standalone commands](https://docs.qualcomm.com/doc/80-70018-265/topic/download-binaries.html#download-binaries)
- [Build with Dockerfile](https://docs.qualcomm.com/doc/80-70018-265/topic/compile_3_2_3.html#compile-3-2-3)

## Build with standalone commands

> 
> 
> Use standalone commands to download and build the QIRP SDK along with the robotics image. Supports manifest or `git clone` methods.
> 
> 
> **Steps:**
> 
> 1. Download the Qualcomm Yocto and QIRP SDK layers using either manifest or `git clone`.
> 
>     - **Download with manifest**: download the layers for the QIRP SDK by running the following commands.
> 
> 
> Note
> 
> 
> To get the latest `<robotics-release-manifest>`, see the [Qualcomm^®^ Linux Intelligent Robotics Product SDK (QIRP SDK) 2.0 Release Notes](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-260).
> 
> 
> cd <workspace>
>             repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linux-scarthgap -m <robotics-release-manifest>
>             repo sync -c -j8
>             Copy to clipboard
> 
> 
>         **Example:**
> 
> 
>         The following command downloads the release with manifest `qcom-6.6.65-QLI.1.4-Ver.1.1_robotics-product-sdk-1.1.xml`:
> 
> 
> repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linux-scarthgap -m qcom-6.6.65-QLI.1.4-Ver.1.1_robotics-product-sdk-1.1.xml
>             repo sync -c -j8
>             Copy to clipboard
>     - **Download with** `git clone`:
> 
>         1. Set up the host environment and sync the latest Yocto project BSP as described in the [Qualcomm Repo Manifest README file](https://github.com/quic-yocto/qcom-manifest/blob/qcom-linux-scarthgap/README.md).
>         2. Download the layers for the QIRP SDK based on the `<workspace>` directory of the downloaded Yocto project BSP.
> 
> 
> cd <workspace>
>                 git clone https://github.com/ros/meta-ros -b scarthgap layers/meta-ros && cd layers/meta-ros && git checkout c560699e810e60a9526f4226c2c23f8d877280c8 && cd ../../
>                 git clone https://github.com/quic-yocto/meta-qcom-robotics.git -b qcom-6.6.65-QLI.1.4-Ver.1.1_robotics-product-sdk-1.1 layers/meta-qcom-robotics
>                 git clone https://github.com/quic-yocto/meta-qcom-robotics-distro.git -b qcom-6.6.65-QLI.1.4-Ver.1.1_robotics-product-sdk-1.1 layers/meta-qcom-robotics-distro
>                 git clone https://github.com/quic-yocto/meta-qcom-robotics-sdk.git -b qcom-6.6.65-QLI.1.4-Ver.1.1_robotics-product-sdk-1.1 layers/meta-qcom-robotics-sdk
>                 git clone https://github.com/quic-yocto/meta-qcom-qim-product-sdk -b qcom-6.6.65-QLI.1.4-Ver.1.1_qim-product-sdk-1.1.2 layers/meta-qcom-qim-product-sdk
>                 Copy to clipboard
> 
> 
> 
> 
> > 
> > 
> > **Results:** The preceding commands download the following layers:
> > 
> > 
> > meta-qcom
> >             meta-qcom-hwe
> >             meta-qcom-distro
> >             meta-ros
> >             meta-qcom-robotics
> >             meta-qcom-robotics-distro
> >             meta-qcom-robotics-sdk
> >             meta-qcom-qim-product-sdk
> >             Copy to clipboard
> 2. Set up the build environment.
> 
> 
> Note
> 
> 
> If you are building the QIRP SDK on the Ubuntu Server VM of an Arm64 Mac, add the variable setting `SDKMACHINE=aarch64` in the following setup command.
> 
> 
> MACHINE=<Machine_name> DISTRO=<Distro_name>  SDKMACHINE=aarch64 QCOM_SELECTED_BSP=<Build_override> source setup-robotics-environment <Build_directory>
>         Copy to clipboard
> 
>     - If you use the **Download with manifest** method, run these commands:
> 
> 
> cd <workspace>
>             MACHINE=<Machine_name> DISTRO=<Distro_name>  QCOM_SELECTED_BSP=<Build_override> source setup-robotics-environment <Build_directory>
>             Copy to clipboard
>     - If you use the **Download with** `git clone` method, run these commands:
> 
> 
> cd <workspace>
>             ln -s layers/meta-qcom-robotics-distro/set_bb_env.sh ./setup-robotics-environment
>             ln -s layers/meta-qcom-robotics-sdk/scripts/qirp-build ./qirp-build
>             MACHINE=<Machine_name> DISTRO=<Distro_name>  QCOM_SELECTED_BSP=<Build_override> source setup-robotics-environment <Build_directory>
>             Copy to clipboard
> 
> 
> 
> 
> Table : Build parameters
> 
> 
>     | Parameter | RB3 Gen 2 Vision Kit | IQ-9075 Evaluation Kit | IQ-8 Beta Evaluation Kit |
>     | --- | --- | --- | --- |
>     | `Machine_name` | `qcs6490-rb3gen2-vision-kit` | `qcs9075-rb8-core-kit` | `qcs8300-ride-sx` |
>     | `Distro_name` | `qcom-robotics-ros2-jazzy` | `qcom-robotics-ros2-jazzy` | `qcom-robotics-ros2-jazzy` |
>     | `Build_override` | `custom` | <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">custom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">base</span></code></p></li><br></ul> | <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">custom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">base</span></code></p></li><br></ul> |
>     | `Build_directory` | `build-qcs6490-custom` | <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">build-qcs9075-custom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">build-qcs9075-base</span></code></p></li><br></ul> | <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">build-qcs8300-custom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">build-qcs8300-base</span></code></p></li><br></ul> |
> 
> 
> 
> Note
> 
> 
> For Qualcomm^®^ IQ-8 Beta Evaluation Kit and Qualcomm Dragonwing^TM^ IQ-9075 Evaluation Kit, the build command also supports `base` and `custom` *Build\_override* values. The default override is `custom` and you can override to `base` as needed. The following example sets the `base` build override for the machine `qcs9075-rb8-core-kit`:
> 
> 
> MACHINE=qcs9075-rb8-core-kit DISTRO=qcom-robotics-ros2-jazzy QCOM_SELECTED_BSP=base source setup-robotics-environment build-qcs9075-base
>         Copy to clipboard
> 3. Build the robotics image and QIRP SDK artifacts.
> 
> 
> ../qirp-build qcom-robotics-full-image
>         Copy to clipboard
> 
> 
>     **Results:**
> 
> 
> Tab RB3 Gen 2 Vision Development Kit
> Tab IQ-9075 Evaluation Kit
> Tab IQ-8 Beta Evaluation Kit
> 
> - QIRP SDK artifacts:
> 
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs6490-custom/tmp-glibc/deploy/qirpsdk_artifacts/qcs6490-rb3gen2-vision-kit/qirp-sdk_<version>.tar.gz
> >         Copy to clipboard
> 
> 
>     - Robotics image:
> 
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs6490-custom/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-robotics-full-image
> >         Copy to clipboard
> 
> > 
> > 
> > **Example using** `custom` **build override**
> 
> 
>     - QIRP SDK artifacts:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs9075-custom/tmp-glibc/deploy/qirpsdk_artifacts/qcs9075-rb8-core-kit/qirp-sdk_<version>.tar.gz
> >             Copy to clipboard
>     - Robotics image:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs9075-custom/tmp-glibc/deploy/images/qcs9075-rb8-core-kit/qcom-robotics-full-image
> >             Copy to clipboard
> 
> 
> 
> 
> > 
> > 
> > **Example using** `base` **build override**
> 
> 
>     - QIRP SDK artifacts:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs9075-base/tmp-glibc/deploy/qirpsdk_artifacts/qcs9075-rb8-core-kit/qirp-sdk_<version>.tar.gz
> >             Copy to clipboard
>     - Robotics image:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs9075-base/tmp-glibc/deploy/images/qcs9075-rb8-core-kit/qcom-robotics-full-image
> >             Copy to clipboard
> 
> **Example using** `custom` **build override**
> 
>     - QIRP SDK artifacts:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs8300-custom/tmp-glibc/deploy/qirpsdk_artifacts/qcs8300-ride-sx/qirp-sdk_<version>.tar.gz
> >             Copy to clipboard
>     - Robotics image:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs8300-custom/tmp-glibc/deploy/images/qcs8300-ride-sx/qcom-robotics-full-image
> >             Copy to clipboard
> 
> 
> 
> **Example using** `base` **build override**
> 
>     - QIRP SDK artifacts:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs8300-base/tmp-glibc/deploy/qirpsdk_artifacts/qcs8300-ride-sx/qirp-sdk_<version>.tar.gz
> >             Copy to clipboard
>     - Robotics image:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs8300-base/tmp-glibc/deploy/images/qcs8300-ride-sx/qcom-robotics-full-image
> >             Copy to clipboard

## Build with Dockerfile

> 
> 
> Build the QIRP SDK along with the robotic image using the Dockerfile, building upon the Qualcomm Linux image.
> 
> 
> **Steps:**
> 
> 1. Build the Qualcomm Linux image with the steps under [Build with Dockerfile](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/build_from_source_github_intro.html#build-with-dockerfile).
> 
>     1. Follow [Ubuntu host setup](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/build_from_source_github_intro.html#ubuntu-host-setup-2) and [check the host computer configuration](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/build_from_source_github_intro.html#host-computer-requirements).
>     2. Follow the steps in [Build BSP image](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/build_from_source_github_intro.html#build-bsp-image-2).
> 2. Run the `docker run` command.
> 
> 
> Note
> 
> 
> Run the following commands inside the Qualcomm Linux build location.
> 
> 
> cd <workspace_path>/qcom-download-utils/qcom-6.6.65-QLI.1.4-Ver.1.1
>         bash
>         docker run -it -v "${HOME}/.gitconfig":"/home/${USER}/.gitconfig" -v "${HOME}/.netrc":"/home/${USER}/.netrc" -v $(pwd):$(pwd) -w $(pwd) qcom-6.6.65-qli.1.4-ver.1.0_22.04 /bin/bash
>         Copy to clipboard
> 3. Download the layers for the QIRP SDK based on the `<workspace>` directory.
> 
> 
> git clone https://github.com/ros/meta-ros -b scarthgap layers/meta-ros && cd layers/meta-ros && git checkout c560699e810e60a9526f4226c2c23f8d877280c8 && cd ../../
>         git clone https://github.com/quic-yocto/meta-qcom-robotics.git -b qcom-6.6.65-QLI.1.4-Ver.1.1_robotics-product-sdk-1.1 layers/meta-qcom-robotics
>         git clone https://github.com/quic-yocto/meta-qcom-robotics-distro.git -b qcom-6.6.65-QLI.1.4-Ver.1.1_robotics-product-sdk-1.1 layers/meta-qcom-robotics-distro
>         git clone https://github.com/quic-yocto/meta-qcom-robotics-sdk.git -b qcom-6.6.65-QLI.1.4-Ver.1.1_robotics-product-sdk-1.1 layers/meta-qcom-robotics-sdk
>         git clone https://github.com/quic-yocto/meta-qcom-qim-product-sdk -b qcom-6.6.65-QLI.1.4-Ver.1.1_qim-product-sdk-1.1.2 layers/meta-qcom-qim-product-sdk
>         Copy to clipboard
> 4. Set up the build environment.
> 
> 
> Note
> 
> 
> If you are building the QIRP SDK on the Ubuntu Server VM of an Arm64 Mac, add the variable setting `SDKMACHINE=aarch64` in the following setup command.
> 
> 
> MACHINE=<Machine_name> DISTRO=<Distro_name>  SDKMACHINE=aarch64 QCOM_SELECTED_BSP=<Build_override> source setup-robotics-environment <Build_directory>
>         Copy to clipboard
> 
> 
> ln -s layers/meta-qcom-robotics-distro/set_bb_env.sh ./setup-robotics-environment
>         ln -s layers/meta-qcom-robotics-sdk/scripts/qirp-build ./qirp-build
>         MACHINE=<Machine_name> DISTRO=<Distro_name>  QCOM_SELECTED_BSP=<Build_override> source setup-robotics-environment <Build_directory>
>         Copy to clipboard
> 
> 
> 
> Table : Build parameters
> 
> 
>     | Parameter | RB3 Gen 2 Vision Kit | IQ-9075 Evaluation Kit | IQ-8 Beta Evaluation Kit |
>     | --- | --- | --- | --- |
>     | `Machine_name` | `qcs6490-rb3gen2-vision-kit` | `qcs9075-rb8-core-kit` | `qcs8300-ride-sx` |
>     | `Distro_name` | `qcom-robotics-ros2-jazzy` | `qcom-robotics-ros2-jazzy` | `qcom-robotics-ros2-jazzy` |
>     | `Build_override` | `custom` | <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">custom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">base</span></code></p></li><br></ul> | <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">custom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">base</span></code></p></li><br></ul> |
>     | `Build_directory` | `build-qcs6490-custom` | <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">build-qcs9075-custom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">build-qcs9075-base</span></code></p></li><br></ul> | <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">build-qcs8300-custom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">build-qcs8300-base</span></code></p></li><br></ul> |
> 5. Build the robotics image and QIRP SDK artifacts.
> 
> 
> ../qirp-build qcom-robotics-full-image
>         Copy to clipboard
> 
> 
>     **Results:**
> 
> 
> Tab RB3 Gen 2 Vision Development Kit
> Tab IQ-9075 Evaluation Kit
> Tab IQ-8 Beta Evaluation Kit
> 
> - QIRP SDK artifacts:
> 
> 
> <workspace>/qcom-download-utils/qcom-6.6.65-QLI.1.4-Ver.1.1/build-qcs6490-custom/tmp-glibc/deploy/qirpsdk_artifacts/qcs6490-rb3gen2-vision-kit/qirp-sdk_<version>.tar.gz
>             Copy to clipboard
>     - Robotics image:
> 
> 
> <workspace>/qcom-download-utils/qcom-6.6.65-QLI.1.4-Ver.1.1/build-qcs6490-custom/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-robotics-full-image
>             Copy to clipboard
> 
> **Example using** `custom` **build override**
> 
>     - QIRP SDK artifacts:
> 
> 
> 
> > 
> > 
> > <workspace>/qcom-download-utils/qcom-6.6.65-QLI.1.4-Ver.1.1/build-qcs9075-custom/tmp-glibc/deploy/qirpsdk_artifacts/qcs9075-rb8-core-kit/qirp-sdk_<version>.tar.gz
> >             Copy to clipboard
>     - Robotics image:
> 
> 
> 
> > 
> > 
> > <workspace>/qcom-download-utils/qcom-6.6.65-QLI.1.4-Ver.1.1/build-qcs9075-custom/tmp-glibc/deploy/images/qcs9075-rb8-core-kit/qcom-robotics-full-image
> >             Copy to clipboard
> 
> 
> 
> **Example using** `base` **build override**
> 
>     - QIRP SDK artifacts:
> 
> 
> <workspace>/qcom-download-utils/qcom-6.6.65-QLI.1.4-Ver.1.1/build-qcs9075-base/tmp-glibc/deploy/qirpsdk_artifacts/qcs9075-rb8-core-kit/qirp-sdk_<version>.tar.gz
>             Copy to clipboard
>     - Robotics image:
> 
> 
> <workspace>/qcom-download-utils/qcom-6.6.65-QLI.1.4-Ver.1.1/build-qcs9075-base/tmp-glibc/deploy/images/qcs9075-rb8-core-kit/qcom-robotics-full-image
>             Copy to clipboard
> 
> **Example using** `custom` **build override**
> 
>     - QIRP SDK artifacts:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs8300-custom/tmp-glibc/deploy/qirpsdk_artifacts/qcs8300-ride-sx/qirp-sdk_<version>.tar.gz
> >             Copy to clipboard
>     - Robotics image:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs8300-custom/tmp-glibc/deploy/images/qcs8300-ride-sx/qcom-robotics-full-image
> >             Copy to clipboard
> 
> 
> 
> **Example using** `base` **build override**
> 
>     - QIRP SDK artifacts:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs8300-base/tmp-glibc/deploy/qirpsdk_artifacts/qcs8300-ride-sx/qirp-sdk_<version>.tar.gz
> >             Copy to clipboard
>     - Robotics image:
> 
> 
> 
> > 
> > 
> > <workspace>/build-qcs8300-base/tmp-glibc/deploy/images/qcs8300-ride-sx/qcom-robotics-full-image
> >             Copy to clipboard

## Flash the QIRP to devices

Flash the robotics image to the device, and install the QIRP SDK.

- To flash the robotics image to the device, see [Flash software images](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/flash_images.html).
- To install the QIRP SDK on the device, see [Install the QIRP SDK on the device](https://docs.qualcomm.com/doc/80-70018-265/topic/flash-and-install_4_3.html#install-qirp-sdk).

Last Published: Apr 29, 2025

[Previous Topic
Build with QSC-CLI](https://docs.qualcomm.com/bundle/publicresource/80-70018-265/topics/build-with-qsc-cli_3_1.md) [Next Topic
Build with GitHub (firmware and extras)](https://docs.qualcomm.com/bundle/publicresource/80-70018-265/topics/using-detailed-instructions_3_2.md)