documentation/bsp-guide/bsp.rst

15 This guide presents information about BSP layers, defines a structure
19 Layer using the :ref:`bitbake-layers <bsp-guide/bsp:Creating a new BSP Layer Using the \`\`bitbake-…
22 BSP Layers
28 layers in the Yocto Project use the following well-established naming
39    advisable to follow it when creating layers. Technically speaking, a
46 layers in the
50 you will find a list of repositories under "Yocto Metadata Layers".
54    Layers that are no longer actively supported as part of the Yocto
58 ``meta-raspberrypi`` and ``meta-intel``). Each of these layers is a
65 In addition to BSP layers, the ``meta-yocto-bsp`` layer is part of the
98    Ordering and :term:`BBFILE_PRIORITY` for the layers listed in :term:`BBLAYERS`
99    matter. For example, if multiple layers define a machine configuration, the
101    priorities. The build system works from the top-down through the layers
104 Some BSPs require or depend on additional layers beyond the BSP's root
106 layers in the ``README`` "Dependencies" section of the BSP's root layer.
110 Some layers function as a layer to hold other BSP layers. These layers
111 are known as ":term:`container layers <Container Layer>`". An example of
114 layer. The ``meta-openembedded`` layer contains many ``meta-*`` layers.
115 In cases like this, you need to include the names of the actual layers
130 For more information on layers, see the
131 ":ref:`dev-manual/common-tasks:understanding and creating layers`"
134 Preparing Your Build Host to Work With BSP Layers
138 layers. Once you have the host set up, you can create the layer as
140 ":ref:`bsp-guide/bsp:creating a new bsp layer using the \`\`bitbake-layers\`\` script`"
167    BSPs, which are maintained in their own layers or in layers designed
169    BSP layers, you can look at the
256 OpenEmbedded build system, through its standard :ref:`layers mechanism
482 such as the names of any other layers on which the BSP depends and the
720 the ":ref:`bsp-guide/bsp:creating a new bsp layer using the \`\`bitbake-layers\`\` script`"
735    local copies of these supported BSP layers on your system gives you
736    access to layers you might be able to leverage when creating your
738    ":ref:`bsp-guide/bsp:preparing your build host to work with bsp layers`"
741 #. *Create Your Own BSP Layer Using the bitbake-layers Script:*
742    Layers are ideal for isolating and storing work for a given piece of
747    ``bitbake-layers`` script. For information about that script, see the
748    ":ref:`bsp-guide/bsp:creating a new bsp layer using the \`\`bitbake-layers\`\` script`"
758    layers, see the ":ref:`overview-manual/yp-intro:the yocto project layer model`"
760    reference the ":ref:`dev-manual/common-tasks:understanding and creating layers`"
762    information on BSP layers, see the ":ref:`bsp-guide/bsp:bsp layers`"
803    ``bitbake-layers`` script, you are able to interactively configure
847    ":ref:`bsp-guide/bsp:bsp layers`" section in this manual and the
848    ":ref:`dev-manual/common-tasks:understanding and creating layers`"
875    ":ref:`bsp-guide/bsp:bsp layers`" section.
918       typically a list of required layers needed to build the BSP.
962    targets, you should create separate BSP layers for each target.
1016    ":ref:`dev-manual/common-tasks:appending other layers metadata with your layer`"
1157 Creating a new BSP Layer Using the ``bitbake-layers`` Script
1160 The ``bitbake-layers create-layer`` script automates creating a BSP
1168 -  *Create a General Layer:* Use the ``bitbake-layers`` script with the
1171    ``bitbake-layers`` script, see the
1172    ":ref:`dev-manual/common-tasks:creating a general layer using the \`\`bitbake-layers\`\` script`"
1198    layers mentioned in the previous step also contain different kernel
1233 in the discussion that describes how to create layers in the Yocto