View source for AIM-Linux/BSP/Qualcomm/RISC QCS Yocto LE1.1 ROM2860


= 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

= Docker Install and BSP Download =

== Pull docker images ==
<pre>$ sudo docker pull advrisc/u20.04-qcslbv2:latest</pre>

== Run docker example ==
<pre>$ 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</pre>

== Download BSP ==

<span style="color:#cc0000;">'''You need to get the ADV_GIT_TOKEN by contacting the PM or AE of ROM-2860.'''</span>
<pre>$ 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
$ 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 -j12</pre>

== Get and Unzip the Download Files ==

LIV11 yocto downloads file:[https://www.dropbox.com/scl/fo/tptbp080ohgckjdbr3vrq/ANzxY7ble5Crf5iY3OBFgpo/officialbuild/risc_qcs_linux_yocto_00041.0?dl=0&preview=downloads.qcs6490.le.1.1.r00041.0.tar.gz&rlkey=647rksjn60zyqj4i134tflsuj&subfolder_nav_tracking=1 [ downloads.qcs6490.le.1.1.r00041.0.tar ]]
<pre>$ cd /home/adv/BSP
$ tar -zxvf downloads.qcs6490.le.1.1.r00041.0.tar </pre>

= Build Instructions =

== Source env ==
<pre>$ source scripts/env.sh</pre>


== Build All Images ==
<pre>$ scripts/build_release.sh -all</pre>

*'''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''' 

&nbsp;

== Build All Images individually ==

==== 1. Build ADSP Image ====
<pre>$ scripts/build_release.sh -adsp</pre>

==== 2. Build AOP Image ====
<pre>$ scripts/build_release.sh -aop</pre>

==== 3. Build CDSP Image ====
<pre>$ scripts/build_release.sh -cdsp</pre>

==== 4. Build BOOT(XBL) Image ====
<pre>$ scripts/build_release.sh -boot</pre>

==== 5. Build TZ Image ====
<pre>$ scripts/build_release.sh -tz</pre>

==== 6. Generate Firmware Prebuilds ====
<pre>$ scripts/build_release.sh -common</pre>

==== 7. Build YOCTO Image ====
<pre>$ scripts/build_release.sh -yocto</pre>

== Build yocto images ==
<pre>$ cd /home/adv/BSP
$ MACHINE=qcm6490 DISTRO=qcom-robotics-ros2-humble source setup-robotics-environment
$ devtool modify qps615
$ ../qirp-build qcom-robotics-full-image</pre>

= Recovery & Rescue =
Using windows PCAT or Qualcomm Download (QDL) tool to flash software images to the device.


== Emergency download (EDL) mode ==

Connect the Micro USB (EDL) to your linux host computer.

&nbsp;

== Windows PCAT Tool ==

=== Install the QPST_QFIL and Qualcomm_USB_Driver ===

Download and install the following files on the Windows OS (Windows 10 Test OK):

*QPST_QFIL: qpst.win.2.7_installer_00496.2.zip 
*Qualcomm_USB_Driver: QUD.WIN.1.1 Installer_10065.1.zip 

Note: If you can't get these files, please contact PM or AE to get these files.

=== Get the official images and unzip ===

Release image URL: [[AIM-Linux/BSP/Qualcomm/Linux_Ubuntu_OS_Release_note/Ubuntu20/Internal|OS Support List (based on Ubuntu 20.04 - LU 1.0)]]

Unzip command example:
<pre>$ sudo tar -zxvf 2860A1AIM37UIV10059_emmc_2024-03-14.tgz</pre>

=== Enter 9008 download mode ===

*Connect the&nbsp;'''Micro USB (EDL)'''&nbsp;to your host computer. 
*'''Forced Recovery''': The SW2 switch to 1-on. 
*'''Flash EMMC''': the SW1 switch to 1-off, 2-on 
*'''Flash UFS''': the SW1 switch to 1-on, 2-on 
*Connect the adapter and power on the device 

=== Use the QFIL to flash image ===

==== EMMC ====

*Open QFIL tool and click the&nbsp;'''"Select Port"''' 

[[File:Qfil flash image 1 1713161681873.png|800px|Qfil flash image 1 1713161681873.png]]

&nbsp;

*Select the&nbsp;'''"Qualcomm HS-USB QDloader 9008"''' 

[[File:Qfil flash image 2 1713161718506.png|800px|Qfil flash image 2 1713161718506.png]]

&nbsp;

*1.Click the&nbsp;'''"Configuration"''' 
*2.Click the&nbsp;'''"FireHose Configuration"''' 

[[File:Qfil flash image 3 1713161738991.png|800px|Qfil flash image 3 1713161738991.png]]

&nbsp;

*1.Select the "Device Type" to&nbsp;'''"emmc"''' 
*2.Select the&nbsp;'''"Reset After Download"''' 
*3.Select the&nbsp;'''"Erase All Before Download"''' 

[[File:Qfil flash image 4 1713161932766.png|800px|Qfil flash image 4 1713161932766.png]]

&nbsp;

*1.Select the "Availible Meta Build Storage Types" to&nbsp;'''"emmc"''' 
*2.Select the "Select Build Type" to&nbsp;'''"Meta Build"''' 
*3.Click the&nbsp;'''"Load Content"'''&nbsp;and Select the contents.xml file of&nbsp;'''emmc''' 
*4.Click the&nbsp;'''"Download Content"''' 

[[File:Qfil flash image 5 1713161947957.png|800px|Qfil flash image 5 1713161947957.png]]

&nbsp;

*Finish Download 
*You can power off the device and power on it again 

[[File:Qfil flash image 7 1713161996595.png|800px|Qfil flash image 7 1713161996595.png]]

&nbsp;

==== UFS ====

Need to do the&nbsp;'''Provision'''&nbsp;when using it for the first time

*Open QFIL tool and click the&nbsp;'''"Select Port"''' 

[[File:Qfil flash image 1 1713161681873.png|800px|Qfil flash image 1 1713161681873.png]]

&nbsp;

*Select the&nbsp;'''"Qualcomm HS-USB QDloader 9008"''' 

[[File:Qfil flash image 2 1713161718506.png|800px|Qfil flash image 2 1713161718506.png]]

&nbsp;

*1.Click the&nbsp;'''"Configuration"''' 
*2.Click the&nbsp;'''"FireHose Configuration"''' 

[[File:Qfil flash image 3 1713161738991.png|800px|Qfil flash image 3 1713161738991.png]]

&nbsp;

*1.Select the "Device Type" to&nbsp;'''"ufs"''' 
*2.Select the&nbsp;'''"Provision"''' 

[[File:Qfil flash image 8 1713163252331.png|800px|Qfil flash image 8 1713163252331.png]]

&nbsp;

*1.Select the&nbsp;'''"provision_ufs31.xml"'''&nbsp;file 
*2.Select the&nbsp;'''"prog_firehose_ddr.elf"'''&nbsp;programmer file 
*3.Click the&nbsp;'''"Provision"''' 

[[File:Qfil flash image 9 1713163470993.png|800px|Qfil flash image 9 1713163470993.png]]

&nbsp;

*Finish Provision 
*You can power off the device and power on it again 

[[File:Qfil flash image 10 1713163492158.png|800px|Qfil flash image 10 1713163492158.png]]

&nbsp;

*1.Click the&nbsp;'''"Configuration"''' 
*2.Click the&nbsp;'''"FireHose Configuration"''' 

[[File:Qfil flash image 3 1713161738991.png|800px|Qfil flash image 3 1713161738991.png]]

&nbsp;

*1.Deselected the&nbsp;'''"Provision"''' 
*2.Select the&nbsp;'''"Reset After Download"''' 
*3.Select the&nbsp;'''"Erase All Before Download"''' 

[[File:Qfil flash image 11 1713163505186.png|800px|Qfil flash image 11 1713163505186.png]]

&nbsp;

*1.Select the "Availible Meta Build Storage Types" to&nbsp;'''"ufs"''' 
*2.Select the "Select Build Type" to&nbsp;'''"Meta Build"''' 
*3.Click the&nbsp;'''"Load Content"'''&nbsp;and Select the contents.xml file of&nbsp;'''ufs''' 
*4.Click the&nbsp;'''"Download Content"''' 

[[File:Qfil flash image 12 1713163517837.png|800px|Qfil flash image 12 1713163517837.png]]

&nbsp;

*Finish Download 
*You can power off the device and power on it again 

[[File:Qfil flash image 13 1713164712430.png|800px|Qfil flash image 13 1713164712430.png]]

&nbsp;

&nbsp;

== Fastboot ==

*Micro USB: ROM-ED92 USB0 

Connect&nbsp;the ROM-ED92 USB0 to host computer and set the Micro USB to&nbsp;'''peripheral'''&nbsp;mode.
<pre># echo "peripheral" > /sys/devices/platform/soc/a600000.ssusb/mode</pre>

=== Enter the fastboot mode ===
<pre>adv@adv-desktop:~$ adb devices
List of devices attached
2e8c656e        device

adv@adv-desktop:~$ adb root
restarting adbd as root

adv@adv-desktop:~$ adb reboot bootloader

adv@adv-desktop:~$ fastboot devices
2e8c656e        fastboot</pre>

=== Use the fastboot to flash the kernel boot image ===
<pre>adv@adv-desktop:~$ fastboot flash boot_a qti-ubuntu-robotics-image-qcs6490-odk-boot.img
target reported max download size of 805306368 bytes
sending 'boot_a' (24420 KB)...
OKAY [  0.790s]
writing 'boot_a'...
OKAY [  0.144s]
finished. total time: 0.935s

adv@adv-desktop:~$ fastboot flash boot_b qti-ubuntu-robotics-image-qcs6490-odk-boot.img
target reported max download size of 805306368 bytes
sending 'boot_b' (24420 KB)...
OKAY [  0.827s]
writing 'boot_b'...
OKAY [  0.133s]
finished. total time: 0.960s</pre>

=== Use the fastboot to flash the kernel dtbo image ===
<pre>adv@adv-desktop4:~$ fastboot flash dtbo_a dtbo.img
target reported max download size of 805306368 bytes
sending 'dtbo_a' (12330 KB)...
OKAY [  0.427s]
writing 'dtbo_a'...
OKAY [  0.070s]
finished. total time: 0.497s

adv@adv-desktop4:~$ fastboot flash dtbo_b dtbo.img
target reported max download size of 805306368 bytes
sending 'dtbo_b' (12330 KB)...
OKAY [  0.422s]
writing 'dtbo_b'...
OKAY [  0.061s]
finished. total time: 0.483s</pre>