From 89496194bae76043719de99c304d76d682ac9464 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Thu, 15 Sep 2011 12:12:06 -0700 Subject: [PATCH] documentation/adt-manual/adt-prepare.xml: applied Jessica Zhang revisions These changes reflect corrections resulting from Jessica Zhang's review of the sections. (From yocto-docs rev: c3fed39bc3909c38424e7e72c40471dcb0053c8d) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/adt-manual/adt-prepare.xml | 73 ++++++++++++------------ 1 file changed, 38 insertions(+), 35 deletions(-) diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index 3eacf859dd..094ae01cb6 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml @@ -34,8 +34,8 @@ If you use this method, you just get the cross-toolchain and QEMU - you do not get any of the other mentioned benefits had you run the ADT Installer script. Use the Toolchain from within a Yocto Project Build Tree: - If you already have a Yocto Project build tree, you can install the cross-toolchain - using that tree. + If you already have a Yocto Project build tree, you can build the cross-toolchain + within tree. However, like the previous method mentioned, you only get the cross-toolchain and QEMU - you do not get any of the other benefits without taking separate steps. @@ -62,7 +62,8 @@ If you use BitBake to generate the ADT Installer tarball, you must - source the Yocto Project environment setup script located + source the Yocto Project environment setup script + (oe-init-build-env) located in the Yocto Project file structure before running the bitbake command that creates the tarball. @@ -209,30 +210,30 @@ Go into that folder and download the toolchain tarball whose name includes the appropriate target architecture. For example, if your host development system is an Intel-based 64-bit system and - you are going to use your cross-toolchain for an ARM-based target, go into the + you are going to use your cross-toolchain for an Intel-based 32-bit target, go into the x86_64 folder and download the following tarball: yocto-eglibc-x86_64-i586-toolchain-gmae-1.1.tar.bz2 The cross-toolchain tarballs provided by the Yocto Project support development - of GNOME platorms on mobile devices (GMAE). + of GNOME platforms on mobile devices (GMAE). As an alternative to steps one and two, you can build the toolchain tarball if you have a Yocto Project build tree. If you need GMAE, you should use the bitbake meta-toolchain-gmae command. The resulting tarball will support such development. - However, if you not concerned with GMAE, + However, if you are not concerned with GMAE, you can generate the tarball using bitbake meta-toolchain. Use the appropriate bitbake command only after you have - sourced the oe-build-init script located in the Yocto + sourced the oe-build-init-env script located in the Yocto Project files. - When the bitbake command completes, the toolchain tarball will + When the bitbake command completes, the tarball will be in tmp/deploy/sdk in the Yocto Project build tree. Make sure you are in the root directory with root privileges and then expand the tarball. The tarball expands into /opt/poky/$SDKVERSION. - Once the tarball in unpacked, the cross-toolchain is installed. + Once the tarball is expanded, the cross-toolchain is installed. You will notice environment setup files for the cross-toolchain in the directory. @@ -243,21 +244,19 @@ Using BitBake and the Yocto Project Build Tree - A final way of installing just the cross-toolchain is to use BitBake within an existing - Yocto Project build tree. - This method installs the toolchain into the Yocto Project build tree, not the - /opt directory. + A final way of installing just the cross-toolchain is to use BitBake to build the + toolchain within an existing Yocto Project build tree. + This method does not install the toolchain into the /opt directory. As with the previous method, if you need to install the target sysroot, you must do this separately. - Follow these steps to install the toolchain into the build tree: + Follow these steps to build and install the toolchain into the build tree: - Source the environment setup script located in the Yocto Project - files. - The script has the string init-build-env - as part of the name. + Source the environment setup script + oe-init-build-env located in the Yocto Project + files. At this point, you should be sure that the MACHINE variable in the local.conf file found in the Yocto Project @@ -272,12 +271,12 @@ command. Run bitbake meta-ide-support to complete the cross-toolchain installation. - If you change your working directory after you + If change out of your working directory after you source the environment setup script and before you run - the BitBake command, the command will not work. + the BitBake command, the command might not work. Be sure to run the bitbake command immediately after checking or editing the local.conf but without - changing your working directory. + changing out of your working directory. Once BitBake finishes, the cross-toolchain is installed within the Yocto Project build tree. You will notice environment setup files for the cross-toolchain in the @@ -289,12 +288,12 @@ -
- Setting Up the Environment +
+ Setting Up the Cross-Development Environment - Before you can use the cross-toolchain, you need to set up the toolchain environment by - sourcing the environment setup script. + Before you can develop using the cross-toolchain, you need to set up the + cross-development environment by sourcing the environment setup script. If you used the ADT Installer or used an existing ADT tarball to install the ADT, then you can find this script in the /opt/poky/$SDKVERSION directory. @@ -323,14 +322,13 @@ hardware or the QEMU emulator. Furthermore, if you plan on booting your image using NFS or you want to use the root filesystem as the target sysroot, you need to extract the root filesystem. - This section describes how to get set up with the kernel and filesystem images.
Getting the Images - To get the kernel and filesystem images you either have to build them or download + To get the kernel and filesystem images, you either have to build them or download pre-built versions. You can find examples for both these situations in the "A @@ -346,7 +344,9 @@ area - and are ideal for experimentation within Yocto Project. If you plan on remotely deploying and debugging your application from within the - Eclipse IDE, you must have an image that supports Sato. + Eclipse IDE, you must have an image that contains the Yocto Target Communication + Framework (TCF) agent (tcf-agent), which is the + core-image-sato-sdk image. For information on the image types you can build using the Yocto Project, see Reference: Images in @@ -360,23 +360,26 @@ Extracting the Root Filesystem - You must extract the root filesystem if you want to boot the image using NFS or you - want to use the root filesystem as the target sysroot. + You must extract the root filesystem if you want to boot the image using NFS + or you want to use the root filesystem as the target sysroot. For example, the Eclipse IDE environment with the Eclipse Yocto Plug-in installed allows you - to boot under NFS. - Another example is if you want to test your image against actual hardware with the + to use QEMU to boot under NFS. + Another example is if you want to develop your target application using the root filesystem as the target sysroot. - To extract the root filesystem you use the runqemu-extract-sdk command on the + To extract the root filesystem, first source + the cross-development environment setup script and then + use the runqemu-extract-sdk command on the filesystem image. - For example, the following command extracts the root filesystem from a previously built - filesystem image tarball named + For example, the following commands set up the environment and then extract + the root filesystem from a previously built filesystem image tarball named core-image-sato-sdk-qemux86-2011091411831.rootfs.tar.bz2. The example extracts the root filesystem into the $HOME/qemux86-sato directory: + $ source $HOME/poky/build/tmp/environment-setup-i586-poky-linux $ runqemu-extract-sdk \ tmp/deploy/images/core-image-sato-sdk-qemux86-2011091411831.rootfs.tar.bz2 \ $HOME/qemux86-sato