From 524f1f5bf8fde145834c8b02a8cf6fe5b521ff30 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Thu, 24 Oct 2013 08:42:21 -0700 Subject: yocto-project-qs: Updated the "Super User" section for no tarballs Fixes [YOCTO #5368] Partial fix for this issue. This section had two options for setting up the Source Directory (tarball and cloned repo). I removed the tarball option. Also, I did some routine formatting as well as verified that the example runs on a more recent Linux distro. Previously, the example was confirmed and stated that it ran on 10.04 Ubuntu. Well, this distro is not even in the supported list any longer so I ran it on a 12.04 Ubuntu machine and stated that. (From yocto-docs rev: 1203e083ec8f7ac91bd832a27273ab4afc5aa4c8) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../yocto-project-qs/yocto-project-qs.xml | 78 ++++++++++++---------- 1 file changed, 41 insertions(+), 37 deletions(-) (limited to 'documentation/yocto-project-qs/yocto-project-qs.xml') diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml index 73da290303..250398e63a 100644 --- a/documentation/yocto-project-qs/yocto-project-qs.xml +++ b/documentation/yocto-project-qs/yocto-project-qs.xml @@ -804,29 +804,23 @@ gives you a minimal description of how to use the Yocto Project to build images for a BeagleBoard xM starting from scratch. - The steps were performed on a 64-bit Ubuntu 10.04 system. + The steps were performed on a 64-bit Ubuntu 12.04 system.
Getting the Yocto Project - Set up your Source Directory - one of two ways: - - Tarball: - Use if you want the latest stable release: - - $ wget &YOCTO_RELEASE_DL_URL;/&YOCTO_POKY_TARBALL; - $ tar xvjf &YOCTO_POKY_TARBALL; - - Git Repository: - Use if you want to work with cutting edge development content: - + Set up your + Source Directory + by using Git to clone the poky poky + repository and then check out the release branch: + + $ cd ~ $ git clone git://git.yoctoproject.org/poky - - - The remainder of the section assumes the Git repository method. + $ cd poky + $ git checkout -b &DISTRO_NAME; origin/&DISTRO_NAME; +
@@ -835,7 +829,8 @@ You need some packages for everything to work. - Rather than duplicate them here, look at the "The Packages" + Rather than duplicate them here, look at the + "The Packages" section earlier in this quick start. @@ -844,17 +839,18 @@ Initializing the Build Environment - From the parent directory your + From the root directory of your Source Directory, initialize your environment and provide a meaningful Build Directory name: - $ source poky/&OE_INIT_FILE; mybuilds + $ source &OE_INIT_FILE; mybuilds - At this point, the mybuilds directory has been created for you - and it is now your current working directory. - If you don't provide your own directory name it defaults to build, + At this point, the mybuilds directory has + been created for you and it is now your current working directory. + If you don't provide your own directory name, + it defaults to build, which is inside the Source Directory. @@ -863,18 +859,21 @@ Configuring the local.conf File - Initializing the build environment creates a conf/local.conf configuration file + Initializing the build environment creates a + conf/local.conf configuration file in the Build Directory. - You need to manually edit this file to specify the machine you are building and to optimize - your build time. + You need to manually edit this file to specify the machine you + are building and to optimize your build time. Here are the minimal changes to make: BB_NUMBER_THREADS = "8" PARALLEL_MAKE = "-j 8" MACHINE ?= "beagleboard" - Briefly, set BB_NUMBER_THREADS - and PARALLEL_MAKE to + Briefly, set + BB_NUMBER_THREADS + and + PARALLEL_MAKE to twice your host processor's number of cores. @@ -924,9 +923,10 @@ Building the Image - At this point, you need to select an image to build for the BeagleBoard xM. - If this is your first build using the Yocto Project, you should try the smallest and simplest - image: + At this point, you need to select an image to build for the + BeagleBoard xM. + If this is your first build using the Yocto Project, you should try + the smallest and simplest image: $ bitbake core-image-minimal @@ -936,15 +936,18 @@ Here are some variations on the build process that could be helpful: - Fetch all the necessary sources without starting the build: + Fetch all the necessary sources without starting + the build: $ bitbake -c fetchall core-image-minimal - This variation guarantees that you have all the sources for that BitBake target - should you disconnect from the net and want to do the build later offline. - - Specify to continue the build even if BitBake encounters an error. - By default, BitBake aborts the build when it encounters an error. + This variation guarantees that you have all the sources for + that BitBake target should you disconnect from the net and + want to do the build later offline. + Specify to continue the build even if BitBake + encounters an error. + By default, BitBake aborts the build when it encounters an + error. This command keeps a faulty build going: $ bitbake -k core-image-minimal @@ -953,7 +956,8 @@ - Once you have your image, you can take steps to load and boot it on the target hardware. + Once you have your image, you can take steps to load and boot it on + the target hardware. -- cgit v1.2.3-54-g00ecf