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 layer extends the Yocto Project's reference system Poky to provide support for a selection of TQ Embedded CPU Modules, including the @mod_name@.

It uses the same codebase as the 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 Revision1) @bsp_rev@
meta-tq release @yocto_rel_branch@.@mod_name_mtq@.BSP.SW.@bsp_rev@
Yocto Project / Poky Release @yocto_rel_ver_major@.@yocto_rel_ver_minor@ - @yocto_rel_name@
Target machine2) @mtq_machines@
U-Boot @uboot_version@
Linux Kernel @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 @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 machine3)) 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 ci-meta-tq layer for the @stk_name@.

Section Remarks / Instructions for ci-meta-tq & @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)
Building Images

This section provides step-by-step instructions for @stk_name@.

Building an Image for Hardware

1. Create a Local Copy of @mtq_repos@ 

$ git clone --branch=@yocto_rel_branch@@yocto_rel_branch_module@ --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git

2. Configure the Build4): 

$ cd ci-meta-tq
$ source fsl-setup-release.sh -b tqma8xx_build -e wayland
$ echo 'MACHINE = "@mtq_machine_default@"' >> conf/local.conf

3. Build an Image for @stk_name@: 

$ bitbake @mtq_image@

The resulting image is tmp/deploy/images/@mtq_machine_default@5)/@mtq_image@-@mtq_machine_default@6).wic
4. Write the Image7)8) 

$ sudo dd if=tmp/deploy/images/@mtq_machine_default@/@mtq_image@-@mtq_machine_default@.wic of=TARGET_DEVICE

5. Boot the @stk_name@ from SD card (cf. @mb_name@ DIP switche settings)

1)
refers to the revision of the PTXdist based TQ Linux BSP, which provides the codebase of U-Boot and Linux kernel
2)
i.e. value for MACHINE variable
3)
for testing purposes Yocto Project provides a ready to use virtual machine called Build Appliance
4) , 5) , 6) , 7)
valid machines are
@mtq_machines@
8)
TARGET_DEVICE has to be an SD card