Building A Yocto Image; Prerequisites; Bsp Meta Layer - Cherry Theobroma PX30-mQ7 User Manual

6 Building a Yocto image

The Yocto Project is an open-source project that helps building Linux-based distributions, mainly for embededded products.
Theobroma Systems provides a minimal BSP layer to allow building Yocto images for the company's modules. Upon request,
access can be given to a more featureful "demonstration" layer which provides hardware and software validation scripts as well
as demo applications.
This user guide does not aim at getting the user familiar with development with the Yocto Project but rather help them setup
their build environment to create a basic Yocto image that can be used on one of Theobroma Systems's modules.
The Yocto project provides an open source Linux build framework, which allows to create customized build environments for
embedded systems.
Yocto consists of the following parts:
• The Yocto Project tools,
• Reference Linux distribution (Poky),
• Build system (co-maintained with OpenEmbedded),
There exists extensive documentation for the Yocto Project and BitBake.
The Yocto Project releases a new version twice a year and some versions are maintained for a longer time when marked as
LTS (Long-Term Support). Such is the case of Kirkstone (4.0), supported until at least April 2024. Theobroma Systems highly
recommend to use LTS versions and update to a newer version once its support has reached end-of-life, to benefit from bug
fixes, security fixes, miscellaneous improvements and additional features.

6.1 Prerequisites

While the Yocto Project supports mainy different build systems, Theobroma Systems currently only tests building on Debian
11 (Bullseye).
The required packages for Debian are listed in the documentation and can be installed with the following command:
sudo apt-get install -y --no-install-recommends gawk wget git diffstat unzip
texinfo gcc build-essential chrpath socat cpio python3 python3-pip
python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2
libegl1-mesa libsdl1.2-dev xterm python3-subunit mesa-common-dev zstd
liblz4-tool file

6.2 BSP meta layer

The Yocto Project BSP
meta-theobroma-systems-bsp.git/.
It contains the minimal configuration and recipe append files (bbappend) necessary to build a minimal working image. It is
meant to be a base upon which to build and thus many tools are purposefully missing.
6.2.1 Initial setup
Clone the BSP meta layer and its dependencies from a new directory called yocto :
git clone https://git.theobroma-systems.com/yocto-layers/meta-theobroma-systems-bsp.git -b kirkstone
git clone https://git.yoctoproject.org/poky -b kirkstone-4.0.7
git clone https://git.yoctoproject.org/meta-arm -b yocto-4.0.1
git clone https://git.yoctoproject.org/meta-rockchip -b kirkstone
git clone https://git.openembedded.org/meta-openembedded -b kirkstone
The following directory layout should be observed:
PX30-uQ7 User Manual
© Theobroma Systems Design und Consulting GmbH
meta layer can be found
\
\
\
\
at https://git.theobroma-systems.com/yocto-layers/
v1.2.0-1-g5ccabb6
Page 23