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:
committed by
Richard Purdie
parent
a99c2c5581
commit
2b93720cfc
@@ -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>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user