Preface
The instructions on this page have been tested on Ubuntu 14.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 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.
The instructions on this page refer to the BSP and ancillary tools listed in the following table:
BSP Revision1) | 0115 |
---|---|
meta-tq release | warrior.TQMa6x.BSP.SW.0115 |
Yocto Project / Poky Release | 2.7.2 - Warrior |
Target machine2) | tqma6q-mba6x tqma6q-nav tqma6dl-mba6x tqma6s-mba6x |
U-Boot | 2017.11 |
Linux Kernel | 4.14.78 |
It's strongly recommended to use git for downloading both the Yocto Project / Poky Release as well as meta-tq (instead of downloading archives and extracting them).
The goal of these wiki pages is to get you started using 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 2.7.2 - Warrior 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 machine3)) with a (preferably) recent Linux distribution installed.
Please refer to section The Linux Distribution of the Yocto Project Quick Start for supported linux distributions and section The 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.
Yocto Project / Poky set-up
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 meta-tq layer for the STKa6x.
Section | Remarks / Instructions for meta-tq & STKa6x |
---|---|
Welcome! | Introduction and basic information about the Yocto Project |
Introducing the Yocto Project Development Environment | |
Setting Up to use the Yocto Project | Description of basic requirements for using the Yocto Project (also cf. Prerequisites above) |
Yocto Project Release | Instructions on how to install a release of the Yocto Project on the Build Host$ git checkout warrior
will not work unless you change into the Alternatively you can clone the Poky repository and checkout branch warrior in one step by executing $ git clone -b warrior git://git.yoctoproject.org/poky.git |
Building Images | This section provides step-by-step instructions for To sucessfully build an image for hardware you have to carry out steps from both subsections6) as follows. Building an Image for Emulation
1. Be Sure Your Build Host is Set Up:
See above $ git checkout warrior
You can skip this step if you checked out branch warrior already when/after cloning the poky repository. $ source oe-init-build-env
The above is absolutely required, otherwise the subsequent steps will not work! Building an Image for Hardware1. Create a Local Copy of meta-tq $ cd $HOME/poky $ git clone -b warrior https://github.com/tq-systems/meta-tq.git 2. Configure the Build7): $ cd $HOME/poky/build $ bitbake-layers add-layer "../meta-tq" $ echo 'MACHINE = "tqma6q-mba6x"' >> conf/local.conf 3. Build an Image for STKa6x: $ bitbake core-image-minimal
The resulting image is $ sudo dd if=tmp/deploy/images/tqma6q-mba6x/core-image-minimal-tqma6q-mba6x.wic of=TARGET_DEVICE 5. Boot the STKa6x from SD card (cf. MBa6x DIP switch settings) |
TARGET_DEVICE
has to be an SD card