Embedded module TQMa8Xx - 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 TQMa8Xx.

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 0017
meta-tq release sumo.TQMa8.BSP.SW.0017
Yocto Project / Poky Release 2.5.1 - Sumo
Target machine1) tqma8xd-mba8xx\
tqma8xqp-mba8xx
U-Boot 2018.03
Linux Kernel 4.14




















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

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

Prerequisites

Yocto Project / Poky requires a Linux build host, so first of all you need a development workstation (or a virtual machine2)) 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 16.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 Build instructions

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.0017 -b sumo-tqma8x

3. Update git submodules: 

$ git submodule update --init
$ git submodule sync

4. Setup local branch to track the remote branch. 

git branch -u origin/sumo-tqma8x

5. Configure the Build3): 

$ source fsl-setup-release.sh -b tqma8xx_build -e wayland
$ echo 'MACHINE = "tqma8xqp-mba8xx"' >> conf/local.conf

6. Build an Image for STKa8Xx: 

$ bitbake tq-image-qt5

The resulting image is tmp/deploy/images/tqma8xqp-mba8xx4)/tq-image-qt5-tqma8xqp-mba8xx5).wic
7. Write the Image6)7) 

$ sudo dd if=tmp/deploy/images/tqma8xqp-mba8xx/tq-image-qt5-tqma8xqp-mba8xx.wic of=TARGET_DEVICE

8. Boot the STKa8Xx from SD card (cf. MBa8Xx DIP switch settings) |

1)
i.e. value for MACHINE variable
2)
for testing purposes Yocto Project provides a ready to use virtual machine called Build Appliance
3) , 4) , 5) , 6)
valid machines are
tqma8xd-mba8xx\
tqma8xqp-mba8xx
7)
TARGET_DEVICE has to be an SD card

Disclaimer
TQ-Systems GmbH provides the Board Support Packages (BSP) free of charge. The software included in the shipment has been configured individually for the starter kits. The software is only intended to evaluate the module. The use of the Board Support Packages (BSP) is only allowed within the scope of functionality described by TQ-Systems GmbH. TQ-Systems GmbH does not accept any liability for all further changes of the Board Support Package and for any damage resulting from its use.