From ec33e21004c773df60ad0dc5e0a2d04ff9414d62 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 4 Apr 2012 15:16:38 -0600 Subject: documentation/bsp-guide/bsp.xml: Edits to intro sections Adding the new section "Customizing a Recipe for a BSP" has added enough sections to this book such that the introductory area needed some attention. I pared down the intro text to basically just cover the manual's organization and a bit about BSPs. I moved all the introductory common form stuff into the section that just addresses the BSP form. This is better organization for the manual as it is evolving. (From yocto-docs rev: 9aec4ce47fb090ae2f6c5bed93da03e77ae49a4c) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/bsp-guide/bsp.xml | 68 ++++++++++++++++++++--------------------- 1 file changed, 34 insertions(+), 34 deletions(-) (limited to 'documentation/bsp-guide') diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml index d15abe027d..f12db850fc 100644 --- a/documentation/bsp-guide/bsp.xml +++ b/documentation/bsp-guide/bsp.xml @@ -19,44 +19,15 @@ - This chapter (or document if you are reading the BSP Developer's Guide) defines - a structure for these components - so that BSPs follow a commonly understood layout. - The information here also shows how you can create and manage a + This chapter (or document if you are reading the BSP Developer's Guide) + talks about BSP Layers, defines a structure for components + so that BSPs follow a commonly understood layout, discusses how to customize + a recipe for a BSP, addresses BSP licensing, and provides information that + shows you how to create and manage a BSP Layer using two Yocto Project BSP Tools. - - Providing a common form allows end-users to understand and become familiar - with the layout. - A common form also encourages standardization - of software support of hardware. - - - - The proposed format does have elements that are specific to the Yocto Project and - OpenEmbedded build systems. - It is intended that this information can be - used by other systems besides Yocto Project and OpenEmbedded and that it will be simple - to extract information and convert it to other formats if required. - Yocto Project, through its standard layers mechanism, can directly accept the format - described as a layer. - The BSP captures all - the hardware-specific details in one place in a standard format, which is - useful for any person wishing to use the hardware platform regardless of - the build system they are using. - - - - The BSP specification does not include a build system or other tools - - it is concerned with the hardware-specific components only. - At the end-distribution point, you can ship the BSP combined with a build system - and other tools. - However, it is important to maintain the distinction that these - are separate components that happen to be combined in certain end products. - -
BSP Layers @@ -115,6 +86,35 @@
Example Filesystem Layout + + Providing a common form allows end-users to understand and become familiar + with the layout. + A common format also encourages standardization of software support of hardware. + + + + The proposed form does have elements that are specific to the Yocto Project and + OpenEmbedded build systems. + It is intended that this information can be + used by other systems besides Yocto Project and OpenEmbedded and that it will be simple + to extract information and convert it to other formats if required. + Yocto Project, through its standard layers mechanism, can directly accept the format + described as a layer. + The BSP captures all + the hardware-specific details in one place in a standard format, which is + useful for any person wishing to use the hardware platform regardless of + the build system they are using. + + + + The BSP specification does not include a build system or other tools - + it is concerned with the hardware-specific components only. + At the end-distribution point, you can ship the BSP combined with a build system + and other tools. + However, it is important to maintain the distinction that these + are separate components that happen to be combined in certain end products. + + Below is the common form for the file structure inside a BSP Layer. While you can use this basic form for the standard, realize that the actual structures -- cgit v1.2.3-54-g00ecf