From 4737719dc196f98aef768fd814c96adfe1069759 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 27 Jul 2011 12:47:59 -0700 Subject: [PATCH] documentation/dev-manual/dev-manual-model.xml: Added structure I added structure to contain sub-sections for system (BSP and kernel) and application overviews. (From yocto-docs rev: 028f65219b001081d221d63f368ff06066a95a64) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-model.xml | 73 ++++++++++++++----- 1 file changed, 56 insertions(+), 17 deletions(-) diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml index 8d8c2ae33e..7dede8aa28 100644 --- a/documentation/dev-manual/dev-manual-model.xml +++ b/documentation/dev-manual/dev-manual-model.xml @@ -19,11 +19,42 @@ (system development and application development)]. -
- Place-Holder Section for Development in General + + Many development models exist for which you can use the Yocto Project. + However, for the purposes of this manual we are going to focus on two common ones: + System Development and User Application Development. + System Development covers Board Support Package (BSP) development and kernel modification. + User Application Development covers development of applications that you intend to run on some + target hardware. + + + + This chapter presents an overview of the primary models. + Supsequent appendices in the manual provide detailed explanations of the examples. + + + + [WRITERS NOTE: What is undetermined at this point is how much of the entire development process + we include in this particular chapter. + In other words, do we cover debugging and emulation steps here on a case-specific basis? + Or, do we capture that information in the appropriate subsequent chapter by case?] + + +
+ System Development - Text needed here. + System development involves modification or creation of an image that you want to run on + a specific hardware target. + Usually when you want to create an image that runs on embedded hardware the image does + not require the same amount of features that a full-fledged Linux distribution provides. + Thus, you can create a much smaller image that is designed to just use the hardware + features for your particular hardware. + + + + To help you understand how system development works in the Yocto Project, this section + covers two types of image development: BSP creation and kernel modification.
@@ -70,7 +101,7 @@ recipes and configuration files from scratch. While it is possible to create everything from scratch, basing your new BSP on something that is close is much easier. - Or, at a minimum, it gives you some structure with which to start. + Or, at a minimum, it gives you some structure with which to start. At this point you need to understand your target hardware well enough to determine which existing BSP it most closely matches. Things to consider are your hardware’s on-board features such as CPU type and graphics support. @@ -82,13 +113,13 @@ To see the supported BSPs, go to the Yocto Project download page and click on “BSP Downloads.” - Establish a local copy of the base BSP files: Having + Establish a local copy of the base BSP files: Having the BSP files on your system gives you access to the build process and tools you need. For information on how to get these files, see - Getting Setup earlier in this manual. + Getting Setup earlier in this manual. Create your own BSP layer: Layers are ideal for - isolating and storing work for a given piece of hardware. + isolating and storing work for a given piece of hardware. A layer is really just a location or area in which you place the recipes for your BSP. In fact, a BSP is, in itself, a special type of layer. Consider an application as another example that illustrates a layer. @@ -99,8 +130,8 @@ all the relevant information for the project that the Yocto Project build system knows about. The Yocto Project supports four BSPs that are part of the - Yocto Project release: atom-pc, beagleboard, - mpc8315e, and routerstationpro. + Yocto Project release: atom-pc, beagleboard, + mpc8315e, and routerstationpro. The recipes and configurations for these four BSPs are located and dispersed within local Yocto Project files. Consequently, they are not totally isolated in the spirit of layers unless you think @@ -109,7 +140,7 @@ N450, and Sugar Bay are isolated. When you set up a layer for a new BSP you should follow a standard layout. This layout is described in the - + Example Filesystem Layout section of the Board Support Package (BSP) Development Guide. In the standard layout you will notice a suggested structure for recipes and @@ -120,7 +151,7 @@ Make configuration and recipe changes to your new BSP layer: The standard BSP layer structure organizes the files you need to edit in conf and several recipes-* within the - BSP layer. + BSP layer. Configuration changes identify where your new layer is on the local system and identify which kernel you are going to use. Recipe changes include altering recipes (.bb files), removing @@ -165,10 +196,10 @@ Disk image. Minimal RAM-based Initial Root Filesystem – A minimal image - that has the initramfs as part of the kernel, which allows the + that has the initramfs as part of the kernel, which allows the system to find the first “init” program more efficiently. Minimal Live – A Minimal Live image. - Minimal MTD Utilities – A minimal image that has support + Minimal MTD Utilities – A minimal image that has support for the MTD utilities, which let the user interact with the MTD subsystem in the kernel to perform operations on flash devices. Sato – An image with Sato support, a mobile environment @@ -183,7 +214,7 @@ Sato SDK Direct Disk – A Sato SDK Direct Disk image. Sato SDK Live – A Sato SDK Live - image. + image. @@ -198,11 +229,11 @@ Finally, there is wiki page write up of the example located here you might find helpful. - +
-
- Place-Holder Section For Application Development +
+ Place-Holder Section For Kernel Development Model Text needed here. @@ -210,6 +241,14 @@
+
+ Place-Holder Section For Application Development + + + Text needed here. + +
+