Bitbake Setup

We provide a script,, that simplifies the setup for our machines. To use the script, the name of the specific machine to be built for needs to be specified as well as the desired distro. The script sets up a directory and the configuration files for the specified machine and distro. It also adds our layers to the bblayers.conf file.

There are different configurations you can choose from.

  • NXP DISTRO configurations
DISTRO= Description
fsl-imx-wayland Wayland weston graphics
fsl-imx-xwayland Wayland graphics and X11. X11 applications using EGL are not supported
fsl-imx-fb Frame Buffer graphics - no X11 or Wayland. Frame Buffer is not supported on i.MX 8
  • Ka-Ro DISTRO configurations
DISTRO= Description
karo-minimal Ka-Ro Linux Distro with minimal read-only rootfs
karo-wayland Ka-Ro Linux Distro with wayland backend
  • A list of supported MACHINE configurations
MACHINE= Description Supported Baseboards Display Support
qs8m-mq00 QS8M-MQ00 i.MX8M Mini Solder-in Module QSBASE 2 Raspi Display, 10 inch display**
qs8m-nd00 QS8M-MQ00 i.MX8M Nano Solder-in Module QSBASE 2 Raspi Display, 10 inch display**
qsxm-mm60* QSXM-MM60 i.MX8M Mini Solder-in Module QSBASE 3 Raspi Display, 10 inch display**
qsxp-ml81* QSXP-ML81 i.MX8M Plus Solder-in Module QSBASE 3 Raspi Display, 10 inch display**
tx8m-1610 TX8M-1610 i.MX8M Mini CoM MIPI-MB, MB7 10 inch display
tx8m-1620 TX8M-1620 i.MX8M Mini CoM LVDS-MB, MB7 10 inch display
tx8m-nd00 TX8M-ND00 i.MX8M Nano CoM MIPI-MB, MB7 10 inch display
* = Experimental
** = Additional Hardware Required

Use this command to setup your build directory (specify the distro you want to use, the machine, and the build directory):

DISTRO=<distro> MACHINE=<machine> source -b <build-dir>

When the script has run, your current directory changes to the <build-dir> you chose before.


DISTRO=karo-minimal MACHINE=tx8m-1610 source -b build-tx8m-1610

Starting Build


The setup-environment provided by the Zeus release already sets up a SSTATE CACHE to speedup the build process.
For more about sstate caches see Enable sstate cache 1.

Here are the different images you can build:

Image Description DISTRO= (required) Provided by layer
Official Ka-Ro images
karo-image-minimal Ka-Ro Linux BSP with minimal read-only rootfs karo-minimal meta-karo-nxp-distro
karo-image-weston Ka-Ro Linux BSP with wayland backend karo-wayland meta-karo-nxp-distro
Official NXP images
imx-boot U-Boot flashable binaries N/A (any) meta-karo-nxp
linux-imx Linux Kernel, specified .dtb files, Kernel modules N/A (any) meta-karo-nxp
fsl-image-validation-imx Builds an i.MX image with a GUI without any Qt content fsl-imx-(x)wayland meta-fsl-bsp-release
fsl-image-qt5-validation-imx Builds an opensource Qt 5 image. These images are only supported for i.MX SoC with hardware graphics fsl-imx-(x)wayland meta-fsl-bsp-release
fsl-image-qt5 Fsl-image-gui with QT 5.9 fsl-imx-(x)wayland meta-fsl-bsp-release
fsl-image-multimedia Fsl multimedia image fsl-imx-(x)wayland meta-fsl-bsp-release
imx-image-full Full i.MX image with machine learning, camera and QT support fsl-imx-(x)wayland meta-imx
General Yocto / OE images
core-image-minimal See N/A (any) Poky
core-image-baes See N/A (any) Poky
core-image-sato See N/A (any) Poky

Build the image with the following command inside your <build-dir>:

bitbake <image>

Getting the SDK

To build the SDK of a certain image run inside your <build-dir>:

bitbake <image> -c populate_sdk

Image Deployment

After a build is complete, the created image resides in the tmp/deploy/images sub-directory. An image is, for the most part, specific to the machine set in the environment setup. Each image build usually creates U-Boot, kernel, and an images based on the IMAGE_FSTYPES defined in the machine configuration file.

Usually created files are:

Filename Content
imx-boot-<machine>.bin-<type>-flash_tx8m U-Boot flashable binaries
Image Kernel image
modules-<machine>.tgz Kernel modules
<image>-<machine>.ext4 .ext4 RootFileSystem
*.dtb Devicetree blob(s)


To continue programming your board with these images have a look at UUU - Universal Update Utility.


See what you can do with Yocto Zeus built Images at NXP Zeus BSP.