Embedded module TQMa8XxS - YOCTO Linux BSP documentation

This is an old revision of the document!

WORK IN PROGRESS

The instructions on this page have been tested on Ubuntu 16.04 (64 bit) in a VMWare virtual machine.

The meta-tq layer extends the Yocto Project's reference system Poky to provide support for a selection of TQ Embedded CPU Modules, including the TQMa8XxS.

It uses the same codebase as the PTXdist based TQ Linux BSPs and therefore provides the same versions of U-Boot and Linux kernel, but doesn't define a specific root filesystem configuration.

Please use ci-meta-tq instead of meta-tq to build this release of the BSP.

The instructions on this page refer to the BSP and ancillary tools listed in the following table:

BSP Revision	0016
meta-tq release all releases	sumo.TQMa8.BSP.SW.0016
Yocto Project / Poky Release	2.5.2 - Sumo `git clone -b sumo git://git.yoctoproject.org/poky.git` poky-sumo-19.0.0.tar.bz2
Target machine¹⁾	tqma8xqs-mb-smarc-2 TQMa8XQS on MB-SMARC2 tqma8xds-mb-smarc-2 TQMa8XDS on MB-SMARC2
U-Boot	v2018.03-rel_imx_4.14.98_2.2.0_ga
Linux Kernel	rel_imx_4.14.98_2.2.0_ga

It's strongly recommended to use git for downloading both the Yocto Project / Poky Release as well as ci-meta-tq (instead of downloading archives and extracting them).

The goal of these wiki pages is to get you started using ci-meta-tq with the STKa8XxS, so instead of reinventing the wheel we will adhere to the very compact Yocto Project Quick Start and supply details specific to the STKa8XxS where necessary.

For further details regarding Yocto Project 2.5.2 - Sumo please refer to its official documentation.

Yocto Project / Poky requires a Linux build host, so first of all you need a development workstation (or a virtual machine²⁾) with a (preferably) recent Linux distribution installed.

Please refer to section Compatible Linux Distribution of the Yocto Project Quick Start for supported linux distributions and section Build Host Packages for required build host packages for those distributions.

Although not required by Yocto Project / Poky, we also recommend to configure and run a tftp server (for image download / update) and an nfs server (for network mounted root filesystem) on your development host.

The Yocto Project Quick Start document explains how to set up Yocto Project / Poky and how to build images using the meta-intel layer. Using this as a guideline, the following table describes how to use the ci-meta-tq layer for the STKa8XxS.

Section	Remarks / Instructions for ci-meta-tq & STKa8XxS
Welcome!	Introduction and basic information about the Yocto Project
Setting Up to Use the Yocto Project	Description of basic requirements for using the Yocto Project (also cf. Prerequisites above)
Building Your Images	This section provides step-by-step instructions for STKa8XxS. Building an Image for Hardware 1. Create a local copy of ci-meta-tq $ git clone --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git 2. Checkout BSP release on new local branch. $ cd ci-meta-tq $ git checkout sumo.-tqma8x.BSP.SW.<label yocto_rel_branch_rev>YOCTO_REL_BRANCH_REV</label> -b <label yocto_local_branch_name>YOCTO_LOCAL_BRANCH_NAME</label> 3. Update git submodules: $ git submodule update --init $ git submodule sync 4. Setup local branch to track the remote branch. git branch -u origin/<label yocto_local_branch_name>YOCTO_LOCAL_BRANCH_NAME</label> 5. Configure the Build³⁾: $ source fsl-setup-release.sh -b tqma8xxs_build -e wayland $ echo 'MACHINE = "tqma8xqps-mb-smarc-2"' >> conf/local.conf 6. Build an Image for STKa8XxS: $ bitbake tq-image-qt5 The resulting image is `tmp/deploy/images/tqma8xqps-mb-smarc-2⁴⁾/tq-image-qt5-tqma8xqps-mb-smarc-2⁵⁾.wic` 7. Write the Image⁶⁾⁷⁾ $ sudo dd if=tmp/deploy/images/tqma8xqps-mb-smarc-2/tq-image-qt5-tqma8xqps-mb-smarc-2.wic of=TARGET_DEVICE 8. Boot the STKa8XxS from SD card (cf. MBa8xxS DIP switch settings)