This is an old revision of the document!


Embedded module TQMT10xx - YOCTO Linux BSP documentation



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

The meta-tq-powerach layer extends the Yocto Project's reference system Poky to provide support for the TQMT10xx TQ Embedded CPU Modules.

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

BSP Revision 0100
meta-tq-powerarch jethro-tqmtxxxx
Yocto Project / Poky Release Jethro - 2.0.1
Target machine1) tqmt1040-64b-stk
tqmt1042-64b-stk
U-Boot 2015.07
Linux Kernel 4.4

It's strongly recommended to use git for downloading both the Yocto Project / Poky Release as well as meta-tq-powerarch (instead of downloading archives and extracting them).

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

For further details regarding Yocto Project 2.0.1 - Jethro please refer to its official documentation.

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

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 describes how to use the meta-tq-powerach layer for the STK104x.

Install the repo tool on development host

  • Download the repo tool:
    curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > repo
  • Make it executable:
    chmod +x repo
  • Move it to your system path:
    sudo mv repo /usr/local/bin
  • Verify installation:
    repo --help

Initialize the repository

  • Create an empty directory:
    mkdir yocto && cd yocto
  • Initialize the repository:
    repo init -u ssh://git@github.com/tq-systems/yocto-manifest.git -b jethro-tqmtxxxx
  • Fetch all the source codes:
    repo sync

Setup the Yocto project build environment

1. Create an environment file in your build directory:
cat > environment << EOF
export LOADENV_USER=tq
export TEMPLATECONF=meta-tq-powerarch/conf
source poky/oe-init-build-env
export BB_ENV_EXTRAWHITE="$BB_ENV_EXTRAWHITE FSL_RCW"
EOF
2. Initialize Build environment

Before image generation can be started the build environment has to be initialized by the following command:

 source environment 

This copies default configuration information into the build/conf directory. Additionally some environment variables will be set up for the build system. This configuration directory is not under revision control; you may wish to edit these configuration files for your specific setup.

Building an Image

Now building an image can be started by running the command:

 bitbake core-image-minimal 

1)
i.e. value for MACHINE variable
2)
for testing purposes Yocto Project provides a ready to use virtual machine called Build Appliance
  • Last modified: 2022/08/04 15:04