From 6e12a35e3d912f76c8ad88504b4fdf6ceaf1d6c5 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 11 May 2015 12:46:47 -0600 Subject: adt-manual: Updated the "Getting the Images" section for eclipse-debug The way to include tcf-agent now in an image that you are going to remotely deploy and debug using the Eclipse IDE is to simply include the eclipse-debug image feature as part of the image. I updated the section around getting images to reflect this simple method. Reported-by: Adam Lee (From yocto-docs rev: 9aec91d7f4fda558baa0e8a0290b42d76e735c63) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/adt-manual/adt-prepare.xml | 82 ++++++++++---------------------- 1 file changed, 24 insertions(+), 58 deletions(-) (limited to 'documentation/adt-manual') diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index 8776645207..814adbd615 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml @@ -480,8 +480,8 @@ and are ideal for experimentation using Yocto Project. For information on the image types you can build using the OpenEmbedded build system, see the - "Images" chapter in - the Yocto Project Reference Manual. + "Images" + chapter in the Yocto Project Reference Manual. @@ -492,62 +492,28 @@ - Furthermore, 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 type of pre-built - image that contains the tcf-agent. - And, those images are SDK (e.g.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 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 and Toolchains" section. - - Set up the cross-development environment as described in the - "Setting - Up the Cross-Development Environment" section. - Get the tcf-agent source code using - the following commands: - - $ git clone http://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.agent.git - $ cd org.eclipse.tcf.agent/agent - - Locate the - Makefile.inc file inside the - agent folder and modify it - 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. - - - + 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). + You can do this by including the eclipse-debug + image feature. + + See the + "Image Features" + section in the Yocto Project Reference Manual for information on + image features. + + To include the eclipse-debug image feature, + modify your local.conf file in the + Build Directory + so that the + EXTRA_IMAGE_FEATURES + variable includes the "eclipse-debug" feature. + After modifying the configuration file, you can rebuild the image. + Once the image is rebuilt, the tcf-agent + will be included in the image and is launched automatically after + the boot. -- cgit v1.2.3-54-g00ecf