Yocto Guide

Choosing the right Guide

• NXP Yocto BSP Guide
• Mainline Yocto BSP Guide

The table below will help you to decide which guide to use, depending on the module you want to use. In this guides, the right BSP is written down, so you don’t have to worry about it.

Note

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

Module	Kernel Version	Yocto Release	Usage Guide	Supported Build Hosts
QS93 Series TX93 Series TX8M Series TX8P Series QS8M Series QSXM Series QSXP Series	linux-imx_6.6.52_2.2.0 NXP Kernel[6]	Scarthgap	NXP Yocto BSP Guide	Scarthgap Reference Manual
QSRZ Series TXRZ Series	Linux 5.10.184-cip36 Renesas Kernel[7] + Ka-Ro patches	Mickledore	Mainline Yocto BSP Guide	Mickledore Reference Manual
QSMP Series TXMP Series	Linux 6.6.48 Mainline[3] + STM patches	Scarthgap	Mainline Yocto BSP Guide	Scarthgap Reference Manual
TX6 Series TXUL Series	Linux 5.10.61 Mainline[3]	Hardknott	Mainline Yocto BSP Guide	Hardknott Reference Manual

For all BSPs

• Enable sstate cache

Legacy Yocto

• Yocto Thud Guide
• NXP Yocto Sumo Guide
• Yocto Rocko Guide

These Yocto releases are still available but they are deprecated, please use the above given new ones.

Module	Kernel Version	Yocto Release	Usage Guide	Supported Build Hosts
QS93 Series TX93 Series TX8M Series TX8P Series QS8M Series QSXM Series QSXP Series	linux-imx_6.1.36_2.1.0 NXP Kernel[6]	Mickledore	NXP Yocto BSP Guide	Mickledore Reference Manual
QS93 Series (i.MX 93 A0) TX93 Series (i.MX 93 A0)	linux-imx_6.1.1_1.0.0 NXP Kernel[6]	Langdale	NXP Yocto BSP Guide	Langdale Reference Manual
QSMP Series TXMP Series	Linux 6.1.28 Mainline[3] + STM patches	Mickledore	Mainline Yocto BSP Guide	Mickledore Reference Manual
TX6 Series TXUL Series TX8M Series QS8M Series	linux-karo_4.14.98 NXP Kernel[5]	Sumo	NXP Yocto Sumo Guide	Sumo Reference Manual
TX6 Series TXUL Series	linux-karo_4.14.24 Mainline LTS[3]	Rocko	Yocto Rocko Guide	Rocko Reference Manual

If you’re new to Yocto

This is our Yocto Guide. First, lets explain some terms:

• BSP - Board Support Package:

  A Board Support Package (BSP) is a collection of information that defines how to support a particular hardware device, set of devices, or hardware platform. The BSP includes information about the hardware features present on the device and kernel configuration information along with any additional hardware drivers required. The BSP also lists any additional software components required in addition to 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 Hardknott Release for the Mainline base BSP and Kirkstone Release for the NXP based BSP.

• 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]

On GitHub we are providing different BSP’s and layers. The following table should give 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-nxp-bsp	BSP	Ka-Ro flavoured NXP i.MX Yocto BSP.
meta-karo-nxp	Layer	Ka-Ro’s Yocto layer for NXP i.MX Processors based boards.
meta-karo-nxp-distro	Layer	Ka-Ro’s NXP Yocto Distro layer deprecated (prior to mickledore release)

Glossary

[1]

Further information: https://www.yoctoproject.org/docs/3.0.2/bsp-guide/bsp-guide.html

[2]

From: https://www.yoctoproject.org/docs/3.0.2/dev-manual/dev-manual.html#new-recipe-writing-a-new-recipe

[3] (1,2,3,4)

From Kernel.org / git

[4]

As given by STM’s Yocto - STM kernel recipe

[5]

As given by NXP’s 4.14 Yocto - NXP kernel recipe

[6] (1,2,3)

Forked from NXP’s linux-imx Kernel - https://github.com/karo-electronics/karo-tx-linux/tree/lf-6.6.y-karo-2

[7]

Renesas Kernel Repo mostly matching Mainline Kernel - https://github.com/renesas-rz/rz_linux-cip/tree/rz-5.10-cip36