Building an image

From RidgeRun Developer Wiki





Follow Us On Twitter LinkedIn Email Share this page



Preferred Partner Logo 3



Modify the existing configuration

Since this image is directed to run on a Verdin i.MX95 SOM, we need to modify the configuration accordingly. In build/conf/local.conf, ensure the machine is set to:

MACHINE = "verdin-imx95"

Since Verdin iMX95 is NXP-based, you must accept the Freescale/NXP EULA. Appending this line at the end of the local.conf:

 ACCEPT_FSL_EULA = "1"

If this is not added, the build will fail when building NXP components.

By default, the distribution is usually set automatically (commonly tdx-xwayland). You may override it in local.conf if needed:

 DISTRO ?= "tdx-xwayland"

Available distro variants include:

  • tdx-xwayland – Downstream vendor kernel without PREEMPT_RT
  • tdx-xwayland-rt – Downstream vendor kernel with PREEMPT_RT
  • tdx-xwayland-upstream – Mainline kernel without PREEMPT_RT
  • tdx-xwayland-upstream-rt – Mainline kernel with PREEMPT_RT

For most use cases, the default is sufficient.

Build the Image

Toradex provides two reference image variants for evaluation purposes.

Reference Minimal Image

Image name:

 tdx-reference-minimal-image 

Features:

  • Headless system (no graphical interface)
  • systemd as init system
  • connman network manager
  • Basic command-line package group

Build the image:

cd build 
bitbake tdx-reference-minimal-image

Reference Multimedia Image

Image name:

 tdx-reference-multimedia-image 

Includes everything from the Minimal image, plus:

  • Weston / Wayland + XWayland
  • Qt graphical framework
  • GStreamer multimedia framework
  • V4L2 camera framework
  • Graphical and Qt package groups

Build the image:

cd build 
bitbake -k tdx-reference-multimedia-image

Notes:

  • The first build may take several hours.
  • Subsequent builds are faster due to caching.
  • -k option is used to keep the build process even after a package failed.

Final Result

After a successful build, you should see multiple files in:

 build/deploy/images/verdin-imx95/ 

Among them, the most relevant files for deployment and usage are the following:

Toradex Easy Installer Image (Recommended for eMMC Flashing)

  • Verdin-iMX95_Reference-Minimal-Image-Tezi_<version>.tar
  • Verdin-iMX95_Reference-Minimal-Image-Tezi.tar

This is the image used with Toradex Easy Installer (TEZI).

SD Card Image

  • Verdin-iMX95_Reference-Minimal-Image.wic.gz
  • Verdin-iMX95_Reference-Minimal-Image.wic.bmap

This image is used to boot directly from an SD card.