From 37873380259d39c105d45243e6ce0c88b18a550e Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 26 Mar 2012 16:09:20 -0600 Subject: documentation/adt-manual/adt-eclipse.xml: Added new commander section Hongna Xu realized that the whole Bitbake Commander part is missing in the ADT manual. This should be Section 4.8. She sent the info and I created a new section titled "Customizing and Image Using a BitBake Commander Project and Hob". Reported-by: Hongna Xu (From yocto-docs rev: eb207806dbd2f73089068ef9e3fa447aa8a38404) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/adt-manual/adt-eclipse.xml | 87 ++++++++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) (limited to 'documentation/adt-manual') diff --git a/documentation/adt-manual/adt-eclipse.xml b/documentation/adt-manual/adt-eclipse.xml index dcc201cdc8..3a6dce5da7 100644 --- a/documentation/adt-manual/adt-eclipse.xml +++ b/documentation/adt-manual/adt-eclipse.xml @@ -643,6 +643,93 @@ +
+ Customizing an Image Using a BitBake Commander Project and Hob + + + Within Eclipse, you can create a Yocto BitBake Commander project, + edit the metadata, and then use the + Hob to build a customized + image all within one IDE. + + +
+ Creating the Yocto BitBake Commander Project + + + To create a Yocto BitBake Commander project, follow these steps: + + Select Window -> Open Perspective -> Other + and then choose Bitbake Commander. + Click OK to change the Eclipse perspective into the + Bitbake Commander perspective. + Select File -> New -> Project to create a new Yocto + Bitbake Commander project. + Choose Yocto Project Bitbake Commander -> New Yocto Project + and click Next. + Enter the Project Name and choose the Project Location. + The Yocto project's metadata files will be put under the directory + <project_location>/<project_name>. + If that directory does not exist, you need to check + the "Clone from Yocto Git Repository" box, which would execute a + git clone command to get the Yocto project's metadata files. + + Select Finish to create the project. + + +
+ +
+ Editing the Metadata Files + + + After you create the Yocto Bitbake Commander project, you can modify the metadata files + by opening them in the project. + When editing recipe files (.bb files), you can view BitBake + variable values and information by hovering the mouse pointer over the variable name and + waiting a few seconds. + + + + To edit the metadata, follow these steps: + + Select your Yocto Bitbake Commander project. + Select File -> New -> Yocto BitBake Commander -> BitBake Recipe + to open a new recipe wizard. + Point to your source by filling in the "SRC_URL" field. + For example, you can add a recipe in the + Yocto Project Source Files, + input the "SRC_URL" as follows: + + ftp://ftp.gnu.org/gnu/m4/m4-1.4.9.tar.gz + + Click "Populate" to calculate the archive md5, sha256, + license checksum values and to auto-generate the recipe filename. + Fill in the "Description" field. + Be sure values for all required fields exist. + Click Finish. + + +
+ +
+ Building and Customizing the Image + + + To build and customize the image in Eclipse, follow these steps: + + Select your Yocto Bitbake Commander project. + Select Project -> Launch HOB. + Enter the build directory where you want to put your final images. + Click OK to launch Hob. + Use Hob to customize and build your own images. + For information on Hob, see the + Hob Project Page on the + Yocto Project website. + + +
+