Eigenes Template “tabs_yocto” erstellen
Eigenes Template “yocto_quickstart” erstellen
Platzhalter für modulspezifische Daten einfügen
meta-tq Quick Start Guide
Preface
The instructions on this page have been tested on Ubuntu @ubuntu_version@ (64 bit) 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 TQMLS102xA.
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.
The instructions on this page refer to the BSP and ancillary tools listed in the following table:
| BSP Revision1) | 0102 |
|---|---|
| meta-tq release | TQMLS102xa.BSP.SW.20170728 |
| Yocto Project / Poky Release | Morty 2.2.1 |
| MACHINE | tqmls102xa-mbls102xa@mod_name_code@-@mb_name_code@ |
| U-Boot | 2016.05@uboot_version@ |
| Linux Kernel | 4.4@linux_kernel@ |
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).
The goal of these wiki pages is to get you started using meta-tq with the STKLS102xA, so instead of reinventing the wheel we will adhere to the very compact Yocto Project Quick Start and supply details specific to the STKLS102xA where necessary.
For further details regarding Yocto Project please refer to the documentation at their website.
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 set-up
To set up Yocto Project please follow the instructions in Yocto Project Quick Start while paying attention to the following table, which provides details specific to meta-tq for the STKLS102xA.
| Section | Remarks / Instructions for meta-tq & STKLS102xA |
|---|---|
| Welcome! | |
| Introducing the Yocto Project Development Environment | |
| Setting Up to Use the Yocto Project | |
| Yocto Project Release | Caveat:$ git checkout morty
will not work unless you change into the $ git clone -b morty git://git.yoctoproject.org/poky.git |
| Building Images | Important: Make sure you initialize your build environment (step #3), this is required for the subsequent steps. You can skip steps # 5-7 in subsection Building an Image for Emulation (these are not required for meta-tq). |
| Building an Image for Hardware | 1. Create a Local Copy of the meta-tq Repository:$ cd $HOME/poky $ git clone -b morty https://github.com/tq-systems/meta-tq.git 2. Configure the Build: $ cd $HOME/poky/build $ bitbake-layers add-layer "../meta-tq" $ echo 'MACHINE = "tqmls102xa-mbls102xa"' >> conf/local.conf 3. Build an Image for STKLS102xA: $ bitbake core-image-minimal
The resulting image is $ sudo dd if=tmp/deploy/images/tqmls102xa-mbls102xa/core-image-minimal.wic of=TARGET_DEVICE |
TQ-Systems GmbH provides the Board Support Packages (BSP) free of charge. The software included in the shipment has been configured individually for the starter kits. The software is only intended to evaluate the module. The use of the Board Support Packages (BSP) is only allowed within the scope of functionality described by TQ-Systems GmbH. TQ-Systems GmbH does not accept any liability for all further changes of the Board Support Package and for any damage resulting from its use.