diff options
| -rw-r--r-- | documentation/adt-manual/adt-prepare.xml | 82 |
1 files changed, 24 insertions, 58 deletions
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 @@ | |||
| 480 | and are ideal for experimentation using Yocto Project. | 480 | and are ideal for experimentation using Yocto Project. |
| 481 | For information on the image types you can build using the OpenEmbedded build system, | 481 | For information on the image types you can build using the OpenEmbedded build system, |
| 482 | see the | 482 | see the |
| 483 | "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>" chapter in | 483 | "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>" |
| 484 | the Yocto Project Reference Manual. | 484 | chapter in the Yocto Project Reference Manual. |
| 485 | </para> | 485 | </para> |
| 486 | 486 | ||
| 487 | <para> | 487 | <para> |
| @@ -492,62 +492,28 @@ | |||
| 492 | </para> | 492 | </para> |
| 493 | 493 | ||
| 494 | <para> | 494 | <para> |
| 495 | Furthermore, if you plan on remotely deploying and debugging your | 495 | If you plan on remotely deploying and debugging your |
| 496 | application from within the | 496 | application from within the Eclipse IDE, you must have an image |
| 497 | Eclipse IDE, you must have an image that contains the Yocto Target Communication | 497 | that contains the Yocto Target Communication Framework (TCF) agent |
| 498 | Framework (TCF) agent (<filename>tcf-agent</filename>). | 498 | (<filename>tcf-agent</filename>). |
| 499 | By default, the Yocto Project provides only one type of pre-built | 499 | You can do this by including the <filename>eclipse-debug</filename> |
| 500 | image that contains the <filename>tcf-agent</filename>. | 500 | image feature. |
| 501 | And, those images are SDK (e.g.<filename>core-image-sato-sdk</filename>). | 501 | <note> |
| 502 | </para> | 502 | See the |
| 503 | 503 | "<ulink url='&YOCTO_DOCS_REF_URL;#ref-features-image'>Image Features</ulink>" | |
| 504 | <para> | 504 | section in the Yocto Project Reference Manual for information on |
| 505 | If you want to use a different image type that contains the <filename>tcf-agent</filename>, | 505 | image features. |
| 506 | you can do so one of two ways: | 506 | </note> |
| 507 | <itemizedlist> | 507 | To include the <filename>eclipse-debug</filename> image feature, |
| 508 | <listitem><para>Modify the <filename>conf/local.conf</filename> configuration in | 508 | modify your <filename>local.conf</filename> file in the |
| 509 | the <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> | 509 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> |
| 510 | and then rebuild the image. | 510 | so that the |
| 511 | With this method, you need to modify the | 511 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_IMAGE_FEATURES'><filename>EXTRA_IMAGE_FEATURES</filename></ulink> |
| 512 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_IMAGE_FEATURES'><filename>EXTRA_IMAGE_FEATURES</filename></ulink> | 512 | variable includes the "eclipse-debug" feature. |
| 513 | variable to have the value of "tools-debug" before rebuilding the image. | 513 | After modifying the configuration file, you can rebuild the image. |
| 514 | Once the image is rebuilt, the <filename>tcf-agent</filename> will be included | 514 | Once the image is rebuilt, the <filename>tcf-agent</filename> |
| 515 | in the image and is launched automatically after the boot.</para></listitem> | 515 | will be included in the image and is launched automatically after |
| 516 | <listitem><para>Manually build the <filename>tcf-agent</filename>. | 516 | the boot. |
| 517 | To build the agent, follow these steps: | ||
| 518 | <orderedlist> | ||
| 519 | <listitem><para>Be sure the ADT is installed as described in the | ||
| 520 | "<link linkend='installing-the-adt'>Installing the ADT and Toolchains</link>" section. | ||
| 521 | </para></listitem> | ||
| 522 | <listitem><para>Set up the cross-development environment as described in the | ||
| 523 | "<link linkend='setting-up-the-cross-development-environment'>Setting | ||
| 524 | Up the Cross-Development Environment</link>" section.</para></listitem> | ||
| 525 | <listitem><para>Get the <filename>tcf-agent</filename> source code using | ||
| 526 | the following commands: | ||
| 527 | <literallayout class='monospaced'> | ||
| 528 | $ git clone http://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.agent.git | ||
| 529 | $ cd org.eclipse.tcf.agent/agent | ||
| 530 | </literallayout></para></listitem> | ||
| 531 | <listitem><para>Locate the | ||
| 532 | <filename>Makefile.inc</filename> file inside the | ||
| 533 | <filename>agent</filename> folder and modify it | ||
| 534 | for the cross-compilation environment by setting the | ||
| 535 | <filename>OPSYS</filename> and | ||
| 536 | <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink> | ||
| 537 | variables according to your target. | ||
| 538 | </para></listitem> | ||
| 539 | <listitem><para>Use the cross-development tools to build the | ||
| 540 | <filename>tcf-agent</filename>. | ||
| 541 | Before you "Make" the file, be sure your cross-tools are set up first. | ||
| 542 | See the "<link linkend='makefile-based-projects'>Makefile-Based Projects</link>" | ||
| 543 | section for information on how to make sure the cross-tools are set up | ||
| 544 | correctly.</para> | ||
| 545 | <para>If the build is successful, the <filename>tcf-agent</filename> output will | ||
| 546 | be <filename>obj/$(OPSYS)/$(MACHINE)/Debug/agent</filename>.</para></listitem> | ||
| 547 | <listitem><para>Deploy the agent into the image's root filesystem.</para></listitem> | ||
| 548 | </orderedlist> | ||
| 549 | </para></listitem> | ||
| 550 | </itemizedlist> | ||
| 551 | </para> | 517 | </para> |
| 552 | </section> | 518 | </section> |
| 553 | 519 | ||