mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-06-03 13:49:49 +00:00
Code Issues Projects Releases Wiki Activity

documentation/bsp-guide/bsp.xml: Edits for BSP Layer understanding

Browse Source 
I added a small section at the start of chapter to define a
BSP Layer, note where the YP keeps them, and note that meta-intel
is somewhat of a "super" layer as it contains several BSP layers
of its own.

(From yocto-docs rev: 2e044072660d3f675612e01e3871d6a4fb0894bd)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2012-02-17 15:03:46 -06:00
committed by Richard Purdie
parent f7fb723548
commit 4dd2dc9886
1 changed files with 41 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/bsp-guide/bsp.xml
+41 -13
View File
@@ -61,32 +61,52 @@
are separate components that happen to be combined in certain end products. are separate components that happen to be combined in certain end products.
</para> </para>
<section id="bsp-filelayout"> <section id='bsp-layers'>
<title>Example Filesystem Layout</title> <title>BSP Layers</title>
<para> <para>
The BSP consists of a file structure inside a base directory, which uses the following The BSP consists of a file structure inside a base directory.
naming convention: Collectively, you can think of the base directory and the file structure
as a BSP Layer.
BSP Layers use the following naming convention:
<literallayout class='monospaced'> <literallayout class='monospaced'>
meta-&lt;bsp_name&gt; meta-&lt;bsp_name&gt;
</literallayout> </literallayout>
"bsp_name" is a placeholder for the machine or platform name.
</para> </para>
<para> <para>
"bsp_name" is a placeholder for the machine or platform name. The Yocto Project organizes BSP Layers within the Yocto Metadata Layers area
Here are some example base directory names: of the Yocto Project Source Repositories at
<ulink url='http://git.yoctoproject.org/cgit.cgi'></ulink>.
If you examine the source repositories, you will find many BSP Layers.
Here are a few:
<literallayout class='monospaced'> <literallayout class='monospaced'>
meta-baryon
meta-fsl-ppc
meta-intel
meta-selinux
meta-ti
</literallayout>
It is worth noting that the <filename>meta-intel</filename> BSP Layer contains
within itself several other BSP Layers, which makes it sort of a "super" layer.
Following is a sampling of the BSP Layers that the <filename>meta-intel</filename>
BSP Layer contains:
<literallayout class='monospaced'>
meta-cedartrail
meta-crownbay
meta-emenlow meta-emenlow
meta-n450 meta-fishriver
meta-beagleboard meta-fri2
</literallayout> </literallayout>
</para> </para>
<para> <para>
The base directory (<filename>meta-&lt;bsp_name&gt;</filename>) is the root of the BSP layer. The layer's base directory (<filename>meta-&lt;bsp_name&gt;</filename>) is the root
of the BSP Layer.
This root is what you add to the <filename>BBLAYERS</filename> This root is what you add to the <filename>BBLAYERS</filename>
variable in the <filename>build/conf/bblayers.conf</filename> file found in the variable in the <filename>build/conf/bblayers.conf</filename> file found in the
Yocto Project file's build directory. <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#yocto-project-build-directory'>Yocto Project Build Directory</ulink>.
Adding the root allows the Yocto Project build system to recognize the BSP Adding the root allows the Yocto Project 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:
@@ -97,16 +117,24 @@
/usr/local/src/yocto/meta-&lt;bsp_name&gt; \ /usr/local/src/yocto/meta-&lt;bsp_name&gt; \
" "
</literallayout> </literallayout>
</para>
<para>
For more detailed information on layers, see the For more detailed information on layers, see the
"<ulink url='http://www.yoctoproject.org/docs/latest/poky-ref-manual/poky-ref-manual.html#usingpoky-changes-layers'>BitBake Layers</ulink>" "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#usingpoky-changes-layers'>Bitbake Layers</ulink>"
section of the Yocto Project Reference Manual. section of the Yocto Project Development Manual.
You can also see the detailed examples in the appendices of You can also see the detailed examples in the appendices of
<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html'> <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html'>
The Yocto Project Development Manual</ulink>. The Yocto Project Development Manual</ulink>.
</para> </para>
</section>
<section id="bsp-filelayout">
<title>Example Filesystem Layout</title>
<para> <para>
Below is the common form for the file structure inside a base directory. Below is the common form for the file structure inside a BSP Layer.
While you can use this basic form for the standard, realize that the actual structures While you can use this basic form for the standard, realize that the actual structures
for specific BSPs could differ. for specific BSPs could differ.