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
karo-xwayland Ka-Ro Linux Distro with xwayland backend
  • A list of supported MACHINE configurations
MACHINE= Description Supported Baseboards Display Support Camera Support
qs8m-mq00 QS8M-MQ00 i.MX8M Mini Solder-in Module QSBASE 2 Raspi Display, 10 inch display** Raspi Camera (Sony IMX 219)
qs8m-nd00 QS8M-MQ00 i.MX8M Nano Solder-in Module QSBASE 2 Raspi Display, 10 inch display** Raspi Camera (Sony IMX 219)*
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** Basler daA3840-30mc
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  
** = Additional Hardware Required


Before setting up your build-directory, read to the Starting Build section to see which distro you might need.

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


To enable different features for your build you can modify the conf/local.conf file inside your build-directory.


For Qsbase3 baseboard there is WiFi and BT support with a Laird WiFi Module.

To enable add the following line to your conf/local.conf.

WiFi Only

DISTRO_FEATURES_append = " wifi"

WiFi and Bluetooth

DISTRO_FEATURES_append = " bluetooth wifi"


With the Laird WiFi module it is mandatory to have the WiFi firmware loaded to get Bluetooth up and running!


How to use WiFi / BT is documented in WiFi/BT Guide.

Raspi Camera

For QS8M on Qsbase2 there is Raspi Camera (Sony IMX 219) support.

To enable add the following line to your conf/local.conf.

DISTRO_FEATURES_append = " imx219"


How to use Camera is documented in Camera Guide.

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.

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

bitbake <image>

Here are the different images you can build:

Image Description DISTRO= (required) Provided by layer
Official Ka-Ro images
karo-image-minimal Image with minimal read-only rootfs karo-minimal meta-karo-nxp-distro
karo-image-base Image with minimal rootfs using udev instead of mdev karo-minimal meta-karo-nxp-distro
karo-image-weston Image with weston desktop karo-(x)wayland meta-karo-nxp-distro
karo-image-qt5 QT5 Image on weston desktop.
To use it wit QT-Creator see Toolchain with QT Creator
karo-(x)wayland meta-karo-nxp-distro
karo-image-basler Image with Basler Camera support on weston desktop.
For Details follow Basler Camera section.
karo-xwayland 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-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-base See N/A (any) Poky
core-image-sato See N/A (any) Poky

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.
If you compiled karo-image-qt5 check out Toolchain with QT Creator.