| Both sides previous revision Previous revision Next revision | Previous revision |
| en:arm:tqma8xx:linux:yocto:quickstart_yocto [2019/01/15 11:24] – added content liedmann | en:arm:tqma8xx:linux:yocto:quickstart_yocto [2023/09/12 10:27] (current) – updated rudolphr |
|---|
| <WRAP round important>WORK IN PROGRESS</WRAP> | <embed en:templates:tabs_yocto_bootstrap> |
| <embed en:templates:tabs_yocto> | |
| <label product_type>Embedded module</label> | <label product_type>Embedded module</label> |
| <label lang>en</label> | <label lang>en</label> |
| </embed> | </embed> |
| \\ | \\ |
| \\ | <embed en/templates/ci-meta-tq_qs_yocto-kirkstone> |
| ===== 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 //meta-tq// layer extends the //Yocto Project's// reference system //Poky// to provide support for a selection of TQ Embedded CPU Modules, including the TQMa8Xx. | |
| |
| The instructions on this page refer to the BSP and ancillary tools listed in the following table: | <label lang>en</label> |
| | <label mod_arch>arm</label> |
| |
| ^ BSP Revision ^ 0001 ^ | <label stk_name>STKa8Xx</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 mod_name>TQMa8Xx</label> |
| ^ Yocto Project / Poky Release | 2.4.4 - Rocko | | <label mod_name_code>tqma8xx</label> |
| ^ Target machine((i.e. value for [[https://www.yoctoproject.org/docs/2.4.4/ref-manual/ref-manual.html#var-MACHINE|MACHINE]] variable)) | tqma8qx-mba8qx | | <label mod_name_mtq>TQMa8</label> |
| ^ U-Boot | 2017.03 | | <label mb_name>MBa8Xx</label> |
| ^ Linux Kernel | 4.9.88 | | <label mb_name_code>mba8xx</label> |
| |
| \\ | <label bsp_rev>0092</label> |
| <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> | <label bsp_notation>BSP.SW</label> |
| | <label uboot_version>[[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/kirkstone.TQMa8.BSP.SW.0092|v2020.04_imx_5.4.47_2.2.0]]</label> |
| | <label linux_kernel>[[https://github.com/tq-systems/linux-tqmaxx/releases/tag/kirkstone.TQMa8.BSP.SW.0092|fslc-5.15-2.0.x-imx]]</label> |
| |
| <WRAP info round> | <label mtq_image>tq-image-weston</label> |
| The goal of these wiki pages is to get you started using //meta-tq// with the STKa8Xx , 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 STKa8Xx where necessary.\\ | <label mtq_machines> ++tqma8xqp-2gb-mba8xx|TQMa8QXP with 2 GB RAM (DDR3) on MBa8Xx++\\\ ++tqma8xqp-1gb-mba8xx|TQMa8QXP with 1 GB RAM (DDR3) on MBa8Xx++\\\ ++tqma8xdp-1gb-mba8xx|TQMa8XDP with 1GB RAM (DDR3) on MBa8Xx++\\\ ++tqma8xqp4-mba8xx|TQMa8XQP4 with 2GB RAM (LPDDR4) on MBa8Xx++ </label> |
| \\ | <label mtq_machine_default>tqma8xqp-1gb-mba8xx</label> |
| For further details regarding //Yocto Project// 2.4.4 - Rocko please refer to its [[https://www.yoctoproject.org/documentation/archived|official documentation]]. | <label mtq_repos>//ci-meta-tq//</label> |
| </WRAP> | |
| |
| ===== Prerequisites ===== | <label yocto_rel_name>Kirkstone</label> |
| | <label yocto_rel_ver_major>4.0</label> |
| | <label yocto_rel_ver_minor>11</label> |
| | <label yocto_rel_branch>kirkstone</label> |
| | <label yocto_rel_branch_module>TQMa8</label> |
| | <label yocto_rel_base_url>downloads.yoctoproject.org/releases/yocto</label> |
| | <label yocto_rel_tarball>poky-a361fb3df9c87cf12963a9d785a9f99faa839222.tar.bz2</label> |
| | <label yocto_doc_base_url>www.yoctoproject.org/docs</label> |
| | <label yocto_rel_branch_rev>0092</label> |
| | <label yocto_local_branch_name>kirkstone-tqma8xx</label> |
| | <label yocto_remote_branch_name>kirkstone</label> |
| | <label ci_mtq_build_cfg>imx</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 host_os_name>Ubuntu</label> |
| | <label host_os_version>20.04</label> |
| | <label host_os_bits>64 bit</label> |
| | |
| | <label distro_env>dumpling-wayland-nxp</label> |
| | <label machine_env>tqma8xqp-1gb-mba8xx</label> |
| | |
| | <label yocto_zeus_rel_branch>zeus</label> |
| | <label yocto_zeus_rel_branch_module>TQMa8Xx</label> |
| | <label yocto_zeus_rel_branch_rev>0055</label> |
| | <label yocto_zeus_local_branch_name>zeus-tqma8xx</label> |
| | <label yocto_zeus_remote_branch_name>zeus-tqma8</label> |
| | <label mtq_machine_default_zeus>tqma8xqp-1gb-mba8xx</label> |
| | <label mtq_machines_zeus>++tqma8xqp-2gb-mba8xx|TQMa8QXP with 2 GB RAM (DDR3) on MBa8Xx++\\\ ++tqma8xqp-1gb-mba8xx|TQMa8QXP with 1 GB RAM (DDR3) on MBa8Xx++\\\ ++tqma8xdp-1gb-mba8xx|TQMa8XDP with 1GB RAM (DDR3) on MBa8Xx++\\\ ++tqma8xqp4-mba8xx|TQMa8XQP4 with 2GB RAM (LPDDR4) on MBa8Xx++\\\ ++tqma8xdp4-mba8xx|TQMa8XDP4 with 2GB RAM (LPDDR4) on MBa8Xx++</label> |
| | <label mtq_image_zeus>tq-image-weston</label> |
| |
| Please refer to section [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/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 [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/yocto-project-qs/yocto-project-qs.html#packages|The Build Host Packages]] for required build host packages for those distributions. | |
| | </embed> |
| 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.4.4/yocto-project-qs/yocto-project-qs|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 STKa8Xx. | |
| | |
| ^ Section ^ Remarks / Instructions for //ci-meta-tq// & STKa8Xx ^ | |
| | [[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 STKa8Xx | |
| </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> | |
| $ cd $HOME/poky | |
| $ git clone --branch=rocko-tqma8x --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git | |
| </code> | |
| 2. Configure the Build: | |
| <code> | |
| $ source fsl-setup-release.sh -b tqma8xx_build -e wayland | |
| $ echo 'MACHINE = "tqma8qx-mba8qx"' >> conf/local.conf | |
| </code> | |
| 3. Build an Image for STKa8Xx: | |
| <code> | |
| $ bitbake tq-image-qt5 | |
| </code> | |
| <wrap help round center 80%>The resulting image is ''tmp/deploy/images/tqma8qx-mba8qx/tq-image-qt5-tqma8qx-mba8qx.wic''</wrap>\\ | |
| 4. Write the Image((''TARGET_DEVICE'' has to be an SD card)) | |
| <code> | |
| $ sudo dd if=tmp/deploy/images/<label mod_name_code>MOD_NAME_CODE</label>-<label mb_name_code>MB_NAME_CODE</label>/tq-image-qt5-tqma8qx-mba8qx.wic of=TARGET_DEVICE | |
| </code> | |
| 5. Boot the STKa8Xx from SD card (cf. [[en:arm:tqma8xx:mba8xx:dip_switches|MBa8Xx DIP switche settings]]) | |
| </WRAP> | | |