Embedded module TQMa6x - YOCTO Linux BSP documentation
Preface
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 TQMa6x.
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 Revision | 0118 |
---|---|
meta-tq release | zeus.TQMa6x.BSP.SW.0118 |
Yocto Project / Poky Release | 3.0.3 |
Target machine1) | tqma6s-mba6x tqma6dl-mba6x tqma6q-mba6x tqma6qp-mba6x |
U-Boot | 2016.03 (NXP imx-rel_imx_4.1.15_2.0.0_ga) |
Linux Kernel | 5.4.23 5.4.23 + rt23 fslc-5.4-1.0.0-imx |
For further details regarding Yocto Project 3.0.3 - Zeus please refer to its official documentation.
Prerequisites
Build Host
Yocto Project / Poky requires a Linux build host, so first of all you need a development workstation (or a virtual machine2)) with a Linux distribution installed.
Please refer to section Compatible Linux Distribution of the Yocto Project Quick Start for supported linux distributions and section 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 Build instructions
BSP build instructions
1. Create a local copy of ci-meta-tq
$ git clone --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git
2. Checkout BSP release on new local branch.
$ cd ci-meta-tq
$ git checkout zeus.TQMa6x.BSP.SW.0118 -b zeus
3. Update git submodules:
$ git submodule update --init $ git submodule sync
4. Setup local branch to track the remote branch.
git branch -u origin/zeus
5. Initialize the build environment:
$ source setup-environment tqma6x_build imx
6. Configure the Build for a specific Linux kernel3):
Configuration for NXP Linux kernel
Configuration for Linux mainline kernel
Configuration for Linux RT kernel
7. Build an Image for STKa6x:
$ bitbake tq-image-weston
The resulting image is tmp/deploy/images/tqma6q-mba6x4)/tq-image-weston-tqma6q-mba6x5).wic
8. Write the Image6)7)
$ sudo dd if=tmp/deploy/images/tqma6q-mba6x/tq-image-weston-tqma6q-mba6x.wic of=TARGET_DEVICE
9. Boot the STKa6x from SD card (cf. MBa6x DIP switch settings)