Embedded Single Board Computer TQMLS1012AL - Yocto Linux BSP documentation
WORK IN PROGRESS
Preface
The instructions on this page have been tested on Ubuntu 16.04 64-bit in a VMWare virtual machine.
The ci-meta-tq layer extends the Yocto Project's reference system Poky to provide support for a selection of TQ Embedded CPU Modules, including the MBLS102AL embedded single board computer.
The instructions on this page refer to the BSP and ancillary tools listed in the following table:
| BSP Revision | 0003 |
|---|---|
| ci-meta-tq release | https://github.com/tq-systems/ci-meta-tq/tree/sumo-tqmls1012al |
| Yocto Project / Poky Release | 2.5 - Sumo |
| Target machine1) | tqmls1012al-mbls1012al |
| U-Boot | 2017.11 - LSDK-18.03 |
| Linux Kernel | 4.14 - LSDK-18.03 |
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 MBLS1012AL , so instead of reinventing the wheel we will adhere to the very compact Yocto Project Quick Start and supply details specific to the MBLS1012AL where necessary.
For further details regarding Yocto Project 2.5 - Rocko 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 ci-meta-tq layer for the TQMLS102AL.
| Section | Remarks / Instructions for ci-meta-tq & MBLS1012AL |
|---|---|
| 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 Building an Image for MBLS1012AL To sucessfully build an image for hardware you have to carry out steps from both subsections3) as follows. Building an Image for Hardware1. Create a Local Copy of the ci-meta-tq Repository: $ git clone --branch=sumo-tqmls1012al --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git 2. Configure the Build: $ cd ci-meta-tq $ source source setup-environment mbls1012al network $ echo 'MACHINE = "tqmls1012al-mbls1012al"' >> conf/local.conf 3. Build an Image for MBLS1012AL: $ bitbake tq-image-generic
The resulting image is $ sudo dd if=tmp/deploy/images/tqmls1012al-mbls1012al/tq-image-generic-tqmls1012al-mbls1012al.wic of=TARGET_DEVICE 5. Boot the MBLS1012AL from SD card (cf. MBLS1012AL DIP switch settings) |