bsp-guide: Edits to "BSP Layers" section adding locator info.
I extended the section to mention where to find YP supported BSP layers and a bit on how to get them via the link from the Source Repositories web interface. Changes driven by community input. (From yocto-docs rev: 4c944bf33b7d642126c52efd313666270145ab50) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
10996ccceb
commit
926a8ee45b
|
@ -31,9 +31,9 @@
|
||||||
<title>BSP Layers</title>
|
<title>BSP Layers</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
The BSP consists of a file structure inside a base directory.
|
A BSP consists of a file structure inside a base directory.
|
||||||
Collectively, you can think of the base directory and the file structure
|
Collectively, you can think of the base directory, its file structure,
|
||||||
as a BSP Layer.
|
and the contents as a BSP Layer.
|
||||||
Although not a strict requirement, layers in the Yocto Project use the
|
Although not a strict requirement, layers in the Yocto Project use the
|
||||||
following well established naming convention:
|
following well established naming convention:
|
||||||
<literallayout class='monospaced'>
|
<literallayout class='monospaced'>
|
||||||
|
@ -43,13 +43,46 @@
|
||||||
"bsp_name" in the above form.
|
"bsp_name" in the above form.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
To help understand the BSP layer concept, consider the BSPs that the
|
||||||
|
Yocto Project supports and provides with each release.
|
||||||
|
You can see the layers in the
|
||||||
|
<ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-repositories'>Yocto Project Source Repositories</ulink>
|
||||||
|
through a web interface at
|
||||||
|
<ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi'></ulink>.
|
||||||
|
If you go to that interface you will find near the bottom of the list
|
||||||
|
under "Yocto Metadata Layers" several BSP layers all of which are
|
||||||
|
supported by the Yocto Project (e.g. <filename>meta-minnow</filename>,
|
||||||
|
<filename>meta-raspberrypi</filename>, and
|
||||||
|
<filename>meta-intel</filename>).
|
||||||
|
Each of these layers is a repository unto itself and clicking on a
|
||||||
|
layer reveals information that includes two links from which you can choose
|
||||||
|
to set up a clone of the layer's repository on your local host system.
|
||||||
|
Here is an example that clones the Minnow Board BSP layer:
|
||||||
|
<literallayout class='monospaced'>
|
||||||
|
$ git clone git://git.yoctoproject.org/meta-minnow
|
||||||
|
</literallayout>
|
||||||
|
For information on the BSP development workflow, see the
|
||||||
|
"<ulink url='&YOCTO_DOCS_DEV_URL;#developing-a-board-support-package-bsp'>Developing a Board Support Package (BSP)</ulink>"
|
||||||
|
section in the Yocto Project Development Manual.
|
||||||
|
For more information on how to set up a local copy of source files
|
||||||
|
from a Git repository, see the
|
||||||
|
"<ulink url='&YOCTO_DOCS_DEV_URL;#getting-setup'>Getting Set Up</ulink>"
|
||||||
|
section also in the Yocto Project Development Manual.
|
||||||
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
The layer's base directory (<filename>meta-<bsp_name></filename>) is the root
|
The layer's base directory (<filename>meta-<bsp_name></filename>) is the root
|
||||||
of the BSP Layer.
|
of the BSP Layer.
|
||||||
This root is what you add to the
|
This root is what you add to the
|
||||||
<ulink url='&YOCTO_DOCS_REF_URL;#var-BBLAYERS'><filename>BBLAYERS</filename></ulink>
|
<ulink url='&YOCTO_DOCS_REF_URL;#var-BBLAYERS'><filename>BBLAYERS</filename></ulink>
|
||||||
variable in the <filename>conf/bblayers.conf</filename> file found in the
|
variable in the <filename>conf/bblayers.conf</filename> file found in the
|
||||||
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>.
|
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>,
|
||||||
|
which is establishe after you run one of the OpenEmbedded build environment
|
||||||
|
setup scripts (i.e.
|
||||||
|
<ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
|
||||||
|
and
|
||||||
|
<ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>).
|
||||||
Adding the root allows the OpenEmbedded build system to recognize the BSP
|
Adding the root allows the OpenEmbedded build system to recognize the BSP
|
||||||
definition and from it build an image.
|
definition and from it build an image.
|
||||||
Here is an example:
|
Here is an example:
|
||||||
|
|
Loading…
Reference in New Issue