Next revision | Previous revision Next revisionBoth sides next revision |
en:arm:tqma8xx:linux:yocto:quickstart_yocto [2019/01/14 10:53] – created liedmann | en:arm:tqma8xx:linux:yocto:quickstart_yocto [2019/01/15 15:35] – liedmann |
---|
<WRAP round important>WORK IN PROGRESS</WRAP> | |
<embed en:templates:tabs_yocto> | <embed en:templates:tabs_yocto> |
<label product_type>Embedded module</label> | <label product_type>Embedded module</label> |
\\ | \\ |
\\ | \\ |
| <WRAP round important>WORK IN PROGRESS</WRAP> |
| ===== Preface ===== |
| <WRAP info round> |
| The instructions on this page have been tested on Ubuntu 16.04 64-bit in a VMWare virtual machine. |
| </WRAP> |
| The //meta-tq// layer extends the //Yocto Project's// reference system //Poky// to provide support for a selection of TQ Embedded CPU Modules, including the TQMa8Xx. |
| |
| The instructions on this page refer to the BSP and ancillary tools listed in the following table: |
| |
| ^ BSP Revision ^ 0001 ^ |
| ^ ++ci-meta-tq release|\\ [[https://github.com/tq-systems/ci-meta-tq]]++ | [[https://github.com/tq-systems/ci-meta-tq/tree/rocko-tqma8x]] | |
| ^ Yocto Project / Poky Release | 2.4.4 - Rocko | |
| ^ Target machine((i.e. value for [[https://www.yoctoproject.org/docs/2.4.4/ref-manual/ref-manual.html#var-MACHINE|MACHINE]] variable)) | tqma8qx-mba8qx | |
| ^ U-Boot | 2017.03 | |
| ^ Linux Kernel | 4.9.88 | |
| |
| \\ |
| <WRAP important round>It's strongly recommended to use **git** for downloading both the //Yocto Project / Poky// Release as well as //meta-tq// (instead of downloading archives and extracting them).</WRAP> |
| |
| <WRAP info round> |
| The goal of these wiki pages is to get you started using //meta-tq// with the STKa8Xx , so instead of reinventing the wheel we will adhere to the very compact [[https://www.yoctoproject.org/docs/2.4.4/yocto-project-qs/yocto-project-qs.html|Yocto Project Quick Start]] and supply details specific to the STKa8Xx where necessary.\\ |
| \\ |
| For further details regarding //Yocto Project// 2.4.4 - Rocko please refer to its [[https://www.yoctoproject.org/documentation/archived|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.4.4/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.4.4/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.4.4/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 table describes how to use the //ci-meta-tq// layer for the STKa8Xx. |
| |
| ^ Section ^ Remarks / Instructions for //ci-meta-tq// & STKa8Xx ^ |
| | [[https://www.yoctoproject.org/docs/2.4.4/yocto-project-qs/yocto-project-qs.html#welcome|Welcome!]] | <wrap info round>Introduction and basic information about the //Yocto Project//</wrap> | |
| | [[https://www.yoctoproject.org/docs/2.4.4/yocto-project-qs/yocto-project-qs.html#yp-intro|Introducing the Yocto Project Development Environment]] | ::: | |
| | [[https://www.yoctoproject.org/docs/2.4.4/yocto-project-qs/yocto-project-qs.html#yp-resources|Setting Up to Use the Yocto Project]] | <wrap info round>Description of basic requirements for using the //Yocto Project// (also cf. [[en:arm:tqma8xx:linux:yocto:quickstart_yocto#Prerequisites]] above)</wrap> | |
| | [[https://www.yoctoproject.org/docs/2.4.4/yocto-project-qs/yocto-project-qs.html#qs-building-images|Building Images]] | <WRAP info round> |
| This section provides step-by-step instructions for Building an Image for STKa8Xx |
| </WRAP><WRAP important round> |
| To sucessfully build an image for hardware you have to carry out steps from both subsections((subsection headings may be missing in //Yocto Project Quick Start// (depends on //Poky// version) )) as follows.</WRAP><WRAP block> |
| ==== Building an Image for Hardware ==== |
| 1. Create a Local Copy of the //ci-meta-tq// Repository: |
| <code> |
| $ git clone --branch=rocko-tqma8x --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git |
| </code> |
| 2. Configure the Build: |
| <code> |
| $ cd ci-meta-tq |
| $ source fsl-setup-release.sh -b tqma8xx_build -e wayland |
| $ echo 'MACHINE = "tqma8qx-mba8qx"' >> conf/local.conf |
| </code> |
| 3. Build an Image for STKa8Xx: |
| <code> |
| $ bitbake tq-image-qt5 |
| </code> |
| <wrap help round center 80%>The resulting image is ''tmp/deploy/images/tqma8qx-mba8qx/tq-image-qt5-tqma8qx-mba8qx.wic''</wrap>\\ |
| 4. Write the Image((''TARGET_DEVICE'' has to be an SD card)) |
| <code> |
| $ sudo dd if=tmp/deploy/images/tqma8qx-mba8x/tq-image-qt5-tqma8qx-mba8qx.wic of=TARGET_DEVICE |
| </code> |
| 5. Boot the STKa8Xx from SD card (cf. [[en:arm:tqma8xx:mba8xx:dip_switches|MBa8Xx DIP switch settings]]) |
| </WRAP> | |