Cherry Theobroma PX30-mQ7 User Manual page 29

user and also allows to easily build for multiple machines without modifying a file in-between.
The build process can take several hours depending on the capabilities of the build machine and the user's Internet connection.
Note: If the Bitbake process needs to be stopped for any reason, a SIGINT ( Ctrl + c ) signal can be sent once. Bitbake will
gracefully close down upon reception of this signal. This graceful shutdown can take a lot of time depending on the tasks that
are currently being executed. It is highly recommended to not send this signal more than once, failing to do so may hinder
next Bitbake commands.
The artefacts can be found after some time in build/tmp/deploy/images/ringneck-haikou/ directory. A flashable
image is one whose extension is .wic , e.g. core-image-minimal-ringneck-haikou-20221021134027.rootfs.wic .
Make the resulting image available for later steps:
export SDCARD_IMG=$PWD/build/tmp/deploy/images/ringneck-haikou/core-image-minimal-ringneck-haikou.
rootfs.wic
6.2.4 Flashing an SD card with bmaptool
To flash the image on an SD card, bmaptool can be used, it is both faster and safer than a traditional dd as used in Section 7.1
Deploy on SD Card. For that, the .wic.bmap companion file, built by the Yocto Project and found in the same directory as
the .wic artefact, should be in the same directory as the .wic artefact. Then run the following command, with /dev/sdX
replaced by the block device representing the user's SD card:
sudo bmaptool copy core-image-minimal-ringneck-haikou-20221021134027.rootfs.wic /dev/sdX
6.2.5 Building with kas
kas is a setup tool for Bitbake-based projects, such as the Yocto Project, which aims to replace the commands listed above for
a simpler, more automated, setup and creation of images.
Theobroma Systems provides a kas configuration file kas-theobroma.yml in the BSP meta layer for convenience.
kas can be installed on the build machine with the following command:
sudo apt-get install -y --no-install-recommends kas
Note: It is also available as a Python package and installable with:
python3 -m pip install --user kas
The Section 6.2.1 Initial setup and Section 6.2.2 Initializing build environment can then be replaced by the following two com-
mands:
git clone https://git.theobroma-systems.com/yocto-layers/meta-theobroma-systems-bsp.git -b kirkstone
kas checkout meta-theobroma-systems-bsp/kas-theobroma.yml
The Section 6.2.3 Building a minimal image can now be replaced with:
KAS_MACHINE="ringneck-haikou"
Note: kas is also available in an OCI container form on GitHub container registry. Theobroma Systems uses this container
for automated building of images within Jenkins. It is started the following way:
podman run --userns=keep-id -e USER_ID=$(id -u) -e GROUP_ID=$(id -g) --tmpfs /tmp ghcr.io/siemens/kas/
kas:3.1
PX30-uQ7 User Manual
© Theobroma Systems Design und Consulting GmbH
kas build meta-theobroma-systems-bsp/kas-theobroma.yml
v1.2.0-1-g5ccabb6
Page 25