Embedded module TQMa8MPxS - YOCTO Linux BSP documentation

Preface

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 .

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	0004
meta-tq release all releases	https://github.com/tq-systems/ci-meta-tq/releases/tag/
Yocto Project / Poky Release
Target machine
U-Boot
Linux Kernel

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

For further details regarding Yocto Project /ref-manual/index.html|official documentation]].

Prerequisites

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 Required Packages for the Build Host for required build host packages for those distributions.

The instructions on this page have been tested on Ubuntu 20.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 BSP Build Instructions

Yocto 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/
cd ~/workspace/

2. Create a local copy of ci-metatq

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

4. Update git submodules:

git submodule sync
git submodule update --init

5. Setup local branch to track the remote branch.

git branch -u origin/

6. Export the environment DISTRO and MACHINE environment variable:

export DISTRO=
export MACHINE=

7. Configure the Build:

source setup-environment

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 _build

8. Build an Image for STKa8MPxL” mod_name=“TQMa8MPxL:

Image with debug features/root login

bitbake

Image with IMAGE_FEATURES debug and debug-tweaks enabled to have an open root login for console and ssh for ease of development and testing.

Image without debug features/root login

bitbake

Image without IMAGE_FEATURES debug and debug-tweaks enabled. A user login is not allowed with this image, if a login is required, please see poky documentation for extrausers.bbclass

For further information to the TQ image recipes, please refer to the section Image recipes from the meta-dumpling Yocto layer documentation.
meta-dumpling documentation

The resulting image is tmp/deploy/images/.wic

9. Write the Image to an SD-Card

sudo dd if=tmp/deploy/images/.wic of=/dev/<TARGET_DEVICE>

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

10. Boot the STKa8MPxL” mod_name=“TQMa8MPxL from SD card (cf. DIP switch settings) |