1
0
mirror of https://git.yoctoproject.org/poky synced 2026-05-30 00:20:08 +00:00

bsp-guide, dev-manual: Moved BSP Layer prep steps to bsp-guide

The YP Development Manual had some build host preparation steps
as part of the chapter that talks about getting a host ready
for using YP.  These steps are better suited in the BSP Guide.
I moved them there and filled out the steps to be more complete.

(From yocto-docs rev: 2277812d0dd411a103a4a4252d4cb90c471901c9)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2017-08-18 12:48:44 -07:00
committed by Richard Purdie
parent a99c2c5581
commit 2b93720cfc
2 changed files with 151 additions and 111 deletions
@@ -203,115 +203,6 @@
</para>
</section>
<section id='setting-up-bsp-layers'>
<title>Setting Up BSP Layers</title>
<para>
This section describes how to set up a layer for a Board Support
Package (BSP).
For structural information on BSPs, see the
<ulink url='&YOCTO_DOCS_BSP_URL;#bsp-guide'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>.
<orderedlist>
<listitem><para>
<emphasis>Determine the BSP Layer You Want:</emphasis>
The Yocto Project supports many BSPs, which are maintained in
their own layers or in layers designed to contain several
BSPs.
To get an idea of machine support through BSP layers, you can
look at the
<ulink url='&YOCTO_RELEASE_DL_URL;/machines'>index of machines</ulink>
for the release.
<note>
The Yocto Project uses the following BSP layer naming
scheme:
<literallayout class='monospaced'>
meta-<replaceable>bsp_name</replaceable>
</literallayout>
where <replaceable>bsp_name</replaceable> is the recognized
BSP name.
Here is an example:
<literallayout class='monospaced'>
meta-raspberrypi
</literallayout>
See the
"<ulink url='&YOCTO_DOCS_BSP_URL;#bsp-layers'>BSP Layers</ulink>"
section in the Yocto Project Board Support Package (BSP)
Developer's Guide for more information on BSP Layers.
</note>
</para></listitem>
<listitem><para>
<emphasis>Optionally Set Up the <filename>meta-intel</filename> BSP Layer:</emphasis>
If your hardware is based on current Intel CPUs and devices,
you can leverage this BSP layer.
For details on the <filename>meta-intel</filename> BSP layer,
see the layer's
<ulink url='http://git.yoctoproject.org/cgit/cgit.cgi/meta-intel/tree/README'><filename>README</filename></ulink>
file.
<orderedlist>
<listitem><para>
<emphasis>Navigate to Your Source Directory:</emphasis>
Typically, you set up the
<filename>meta-intel</filename> Git repository
inside the
<ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>
(e.g. <filename>poky</filename>).
</para></listitem>
<listitem><para>
<emphasis>Clone the Layer:</emphasis>
<literallayout class='monospaced'>
$ git clone git://git.yoctoproject.org/meta-intel.git
Cloning into 'meta-intel'...
remote: Counting objects: 14224, done.
remote: Compressing objects: 100% (4591/4591), done.
remote: Total 14224 (delta 8245), reused 13985 (delta 8006)
Receiving objects: 100% (14224/14224), 4.29 MiB | 2.90 MiB/s, done.
Resolving deltas: 100% (8245/8245), done.
Checking connectivity... done.
</literallayout>
</para></listitem>
<listitem><para>
<emphasis>Check Out the Proper Branch:</emphasis>
The branch you check out for
<filename>meta-intel</filename> must match the same
branch you are using for the Yocto Project release
(e.g. &DISTRO_NAME_NO_CAP;):
<literallayout class='monospaced'>
$ git checkout <replaceable>branch_name</replaceable>
</literallayout>
For an example on how to discover branch names and
checkout on a branch, see the
"<link linkend='checking-out-by-branch-in-poky'>Checking Out By Branch in Poky</link>"
section.
</para></listitem>
</orderedlist>
</para></listitem>
<listitem><para>
<emphasis>Optionally Set Up an Alternative BSP Layer:</emphasis>
If your hardware can be more closely leveraged to an
existing BSP not within the <filename>meta-intel</filename>
BSP layer, you can clone that BSP layer.</para>
<para>The process is identical to the process used for the
<filename>meta-intel</filename> layer except for the layer's
name.
For example, if you determine that your hardware most
closely matches the <filename>meta-minnow</filename>,
clone that layer:
<literallayout class='monospaced'>
$ git clone git://git.yoctoproject.org/meta-minnow
Cloning into 'meta-minnow'...
remote: Counting objects: 456, done.
remote: Compressing objects: 100% (283/283), done.
remote: Total 456 (delta 163), reused 384 (delta 91)
Receiving objects: 100% (456/456), 96.74 KiB | 0 bytes/s, done.
Resolving deltas: 100% (163/163), done.
Checking connectivity... done.
</literallayout>
</para></listitem>
</orderedlist>
</para>
</section>
<section id='local-kernel-files'>
<title>Setting Up to Work on a Kernel</title>