iMX93 Industrial Yocto Image Building - Revision history

Voipac-sw: /* Building the image */

2025-10-14T06:40:59Z

Building the image

Voipac-sw: /* Locating output files */

2025-01-28T14:45:02Z

Locating output files

Voipac-sw: /* Locating output files */

2025-01-28T14:37:58Z

Locating output files

Voipac-sw: /* Building the image */

2025-01-28T14:37:39Z

Building the image

Voipac-sw at 14:36, 28 January 2025

2025-01-28T14:36:49Z

Voipac-sw: Created page with "Category:iMX93 Industrial Category:iMX93 Industrial Software Category:iMX93 Industrial Yocto Category:Yocto
TOC
Th..."

2025-01-24T09:17:40Z

Created page with "Category:iMX93 Industrial Category:iMX93 Industrial Software Category:iMX93 Industrial Yocto Category:Yocto  <div style="float:right">__TOC__</div> Th..."

New page

[[Category:iMX93 Industrial]]
[[Category:iMX93 Industrial Software]]
[[Category:iMX93 Industrial Yocto]]
[[Category:Yocto]]

<div style="float:right">__TOC__</div>

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

Before images can be built, [[iMX8M Industrial Yocto Prerequisites|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 [https://github.com/voipac Voipac GitHub] repository.

== Cloning the project ==
Create a new directory for the project environment:
<syntaxhighlight lang="bash">
mkdir ~/voipac-yocto
cd ~/voipac-yocto
</syntaxhighlight>

Clone the iMX8M Industrial Yocto Project into the host machine:
<syntaxhighlight lang="bash">
git clone https://github.com/voipac/yocto-imx8m-voipac.git
</syntaxhighlight>

== Building the image ==
Voipac provides quick and simple-to-use option how to build an image by using [https://github.com/voipac/yocto-imx8m-voipac/blob/master/build_image.sh prepared script]:
<syntaxhighlight lang="bash">
#!/bin/bash

set -e

# Copy manifests helper function
copy_manifests() {
rm -rf .repo
mkdir -p .repo/manifests
cp scripts/voipac.xml .repo/manifests/
}

# Fetch the latest meta layers
if ! diff -q .repo/manifests/voipac.xml scripts/voipac.xml >/dev/null 2>&1; then
copy_manifests
repo init -u "$(pwd)"/.repo/repo -b default -m voipac.xml
fi

repo sync --optimized-fetch

MACHINE=imx8mq-voipac DISTRO=fslc-xwayland source ./setup-environment build-voipac
bitbake -f voipac-image
</syntaxhighlight>

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

The second to last '' source'' command defines the machine for which the last command ''bitbake'' compiles and builds output binaries. Besides describing the specifics for iMX8M Industrial Development Kit, '''DISTRO''' provides several graphical interface options:
* '''fsl-imx-wayland''': Wayland/Weston graphics
* '''fsl-imx-xwayland''': Wayland graphics and X11
* '''fsl-imx-fb''': framebuffer graphics (no Wayland or X11)

The script can be run to fetch and build the Yocto images by simply calling its filename:
<syntaxhighlight lang="bash">
./build_image.sh
</syntaxhighlight>

'''''Note:''''' Make sure that the synchronization finished without errors displaying the successful fetching with the following massage:
<syntaxhighlight lang="bash">
repo sync has finished successfully.
</syntaxhighlight>

'''''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:
<syntaxhighlight lang="bash">
cd ~/voipac-yocto/yocto-imx8m-voipac/build-voipac/tmp/deploy/images
</syntaxhighlight>

This directory also include binaries to be flashed into the development kit. To make them more accessible, the files can be copied and unpacked:
<syntaxhighlight lang="bash">
cp -prv imx-boot ~/
cp -prv voipac-image-imx8mq-voipac-20230512212054.rootfs.wic.gz ~/voipac-image-imx8mq-voipac.wic.gz
gzip -d ~/voipac-image-imx8mq-voipac.wic.gz
</syntaxhighlight>
'''''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 [[iMX8M Industrial Flashing Procedure|flashing procedure]] instructions to start the development kit with the compiled images.

@@ Line 35: / Line 35: @@
 The script can be run to fetch and build the Yocto images by simply calling its filename:
 <syntaxhighlight lang="bash">
-./build_image.sh [lite|basic|pro|max]
+./build_image.sh [lite|basic|pro|max] imx93
 </syntaxhighlight>

@@ Line 44: / Line 44: @@
 After the compiling process was completed, the freshly built output files are located in the directory:
 <syntaxhighlight lang="bash">
-cd ~/voipac-yocto/yocto-imx-voipac/build-voipac/tmp/deploy/images
+cd ~/voipac-yocto/yocto-imx-voipac/build/tmp/deploy/images/imx93-voipac
 </syntaxhighlight>
 This directory also include binaries to be flashed into the development kit. To make them more accessible, the files can be copied and unpacked:
 <syntaxhighlight lang="bash">
-cp -prv voipac-image-imx93-voipac-20230512212054.rootfs.wic.zst ~/voipac-image-imx93-voipac.wic.zst
+cp -prv voipac-image-imx93-voipac.rootfs-20250110131518.wic.zst ~/voipac-image-imx93-voipac.wic.zst
 </syntaxhighlight>
-'''''Note:''''' The number string (e.g. ''20230512212054'') in the filename differs between every build as it displays the timestamp of the compilation.
+'''''Note:''''' The number string (e.g. ''20250110131518'') 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 [[iMX93 Industrial Flashing Procedure|flashing procedure]] instructions to start the development kit with the compiled images.

@@ Line 6: / Line 6: @@
 <div style="float:right">__TOC__</div>
-This Wiki page guides through the process of downloading the Yocto Project source files for release 3.1 (dunfell), their synchronization and building images for the iMX8M Industrial Development Kit.
+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, [[iMX8M Industrial Yocto Prerequisites|necessary steps need to be performed]] to setup the host machine.
+Before images can be built, [[iMX93 Industrial Yocto Prerequisites|necessary steps need to be performed]] to setup the host machine.
@@ Line 20: / Line 20: @@
 </syntaxhighlight>
-Clone the iMX8M Industrial Yocto Project into the host machine:
+Clone the iMX93 Industrial Yocto Project into the host machine:
 <syntaxhighlight lang="bash">
-git clone https://github.com/voipac/yocto-imx8m-voipac.git
+git clone https://github.com/voipac/yocto-imx-voipac.git
 </syntaxhighlight>
 == Building the image ==
-Voipac provides quick and simple-to-use option how to build an image by using [https://github.com/voipac/yocto-imx8m-voipac/blob/master/build_image.sh prepared script]:
+Voipac provides quick and simple-to-use option how to build an image by using [https://github.com/voipac/yocto-imx-voipac/blob/imx9x-scarthgap/build_image.sh prepared script]:
-# Fetch the latest meta layers
+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:
 <syntaxhighlight lang="bash">
-./build_image.sh
+./build_image.sh [basic|light|pro|max]
 </syntaxhighlight>
 '''''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.).
@@ Line 75: / Line 44: @@
 After the compiling process was completed, the freshly built output files are located in the directory:
 <syntaxhighlight lang="bash">
-cd ~/voipac-yocto/yocto-imx8m-voipac/build-voipac/tmp/deploy/images
+cd ~/voipac-yocto/yocto-imx-voipac/build-voipac/tmp/deploy/images
 </syntaxhighlight>
 This directory also include binaries to be flashed into the development kit. To make them more accessible, the files can be copied and unpacked:
 <syntaxhighlight lang="bash">
-cp -prv imx-boot ~/
+cp -prv voipac-image-imx93-voipac-20230512212054.rootfs.wic.zst ~/voipac-image-imx8mq-voipac.wic.zst
 </syntaxhighlight>
 '''''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 [[iMX8M Industrial Flashing Procedure|flashing procedure]] instructions to start the development kit with the compiled images.
+At this point everything was prepared to flash the binaries. Follow the [[iMX93 Industrial Flashing Procedure|flashing procedure]] instructions to start the development kit with the compiled images.

iMX93 Industrial Yocto Image Building - Revision history

Voipac-sw: /* Building the image */

Voipac-sw: /* Locating output files */

Voipac-sw: /* Locating output files */

Voipac-sw: /* Building the image */

Voipac-sw at 14:36, 28 January 2025

Voipac-sw: Created page with "Category:iMX93 Industrial Category:iMX93 Industrial Software Category:iMX93 Industrial Yocto Category:Yocto __TOC__ Th..."

Voipac-sw: Created page with "Category:iMX93 Industrial Category:iMX93 Industrial Software Category:iMX93 Industrial Yocto Category:Yocto
TOC
Th..."