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: