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 [2023/01/23 10:43] (current) – changed link to U-Boot and Linux Kernel Sources liedmann
@@ Line 1: / Line 1: @@
-<embed en:templates:tabs_yocto>
+<embed en:templates:tabs_yocto_bootstrap>
   <label product_type>Embedded module</label>
   <label lang>en</label>
@@ Line 11: / Line 11: @@
 </embed>
 \\
+\\
+<callout type="primary" icon="true">The instructions on this page have been tested on Ubuntu 16.04 64bit) in a VMWare virtual machine.</callout>
+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:
+<grid>
+<col sm="6">
+<panel no-body="true">
+^ BSP Revision  ^  0101  ^
+^ ++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  |  [[https://github.com/tq-systems/uboot-tqmt/tree/jethro.TQMT104x.BSP.SW.0101|2015.07]]  |
+^ Linux Kernel  |  [[https://github.com/tq-systems/linux-tqmt/tree/jethro.TQMT104x.BSP.SW.0101|4.4]]  |
+</panel>
+</col>
+</grid>
+<alert type="warning" icon="fa fa-warning"> 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).</alert>
+<callout type="primary" icon="true">
+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 [[https://www.yoctoproject.org/docs/2.0.1/yocto-project-qs/yocto-project-qs.html|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 [[https://www.yoctoproject.org/docs/archived-documents/|official documentation]].
+</callout>
+===== Prerequisites  =====
+<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 (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.
+</panel>
+===== Yocto Build instructions =====
+<panel type="primary" title="BSP build instructions">
+<alert type="warning">Please setup the build host as described in the [[.:quickstart_yocto#Prerequisites]] section above .</alert>
+===== 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 https://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>
+</panel>