.. |br| raw:: html

   <br/>

.. |hr| raw:: html

   <hr/>

.. _yocto-guide-index:

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

.. rubric:: Choosing the right Guide

.. toctree::
   :maxdepth: 1

   nxp/index
   mainline/index

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.

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

   * - 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

     - :doc:`nxp/index`

     - `Scarthgap Reference Manual <https://docs.yoctoproject.org/5.0.5/ref-manual/system-requirements.html#supported-linux-distributions>`_


   * - * QSRZ Series

       * TXRZ Series

     - Linux 5.10.184-cip36

       Renesas Kernel\ [7]_ *+ Ka-Ro patches*

     - Mickledore

     - :doc:`mainline/index`

     - `Mickledore Reference Manual <https://docs.yoctoproject.org/mickledore/ref-manual/system-requirements.html#supported-linux-distributions>`_

   * - * QSMP Series

       * TXMP Series

     - Linux 6.6.48

       Mainline\ [3]_ *+ STM patches*

     - Scarthgap

     - :doc:`mainline/index`

     - `Scarthgap Reference Manual <https://docs.yoctoproject.org/5.0.5/ref-manual/system-requirements.html#supported-linux-distributions>`_

   * - * TX6 Series

       * TXUL Series

     - Linux 5.10.61
     
       Mainline\ [3]_

     - Hardknott

     - :doc:`mainline/index`

     - `Hardknott Reference Manual <https://docs.yoctoproject.org/3.3.2/ref-manual/system-requirements.html#supported-linux-distributions>`_

.. rubric:: For all BSPs

.. toctree::
   :maxdepth: 1

   sstate


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

.. toctree::
   :maxdepth: 1

   yocto-thud-guide/index
   yocto-sumo-guide/index
   yocto-rocko-guide/index

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

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

   * - 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

     - :doc:`nxp/index`

     - `Mickledore Reference Manual <https://docs.yoctoproject.org/mickledore/ref-manual/system-requirements.html#supported-linux-distributions>`_


   * - * QS93 Series (i.MX 93 A0)

       * TX93 Series (i.MX 93 A0)

     - linux-imx_6.1.1_1.0.0

       NXP Kernel\ [6]_

     - Langdale

     - :doc:`nxp/index`

     - `Langdale Reference Manual <https://docs.yoctoproject.org/langdale/ref-manual/system-requirements.html#supported-linux-distributions>`_

   * - * QSMP Series

       * TXMP Series

     - Linux 6.1.28

       Mainline\ [3]_ *+ STM patches*

     - Mickledore

     - :doc:`mainline/index`

     - `Mickledore Reference Manual <https://docs.yoctoproject.org/mickledore/ref-manual/system-requirements.html#supported-linux-distributions>`_

   * - * TX6 Series

       * TXUL Series

       * TX8M Series

       * QS8M Series

     - linux-karo_4.14.98

       NXP Kernel\ [5]_

     - Sumo

     - :doc:`yocto-sumo-guide/index`

     - `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

     - :doc:`yocto-rocko-guide/index`

     - `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 **deprecated** (prior to `mickledore` release)


.. 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://github.com/nxp-imx/meta-fsl-bsp-release/tree/sumo-4.14.98-2.3.0/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.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

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