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 |
|---|---|---|---|---|---|
|
linux-imx_6.18.37_2.1.0 NXP Kernel[9] |
wrynose karo-nxp-bsp |
wrynose-26-11.1 on GitHub |
||
|
linux-imx_6.6.52_2.2.2 NXP Kernel [6] |
scarthgap karo-nxp-bsp |
KARO-2026-11-13 on GitHub |
||
|
ST Linux 6.6.116 linux-stm32mp [4] + Ka-Ro patches |
scarthgap karo-bsp |
KARO-2026-11-13 on GitHub |
||
|
Linux 6.1.141-cip43 Renesas Kernel [7] + Ka-Ro patches |
scarthgap karo-bsp |
KARO-2026-11-13 on GitHub |
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 |
|---|---|---|
BSP |
Ka-Ro’s Mainline Yocto BSP for boards. |
|
Layer |
Ka-Ro’s Mainline Yocto layer for our CoMs. |
|
Layer |
Ka-Ro’s Mainline Yocto Distro layer. |
|
Base |
Base directory of the Mainline BSP, checked out as |
|
BSP |
Ka-Ro-flavored NXP i.MX Yocto BSP. |
|
Layer |
Ka-Ro’s Yocto layer for NXP i.MX Processor-based CoMs. |
|
Base |
Base directory of the NXP BSP, checked out as |
Glossary