..
 # SPDX-FileCopyrightText: <text>Copyright 2024-2025 Arm Limited and/or its
 # affiliates <open-source-office@arm.com></text>
 #
 # SPDX-License-Identifier: MIT

###########
Integration
###########

The Yocto Project version used by the Reference Software Stack
is |yocto version|.

*******************************
meta-arm-bsp-extras Yocto layer
*******************************

The ``meta-arm-bsp-extras`` layer primarily depends on the ``meta-arm`` layer
which implements the ``fvp-rd-aspen`` bitbake ``MACHINE`` definition to enable
the Arm Automotive Solutions to run on the Arm Reference Design RD-Aspen FVP
(FVP_RD_Aspen).

Yocto build configuration
=========================

A set of ``yaml`` configuration files (found at :repo:`yocto/kas`) for
the `kas build tool`_ is provided to support bitbake layer fetching, project
configuration and executing the build and validation.

Yocto layers dependency
=======================

The following diagram illustrates the layers which are integrated as part of
the Reference Software Stack.

|

.. image:: ../images/yocto_layers_dependency_diagram.*
   :align: center
   :alt: Yocto Layer Dependency

|

.. note::
  The ``meta-arm-systemready`` layer is only required when building for the
  Arm SystemReady firmware.

The layer dependency sources and their revisions for the ``rd-aspen`` repository
(|arm auto solutions repository|) |rd-aspen layer dependency statement| are:

  .. code-block:: yaml
    :substitutions:

    URL: |meta-arm repository|
    layers: meta-arm, meta-arm-systemready, meta-arm-toolchain
    branch: |rd-aspen meta-arm branch|
    revision: |rd-aspen meta-arm revision|

    URL: |meta-openembedded repository|
    layers: meta-python
    branch: |meta-openembedded branch|
    revision: |rd-aspen meta-openembedded revision|

    URL: |meta-ptx repository|
    layers: meta-ptx
    branch: |meta-ptx branch|
    revision: |rd-aspen meta-ptx revision|

    URL: |poky repository|
    layers: meta
    branch: |poky branch|
    revision: |rd-aspen poky revision|