View source for MIO-5355 Yocto user guide


== {{DISPLAYTITLE:AOM-2721 Yocto user guide}}'''產品介紹(Product introduction )''' ==

=== '''產品特性(Product Features)''' ===

*Qualcomm 8 Kryo cores up to 2.7GHz 
*Onboard LPDDR5 8GB, 8533MT/s memory 
*Onboard 128GB UFS and 128GB eMMC 
*1x 2ch. LVDS, 1x DP and 1x HDMI for displays 
*2x USB3.2 Gen1, 2x USB2.0, 2x PCIe Gen3.0 x1, 2x 4wire UART, 1x SPI,16x GPIO, 1x I2C, 2x MIPI-CSI x4 
*1x Micro SD and 1x Nano SIM 
*Support Windows 11 IoT Enterprise 

&nbsp;

=== '''產品官網連結(Product official website link)''' ===

<a href="[https://www.advantech.com/zh-tw/products/a9f9c02c-f4d2-4bb8-9527-51fbd402deea/aom-2721/mod_f2ab9bc8-c96e-4ced-9648-7fce99a0e24a https://www.advantech.com/zh-tw/products/a9f9c02c-f4d2-4bb8-9527-51fbd402deea/aom-2721/mod_f2ab9bc8-c96e-4ced-9648-7fce99a0e24a]" alt="[https://www.advantech.com/zh-tw/products/a9f9c02c-f4d2-4bb8-9527-51fbd402deea/aom-2721/mod_f2ab9bc8-c96e-4ced-9648-7fce99a0e24a https://www.advantech.com/zh-tw/products/a9f9c02c-f4d2-4bb8-9527-51fbd402deea/aom-2721/mod_f2ab9bc8-c96e-4ced-9648-7fce99a0e24a]" title="[https://www.advantech.com/zh-tw/products/a9f9c02c-f4d2-4bb8-9527-51fbd402deea/aom-2721/mod_f2ab9bc8-c96e-4ced-9648-7fce99a0e24a https://www.advantech.com/zh-tw/products/a9f9c02c-f4d2-4bb8-9527-51fbd402deea/aom-2721/mod_f2ab9bc8-c96e-4ced-9648-7fce99a0e24a]">'''AOM-2721'''</a>

&nbsp;

== '''硬件接口說明(Hardware interface introduction)''' ==

=== '''接口布局和尺寸(Layout and Sizes)''' ===

'''<img src="/wiki/images/c/c3/EPC-R2860_cover_sizeS.png" _fck_mw_filename="EPC-R2860 cover sizeS.png" _fck_mw_origimgwidth="333" _fck_mw_origimgheight="294" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />'''

'''<img src="/wiki/images/3/30/ROM-2860_layout_functions_top_s.PNG" _fck_mw_filename="ROM-2860 layout functions top s.PNG" _fck_mw_origimgwidth="465" _fck_mw_origimgheight="414" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />'''

'''<img src="/wiki/images/a/ac/ROM-2860_layout_functions_buttom_s.PNG" _fck_mw_filename="ROM-2860 layout functions buttom s.PNG" _fck_mw_origimgwidth="450" _fck_mw_origimgheight="375" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />'''

'''<img src="/wiki/images/b/bb/ROM-2860_layout_functions_switchsetting_ss.png" _fck_mw_filename="ROM-2860 layout functions switchsetting ss.png" _fck_mw_origimgwidth="493" _fck_mw_origimgheight="304" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />'''

=== '''EPC-R2860&nbsp;接口布局圖 Board Dimension Layout''' ===

&nbsp;

'''SW6'''

=== '''主板内置插针式引脚排序方式 (Pin Header defination)&nbsp;''' ===

=== '''Internal I/O, Jummper/Switch List:''' ===

{| border="1" cellpadding="1" cellspacing="1" style="width: 500px;"
|-
| '''Position'''
| '''Description'''
|-
| &nbsp;
| &nbsp;
|}

&nbsp;

= '''快速入門&nbsp;(Quick Start)''' =

=== '''系统下载 (OS Download)''' ===

'''Yocto 4.0&nbsp;:&nbsp;&nbsp;'''

'''SW1'''

*'''SW1(1-off,2-on)&nbsp;: eMMC boot''' 
*'''SW1(1-on,2-on)&nbsp;: UFS boot''' 

'''SW2'''

*'''SW2(1-on): Forced Recovery''' 
*'''SW2(1-off): Normal Boot''' 
*'''SW2(2-on): AT mode''' 
*'''SW2(2-off):ATx mode''' 

== '''Recovery & Rescue&nbsp;燒錄方法 (Recovery & Rescue method)''' ==

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

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

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

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

'''<img src="/wiki/images/4/4c/ROM-2860_search_bar.PNG" _fck_mw_filename="ROM-2860 search bar.PNG" _fck_mw_origimgwidth="1519" _fck_mw_origimgheight="214" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />'''

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

'''<img src="/wiki/images/f/f3/ROM-2860_PCAT_Tool_version.PNG" _fck_mw_filename="ROM-2860 PCAT Tool version.PNG" _fck_mw_origimgwidth="1752" _fck_mw_origimgheight="442" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />'''

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

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

'''<img src="/wiki/images/a/a7/ROM-2860_QUTS_Tool.PNG" _fck_mw_filename="ROM-2860 QUTS Tool.PNG" _fck_mw_origimgwidth="1468" _fck_mw_origimgheight="410" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />'''

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

'''<img src="/wiki/images/9/93/ROM-2860_QUTS_Tool_version.PNG" _fck_mw_filename="ROM-2860 QUTS Tool version.PNG" _fck_mw_origimgwidth="1803" _fck_mw_origimgheight="390" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />'''

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

'''<img src="/wiki/images/6/69/ROM-2860_new_tools_in_windows.PNG" _fck_mw_filename="ROM-2860 new tools in windows.PNG" _fck_mw_origimgwidth="272" _fck_mw_origimgheight="158" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />'''

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

'''<a href="[https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/Linux_Yocto_OS_Release_note/LE_aeversion https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/Linux_Yocto_OS_Release_note/LE_aeversion]" alt="[https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/Linux_Yocto_OS_Release_note/LE_aeversion https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/Linux_Yocto_OS_Release_note/LE_aeversion]" title="[https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/Linux_Yocto_OS_Release_note/LE_aeversion https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/Linux_Yocto_OS_Release_note/LE_aeversion]">[https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/Linux_Yocto_OS_Release_note/LE_aeversion https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/Linux_Yocto_OS_Release_note/LE_aeversion]</a>&nbsp;'''

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

'''&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;2860A1AIM38LIV11026_2024-11-17_ufs.tgz'''

'''&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;2860A1AIM38LIV11026_2024-11-17_emmc.tgz&nbsp;'''

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

'''<span style="background-color:#ffff00;">14. if your pc can not identify the USB , please download the "</span>'<span style="background-color:#ffff00;">Qualcomm USB Driver"&nbsp;</span>'''

'''<span style="background-color:#ffff00;">15. Search "&nbsp;Qualcomm USB Driver "&nbsp;</span>''<span style="background-color:#ffff00;">in the search bar , then install the driver.&nbsp;</span>'''''

<img src="/wiki/images/a/ac/ROM-2860_search_bar_usb_driver.PNG" _fck_mw_filename="ROM-2860 search bar usb driver.PNG" _fck_mw_origimgwidth="966" _fck_mw_origimgheight="475" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

=== '''<u>Reformat</u>&nbsp;&nbsp;''' ===

'''<span style="background-color:#ffff00;">For confirmation, we will erase the partition before UFS installation.&nbsp;</span>'''

'''1. Select&nbsp; provision button&nbsp;&nbsp;&nbsp;<img src="/wiki/images/8/89/ROM-2860_provision_file_button.PNG" _fck_mw_filename="ROM-2860 provision file button.PNG" _fck_mw_origimgwidth="49" _fck_mw_origimgheight="43" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />&nbsp;&nbsp;'''

<img src="/wiki/images/d/da/ROM-2860_provision_file_icon_yocto.PNG" _fck_mw_filename="ROM-2860 provision file icon yocto.PNG" _fck_mw_origimgwidth="946" _fck_mw_origimgheight="113" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

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

<img src="/wiki/images/2/26/ROM-2860_provision_clean.PNG" _fck_mw_filename="ROM-2860 provision clean.PNG" _fck_mw_origimgwidth="769" _fck_mw_origimgheight="167" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

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

<img src="/wiki/images/9/91/ROM-2860_provision_file_running.PNG" _fck_mw_filename="ROM-2860 provision file running.PNG" _fck_mw_origimgwidth="454" _fck_mw_origimgheight="166" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

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

<img src="/wiki/images/d/d3/ROM-2860_provision_log_yocto.PNG" _fck_mw_filename="ROM-2860 provision log yocto.PNG" _fck_mw_origimgwidth="991" _fck_mw_origimgheight="166" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

=== '''<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&nbsp;&nbsp; &nbsp; &nbsp;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;'''

<img src="/wiki/images/b/b4/ROM-2860_PCAT_UFS_.PNG" _fck_mw_filename="ROM-2860 PCAT UFS .PNG" _fck_mw_origimgwidth="613" _fck_mw_origimgheight="330" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

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

<img src="/wiki/images/3/31/ROM-2860_comport_connect_0_yocto.PNG" _fck_mw_filename="ROM-2860 comport connect 0 yocto.PNG" _fck_mw_origimgwidth="1206" _fck_mw_origimgheight="650" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

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

<img src="/wiki/images/0/0a/ROM-2860_comport_connect_1_yocto.PNG" _fck_mw_filename="ROM-2860 comport connect 1 yocto.PNG" _fck_mw_origimgwidth="1204" _fck_mw_origimgheight="649" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

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

<img src="/wiki/images/f/f9/ROM-2860_comport_connect_2_yocto.PNG" _fck_mw_filename="ROM-2860 comport connect 2 yocto.PNG" _fck_mw_origimgwidth="1207" _fck_mw_origimgheight="259" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

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

<img src="/wiki/images/f/f6/ROM-2860_UFS_0_yocto.PNG" _fck_mw_filename="ROM-2860 UFS 0 yocto.PNG" _fck_mw_origimgwidth="1209" _fck_mw_origimgheight="651" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

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

<img src="/wiki/images/8/88/ROM-2860_UFS_download_yocto.PNG" _fck_mw_filename="ROM-2860 UFS download yocto.PNG" _fck_mw_origimgwidth="1916" _fck_mw_origimgheight="728" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

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

'''<img src="/wiki/images/d/df/ROM-2860_UFS_download_1_yocto.PNG" _fck_mw_filename="ROM-2860 UFS download 1 yocto.PNG" _fck_mw_origimgwidth="1919" _fck_mw_origimgheight="621" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />'''

'''11. UFS Donwload ''''''completed'''

<img src="/wiki/images/6/6d/ROM-2860_UFS_download_done_yocto.PNG" _fck_mw_filename="ROM-2860 UFS download done yocto.PNG" _fck_mw_origimgwidth="1924" _fck_mw_origimgheight="1002" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

'''<span style="background-color:#ffff00;">12. When you finish the download process , please change the switch.</span>'''

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

&nbsp;

=== <u>'''Flash eMMC'''</u> ===

'''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&nbsp;&nbsp; &nbsp; &nbsp;Forced Recovery&nbsp;:&nbsp;&nbsp;The SW2 switch to 1-on&nbsp; ,2 - on .&nbsp;</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;'''

<img src="/wiki/images/3/31/ROM-2860_comport_connect_0_yocto.PNG" _fck_mw_filename="ROM-2860 comport connect 0 yocto.PNG" _fck_mw_origimgwidth="1206" _fck_mw_origimgheight="650" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

&nbsp;

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

<img src="/wiki/images/1/1e/ROM-2860_emmc_0_yocto.PNG" _fck_mw_filename="ROM-2860 emmc 0 yocto.PNG" _fck_mw_origimgwidth="1205" _fck_mw_origimgheight="648" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

'''7. Make sure the setting ,then press " Download " button.'''

<img src="/wiki/images/e/e1/ROM-2860_emmc_1_download_yocto.PNG" _fck_mw_filename="ROM-2860 emmc 1 download yocto.PNG" _fck_mw_origimgwidth="1914" _fck_mw_origimgheight="682" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

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

<img src="/wiki/images/0/07/ROM-2860_emmc_2_download_yocto.PNG" _fck_mw_filename="ROM-2860 emmc 2 download yocto.PNG" _fck_mw_origimgwidth="1916" _fck_mw_origimgheight="738" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

'''9. eMMC Donwload ''''''completed'''

<img src="/wiki/images/1/13/ROM-2860_emmc_3_download_yocto.PNG" _fck_mw_filename="ROM-2860 emmc 3 download yocto.PNG" _fck_mw_origimgwidth="1924" _fck_mw_origimgheight="649" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

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

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

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

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

'''14.&nbsp; If you have done "&nbsp;<u>Reformat</u> " <u>,</u> the message will show " DDR: Start of DDR Training Init "&nbsp;&nbsp;&nbsp;'''

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

'''16.&nbsp; After type the login and password , and you also can chek the image information about date , kernel version etc..&nbsp;'''

<img src="/wiki/images/8/8c/ROM-2860_emmc_boot_yocto.PNG" _fck_mw_filename="ROM-2860 emmc boot yocto.PNG" _fck_mw_origimgwidth="1328" _fck_mw_origimgheight="583" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

&nbsp;

== '''Linux&nbsp;BSP編譯方法(Linux&nbsp;BSP Compile Method)&nbsp;''' ==

<a href="[https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.3_AOM2721 https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.3_AOM2721]" alt="[https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.3_AOM2721 https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.3_AOM2721]" title="[https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.3_AOM2721 https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.3_AOM2721]">'''Yocto 4.0(LE 1.3)'''</a>

<a href="[https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.1_AOM2721 https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.1_AOM2721]" alt="[https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.1_AOM2721 https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.1_AOM2721]" title="[https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.1_AOM2721 https://ess-wiki.advantech.com.tw/view/AIM-Linux/BSP/Qualcomm/RISC_QCS_Yocto_LE1.1_AOM2721]">'''Yocto 4.0(LE 1.1)'''</a>

&nbsp;

Modify&nbsp;scripts/env.sh file:

'''#!/bin/bash'''

'''#TOPDIR=$(dirname $(dirname $(readlink -fm $0)))<br/> TOPDIR=$(dirname $(dirname $(readlink -fm ${BASH_SOURCE[0]})))'''<br/> <img src="/wiki/images/5/55/AOM-2721_build_env.png" _fck_mw_filename="AOM-2721 build env.png" _fck_mw_origimgwidth="811" _fck_mw_origimgheight="336" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />