====== TQMa62xx - YOCTO Linux BSP documentation ======

<nav type="tabs" justified="true">
  * [[.:overview|Overview]]
  * [[.:quickstart_yocto|Quickstart BSP]]
  * [[.:deployment_yocto|Deployment]]
  * [[.:how-to:user-led|How-To]]
  * [[.:known-issues|Known Issues]]
</nav>

===== Create SD-Card image =====

<panel type="default" title="Create SD Card with BSP Image">
The Image can be simply written to the SD Card by using the dd shell command in Linux:
<code bash>
$ cd <path to your image>
$ sudo dd if=tq-image-weston-debug-tqma62xx-mba62xx.rootfs.wic of=/dev/sdc bs=1M conv=fsync #Assuming the SD card is assigned to /dev/sdc
</code>

<alert type="warning" icon="fa fa-warning">The image must be written to the RAW device of the SD Card (e.g. /dev/sdc) and not into a partition (e.g. /dev/sdc1) !</alert>

 To identify the SD card in Linux the shell command dmesg can be used:
  - Open a new terminal 
  - Execute the following command without plugged SD Card <code bash> $ dmesg | tail -n 15</code> 
  - Insert SD Card and wait a few seconds
  - Run the command from step two again
<code bash>
$ dmesg | tail -n 15 
 #plug in SD Card into the reader
$ dmesg | tail -n 15 
</code>
</panel>

===== USB Boot =====
<panel type="default" title="USB Boot">
The TI Sitara AM62x CPU provides the option to boot from USB (host and device).

=== Prerequisites ===

  * Build BSP following [[:en:arm:tqma62xx:linux:yocto:quickstart_yocto|STKa62xx Yocto BSP quickstart guide]].
  * Booting the STKa62xx from USB device requires a Linux based host PC to run the dfu-util.

<accordion collapsed="true">
<panel type="primary" title="Boot from USB host (mass storage)">

1. Format a USB flash drive with FAT32 filesystem. \\ 2. Copy the files listed below from the Yocto buildspace deploy directory to the USB flash drive prepared with FAT32:

  * u-boot.img
  * tispl.bin
  * tiboot3.bin

<callout type="danger">The USB flash drive partition must be set as active!</callout>

3. Connect the USB flash drive with the USB 3.0 the USB-OTG interface. \\ 4. Set the STKa62xx DIP switches to boot from USB host (mass storage).

<grid> <col sm="3"> <WRAP centeralign> [size=150%]**S4**  [/size] {{  :en:dip_4_1100.png?nolink&150  }}</WRAP> </col>

<col sm="3"> <WRAP centeralign> [size=150%]**S5**  [/size] {{  :en:dip_4_1010.png?nolink&150  }}</WRAP> </col>

<col sm="3"> <WRAP centeralign> [size=150%]**S6**  [/size] {{  :en:dip_4_1000.png?nolink&150  }}</WRAP> </col>

<col sm="3"> <WRAP centeralign> [size=150%]**S7**  [/size] {{  :en:dip_4_0000.png?nolink&150  }}</WRAP> </col> </grid>

5. Connect host PC with STKa62xx connector X10 and setup the terminal program. \\ Please see the [[https://support.tq-group.com/en/arm/tqma62xx/mba62xx/stk_quicksteps#terminal_emulator|terminal_emulator]] section how to setup a serial debug connection. \\
6. Power on the STKa62xx to boot from USB. \\
</panel>

<panel type="primary" title="Boot from USB device (dfu-util)"> Please check that dfu-util is installed the Linux host.

1. Copy the files below from the Yocto buildspace deploy directory deploy e.g. the home folder:

  * u-boot.img
  * tispl.bin
  * tiboot3.bin

2. Connect STKa62xx X7 and X10 with a mirco USB cable to the Host PC.

  * X10 is used to connect the STKa62xx as USB device
  * X7 is used as serial debug connection

3. Set the STKa62xx DIP switches to boot from USB device (dfu-util). \\ 
<grid> 
<col sm="3"> <WRAP centeralign> [size=150%]**S4**  [/size] {{  :en:dip_4_1100.png?nolink&150  }}</WRAP> </col>

<col sm="3"> <WRAP centeralign> [size=150%]**S5**  [/size] {{  :en:dip_4_1010.png?nolink&150  }}</WRAP> </col>

<col sm="3"> <WRAP centeralign> [size=150%]**S6**  [/size] {{  :en:dip_4_0100.png?nolink&150  }}</WRAP> </col>

<col sm="3"> <WRAP centeralign> [size=150%]**S7**  [/size] {{  :en:dip_4_0000.png?nolink&150  }}</WRAP> </col> 
</grid>

4. Power up the STKa62xx. \\ 5. Open a second terminal for the serial debug connection with e.g. Minicom \\ Please see the [[https://support.tq-group.com/en/arm/tqma62xx/mba62xx/stk_quicksteps#terminal_emulator|terminal_emulator]] section how to setup a serial debug connection. \\
6. Open terminal (shell) on Linux host and execute the commands below to boot the STKa62xx via USB device.

<callout type="primary" icon="true"> After initial power-on, U-Boot will reset the CPU as a part of an TI Errata workaround, so tiboot3.bin needs to be loaded twice. \\ After a warm boot (reset from U-Boot or reboot from Linux), the initial load of tiboot3.bin must be skipped. </callout>
<code>

sudo dfu-util -a bootloader -D tiboot3.bin

</code>

<callout type="info" icon="true"> STKa62xx issues a reset after loading the tiboot3.bin via dfu-util. when it has been initially powered on. \\ If the STKa62xx has been reset from U-Boot or Linux it is not required to load tiboot.bin3 twice, so only the three commands below have to be executed. </callout>

<code>
sudo dfu-util -R -a bootloader -D tiboot3.bin
sudo dfu-util -R -a tispl.bin -D tispl.bin
sudo dfu-util -R -a u-boot.img -D u-boot.img

</code>

</panel> </accordion>
</panel>

<callout type="primary" icon="true">
The information provided on this wiki page is subject to change due to circumstances beyond our control. While we strive to keep all details as accurate and up-to-date as possible, it is possible that certain updates or changes may go unnoticed for some time. As a result, some sections of this page may contain outdated information. If you notice any mistakes in the documentation, we kindly ask you to inform the TQ Support through our ticket system.
</callout>