sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

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 <adam@gumstix.com>
(From yocto-docs rev: 9aec91d7f4fda558baa0e8a0290b42d76e735c63)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2015-05-11 12:46:47 -06:00 committed by Richard Purdie
parent d9cf5753df
commit 6e12a35e3d
1 changed files with 24 additions and 58 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

82
documentation/adt-manual/adt-prepare.xml
View File

@ -480,8 +480,8 @@
and are ideal for experimentation using Yocto Project. and are ideal for experimentation using Yocto Project.
For information on the image types you can build using the OpenEmbedded build system, For information on the image types you can build using the OpenEmbedded build system,
see the see the
"<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>" chapter in "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>"
the Yocto Project Reference Manual. chapter in the Yocto Project Reference Manual.
</para> </para>
<para> <para>
@ -492,62 +492,28 @@
</para> </para>
<para> <para>
Furthermore, if you plan on remotely deploying and debugging your If you plan on remotely deploying and debugging your
application from within the application from within the Eclipse IDE, you must have an image
Eclipse IDE, you must have an image that contains the Yocto Target Communication that contains the Yocto Target Communication Framework (TCF) agent
Framework (TCF) agent (<filename>tcf-agent</filename>). (<filename>tcf-agent</filename>).
By default, the Yocto Project provides only one type of pre-built You can do this by including the <filename>eclipse-debug</filename>
image that contains the <filename>tcf-agent</filename>. image feature.
And, those images are SDK (e.g.<filename>core-image-sato-sdk</filename>). <note>
</para> See the
"<ulink url='&YOCTO_DOCS_REF_URL;#ref-features-image'>Image Features</ulink>"
<para> section in the Yocto Project Reference Manual for information on
If you want to use a different image type that contains the <filename>tcf-agent</filename>, image features.
you can do so one of two ways: </note>
<itemizedlist> To include the <filename>eclipse-debug</filename> image feature,
<listitem><para>Modify the <filename>conf/local.conf</filename> configuration in modify your <filename>local.conf</filename> file in the
the <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>
and then rebuild the image. so that the
With this method, you need to modify the <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_IMAGE_FEATURES'><filename>EXTRA_IMAGE_FEATURES</filename></ulink>
<ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_IMAGE_FEATURES'><filename>EXTRA_IMAGE_FEATURES</filename></ulink> variable includes the "eclipse-debug" feature.
variable to have the value of "tools-debug" before rebuilding the image. After modifying the configuration file, you can rebuild the image.
Once the image is rebuilt, the <filename>tcf-agent</filename> will be included Once the image is rebuilt, the <filename>tcf-agent</filename>
in the image and is launched automatically after the boot.</para></listitem> will be included in the image and is launched automatically after
<listitem><para>Manually build the <filename>tcf-agent</filename>. the boot.
To build the agent, follow these steps:
<orderedlist>
<listitem><para>Be sure the ADT is installed as described in the
"<link linkend='installing-the-adt'>Installing the ADT and Toolchains</link>" section.
</para></listitem>
<listitem><para>Set up the cross-development environment as described in the
"<link linkend='setting-up-the-cross-development-environment'>Setting
Up the Cross-Development Environment</link>" section.</para></listitem>
<listitem><para>Get the <filename>tcf-agent</filename> source code using
the following commands:
<literallayout class='monospaced'>
$ git clone http://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.agent.git
$ cd org.eclipse.tcf.agent/agent
</literallayout></para></listitem>
<listitem><para>Locate the
<filename>Makefile.inc</filename> file inside the
<filename>agent</filename> folder and modify it
for the cross-compilation environment by setting the
<filename>OPSYS</filename> and
<ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>
variables according to your target.
</para></listitem>
<listitem><para>Use the cross-development tools to build the
<filename>tcf-agent</filename>.
Before you "Make" the file, be sure your cross-tools are set up first.
See the "<link linkend='makefile-based-projects'>Makefile-Based Projects</link>"
section for information on how to make sure the cross-tools are set up
correctly.</para>
<para>If the build is successful, the <filename>tcf-agent</filename> output will
be <filename>obj/$(OPSYS)/$(MACHINE)/Debug/agent</filename>.</para></listitem>
<listitem><para>Deploy the agent into the image's root filesystem.</para></listitem>
</orderedlist>
</para></listitem>
</itemizedlist>
</para> </para>
</section> </section>