Preface
The instructions on this page have been tested on HOST_OS_NAME HOST_OS_VERSION (HOST_OS_BITS) in a VMWare virtual machine.
The meta-tq-powerarch layer extends the Yocto Project's reference system Poky to provide support for a selection of TQ Embedded CPU Modules, including the MOD_NAME.
The instructions on this page refer to the BSP and ancillary tools listed in the following table:
BSP Revision | BSP_REV |
---|---|
Yocto Project / Poky Release | <label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label> - <label yocto_rel_name>YOCTO_REL_NAME</label> |
Target machine1) | MTQ_MACHINES |
U-Boot | UBOOT_VERSION |
Linux Kernel | LINUX_KERNEL |
It's strongly recommended to use git for downloading the Yocto Project / Poky Release (instead of downloading an archive and extracting it).
The goal of these wiki pages is to get you started using meta-tq-powerarch with the STK_NAME, so instead of reinventing the wheel we will adhere to the very compact Yocto Project Quick Start and supply details specific to the STK_NAME where necessary.
For further details regarding Yocto Project YOCTO_REL_VER_MAJOR.YOCTO_REL_VER_MINOR - YOCTO_REL_NAME please refer to its official documentation.
Prerequisites
Yocto Project / Poky requires a Linux build host, so first of all you need a development workstation (or a virtual machine2)) with a (preferably) recent Linux distribution installed.
Please refer to section The Linux Distribution of the Yocto Project Quick Start for supported linux distributions and section 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 tftp server (for image download / update) and an nfs server (for network mounted root filesystem) on your development host.
Yocto Project / Poky set-up
The 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 meta-tq-powerarch layer for the STK_NAME.
Section | Remarks / Instructions for meta-tq-powerarch & STK_NAME |
---|---|
Welcome! | Introduction and basic information about the Yocto Project |
Introducing the Yocto Project Development Environment | |
Setting Up to Use the Yocto Project | Description of basic requirements for using the Yocto Project (also cf. Prerequisites above) |
Yocto Project Release | Instructions on how to install a release of the Yocto Project on the Build Host$ git checkout <label yocto_rel_branch>YOCTO_REL_BRANCH</label>
will not work unless you change into the Alternatively you can clone the Poky repository and checkout branch YOCTO_REL_BRANCH in one step by executing $ git clone -b <label yocto_rel_branch>YOCTO_REL_BRANCH</label> git://git.yoctoproject.org/poky.git |
Building Images | This section provides step-by-step instructions for To sucessfully build an image for hardware you have to carry out steps from both subsections5) as follows. Building an Image for Emulation
1. Be sure your build host is set up:
See above $ git checkout <label yocto_rel_branch>YOCTO_REL_BRANCH</label>
You can skip this step if you checked out branch YOCTO_REL_BRANCH already when/after cloning the poky repository. $ cat > environment export TEMPLATECONF=meta-tq-powerarch/conf source poky/oe-init-build-env export BB_ENV_EXTRAWHITE="$BB_ENV_EXTRAWHITE FSL_RCW"
Press CTRL+D to close the file. Building an Image for Hardware1. Create a Local Copy of MTQ_REPOS: $ cd poky $ tar xvf <path>/<to>/<tarball>/<label mtq_tarball>MTQ_TARBALL</label> $ git clone -b <label yocto_rel_branch>YOCTO_REL_BRANCH</label><label yocto_rel_branch_module>YOCTO_REL_BRANCH_MODULE</label> git://git.yoctoproject.org/meta-fsl-ppc 2. Configure the Build: $ cd .. $ . environment
When building for another machine6) make sure that your local.conf contains a valid combination of $ bitbake <label mtq_image>MTQ_IMAGE</label>
The resulting image is $ sudo dd if=tmp/deploy/images/<label mtq_machine_default>MTQ_MACHINE_DEFAULT</label>/<label mtq_image>MTQ_IMAGE</label>-<label mtq_machine_default>MTQ_MACHINE_DEFAULT</label>.wic of=TARGET_DEVICE 5. Boot the STK_NAME from SD card (cf. <label mb_name>MB_NAME</label> DIP switche settings) |
TARGET_DEVICE
has to be an SD card