===== Preface =====

The //meta-tqmx86// layer extends the //Yocto Project's// reference system //Poky// to provide support for all TQ x86-Modules including the <label mod_name>MOD_NAME</label>. 

<callout type="info" icon="true">
The goal of these wiki pages is to get you started using //meta-tqmx86// with the <label stk_name>STK_NAME</label>, so instead of reinventing the wheel we will adhere to the very compact [[https://docs.yoctoproject.org/brief-yoctoprojectqs/|Yocto Project Quick Start]] and supply details specific to the <label stk_name>STK_NAME</label> where necessary.\\

</callout>

===== Dependencies =====

This layer depends on a number of base layers, which are listed in the following. The Yocto versions "gatesgarth" and "hardknott" are supported at this time. The correct branch matching the Yocto version must be checked out for each layer.

  * [[https://git.yoctoproject.org/cgit.cgi/poky/|poky]]
  * [[http://git.yoctoproject.org/cgit/cgit.cgi/meta-intel|meta-intel]]

===== Prerequisites  =====

<alert type="warning" icon="fa fa-warning">It's strongly recommended to use **git** for downloading both the //Yocto Project / Poky// sources (instead of downloading archives and extracting them)</alert>

<panel type="primary" title="Build Host">

//Yocto Project / Poky// requires a Linux build host, so first of all you need a development workstation (or a virtual machine((for testing purposes //Yocto Project// provides a ready to use virtual machine called [[https://www.yoctoproject.org/tools-resources/projects/build-appliance|Build Appliance]]))) 
with a Linux distribution installed.

Please refer to section [[https://docs.yoctoproject.org/brief-yoctoprojectqs/#compatible-linux-distribution|Compatible Linux Distribution]] of the //Yocto Project Quick Start// for supported linux distributions and section [[https://docs.yoctoproject.org/brief-yoctoprojectqs/#build-host-packages|Build Host Packages]] for required build host packages for those distributions.

<callout type="info" icon="true">
The instructions on this page have been tested on <label host_os_name>HOST_OS_NAME</label> <label host_os_version>HOST_OS_VERSION</label> (<label host_os_bits>HOST_OS_BITS</label>) in a VMWare virtual machine.
</callout>
Although not required by //Yocto Project / Poky//, we also recommend to configure and run a [[en:tftp|tftp server]] (for image download / update) and an [[en:nfs|nfs server]] (for network mounted root filesystem) on your development host.
</panel>

===== Yocto Build instructions =====

1. Create Workspace Folder
<code>
$ mkdir workspace
$ cd workspace
</code>
2. clone both the meta-intel and our meta-tqmx86 repository and checkout the branch you want to use. In this example we use <label poky_branch>POKY_BRANCH</label>:
<code>
$ git clone https://github.com/tq-systems/meta-tqmx86.git
$ cd meta-tqmx86
$ git checkout <label poky_branch>POKY_BRANCH</label>
$ cd ..
$ git clone https://git.yoctoproject.org/git/meta-intel
$ cd meta-intel
$ git checkout <label poky_branch>POKY_BRANCH</label>
</code>

3. clone the official poky repository and checkout the branch you want to use:
<code>
$ cd ..
$ git clone git://git.yoctoproject.org/poky
$ cd poky
$ git checkout <label poky_branch>POKY_BRANCH</label>
</code>

4. initialize the buildspace using the //oe-init-build-env// script. This script creates a build folder and enters it directly:
<code>
$ . oe-init-build-env
</code>


5. In order to use the meta-tqmx86 and meta-intel layer you need to make the build system aware of it. open the file bblayers.conf with your favorite editor to add the layers:
<code>
nano conf/bblayers.conf
</code>
The file should look similar to the following after the adjustment: