IoTGateway/BSP/Linux/TI/Yocto LBVC User Guide

Introduction

This page provides the steps to build the Processor SDK and individual components from source. The Processor SDK build is based on the Arago Project which provides a set of layers for OpenEmbedded and the Yocto Project targeting TI platforms.

This page will provide the basic steps required to recreate the Processor SDK along with a reference of Processor SDK specific configurations, build targets, and target devices. Also, tips and suggestions are provided along with links for more in-depth information.

Getting Start

Prerequisites

Host Setup

Generally，for Linux development, you’ll need a host PC running Linux. In the development with the Advantech SDK, it is strongly recommend to use Ubuntu 22.04 LTS as the developing environment. This is because we have successfully tested our BSP on this OS version. Please install the Ubuntu 22.04 LTS on your PC/NB in advance.

Docker install and setting

If you don't have docker in your system, then you can follow the below steps to install docker and run it first.

To install Docker Engine on your platform please refer to Docker Installation Guide for details.

To pull ubuntu 22.04 image from Docker Hub

$ sudo docker pull advrisc/u22.04-amxxlbv1

To create container

$ sudo docker run -it --name ${CONTAINER_NAME} -v ${WORKSPACE}:/home/adv/yocto_bsp:rw –privileged advrisc/u22.04-amxxlbv1 /bin/bash

Build Steps

The following example shows how to download the Advantech Yocto BSP from Azure.

For this example, a directory called yocto_bsp is created for the project.

$ git clone https://AIM-Linux@dev.azure.com/AIM-Linux/RISC-TI-Linux/_git/adv-ti-yocto-bsp -b processor-sdk-am335x-11.02.05.02 tisdk-adv

$ cd tisdk-adv

$ ./oe-layertool-setup.sh -f configs/processor-sdk/processor-sdk-scarthgap-11.02.05.02-config.txt

$ cd build

$ . conf/setenv

$ MACHINE=am335xepcr3220a1 bitbake -k tisdk-default-image

Your tisdk-default-image tar.xz image will be generated in the deploy-ti directory. Use Processor SDK Linux Create SD Card to flash this image on the SD-Card.  

Build Options

Images

In addition to individual components packages, the following table provides a list of build targets supported. These are the <target> used in the command:

$ MACHINE=<machine> bitbake <target>

The "Build Output" is given relative to the deploy-ti directory.

Target	Build Output	Description
tisdk-default-image	images/<machine>/tisdk-default-image-<machine>.tar.xz	Target Filesystem
tisdk-base-image	images/<machine>/tisdk-base-image-<machine>.tar.xz	Minimal Target Filesytem
tisdk-thinlinux-image	images/<machine>/tisdk-thinlinux-image-<machine>.tar.xz	Minimal Target Filesytem with docker enabled
meta-toolchain-arago-tisdk	sdk/arago-<arago-version>-<architecture>.sh	Devkit
u-boot-ti-staging	images/<machine>/u-boot-<machine>.img images/<machine>/MLO-<machine>	u-boot
linux-ti-staging	images/<machine>/zImage-<machine>.bin images/<machine>/zImage-<machine>.dtb	kernel

 

MACHINE	Supported Product
am335xepcr3220a1	EPC-R3220A1

Create SD Card using balenaEtcher

Download the default bootable SD card image (WIC file) available on the release page as

tisdk-default-image-<machine>-<version>.rootfs.wic.xz

Download and install the balenaEtcher tool :

Balena Etcher is an open-source utility that can be installed on both Linux and Windows. Download the tool fromthis linkand install it.

Flash the WIC image to the SD card :

Insert a micro SD card into the USB SD card reader and start Etcher.Choose the default WIC image to be flashed, choose the USB SD card reader as the target, and then click “Flash”. Etcher will decompress the image and write it to the SD card, as shown below

Danger

This operation WILL ERASE the contents of your SD card.

Boot from Onboard Flash

If you have already get a Linux system SD card and the last step of make process selected "y", you can refer to the following steps to burn the system to the onboard flash.

Please insert the Linux system SD card to EPC-R3220, and then power up. It boot from the SD card.

$ umount /dev/mmcblk1p* 2 > /dev/null || true

$ sudo bmaptool copy /root/tisdk-thinlinux-image-am335xepcr3220a1.rootfs-*.wic /dev/mmcblk1