| Next revision | Previous revision Next revisionBoth sides next revision |
| en:arm:tqma8xxs:linux:yocto:quickstart_yocto [2019/01/15 15:37] – created liedmann | en:arm:tqma8xxs:linux:yocto:quickstart_yocto [2019/07/11 15:18] – liedmann |
|---|
| \\ | \\ |
| <WRAP round important>WORK IN PROGRESS</WRAP> | <WRAP round important>WORK IN PROGRESS</WRAP> |
| ===== Preface ===== | <embed :en:templates:ci-meta-tq_qs_new_yocto_version_sumo_tqma8x> |
| <WRAP info round> | |
| The instructions on this page have been tested on Ubuntu 16.04 64-bit in a VMWare virtual machine. | |
| </WRAP> | |
| 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 TQMa8XxS. | |
| |
| The instructions on this page refer to the BSP and ancillary tools listed in the following table: | <label stk_name>STKa8XxS</label> |
| | <label mod_name>TQMa8XxS</label> |
| | <label mod_name_code>tqma8xxs</label> |
| | <label mod_name_mtq>TQMa8</label> |
| | <label mb_name>MBa8xxS</label> |
| | <label mb_name_code>mba8xxs</label> |
| |
| ^ BSP Revision ^ 0001 ^ | <label bsp_rev>0007</label> |
| ^ ++ci-meta-tq release|\\ [[https://github.com/tq-systems/ci-meta-tq]]++ | [[https://github.com/tq-systems/ci-meta-tq/tree/rocko-tqma8x]] | | <label uboot_version>v2018.03 rel_imx_4.14.78_1.0.0_ga</label> |
| ^ Yocto Project / Poky Release | 2.4.4 - Rocko | | <label linux_kernel>rel_imx_4.14.78_1.0.0_ga</label> |
| ^ Target machine((i.e. value for [[https://www.yoctoproject.org/docs/2.4.4/ref-manual/ref-manual.html#var-MACHINE|MACHINE]] variable)) | tqma8qxs-mb-smarc-2 | | |
| ^ U-Boot | 2017.03 | | |
| ^ Linux Kernel | 4.9.88 | | |
| |
| \\ | |
| <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> | <label mtq_machine_default>tqma8xxs-mba8xxs</label> |
| The goal of these wiki pages is to get you started using //meta-tq// with the STKa8XxS , so instead of reinventing the wheel we will adhere to the very compact [[https://www.yoctoproject.org/docs/2.4.4/yocto-project-qs/yocto-project-qs.html|Yocto Project Quick Start]] and supply details specific to the STKa8XxS where necessary.\\ | <label mtq_repos>//ci-meta-tq//</label> |
| \\ | |
| For further details regarding //Yocto Project// 2.4.4 - Rocko please refer to its [[https://www.yoctoproject.org/documentation/archived|official documentation]]. | |
| </WRAP> | |
| |
| ===== Prerequisites ===== | <label yocto_rel_name>Sumo</label> |
| | <label yocto_rel_ver_major>2.5</label> |
| | <label yocto_rel_ver_minor>2</label> |
| | <label yocto_rel_branch>sumo</label> |
| | <label yocto_rel_branch_module>-tqma8x</label> |
| | <label yocto_rel_base_url>downloads.yoctoproject.org/releases/yocto</label> |
| | <label yocto_rel_tarball>poky-sumo-19.0.0.tar.bz2</label> |
| | <label yocto_doc_base_url>www.yoctoproject.org/docs</label> |
| |
| //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. | <label mtq_image>tq-image-qt5</label> |
| | <label mtq_machines> ++ tqma8xqs-mb-smarc-2 | TQMa8XQS on MB-SMARC2 ++ \\\ ++ tqma8xds-mb-smarc-2 | TQMa8XDS on MB-SMARC2 ++</label> |
| | <label mtq_machine_default>tqma8xqps-mb-smarc-2</label> |
| | <label mtq_repos>//ci-meta-tq//</label> |
| |
| Please refer to section [[https://www.yoctoproject.org/docs/2.4.4/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.4.4/yocto-project-qs/yocto-project-qs.html#packages|The Build Host Packages]] for required build host packages for those distributions. | <label host_os_name>Ubuntu</label> |
| | <label host_os_version>16.04</label> |
| | <label host_os_bits>64 bit</label> |
| |
| 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. | </embed> |
| | |
| ===== Yocto Project / Poky set-up ===== | |
| | |
| The [[https://www.yoctoproject.org/docs/2.4.4/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 STKa8XxS. | |
| | |
| ^ Section ^ Remarks / Instructions for //ci-meta-tq// & STKa8XxS ^ | |
| | [[https://www.yoctoproject.org/docs/2.4.4/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.4.4/yocto-project-qs/yocto-project-qs.html#yp-intro|Introducing the Yocto Project Development Environment]] | ::: | | |
| | [[https://www.yoctoproject.org/docs/2.4.4/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.4.4/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 STKa8XxS. | |
| </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=rocko-tqma8x --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git | |
| </code> | |
| 2. Configure the Build: | |
| <code> | |
| $ cd ci-meta-tq | |
| $ source fsl-setup-release.sh -b tqma8xxs_build -e wayland | |
| $ echo 'MACHINE = "tqma8qxs-mb-smarc-2"' >> conf/local.conf | |
| </code> | |
| 3. Build an Image for STKa8XxS: | |
| <code> | |
| $ bitbake tq-image-qt5 | |
| </code> | |
| <wrap help round center 80%>The resulting image is ''tmp/deploy/images/tqma8qxs-mb-smarc-2/tq-image-qt5-tqma8qxs-mb-smarc-2.wic''</wrap>\\ | |
| 4. Write the Image((''TARGET_DEVICE'' has to be an SD card)) | |
| <code> | |
| $ sudo dd if=tmp/deploy/images/tqma8qxs-mb-smarc-2/tq-image-qt5-tqma8qxs-mb-smarc-2.wic of=TARGET_DEVICE | |
| </code> | |
| 5. Boot the STKa8XxS from SD card (cf. [[en:arm:tqma8xxs:mb-smarc-2:dip_switches|MB-SMARC-2 DIP switch settings]]) | |
| </WRAP> | | |