iMX93 Industrial Yocto Image Building

This Wiki page guides through the process of downloading the Yocto Project source files for release 5.0 (scarthgap), their synchronization and building images for the iMX93 Industrial Development Kit.

Before images can be built, necessary steps need to be performed to setup the host machine.

All the source files for this customized Yocto Project, together with the recent changes made, can be inspected and downloaded at the Voipac GitHub repository.

Cloning the project

Create a new directory for the project environment:

mkdir ~/voipac-yocto
cd ~/voipac-yocto

Clone the iMX93 Industrial Yocto Project into the host machine:

git clone https://github.com/voipac/yocto-imx-voipac.git
git checkout -b imx93 origin/imx9x-scarthgap

Building the image

Voipac provides quick and simple-to-use option how to build an image by using prepared script:

This script automatically updates the latest meta layers. These layers include config files describing where all the sources are located. Afterwards all the directories are synchronized.

The script can be run to fetch and build the Yocto images by simply calling its filename:

./build_image.sh [lite|basic|pro|max]

Note: The first successful build can take several hours (depending on multiple factors affecting the host machine like CPU, internet bandwidth, allocated disk space, etc.).

Locating output files

After the compiling process was completed, the freshly built output files are located in the directory:

cd ~/voipac-yocto/yocto-imx-voipac/build-voipac/tmp/deploy/images

This directory also include binaries to be flashed into the development kit. To make them more accessible, the files can be copied and unpacked:

cp -prv voipac-image-imx93-voipac-20230512212054.rootfs.wic.zst ~/voipac-image-imx8mq-voipac.wic.zst

Note: The number string (e.g. 20230512212054) in the filename differs between every build as it displays the timestamp of the compilation.

Flashing the binaries

At this point everything was prepared to flash the binaries. Follow the flashing procedure instructions to start the development kit with the compiled images.