From 4c4076add1a6ce5d1bd39f61f64971332a4b4139 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 7 Mar 2018 16:05:02 -0800 Subject: bsp-guide: General edits to "BSP Layers" section Added more relevant information around the discussion of BSP layers. (From yocto-docs rev: 8ca439b0bbfdcf390edb723fd12e8a00d90024e3) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/bsp-guide/bsp.xml | 47 +++++++++++++++++++++++++---------------- 1 file changed, 29 insertions(+), 18 deletions(-) (limited to 'documentation/bsp-guide/bsp.xml') diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml index 5c6f9df7ab..e026cefd8c 100644 --- a/documentation/bsp-guide/bsp.xml +++ b/documentation/bsp-guide/bsp.xml @@ -34,8 +34,8 @@ 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: + Although not a strict requirement, BSP layers in the Yocto Project + use the following well-established naming convention: meta-bsp_name @@ -46,8 +46,8 @@ it is advisable to follow it when creating layers. Technically speaking, a BSP layer name does not need to start with meta-. - However, you might run into situations where obscure - scripts assume this convention. + However, various scripts and tools in the Yocto Project + development environment assume this convention. @@ -58,9 +58,15 @@ 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-raspberrypi and + If you go to that interface, you will find a list of repositories + under "Yocto Metadata Layers". + + Layers that are no longer actively supported as part of the + Yocto Project appear under the heading "Yocto Metadata Layer + Archive." + + Each repository is a BSP layer supported by the Yocto Project + (e.g. 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 @@ -72,13 +78,12 @@ - In addition to BSP layers near the bottom of that referenced - Yocto Project Source Repository, the + In addition to BSP layers, the meta-yocto-bsp layer is part of the shipped poky repository. The meta-yocto-bsp layer maintains several BSPs such as the Beaglebone, EdgeRouter, and generic versions of - both 32 and 64-bit IA machines. + both 32-bit and 64-bit IA machines. @@ -102,8 +107,9 @@ which is established after you run the OpenEmbedded build environment setup script (i.e. &OE_INIT_FILE;). - Adding the root allows the OpenEmbedded build system to recognize the BSP - definition and from it build an image. + Adding the root allows the + OpenEmbedded build system + to recognize the BSP layer and from it build an image. Here is an example: BBLAYERS ?= " \ @@ -129,15 +135,20 @@ Some layers function as a layer to hold other BSP layers. - An example of this type of layer is the meta-intel layer, - which contains a number of individual BSP sub-layers, as well as a directory - named common/ full of common content across those layers. - Another example is the meta-yocto-bsp layer mentioned - earlier. + An example of this type of layer is the + meta-intel layer. + This layer contains BSP layers for the Intel-core2-32 + Intel Common Core + (Intel-core2-32) and the Intel-corei7-64 + Intel Common Core + (Intel-corei7-64). + the meta-intel layer also contains + the common/ directory, which contains + common content across those layers. - For more detailed information on layers, see the + For more information on layers, see the "Understanding and Creating Layers" section of the Yocto Project Development Tasks Manual. -- cgit v1.2.3-54-g00ecf