Embedded module TQMa6x - YOCTO Linux BSP documentation

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 TQMa6x.

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.

Because of the dependencies to the other yocto layers we recommend to use ci-meta-tq which already provides all required yocto layers as git submodules instead of meta-tq to build this BSP release.

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

BSP Revision	0118
meta-tq release all releases	zeus.TQMa6x.BSP.SW.0118
Yocto Project / Poky Release	3.0.3
Target machine¹⁾	tqma6s-mba6x TQMa6S on MBa6x tqma6dl-mba6x TQMa6U on MBa6x tqma6q-mba6x TQMa6D/TQMa6Q on MBa6x tqma6qp-mba6x TQMa6DP/TQMa6QP on MBa6x
U-Boot	2016.03 (NXP imx-rel_imx_4.1.15_2.0.0_ga)
Linux Kernel	5.4.23 5.4.23 + rt23 fslc-5.4-1.0.0-imx

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 STKa6x, so instead of reinventing the wheel we will adhere to the very compact Yocto Project Quick Start and supply details specific to the STKa6x where necessary.

For further details regarding Yocto Project 3.0.3 - Zeus please refer to its official documentation.

Build Host

Yocto Project / Poky requires a Linux build host, so first of all you need a development workstation (or a virtual machine²⁾) with a 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.

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

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.

BSP build instructions

Please setup the build host as described in the Prerequisites section above .

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 zeus.TQMa6x.BSP.SW.0118 -b zeus

3. Update git submodules:

$ git submodule update --init
$ git submodule sync

4. Setup local branch to track the remote branch.

git branch -u origin/zeus

5. Initialize the build environment:

$ source setup-environment tqma6x_build imx

6. Configure the Build for a specific Linux kernel³⁾:

Configuration for NXP Linux kernel

$ echo 'MACHINE = "tqma6q-mba6x"' >> conf/local.conf

Configuration for Linux mainline kernel

$ echo 'MACHINE = "tqma6q-mba6x"' >> conf/local.conf
$ echo 'MACHINEOVERRIDES .= ":use-mainline-bsp"' >> conf/local.conf

Configuration for Linux RT kernel

$ echo 'MACHINE = "tqma6q-mba6x"' >> conf/local.conf
$ echo 'MACHINEOVERRIDES .= ":use-mainline-bsp"' >> conf/local.conf
$ echo 'PREFERRED_PROVIDER_virtual/kernel_tqma6x_use-mainline-bsp = "linux-rt-tq"' >> conf/local.conf

7. Build an Image for STKa6x:

$ bitbake tq-image-weston

The resulting image is tmp/deploy/images/tqma6q-mba6x⁴⁾/tq-image-weston-tqma6q-mba6x⁵⁾.wic
8. Write the Image⁶⁾⁷⁾

$ sudo dd if=tmp/deploy/images/tqma6q-mba6x/tq-image-weston-tqma6q-mba6x.wic of=TARGET_DEVICE

9. Boot the STKa6x from SD card (cf. MBa6x DIP switch settings)

¹⁾

i.e. value for MACHINE variable

²⁾

for testing purposes Yocto Project provides a ready to use virtual machine called Build Appliance

³⁾

valid machines are
tqma6s-mba6x
tqma6dl-mba6x
tqma6q-mba6x
tqma6qp-mba6x

⁴⁾

valid machines are
tqma6s-mba6x
tqma6dl-mba6x
tqma6q-mba6x
tqma6qp-mba6x

⁵⁾

valid machines are
tqma6s-mba6x
tqma6dl-mba6x
tqma6q-mba6x
tqma6qp-mba6x

⁶⁾

valid machines are
tqma6s-mba6x
tqma6dl-mba6x
tqma6q-mba6x
tqma6qp-mba6x

⁷⁾

TARGET_DEVICE has to be an SD card

Embedded module TQMa6x - YOCTO Linux BSP documentation

Preface

Prerequisites

Build Host

Yocto Build instructions

BSP build instructions