x86 Yocto Quickstart Guide

To support the TQMxE40M module, the DEV kernel version must be used. For more information, see Use Linux Dev Kernel

Please visit GitHub for the latest build instructions: ci-meta-tqmx86 on GitHub

The meta-tqmx86 layer extends the Yocto Project's reference system Poky to provide support for all TQ Embedded x86 CPU Modules, including the TQMxE40M.

Because of the dependencies to the other yocto layers we recommend to use ci-meta-tqmx86 which already provides all required yocto layers as git submodules instead of meta-tqmx86 to build this BSP release.

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

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

For further details regarding Yocto Project 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 machine) 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 18.04 (64 bit) in a VMWare virtual machine.

Please setup the build host as described in the Setup Build Host section above.

1. Create a local copy of ci-meta-tqmx86

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

2. Checkout BSP release on new local branch.

cd ci-meta-tqmx86
git checkout kirkstone.TQMx86.BSP.SW.0001 -b kirkstone_x86

3. Update git submodules:

git submodule sync
git submodule update --init

4. Configure the Build¹⁾:

source setup-environment build x86

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-tqmx86 folder and execute the following command:

source setup-environment build

5. Build an Image for STKxE40M:

bitbake core-image-base

The resulting image is:

tmp/deploy/images/intel-corei7-64-tqmx86/core-image-base-intel-corei7-64-tqmx86.wic

6. Write the Image²⁾³⁾

sudo dd if=tmp/deploy/images/intel-corei7-64-tqmx86/core-image-base-intel-corei7-64-tqmx86.wic of=TARGET_DEVICE

7. Boot the STKxE40M from SD card or USB Stick

with newer CPUs it is necessary to use a more current kernel version. In this case the intel developement kernel branch can be used. Please see the README for the current version of the development kernel.
To use the development kernel, the following line must be added to the conf/local.conf file:

PREFERRED_PROVIDER_virtual/kernel_intel-corei7-64-tqmx86 = "linux-intel-dev"

¹⁾ , ²⁾

valid machines are
intel-corei7-64-tqmx86

³⁾

TARGET_DEVICE has to be an SD card or USB Stick

x86 Yocto Quickstart Guide

Preface

Setup Build Host

Image build instructions

Use Linux Developement Kernel (Hardknott only!)