~~NOCACHE~~
<embed en:templates:tabs_sbc_yocto>
  <label product_type>Embedded Single Board Computer</label>
  <label lang>en</label>
  <label mod_name>tqmls1012al</label>
  <label sbc_name>mbls1012al</label>
  <label mod_name_head>TQMLS1012AL</label>
  <label mod_arch>arm</label>
  <label bsp_name>linux</label>
  <label bsp_name_head>Linux</label>
  <label build_system>yocto</label>
  <label build_system_head>Yocto</label>
</embed>
\\  
\\
<WRAP round important>WORK IN PROGRESS</WRAP>  
===== Preface =====
<WRAP info round>
The instructions on this page have been tested on Ubuntu 16.04 64-bit in a VMWare virtual machine.
</WRAP>
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]]++  |  [[https://github.com/tq-systems/ci-meta-tq/tree/sumo-tqmls1012al]]  |
^ Yocto Project / Poky Release  |  2.5 - Sumo  | 
^ Target machine((i.e. value for [[https://www.yoctoproject.org/docs/2.5/ref-manual/ref-manual.html#var-MACHINE|MACHINE]] variable))  |  tqmls1012al-mbls1012al  | 
^ U-Boot  |  2017.11 - LSDK-18.03  |
^ Linux Kernel  |  4.14 - LSDK-18.03  |

\\
<WRAP important round>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).</WRAP>

<WRAP info round>
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 [[https://www.yoctoproject.org/docs/2.5/yocto-project-qs/yocto-project-qs.html|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 [[https://www.yoctoproject.org/documentation/archived|official documentation]].
</WRAP>

===== 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 [[https://www.yoctoproject.org/docs/2.5/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 [[https://www.yoctoproject.org/docs/2.5/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 [[https://www.yoctoproject.org/docs/2.5/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 TQMLS102AL.

^ Section  ^ Remarks / Instructions for //ci-meta-tq// & MBLS1012AL ^
| [[https://www.yoctoproject.org/docs/2.5/yocto-project-qs/yocto-project-qs.html#welcome|Welcome!]]  | <wrap info round>Introduction and basic information about the //Yocto Project//</wrap>  |
| [[https://www.yoctoproject.org/docs/2.5/yocto-project-qs/yocto-project-qs.html#yp-intro|Introducing the Yocto Project Development Environment]]  | :::  |
| [[https://www.yoctoproject.org/docs/2.5/yocto-project-qs/yocto-project-qs.html#yp-resources|Setting Up to Use the Yocto Project]]  | <wrap info round>Description of basic requirements for using the //Yocto Project// (also cf. [[en:arm:tqma8xx:linux:yocto:quickstart_yocto#Prerequisites]] above)</wrap>  |
| [[https://www.yoctoproject.org/docs/2.5/yocto-project-qs/yocto-project-qs.html#qs-building-images|Building Images]]  | <WRAP info round>
This section provides step-by-step instructions for Building an Image for MBLS1012AL
</WRAP><WRAP important round>
To sucessfully build an image for hardware you have to carry out steps from both subsections((subsection headings may be missing in //Yocto Project Quick Start// (depends on //Poky// version) )) as follows.</WRAP><WRAP block>
==== Building an Image for Hardware ====
1. Create a Local Copy of the //ci-meta-tq// Repository:
<code>
$ git clone --branch=sumo-tqmls1012al --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git
</code>
2. Configure the Build:
<code>
$ cd ci-meta-tq
$ source source setup-environment mbls1012al network
$ echo 'MACHINE = "tqmls1012al-mbls1012al"' >> conf/local.conf
</code>
3. Build an Image for MBLS1012AL:
<code>
$ bitbake tq-image-generic
</code>
<wrap help round center 80%>The resulting image is ''tmp/deploy/images/tqmls1012al-mbls1012al/tq-image-generic-tqmls1012al-mbls1012al.wic''</wrap>\\ 
4. Write the Image((''TARGET_DEVICE'' has to be an SD card))
<code>
$ sudo dd if=tmp/deploy/images/tqmls1012al-mbls1012al/tq-image-generic-tqmls1012al-mbls1012al.wic of=TARGET_DEVICE
</code>
5. Boot the MBLS1012AL from SD card (cf. [[en:arm:tqma1012al:mbls1012al:dip_switches|MBLS1012AL DIP switch settings]])
</WRAP>  |