Yocto Guide

This guide explains how to build Linux images from source for our modules with the Yocto Project, using our Board Support Packages — including host and development environment setup and customization for your own baseboard.

Note

If you’re new to Yocto, we recommend reading the respective section below before you continue choosing a guide.

Follow the host setup guide to prepare your host system to work with Yocto:

Board Support Packages

We provide and maintain Board Support Packages (BSPs) that offer software for our modules using the Yocto Project.

The table below helps you choose the appropriate BSP guide based on your module.

Module

Kernel Version

BSP

Latest Release

Usage Guide

Supported Build Hosts

  • QS95 Series

linux-imx_6.18.37_2.1.0

NXP Kernel[9]

wrynose
karo-nxp-bsp

wrynose-26-11.1
on GitHub

Yocto Wrynose Guide

Wrynose Reference Manual

  • QS93 Series

  • TX93 Series

  • QS91 Series

  • TX91 Series

  • TX8M Series

  • TX8P Series

  • QS8M Series

  • QSXM Series

  • QSXP Series

  • TX6 Series

  • TXUL Series

linux-imx_6.6.52_2.2.2

NXP Kernel [6]

scarthgap
karo-nxp-bsp

KARO-2026-11-13
on GitHub

Yocto Scarthgap Guide

Scarthgap Reference Manual

  • QSMP Series

  • TXMP Series

ST Linux 6.6.116

linux-stm32mp [4] + Ka-Ro patches

scarthgap
karo-bsp

KARO-2026-11-13
on GitHub

Yocto Scarthgap Guide

Scarthgap Reference Manual

  • QSRZ Series

  • TXRZ Series

Linux 6.1.141-cip43

Renesas Kernel [7] + Ka-Ro patches

scarthgap
karo-bsp

KARO-2026-11-13
on GitHub

Yocto Scarthgap Guide

Scarthgap Reference Manual

If you’re new to Yocto

First, let’s explain some terms:

  • BSP - Board Support Package:

    A Board Support Package is a collection of information that defines how to support a particular hardware device, set of devices, or hardware platform. It includes information about the hardware features present on the device, kernel configuration, and any additional hardware drivers required. It also lists any additional software components required beyond a generic Linux software stack for both essential and optional platform features. [1]

  • BSP-Layer:

    See section 1.1 in the official Yocto documentation of the Scarthgap Release.

  • Recipe:

    Recipes (.bb files) are fundamental components in the Yocto Project environment. Each software component built by the OpenEmbedded build system requires a recipe to define the component. [2]


The Yocto Project uses Bitbake as its core task scheduler and execution engine.

A list of helpful bitbake commands can be found here:


On GitHub we provide different BSPs and layers. The following table gives you an overview:

Repository

Type

Description

karo-bsp

BSP

Ka-Ro’s Mainline Yocto BSP for boards.

meta-karo

Layer

Ka-Ro’s Mainline Yocto layer for our CoMs.

meta-karo-distro

Layer

Ka-Ro’s Mainline Yocto Distro layer.

karo-base

Base

Base directory of the Mainline BSP, checked out as layers/base by the karo-bsp manifest. Provides setup-environment, karo-setup-release.sh and the conf/templates used to create a build directory.

karo-nxp-bsp

BSP

Ka-Ro-flavored NXP i.MX Yocto BSP.

meta-karo-nxp

Layer

Ka-Ro’s Yocto layer for NXP i.MX Processor-based CoMs.

karo-nxp-base

Base

Base directory of the NXP BSP, checked out as sources/base by the karo-nxp-bsp manifest. Provides setup-environment, karo-setup-release.sh and the conf/templates used to create a build directory.

Glossary