Differences

This shows you the differences between two versions of the page.

--- en:power:tqmt10xx:linux:yocto:quickstart_yocto [2019/09/11 13:12] – created liedmann
+++ en:power:tqmt10xx:linux:yocto:quickstart_yocto [2019/09/13 11:07] – fixed link to yocto version liedmann
@@ Line 11: / Line 11: @@
 </embed>
 \\
+\\
+<WRAP round info>The instructions on this page have been tested on Ubuntu 16.04 64bit) in a VMWare virtual machine.</WRAP>
+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 |\\  [[https://github.com/tq-systems/meta-tq-powerarch]]++  |  [[https://github.com/tq-systems/meta-tq-powerarch|jethro-tqmtxxxx]]  |
+^ Yocto Project / Poky Release  |  [[http://downloads.yoctoproject.org/releases/yocto/yocto-2.0.1/poky-jethro-14.0.1.tar.bz2| Jethro - 2.0.1]]  |
+^ Target machine((i.e. value for [[https://www.yoctoproject.org/docs/2.4.4/ref-manual/ref-manual.html#var-MACHINE|MACHINE]] variable))  |  ++tqmt1040-64b-stk | TQMT1040 / STKT104x  ++\\  ++tqmt1042-64b-stk | TQMT1042 / STKT104x  ++   |
+^ U-Boot  |  [[http://www.denx.de/wiki/U-Boot/Documentation|2015.07]]  |
+^ Linux Kernel  |  [[http://lxr.free-electrons.com/source/?v=4.4|4.4]]  |
+<WRAP round important> 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).</WRAP>
+<WRAP round info>
+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 - Rocko please refer to its official documentation.
+</WRAP>
+===== Prerequisites  =====
+//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 (preferably) recent Linux distribution installed.
+Please refer to section [[https://www.yoctoproject.org/docs/2.0.1/yocto-project-qs/yocto-project-qs.html#the-linux-distro|The Linux Distribution]] of the //Yocto Project Quick Start// for supported linux distributions and section [[https://www.yoctoproject.org/docs/2.0.1/yocto-project-qs/yocto-project-qs.html#packages|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 [[en:tftp|tftp server]] (for image download / update) and an [[en:nfs|nfs server]] (for network mounted root filesystem) on your development host.
+===== Yocto Project / Poky set-up =====
+The [[https://www.yoctoproject.org/docs/2.0.1/yocto-project-qs/yocto-project-qs.html|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: <code>curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > repo</code>
+  * Make it executable: <code>chmod +x repo</code>
+  * Move it to your system path: <code>sudo mv repo /usr/local/bin</code>
+  * Verify installation: <code>repo --help</code>
+=== Initialize the repository ===
+  * Create an empty directory: <code>mkdir yocto && cd yocto</code>
+  * Initialize the repository: <code>repo init -u ssh://git@github.com/tq-systems/yocto-manifest.git -b jethro-tqmtxxxx</code>
+  * Fetch all the source codes: <code>repo sync</code>
+=== Setup the Yocto project build environment ===
+==1. Create an environment file in your build directory: ==
+<code>
+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
+</code>
+==2. Initialize Build environment==
+Before image generation can be started the build environment has to be initialized by the following command:
+<code> source environment </code>
+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:
+<code> bitbake core-image-minimal </code>