TQMLS1028A - 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 TQMLS1028A.
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 | 0110 |
|---|---|
| meta-tq release | kirkstone.TQMLS1028A.BSP.SW.0110 |
| Yocto Project / Poky Release | 4.0.18 |
| Target machine1) | tqmls1028a-mbls1028a tqmls1028a-mbls1028a-ind |
| U-Boot | u-boot-2019.10-LSDK-20.04 |
| Linux Kernel | lf-5.15.5-1.0.0 |
For further details regarding Yocto Project 4.0.18 - Kirkstone 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 Supported Linux Distribution of the Yocto Project Quick Start for supported linux distributions and section Required Packages for the Build Host 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 BSP Build Instructions
Yocto BSP
1. Open a new terminal and create a directory for the BSP build e.g. in the home directory and navigate to that directory.
mkdir -p ~/workspace/kirkstone.TQMLS1028A.BSP.SW.0110 cd ~/workspace/kirkstone.TQMLS1028A.BSP.SW.0110
2. Create a local copy of meta-tq
git clone --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git
3. Checkout BSP release on new local branch.
cd ci-meta-tq git checkout kirkstone.TQMLS1028A.BSP.SW.0110 -b kirkstone-tqmls1028a
4. Update git submodules:
git submodule sync git submodule update --init
5. Setup local branch to track the remote branch.
git branch -u origin/kirkstone
6. Export the environment DISTRO and MACHINE3) environment variable:
export DISTRO=dumpling-ls export MACHINE=tqmls1028a-mbls1028a
7. Configure the Build:
source setup-environment tqmls1028a_build ls
source setup-environment tqmls1028a_build
8. Build an Image for STKLS1028A:
Image with debug features/root login
bitbake tq-image-generic-debug
Image with IMAGE_FEATURES debug and debug-tweaks enabled to have an open root login for console and ssh for ease of development and testing.
Image without debug features/root login
bitbake tq-image-generic
Image without IMAGE_FEATURES debug and debug-tweaks enabled. A user login is not allowed with this image, if a login is required, please see poky documentation for extrausers.bbclass
For further information to the TQ image recipes, please refer to the section Image recipes from the meta-dumpling Yocto layer documentation.
meta-dumpling documentation
tmp/deploy/images/tqmls1028a-mbls1028a4)/tq-image-generic-tqmls1028a-mbls1028a5).wicsudo dd if=tmp/deploy/images/tqmls1028a-mbls1028a/tq-image-generic-tqmls1028a-mbls1028a.wic of=/dev/<TARGET_DEVICE>
10. Boot the STKLS1028A from SD card (cf. tqmls1028a DIP switch settings) |