MBLS1028A-IND - 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 TQMLS1028A.

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	0108
meta-tq release all releases	hardknott.TQMLS1028A.BSP.SW.0108
Yocto Project / Poky Release	3.3.6 - Hardknott `git clone -b hardknott git://git.yoctoproject.org/poky.git` poky-hardknott-25.0.3.tar.bz2
Target machine¹⁾	tqmls1028a-mbls1028a TQMLS1028A on MBLS1028A tqmls1028a-mbls1028a-ind TQMLS1028A on MBLS1028A-IND
U-Boot	u-boot-2019.10-LSDK-20.04
Linux Kernel	fslc-5.4-1.0.0-imx LSDK-20.12-V5.4-RT

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

For further details regarding Yocto Project 3.3.6 - Hardknott 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 Supported Linux Distribution of the Yocto Project Quick Start for supported linux distributions and section Required Packages for the Build Host 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.

Yocto Hardknott BSP

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

1. Open a new terminal and create a directory for the BSP build e.g. in the home directory and navigate to that directory.

mkdir -p ~/workspace/hardknott.TQMLS1028A.BSP.SW.0108
cd ~/workspace/hardknott.TQMLS1028A.BSP.SW.0108

2. Create a local copy of meta-tq

git clone --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git

3. Checkout BSP release on new local branch.

cd ci-meta-tq
git checkout hardknott.TQMLS1028A.BSP.SW.0108 -b hardknott-tqmls1028a

4. Update git submodules:

git submodule sync
git submodule update --init

5. Setup local branch to track the remote branch.

git branch -u origin/hardknott

6. Export the environment DISTRO and MACHINE environment variable:

export DISTRO=dumpling
export MACHINE=tqmls1028a-mbls1028a-ind

7. Initialize the build environment³⁾:

source setup-environment tqmls1028a_build ls

Each time a new terminal is opened, the build environment must be reinitialised. The command described above is intended for the initial build space initialisation. To return to an existing buildspace open up a new terminal and navigate to the ci-meta-tq folder and execute the following command:

source setup-environment tqmls1028a_build

8. Configure the Build for a specific Linux kernel⁴⁾:

Configuration for NXP Linux kernel

$ echo 'MACHINE = "tqmls1028a-mbls1028a-ind"' >> conf/local.conf

Configuration for NXP Linux kernel 5.4 with RT patches

$ echo 'MACHINE = "tqmls1028a-mbls1028a-ind"' >> conf/local.conf
$ echo 'PREFERRED_PROVIDER_virtual/kernel_tqmls1028a = "linux-rt-lsdk-tq"' >> conf/local.conf
$ echo 'PREFERRED_VERSION_linux-rt-lsdk-tq = "5.4%"' >> conf/local.conf

Configuration for NXP Linux kernel 5.10 with RT patches

$ echo 'MACHINE = "tqmls1028a-mbls1028a-ind"' >> conf/local.conf
$ echo 'PREFERRED_PROVIDER_virtual/kernel_tqmls1028a = "linux-rt-lsdk-tq"' >> conf/local.conf
$ echo 'PREFERRED_VERSION_linux-rt-lsdk-tq = "5.10%"' >> conf/local.conf

9. Build an Image for STKLS1028A:

Image with debug features/root login

bitbake tq-image-generic-debug

Image without debug features/root login

bitbake tq-image-generic

The resulting image is tmp/deploy/images/tqmls1028a-mbls1028a-ind⁵⁾/tq-image-generic-tqmls1028a-mbls1028a-ind⁶⁾.wic

9. Write the Image⁷⁾⁸⁾

sudo dd if=tmp/deploy/images/tqmls1028a-mbls1028a-ind/tq-image-generic-tqmls1028a-mbls1028a-ind.wic of=/dev/<TARGET_DEVICE>

Please see Create SD Card with BSP Image for detailed instructions.

10. Boot the STKLS1028A from SD card (cf. tqmls1028a 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
tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind

⁴⁾

valid machines are
tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind

⁵⁾

valid machines are
tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind

⁶⁾

valid machines are
tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind

⁷⁾

valid machines are
tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind

⁸⁾

TARGET_DEVICE has to be an SD card

MBLS1028A-IND - Yocto Linux BSP documentation

Preface

Prerequisites

Build Host

Yocto BSP Build Instructions

Yocto Hardknott BSP

Image with debug features/root login

Image without debug features/root login