View source for AIM-Linux/BSP/Qualcomm/RISC QCS Linux 00011.1 ROM-2860


= Introduction =

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

== Ubuntu Version ==

Ubuntu 20.04

== Kernel Version ==

Kernel 5.4.233

= Docker Install and BSP Download =

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

== Run docker example ==
<pre>$ mkdir -p ~/qualcomm-bsp
$ sudo docker run -it --name adv-qcs6490-ubun-1-0 -v ~/qualcomm-bsp:/home/adv/adv-release-bsp:rw --privileged advrisc/u20.04-qcslbv1:latest /bin/bash</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 adv-release-bsp
$ git config --global credential.helper 'store --file ~/.my-credentials'
$ echo "${ADV_GIT_TOKEN}" > ~/.my-credentials
$ repo init -u https://dev.azure.com/AIM-Linux/risc_qcs_linux_00011.1/_git/manifests -b main -m adv_3.5.1.r1-06500-QCS6490.0.xml --repo-url=https://git.codelinaro.org/clo/tools/repo.git --repo-branch=qc-stable
$ repo sync -c -j12</pre>

== Copy HLOS of Chipcode ==
<pre>$ cp -r amss/apps_proc/* .</pre>

= Build Instructions =

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

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

'''Output images: out/emmc and out/ufs'''

== Build yocto images ==
<pre>$ cd poky
$ export MACHINE=qcs6490-odk DISTRO=qti-distro-ubuntu-fullstack-debug
$ export PREBUILT_SRC_DIR="<APPS_ROOT>/prebuilt_HY11"
$ source qti-conf/set_bb_env.sh
$ bitbake qti-ubuntu-robotics-image</pre>

== Build boot and dtb images ==
<pre>$ cd poky
$ export MACHINE=qcs6490-odk DISTRO=qti-distro-ubuntu-fullstack-debug
$ export PREBUILT_SRC_DIR="<APPS_ROOT>/prebuilt_HY11"
$ source qti-conf/set_bb_env.sh
$ bitbake -fc cleanall linux-msm && bitbake linux-msm && bitbake qti-ubuntu-robotics-image -fc do_make_bootimg && bitbake qti-ubuntu-robotics-image -fc do_makedtbo</pre>

= Recovery & Rescue =

== QFIL ==

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