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

== 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.

== Get the official images and unzip ==

Release image URL: [[AIM-Linux/BSP/Qualcomm/Linux_Yocto_OS_Release_note/LE1.1/Internal|OS Support List(LE1.1 based on Yocto4.0)]]

Unzip command example:
<pre>$ sudo tar -zxvf 2860A1AIM38LIV11030_emmc_2024-11-18.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 windows PCAT to flash images ==

'''1. Download the Qualcomm Software Center&nbsp;'''

'''&nbsp; &nbsp; &nbsp; [https://softwarecenter.qualcomm.com/#/ <span lang="EN-US" style="font-family:Aptos">Qualcomm® Software Center</span>]&nbsp;'''

'''2. Open the&nbsp;Qualcomm Software Center&nbsp;'''

'''3. Search "PCAT" in the search bar&nbsp;'''

'''[[File:ROM-2860 search bar.PNG|RTENOTITLE]]'''

'''4. Click&nbsp;Qualcomm® Product Configuration Assistant Tool&nbsp;'''

'''5. Select Qualcomm® Product Configuration Assistant Tool version&nbsp;'''

'''&nbsp; &nbsp; Version: 2.33.2.119'''

'''[[File:ROM-2860 PCAT Tool version.PNG|RTENOTITLE]]'''

'''6. Install&nbsp;Qualcomm® Product Configuration Assistant Tool 2.33.2.119&nbsp;'''

'''7.&nbsp;Search "QUTS" in the search bar&nbsp;&nbsp;'''

'''[[File:ROM-2860 QUTS Tool.PNG|RTENOTITLE]]'''

'''8. Click the&nbsp;&nbsp;Qualcomm® Unified Tools Services&nbsp;'''

'''9. Select&nbsp;Qualcomm® Unified Tools Services version&nbsp;'''

'''&nbsp; &nbsp; &nbsp;Version&nbsp;: 1.75.2.9'''

'''10. Install&nbsp;Qualcomm® Unified Tools Services&nbsp; 1.75.2.9&nbsp;'''

'''[[File:ROM-2860 QUTS Tool version.PNG|RTENOTITLE]]'''

'''11. You will find the new application in your Windows system .&nbsp;'''

'''[[File:ROM-2860 new tools in windows.PNG|RTENOTITLE]]'''

'''12. Unzip the UFS File and eMMC File&nbsp;'''

'''For example&nbsp;:&nbsp;'''

'''&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;2860A1AIM37UIV10084_2024-08-08_ufs_debug.tgz'''

'''&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;2860A1AIM37UIV10084_2024-08-08_emmc_debug.tgz&nbsp;'''

'''13&nbsp;Connect your device via Micro USB.'''

=== '''<u>USF Provision</u>&nbsp;&nbsp;''' ===

'''1. Select&nbsp; provision button&nbsp;&nbsp;&nbsp;[[File:ROM-2860 provision file button.PNG|RTENOTITLE]]&nbsp;&nbsp;'''

[[File:ROM-2860 provision file icon.PNG|RTENOTITLE]]

'''2. Add the&nbsp;prog_firehose_ddr.elf and&nbsp;provision_ufs31.xml in UFS&nbsp;&nbsp;folder.&nbsp;'''

[[File:ROM-2860 provision file.PNG|RTENOTITLE]]

'''3. Then press "OK" , it will start to do USF Provision.&nbsp;'''

[[File:ROM-2860 provision file running.PNG|RTENOTITLE]]

'''4. When the Provision finished , you can see the result in message window.&nbsp;'''

[[File:ROM-2860 provision file result.PNG|RTENOTITLE]]


=== '''<u>Flash UFS</u>''' ===

'''&nbsp;<span style="background-color:#ffff00;">1. Change the SW1 and SW2&nbsp;</span>'''

'''<span style="background-color:#ffff00;">&nbsp;Flash UFS:&nbsp; the SW1 switch to 1-on, 2-on</span>'''

'''<span style="background-color:#ffff00;">Forced Recovery&nbsp;:&nbsp;&nbsp;The SW2 switch to 1-on&nbsp; ,2 - on .&nbsp;</span>'''

'''&nbsp;2. Turn on the power&nbsp;'''

'''&nbsp;3. Open " PCATApp" Tool&nbsp;'''

'''&nbsp;4. Click " Connect A Device"&nbsp;'''

[[File:ROM-2860 PCAT UFS .PNG|RTENOTITLE]]

'''5. Select&nbsp; "Qualcomm HS-USB QDLoader 9008 (COM6)&nbsp;'''

[[File:ROM-2860 PCAT Tool Select device.PNG|RTENOTITLE]]

'''6. Click " Connect "&nbsp; device&nbsp;'''

[[File:ROM-2860 PCAT Tool Connect device.PNG|RTENOTITLE]]

'''7. When you connected successfully , it will show&nbsp; "green word" - Qualcomm HS-USB QDLoader 9008 (COM 6)&nbsp;'''

[[File:ROM-2860 PCAT UFS connectiondevice.PNG|RTENOTITLE]]

'''8. Select UFS Folder in PCAT Tool , the Tool will help load Files automatically and Select "MEMORY_TYPE_UFS"&nbsp;'''

[[File:ROM-2860 PCAT Select UFS File .PNG|RTENOTITLE]]

'''9. Click " Download"&nbsp;'''

[[File:ROM-2860 PCAT Select UFS File Download.png|RTENOTITLE]]

'''10. UFS Download Status&nbsp;'''

'''[[File:ROM-2860 PCAT Select UFS File Download status.png|RTENOTITLE]]11. UFS Donwload compeleted&nbsp;'''

'''[[File:ROM-2860 PCAT Select UFS File Download status 100.png|RTENOTITLE]]'''


=== '''Flash eMMC''' ===

'''1.&nbsp; Turn off the Power&nbsp;'''

'''<span style="background-color:#ffff00;">2.&nbsp;Change the SW1 and SW2&nbsp;</span>'''

'''<span style="background-color:#ffff00;">&nbsp;Flash eMMC:&nbsp; The SW1 switch to 1-off, 2-on</span>'''

'''<span style="background-color:#ffff00;">Forced Recovery&nbsp;:&nbsp;&nbsp;The SW2 switch to 1-on, 2-on</span>'''

'''3. Turn on the power&nbsp;'''

'''4. Make sure the device connection status.&nbsp;'''

'''5.&nbsp;If the device disconnect with PCAT Tool , please connect it again.&nbsp;'''

[[File:ROM-2860 PCAT Tool Connect device.PNG|RTENOTITLE]]

'''6. Select eMMC Folder.'''

'''[[File:ROM-2860 PCAT Select eMMC File.png|RTENOTITLE]]7. Make sure the setting ,then press " Download " button.'''

[[File:ROM-2860 PCAT check eMMC setting download1.png|RTENOTITLE]]

'''&nbsp;8. eMMC downlaoad status&nbsp;'''

[[File:ROM-2860 PCAT Select eMMC File Download status.png|RTENOTITLE]]

'''&nbsp;9. eMMC D''''''onwload compeleted&nbsp;'''

[[File:ROM-2860 PCAT Select eMMC File Download status 100.png|RTENOTITLE]]

'''10. When the eMMC installation finished . Close the PCAT tool ,'''

'''11. pleaes remove the mirco usb cable, turn off the power&nbsp;'''

'''12.'''&nbsp;'''eMMC boot up&nbsp;:&nbsp;'''

'''<span style="background-color:#ffff00;">The SW1 switch to 1-off, 2-on&nbsp;, 2-on&nbsp;</span>'''

'''<span style="background-color:#ffff00;">The SW2 switch to 1-off&nbsp;, 2-on&nbsp;</span>'''

'''13. Connect debug cable and open the terminal ,&nbsp;&nbsp;turn on the power .&nbsp;'''

'''14.&nbsp; When the systme boot up , you need to type &nbsp;" qcm6490 login: <span style="background-color:#ffff33;">root </span>"&nbsp; , " Password: <span style="background-color:#ffff00;">oelinux123</span>"'''

'''15.&nbsp; After type the long in and password , and you also can chek the image information about date , kernel version etc..&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>