Lines Matching full:layer
19 Layer using the :ref:`bitbake-layers <bsp-guide/bsp:Creating a new BSP Layer Using the \`\`bitbake-…
27 and the contents as a BSP layer. Although not a strict requirement, BSP
38 Because the BSP layer naming convention is well-established, it is
40 BSP layer name does not need to start with ``meta-``.
44 To help understand the BSP layer concept, consider the BSPs that the
55 Project appear under the heading "Yocto Metadata Layer Archive."
57 Each repository is a BSP layer supported by the Yocto Project (e.g.
59 repository unto itself and clicking on the layer name displays two URLs
60 from which you can clone the layer's repository to your local system.
61 Here is an example that clones the Raspberry Pi BSP layer::
65 In addition to BSP layers, the ``meta-yocto-bsp`` layer is part of the
66 shipped ``poky`` repository. The ``meta-yocto-bsp`` layer maintains
78 The BSP layer's base directory (``meta-bsp_root_name``) is the root
79 directory of that Layer. This directory is what you add to the
87 layer and from it build an image. Here is an example::
100 OpenEmbedded build system uses the last layer searched given similar layer
105 layer in order to be functional. In this case, you need to specify these
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
112 this type of layer is OpenEmbedded's
114 layer. The ``meta-openembedded`` layer contains many ``meta-*`` 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`"
166 #. *Determine the BSP Layer You Want:* The Yocto Project supports many
173 #. *Optionally Clone the meta-intel BSP Layer:* If your hardware is
175 layer. For details on the ``meta-intel`` BSP layer, see the layer's
184 #. *Clone the Layer:* ::
213 #. *Optionally Set Up an Alternative BSP Layer:* If your hardware can be
215 ``meta-intel`` BSP layer, you can clone that BSP layer.
218 layer except for the layer's name. For example, if you determine that
220 that layer::
257 <overview-manual/yp-intro:the yocto project layer model>`, can
258 directly accept the format described as a layer. The BSP layer captures
265 only. At the end-distribution point, you can ship the BSP layer combined
267 maintain the distinction that the BSP layer, a build system, and tools
271 inside a BSP layer, you should be aware that there are some requirements
272 in order for a BSP layer to be considered compliant with the Yocto
276 Below is the typical directory structure for a BSP layer. While this
285 meta-bsp_root_name/conf/layer.conf
292 Below is an example of the Raspberry Pi BSP layer that is available from
302 meta-raspberrypi/conf/layer.conf
325 meta-raspberrypi/docs/layer-contents.md
455 You can find these files in the BSP Layer at::
473 You can find this file in the BSP Layer at::
488 You can find this file in the BSP Layer at::
507 You can find these files in the BSP Layer at::
521 BSP Layer and it explains how to use the images with the target
527 Layer Configuration File
530 You can find this file in the BSP Layer at::
532 meta-bsp_root_name/conf/layer.conf
534 The ``conf/layer.conf`` file identifies the file structure as a layer,
535 identifies the contents of the layer, and contains information about how
554 statements from the Raspberry Pi ``conf/layer.conf`` file::
580 You can find these files in the BSP Layer at::
586 Layer requires at least one machine file. If the BSP supports multiple
618 You can find these files in the BSP Layer at::
648 You can find these files in the BSP Layer at::
659 You can find these files in the BSP Layer at::
675 located in the BSP Layer for your target device (e.g. the
719 For an example that shows how to create a new layer using the tools, see
720 the ":ref:`bsp-guide/bsp:creating a new bsp layer using the \`\`bitbake-layers\`\` script`"
741 #. *Create Your Own BSP Layer Using the bitbake-layers Script:*
743 hardware. A layer is really just a location or area in which you
745 in itself, a special type of layer. The simplest way to create a new
746 BSP layer that is compliant with the Yocto Project is to use the
748 ":ref:`bsp-guide/bsp:creating a new bsp layer using the \`\`bitbake-layers\`\` script`"
751 Another example that illustrates a layer is an application. Suppose
753 dependencies in order for it to compile and run. The layer, in this
755 are kept. The key point for a layer is that it is an isolated area
758 layers, see the ":ref:`overview-manual/yp-intro:the yocto project layer model`"
769 BSP layer:
778 release, in the ``meta-intel`` layer:
791 When you set up a layer for a new BSP, you should follow a standard
796 BSP found in the ``meta-intel`` layer inside the Source Directory.
798 #. *Make Configuration Changes to Your New BSP Layer:* The standard BSP
799 layer structure organizes the files you need to edit in ``conf`` and
800 several ``recipes-*`` directories within the BSP layer. Configuration
801 changes identify where your new layer is on the local system and
806 #. *Make Recipe Changes to Your New BSP Layer:* Recipe changes include
812 BSP layer, there remains a few things you need to do for the
818 make the OpenEmbedded build system aware of your new layer. See the
819 ":ref:`dev-manual/common-tasks:enabling your layer`"
821 on how to let the build system know about your new layer.
844 - The requirements here assume the BSP layer is a well-formed, "legal"
845 layer that can be added to the Yocto Project. For guidelines on
846 creating a layer that meets these base requirements, see the
862 appears in the officially released BSP layer.
865 exist in the BSP layer, beyond the requirements for general
873 - *Layer Name:* The BSP must have a layer name that follows the Yocto
874 Project standards. For information on BSP layer names, see the
878 your BSP layer as listed in the ``recipes.txt`` file, which is found
880 or in the OpenEmbedded-Core Layer (``openembedded-core``) at
904 file for the Raspberry Pi BSP in the ``meta-raspberrypi`` BSP layer
910 file for the Raspberry Pi BSP in the ``meta-raspberrypi`` BSP layer
927 - The name and contact information for the BSP layer maintainer.
933 - Instructions on how to build the BSP using the BSP layer.
935 - Instructions on how to boot the BSP build from the BSP layer.
948 - *Layer Configuration File:* You must include a ``conf/layer.conf``
950 the ``meta-bsp_root_name`` BSP layer as a layer to the build
956 machine targets that can be built using the BSP layer. Multiple
969 some other mechanism (e.g. ``meta-yocto-bsp`` layer). Such considerations
1016 ":ref:`dev-manual/common-tasks:appending other layers metadata with your layer`"
1019 - Ensure your directory structure in the BSP layer that supports your
1025 layer (i.e. ``recipes-bsp``, ``recipes-graphics``, ``recipes-core``,
1029 layer. How expansive the layer is affects where you must place these
1030 files. For example, if your layer supports several different machine
1031 types, you need to be sure your layer's directory structure includes
1033 layer does not support multiple machines, the layer would not have
1040 ``init-ifupdown_1.0.bb`` recipe for machine "xyz" where the BSP layer
1052 BSP's layer here::
1058 If the ``meta-xyz`` layer did not support multiple machines, you would place
1059 the interfaces configuration file in the layer here::
1157 Creating a new BSP Layer Using the ``bitbake-layers`` Script
1160 The ``bitbake-layers create-layer`` script automates creating a BSP
1161 layer. What makes a layer a "BSP layer" is the presence of at least one
1162 machine configuration file. Additionally, a BSP layer usually has a
1166 Use these steps to create a BSP layer:
1168 - *Create a General Layer:* Use the ``bitbake-layers`` script with the
1169 ``create-layer`` subcommand to create a new general layer. For
1170 instructions on how to create a general layer using the
1172 ":ref:`dev-manual/common-tasks:creating a general layer using the \`\`bitbake-layers\`\` script`"
1175 - *Create a Layer Configuration File:* Every layer needs a layer
1177 the layer's recipes, priorities for the layer, and so forth. You can
1178 find examples of ``layer.conf`` files in the Yocto Project
1180 in your configuration file, locate a layer (e.g. "meta-ti") and
1182 :yocto_git:`local.conf </meta-ti/tree/meta-ti-bsp/conf/layer.conf>`
1206 layer.
1208 BSP Layer Configuration Example
1211 The layer's ``conf`` directory contains the ``layer.conf`` configuration
1212 file. In this example, the ``conf/layer.conf`` file is the following::
1227 The variables used in this file configure the layer. A good way to learn about layer
1231 For a detailed description of this particular layer configuration file,
1232 see ":ref:`step 3 <dev-manual/common-tasks:creating your own layer>`"
1240 configuration file is what makes a layer a BSP layer as compared to a
1241 general or kernel layer.
1244 ``bsp_layer/conf/machine/`` directory of the layer::
1253 located in the layer ``poky/meta-yocto-bsp/conf/machine`` and is named
1341 are set in the :term:`OpenEmbedded-Core (OE-Core)` layer (e.g.
1382 "virtual/kernel" is "linux-yocto", which exists in the layer's
1454 The ``meta-yocto-bsp/recipes-kernel/linux`` directory in the layer contains
1487 part of the ``meta-yocto-bsp`` layer. The relevant statements are