===== Preface =====
The instructions on this page have been tested on () in a VMWare virtual machine.
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 .
It uses the same codebase as the [[..:arm::linux:ptxdist:overview|PTXdist based TQ Linux BSPs]] and therefore provides the same versions of U-Boot and Linux kernel, but doesn't define a specific root filesystem configuration.
Please use //ci-meta-tq// instead of //meta-tq// to build this release of the BSP.
The instructions on this page refer to the BSP and ancillary tools listed in the following table:
^ BSP Revision((refers to the revision of the [[..:arm::linux:ptxdist:overview|PTXdist based TQ Linux BSP]], which provides the codebase of U-Boot and Linux kernel)) ^ ^
^ ++meta-tq release|\\ [[https://github.com/tq-systems/ci-meta-tq/releases|all releases]]++ | [[https://github.com/tq-systems/ci-meta-tq/releases/tag/..BSP.SW.|..BSP.SW.]] |
^ Yocto Project / Poky Release | ++. - |\\ ''git clone -b git:%%//%%git.yoctoproject.org%%/%%poky.git''\\ [[http:///yocto-/|]]++ |
^ Target machine((i.e. value for [[http:///./ref-manual/ref-manual.html#var-MACHINE|MACHINE]] variable)) | |
^ U-Boot | |
^ Linux Kernel | |
\\
It's strongly recommended to use **git** for downloading both the //Yocto Project / Poky// Release as well as //ci-meta-tq// (instead of downloading archives and extracting them).
The goal of these wiki pages is to get you started using //ci-meta-tq// with the , so instead of reinventing the wheel we will adhere to the very compact [[http:///./yocto-project-qs/yocto-project-qs.html|Yocto Project Quick Start]] and supply details specific to the where necessary.\\
\\
For further details regarding //Yocto Project// . - please refer to its [[https://www.yoctoproject.org/documentation/archived|official documentation]].
===== 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 [[http:///./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 [[http:///./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 [[http:///./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 .
^ Section ^ Remarks / Instructions for //ci-meta-tq// & ^
| [[http:///./yocto-project-qs/yocto-project-qs.html#welcome|Welcome!]] | Introduction and basic information about the //Yocto Project// |
| [[http:///./yocto-project-qs/yocto-project-qs.html#yp-intro|Introducing the Yocto Project Development Environment]] | ::: |
| [[http:///./yocto-project-qs/yocto-project-qs.html#yp-resources|Setting Up to Use the Yocto Project]] | Description of basic requirements for using the //Yocto Project// (also cf. [[..:arm::linux:yocto:ci-meta-tq_qs#Prerequisites]] above) |
| [[http:///./yocto-project-qs/yocto-project-qs.html#qs-building-images|Building Images]] |
This section provides step-by-step instructions for .
==== Building an Image for Hardware ====
1. Create a Local Copy of
$ git clone --branch= --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git
2. Configure the Build((valid machines are\\ )):
$ cd ci-meta-tq
$ source fsl-setup-release.sh -b tqma8xx_build -e wayland
$ echo 'MACHINE = ""' >> conf/local.conf
3. Build an Image for :
$ bitbake
The resulting image is ''tmp/deploy/images/((valid machines are\\ ))/-((valid machines are\\ )).wic''\\
4. Write the Image((valid machines are\\ ))((''TARGET_DEVICE'' has to be an SD card))
$ sudo dd if=tmp/deploy/images//-.wic of=TARGET_DEVICE
5. Boot the from SD card (cf. [[..:arm:::dip_switches| DIP switche settings]])
|