.. |br| raw:: html

   <br/>

.. |hr| raw:: html

   <hr/>

.. _yocto-guide-index:

Yocto Guide
===========

.. rubric:: Choosing the right 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.

.. table::
   :widths: 20 15 10 10 20

   +----------------------------+----------------------------------------------+-------------------------+------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
   | Module                     | Kernel Version                               | Yocto Version           | Usage Guide                        | Supported Build Hosts                                                                                                                       |
   +============================+==============================================+=========================+====================================+=============================================================================================================================================+
   |                            | |br|                                         | |br|                    |                                    | |br|                                                                                                                                        |
   |                            | linux-imx_6.1.36_2.1.0 |br|                  | Mickledore              | .. toctree::                       | `Mickledore Reference Manual <https://docs.yoctoproject.org/mickledore/ref-manual/system-requirements.html#supported-linux-distributions>`_ |
   | * QS93 Series (i.MX 93 A1) | NXP Kernel [6]_                              | |br|                    |    :maxdepth: 1                    | |br|                                                                                                                                        |
   | * TX93 Series (i.MX 93 A1) | |br|                                         | |br|                    |                                    | |br|                                                                                                                                        |
   | * TX8M Series              | |br|                                         | |br|                    |    nxp/index.rst                   | |br|                                                                                                                                        |
   | * TX8P Series              | |br|                                         | |br|                    |                                    | |br|                                                                                                                                        |
   | * QS8M Series              | |br|                                         | |br|                    |                                    | |br|                                                                                                                                        |
   | * QSXM Series              | |br|                                         | |br|                    |                                    | |br|                                                                                                                                        |
   | * QSXP Series              | |br|                                         | |br|                    |                                    | |br|                                                                                                                                        |
   |                            | |br|                                         | |br|                    |                                    | |br|                                                                                                                                        |
   | |hr|                       | |br|                                         | |br|                    |                                    | |br|                                                                                                                                        |
   |                            | |br|                                         | |br|                    |                                    | |br|                                                                                                                                        |
   |                            | linux-imx_6.1.1_1.0.0 |br|                   | Langdale                |                                    | `Langdale Reference Manual <https://docs.yoctoproject.org/langdale/ref-manual/system-requirements.html#supported-linux-distributions>`_     |
   | * QS93 Series (i.MX 93 A0) | NXP Kernel [6]_                              | |br|                    |                                    | |br|                                                                                                                                        |
   | * TX93 Series (i.MX 93 A0) | |br|                                         | |br|                    |                                    | |br|                                                                                                                                        |
   |                            | |br|                                         | |br|                    |                                    | |br|                                                                                                                                        |
   +----------------------------+----------------------------------------------+-------------------------+------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
   | * QSRZ Series              | Linux 5.10.184-cip36 |br|                    | Mickledore              | .. toctree::                       | `Mickledore Reference Manual <https://docs.yoctoproject.org/mickledore/ref-manual/system-requirements.html#supported-linux-distributions>`_ |
   | * TXRZ Series              | Renesas Kernel [7]_ |br|                     |                         |    :maxdepth: 1                    |                                                                                                                                             |
   |                            | + Ka-Ro patches                              |                         |                                    |                                                                                                                                             |
   |                            |                                              |                         |    mainline/index.rst              |                                                                                                                                             |
   |                            |                                              |                         |                                    |                                                                                                                                             |
   +----------------------------+----------------------------------------------+                         |                                    |                                                                                                                                             |
   |                            | Linux 6.1.28 |br|                            |                         |                                    |                                                                                                                                             |
   |                            | Mainline [3]_  *+ STM patches*               |                         |                                    |                                                                                                                                             |
   | * QSMP Series |br|         |                                              |                         |                                    |                                                                                                                                             |
   | * TXMP Series |br|         |                                              |                         |                                    |                                                                                                                                             |
   |                            |                                              |                         |                                    |                                                                                                                                             |
   +----------------------------+----------------------------------------------+-------------------------+                                    +---------------------------------------------------------------------------------------------------------------------------------------------+
   | * TX6 Series |br|          | Linux 5.10.61 |br|                           | Hardknott               |                                    | `Hardknott Reference Manual <https://docs.yoctoproject.org/3.3.2/ref-manual/system-requirements.html#supported-linux-distributions>`_       |
   | * TXUL Series |br|         | Mainline [3]_                                |                         |                                    |                                                                                                                                             |
   |                            |                                              |                         |                                    |                                                                                                                                             |
   |                            |                                              |                         |                                    |                                                                                                                                             |
   |                            |                                              |                         |                                    |                                                                                                                                             |
   +----------------------------+----------------------------------------------+-------------------------+------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+

.. rubric:: For all BSPs

.. toctree::
   :maxdepth: 1

   sstate


Legacy Yocto
------------

These Yocto are still available but **these are deprecated**\ , please use the above given new ones.

.. list-table::
   :header-rows: 1
   :widths: 10 10 10 10 15

   * - Module

     - Kernel Version

     - Yocto Release

     - Guide

     - Supported Build Hosts

   * - * QSMP Series

       * TXMP Series

     - linux-st_4.19.49

       STM32MP Kernel [4]_

     - Thud

     - .. toctree::                 
	  :maxdepth: 1              
                             
	  yocto-thud-guide/index.rst

     - `Thud Reference Manual <https://www.yoctoproject.org/docs/2.6.4/ref-manual/ref-manual.html#detailed-supported-distros>`_

   * - * TX6 Series 

       * TXUL Series

       * TX8M Series

       * QS8M Series

     - linux-karo_4.14.98

       NXP Kernel [5]_

     - Sumo

     - .. toctree::                 
	  :maxdepth: 1              
                             
	  yocto-sumo-guide/index.rst

     - `Sumo Reference Manual <https://www.yoctoproject.org/docs/2.5.3/ref-manual/ref-manual.html#detailed-supported-distros>`_

   * - * TX6 Series 

       * TXUL Series

     - linux-karo_4.14.24

       Mainline LTS [3]_

     - Rocko

     - .. toctree::                 
	  :maxdepth: 1              
                             
	  yocto-rocko-guide/index.rst

     - `Rocko Reference Manual <https://www.yoctoproject.org/docs/2.4.4/ref-manual/ref-manual.html#detailed-supported-distros>`_


If you're new to Yocto
------------------------

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

* **BSP** - **B**\ oard **S**\ upport **P**\ ackage:

  *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 <https://www.yoctoproject.org/docs/3.3/bsp-guide/bsp.html#bsp-layers>`_ for the Mainline base BSP and `Kirkstone Release <https://www.yoctoproject.org/docs/4.0/bsp-guide/bsp.html#bsp-layers>`_ 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.

.. list-table::
   :header-rows: 1

   * - Repository
     - Type
     - Description

   * - `karo-bsp <https://github.com/karo-electronics/karo-bsp>`_
     - *BSP*
     - Ka-Ro's Mainline Yocto BSP for boards.

   * - `meta-karo <https://github.com/karo-electronics/meta-karo>`_
     - *Layer*
     - Ka-Ro's Mainline Yocto layer for our CoMs.

   * - `meta-karo-distro <https://github.com/karo-electronics/meta-karo>`_
     - *Layer*
     - Ka-Ro's Mainline Yocto Distro layer.

   * - `karo-nxp-bsp <https://github.com/karo-electronics/karo-nxp-bsp>`_
     - *BSP*
     - Ka-Ro flavoured NXP i.MX Yocto BSP.

   * - `meta-karo-nxp <https://github.com/karo-electronics/meta-karo-nxp>`_
     - *Layer*
     - Ka-Ro's Yocto layer for NXP i.MX Processors based boards.

   * - `meta-karo-nxp-distro <https://github.com/karo-electronics/meta-karo-nxp-distro>`_
     - *Layer*
     - Ka-Ro's NXP Yocto Distro layer.


.. rubric:: Glossary

.. [1] Further information: `https://www.yoctoproject.org/docs/3.0.2/bsp-guide/bsp-guide.html <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 <https://www.yoctoproject.org/docs/3.0.2/dev-manual/dev-manual.html#new-recipe-writing-a-new-recipe>`_
.. [3] From `Kernel.org <https://www.kernel.org/>`_ / `git <https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git>`_
.. [4] As given by STM's Yocto - `STM kernel recipe <https://github.com/STMicroelectronics/meta-st-stm32mp/blob/thud/recipes-kernel/linux/linux-stm32mp_4.19.bb>`_
.. [5] As given by NXP's 4.14 Yocto - `NXP kernel recipe <https://source.codeaurora.org/external/imx/meta-fsl-bsp-release/tree/imx/meta-bsp/recipes-kernel/linux/linux-imx_4.14.98.bb?h=sumo-4.14.98-2.3.0>`_
.. [6] Forked from NXP's linux-imx Kernel - https://github.com/karo-electronics/karo-tx-linux/tree/lf-6.1.y-karo
.. [7] Renesas Kernel Repo mostly matching Mainline Kernel - https://github.com/renesas-rz/rz_linux-cip/tree/rz-5.10-cip36

.. _`respective section below`: `If you're new to Yocto`_