diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
index eef36cbc3f..2d036fc5ac 100644
--- a/documentation/bsp-guide/bsp.xml
+++ b/documentation/bsp-guide/bsp.xml
@@ -31,9 +31,9 @@
BSP Layers
- The BSP consists of a file structure inside a base directory.
- Collectively, you can think of the base directory and the file structure
- as a BSP Layer.
+ A BSP consists of a file structure inside a base directory.
+ Collectively, you can think of the base directory, its file structure,
+ and the contents as a BSP Layer.
Although not a strict requirement, layers in the Yocto Project use the
following well established naming convention:
@@ -43,13 +43,46 @@
"bsp_name" in the above form.
+
+ 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
+ Yocto Project Source Repositories
+ through a web interface at
+ .
+ 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. meta-minnow,
+ meta-raspberrypi, and
+ meta-intel).
+ 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:
+
+ $ git clone git://git.yoctoproject.org/meta-minnow
+
+ For information on the BSP development workflow, see the
+ "Developing a Board Support Package (BSP)"
+ 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
+ "Getting Set Up"
+ section also in the Yocto Project Development Manual.
+
+
The layer's base directory (meta-<bsp_name>) is the root
of the BSP Layer.
This root is what you add to the
BBLAYERS
variable in the conf/bblayers.conf file found in the
- Build Directory.
+ Build Directory,
+ which is establishe after you run one of the OpenEmbedded build environment
+ setup scripts (i.e.
+ &OE_INIT_FILE;
+ and
+ oe-init-build-env-memres).
Adding the root allows the OpenEmbedded build system to recognize the BSP
definition and from it build an image.
Here is an example: