From 1b1f8e5260e90460c1bc6eb9a4fdb9e227980d34 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 30 Sep 2011 08:34:48 -0700 Subject: documentation/adt-manual/adt-prepare.xml: Updated for building tcf-agent The YP only ships one pre-built image that has the tcf-agent built into it - core-image-sato-sdk. There are a couple methods that exist to create images that do not normally have this agent so that they will have it. I updated the "Getting the Images" section to contain those steps. Lianhao and Jessica Zhang were the technical resources for these changes. These changes are the first draft. (From yocto-docs rev: 85432e4892c3fe924bf90961f89e8edfd9693e84) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/adt-manual/adt-prepare.xml | 70 +++++++++++++++++++++++++++----- 1 file changed, 59 insertions(+), 11 deletions(-) (limited to 'documentation') diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index 48a82f5..8a1bc67 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml @@ -336,24 +336,72 @@ Quick Test Run" section of The Yocto Project Quick Start. - + + + The Yocto Project provides basic kernel and filesystem images for several architectures (x86, x86-64, mips, powerpc, and arm) that you can use unaltered in the QEMU emulator. These kernel images reside in the Yocto Project release 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 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 + and are ideal for experimentation within Yocto Project. + For information on the image types you can build using the Yocto Project, see the + "Reference: Images" appendix in - The Yocto Project Reference Manual. - + The Yocto Project Reference Manual. + + + + If you plan on remotely deploying and debugging your application from within the + Eclipse IDE, you must have an image that contains the Yocto Target Communication + Framework (TCF) agent (tcf-agent). + By default, the Yocto Project provides only one pre-built image that contains the + tcf-agent. + And, that image is core-image-sato-sdk. + + + + If you want to use a different image type that contains the tcf-agent, + you can do so one of two ways: + + Modify the conf/local.conf configuration in + the Yocto Project build directory and then rebuild the image. + With this method you need to modify the EXTRA_IMAGE_FEATURES + variable to have the value of "tools-debug" before rebuilding the image. + Once the image is rebuilt, the tcf-agent will be included + in the image and is launched automatically after the boot. + Manually build the tcf-agent. + To build the agent, follow these steps: + + Be sure the ADT is installed as described in the + "Installing the ADT" section. + + Set up the cross-development environment as described in the + "Setting + Up the Cross-Development Environment" section. + Get the tcf-agent source code, which is + stored using the Subversion SCM, using the following command: + + $ svn checkout svn://dev.eclipse.org/svnroot/dsdp/org.eclipse.tm.tcf/trunk/agent \ + <-r #rev_number> + + Modify the Makefile.inc file + for the cross-compilation environment by setting the + OPSYS and MACHINE + variables according to your target. + Use the cross-development tools to build the + tcf-agent. + Before you "Make" the file, be sure your cross-tools are set up first. + See the "Makefile-Based Projects" + section for information on how to make sure the cross-tools are set up + correctly. + If the build is successful, the tcf-agent output will + be obj/$(OPSYS)/$(MACHINE)/Debug/agent. + Deploy the agent into the image's root filesystem. + + + -- cgit v1.1