Revision as of 03:35, 28 November 2025

Introduction

This document describes how to work with the RISC and Qualcomm LE GA1.1 Board Support Package (BSP) release.

Yocto Version

Yocto 4.0.18

Kernel Version

Kernel 6.6.28

Meta Build ID

QCM6490.LE.1.0-00218-STD.PROD-1

Host machine requirements

OS

Ubuntu 20.04 or Ubuntu 22.04

CPU

Intel Core-i7 Processor (>= 8 cores)

RAM

16+ GB RAM

Disk

350 GB free disk space (more is recommended and SSD is suggested for better performance)

Docker Install and BSP Download

Install Docker Engine on your platform

Please refer to Docker Installation Guide for details

Pull docker images

$ sudo docker pull advrisc/u20.04-qcslbv2:latest

Run docker example

$ mkdir -p /home/bsp/myLinux
$ sudo docker run --privileged -it --name qclinux -v /home/bsp/myLinux:/home/adv/BSP:rw advrisc/u20.04-qcslbv2 /bin/bash
adv@7cc0fa834366:~$ sudo chown adv:adv -R BSP

Download BSP

You need to get the ADV_GIT_TOKEN by contacting the PM or AE of MIO-5355.

$ cd /home/adv/BSP
$ git config --global credential.helper 'store --file ~/.my-credentials'
$ echo "https://AIM-Linux:${ADV_GIT_TOKEN}@dev.azure.com" > ~/.my-credentials

Refer to Release image URL: OS Support List(LE1.1 based on Yocto4.0.18) , Official version "mio5355a1_yl01101_k0606028_q6490_08g.xml" is taken as an example :

$ repo init -u https://dev.azure.com/AIM-Linux/risc_qcs_linux_le_1.1/_git/manifest -b main -m mio5355a1_yl01101_k0606028_q6490_08g.xml
$ repo sync -c -j${YOUR_CPU_CORE_NUM}
$ cp layers/meta-advantech/conf/machine/qcm6490.conf layers/meta-qcom-hwe/conf/machine/qcm6490.conf
$ cp layers/meta-advantech/recipes-sdk/files/content_config.json layers/meta-qcom-robotics-sdk/recipes-sdk/files/content_config.json
$ cp layers/meta-advantech/recipes-core/base-files/base-files/fstab layers/poky/meta/recipes-core/base-files/base-files/fstab

If you want to get latest bsp

$ repo init -u https://dev.azure.com/AIM-Linux/risc_qcs_linux_le_1.1/_git/manifest -b main -m adv-6.6.28-QLI.1.1-Ver.1.1_robotics-product-sdk-1.1.xml
$ repo sync -c -j${YOUR_CPU_CORE_NUM}
$ cp layers/meta-advantech/conf/machine/qcm6490.conf layers/meta-qcom-hwe/conf/machine/qcm6490.conf
$ cp layers/meta-advantech/recipes-sdk/files/content_config.json layers/meta-qcom-robotics-sdk/recipes-sdk/files/content_config.json
$ cp layers/meta-advantech/recipes-core/base-files/base-files/fstab layers/poky/meta/recipes-core/base-files/base-files/fstab

You can check the download BSP as the following.

Get and Unzip the Downloads Files

1. Private Yocto downloads file (Must to do) : [ downloads_qcs6490_le1.1_private.tar.gz ]

The size of downloads_qcs6490_le1.1_private.tar.gz is 277854168 byte (271,342 KB)

The md5sum of downloads_qcs6490_le1.1_private.tar.gz is 57692f7262a68b21a5885e8d72299d78

You need to get the PASSWORD by contacting the PM or AE of project.

$ cd /home/adv/BSP
$ openssl des3 -d -k ${PASSWORD} -salt -pbkdf2 -in downloads_qcs6490_le1.1_private.tar.gz -out downloads_qcs6490_le1.1_private_decrypt.tar.gz
$ tar -zxvf downloads_qcs6490_le1.1_private_decrypt.tar.gz

2. Public Yocto downloads file: [ downloads_qcs6490_le1.1_public.tar.gz ]

The size of downloads_qcs6490_le1.1_public.tar.gz is 31810989229 byte (31,065,420 KB)

The md5sum of downloads_qcs6490_le1.1_public.tar.gz is 870323bca740ca9af5322c6553a749ac

$ cd /home/adv/BSP
$ tar -zxvf downloads_qcs6490_le1.1_public.tar.gz

Build Instructions

Source env

For the "Build All images", "Build All Images individually" and "Build yocto images", you need to do the "Source env".

$ source scripts/env.sh

Build All Images

$ scripts/build_release.sh -all

Output ufs images: build-qcom-robotics-ros2-humble/tmp-glibc/deploy/images/qcm6490/qcom-robotics-full-image
Output emmc images: build-qcom-robotics-ros2-humble/tmp-glibc/deploy/images/qcm6490/qcom-robotics-full-image-emmc

Build All Images individually

1. Build ADSP Image

After building the ADSP, you need to build the "6. Generate Firmware Prebuilds" to package new firmware prebuild files.

$ scripts/build_release.sh -adsp

2. Build AOP Image

After building the AOP, you need to build the "6. Generate Firmware Prebuilds" to package new firmware prebuild files.

$ scripts/build_release.sh -aop

3. Build CDSP Image

After building the CDSP, you need to build the "6. Generate Firmware Prebuilds" to package new firmware prebuild files.

$ scripts/build_release.sh -cdsp

4. Build BOOT(XBL) Image

After building the BOOT(XBL), you need to build the "6. Generate Firmware Prebuilds" to package new firmware prebuild files.

$ scripts/build_release.sh -boot

5. Build TZ Image

After building the TZ, you need to build the "6. Generate Firmware Prebuilds" to package new firmware prebuild files.

$ scripts/build_release.sh -tz

6. Generate Firmware Prebuilds

$ scripts/build_release.sh -common

Output firmware prebuild files:

amss/QCM6490.LE.1.0/common/build/ufs/bin/QCM6490_bootbinaries.zip

amss/QCM6490.LE.1.0/common/build/ufs/bin/QCM6490_dspso.zip

amss/QCM6490.LE.1.0/common/build/ufs/bin/QCM6490_fw.zip

7. Build YOCTO Image

$ scripts/build_release.sh -yocto

Build yocto images

$ cd /home/adv/BSP
$ source scripts/env.sh
$ MACHINE=qcm6490 DISTRO=qcom-robotics-ros2-humble source setup-robotics-environment
$ ../qirp-build qcom-robotics-full-image

For the qcsLBV11026 version:

$ cd /home/adv/BSP
$ source scripts/env.sh
$ MACHINE=qcm6490 DISTRO=qcom-wayland source setup-environment
$ devtool modify qps615
$ bitbake qcom-multimedia-image

Difference between revisions of "AIM-Linux/BSP/Qualcomm/RISC QCS Yocto LE1.1 MIO-5355"