mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-06-02 01:19:52 +00:00
Code Issues Projects Releases Wiki Activity

documentation/adt-manual/adt-eclipse.xml: 1.1.2 variables and updates

Browse Source 
First pass at implementing the poky.ent variables.  Also corrected
text as needed.

(From yocto-docs rev: 1eecf5e4f706db5abbee7d819e612002f2425d6e)

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
2012-06-15 06:11:48 -07:00
committed by Richard Purdie
parent ec385088c4
commit ad050e2912
1 changed files with 51 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/adt-manual/adt-eclipse.xml
+51 -18
View File
@@ -1,5 +1,6 @@
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
<chapter id='adt-eclipse'> <chapter id='adt-eclipse'>
<title>Working Within Eclipse</title> <title>Working Within Eclipse</title>
@@ -34,6 +35,11 @@
<listitem><para>Install the Eclipse Yocto Plug-in.</para></listitem> <listitem><para>Install the Eclipse Yocto Plug-in.</para></listitem>
<listitem><para>Configure the Eclipse Yocto Plug-in.</para></listitem> <listitem><para>Configure the Eclipse Yocto Plug-in.</para></listitem>
</orderedlist> </orderedlist>
<note>
Do not install Eclipse from your distribution's package repository.
Be sure to install Eclipse from the official Eclipse download site as directed
in the next section.
</note>
</para> </para>
<section id='installing-eclipse-ide'> <section id='installing-eclipse-ide'>
@@ -43,7 +49,7 @@
It is recommended that you have the Indigo 3.7 version of the It is recommended that you have the Indigo 3.7 version of the
Eclipse IDE installed on your development system. Eclipse IDE installed on your development system.
If you don’t have this version, you can find it at If you don’t have this version, you can find it at
<ulink url='http://www.eclipse.org/downloads'></ulink>. <ulink url='&ECLIPSE_MAIN_URL;'></ulink>.
From that site, choose the Eclipse Classic version particular to your development From that site, choose the Eclipse Classic version particular to your development
host. host.
This version contains the Eclipse Platform, the Java Development This version contains the Eclipse Platform, the Java Development
@@ -100,20 +106,22 @@
<listitem><para>Make sure you are in your Workbench and select <listitem><para>Make sure you are in your Workbench and select
"Install New Software" from the "Help" pull-down menu. "Install New Software" from the "Help" pull-down menu.
</para></listitem> </para></listitem>
<listitem><para>Select <filename>indigo - http://download.eclipse.org/releases/indigo</filename> <listitem><para>Select <filename>indigo - &ECLIPSE_INDIGO_URL;</filename>
from the "Work with:" pull-down menu.</para></listitem> from the "Work with:" pull-down menu.</para></listitem>
<listitem><para>Expand the box next to <filename>Programming Languages</filename> <listitem><para>Expand the box next to <filename>Programming Languages</filename>
and select the <filename>Autotools Support for CDT (incubation)</filename> and select the <filename>Autotools Support for CDT (incubation)</filename>
and <filename>C/C++ Development Tools</filename> boxes.</para></listitem> and <filename>C/C++ Development Tools</filename> boxes.</para></listitem>
<listitem><para>Expand the box next to "Linux Tools" and select the
"LTTng - Linux Tracing Toolkit(incubation)" boxes.</para></listitem>
<listitem><para>Complete the installation and restart the Eclipse IDE.</para></listitem> <listitem><para>Complete the installation and restart the Eclipse IDE.</para></listitem>
<listitem><para>After the Eclipse IDE restarts and from the Workbench, select <listitem><para>After the Eclipse IDE restarts and from the Workbench, select
"Install New Software" from the "Help" pull-down menu.</para></listitem> "Install New Software" from the "Help" pull-down menu.</para></listitem>
<listitem><para>Click the <listitem><para>Click the
"Available Software Sites" link.</para></listitem> "Available Software Sites" link.</para></listitem>
<listitem><para>Check the box next to <listitem><para>Check the box next to
<filename>http://download.eclipse.org/tm/updates/3.3</filename> <filename>&ECLIPSE_UPDATES_URL;</filename>
and click "OK".</para></listitem> and click "OK".</para></listitem>
<listitem><para>Select <filename>http://download.eclipse.org/tm/updates/3.3</filename> <listitem><para>Select <filename>&ECLIPSE_UPDATES_URL;</filename>
from the "Work with:" pull-down menu.</para></listitem> from the "Work with:" pull-down menu.</para></listitem>
<listitem><para>Check the box next to <filename>TM and RSE Main Features</filename>. <listitem><para>Check the box next to <filename>TM and RSE Main Features</filename>.
</para></listitem> </para></listitem>
@@ -127,7 +135,7 @@
<listitem><para>After clicking "Available Software Sites", check the box next to <listitem><para>After clicking "Available Software Sites", check the box next to
<filename>http://download.eclipse.org/tools/cdt/releases/indigo</filename> <filename>http://download.eclipse.org/tools/cdt/releases/indigo</filename>
and click "OK".</para></listitem> and click "OK".</para></listitem>
<listitem><para>Select <filename>http://download.eclipse.org/tools/cdt/releases/indigo</filename> <listitem><para>Select <filename>&ECLIPSE_INDIGO_CDT_URL;</filename>
from the "Work with:" pull-down menu.</para></listitem> from the "Work with:" pull-down menu.</para></listitem>
<listitem><para>Check the box next to <filename>CDT Main Features</filename>. <listitem><para>Check the box next to <filename>CDT Main Features</filename>.
</para></listitem> </para></listitem>
@@ -162,7 +170,7 @@
<listitem><para>In Eclipse, select "Install New Software" from the "Help" menu.</para></listitem> <listitem><para>In Eclipse, select "Install New Software" from the "Help" menu.</para></listitem>
<listitem><para>Click "Add..." in the "Work with:" area.</para></listitem> <listitem><para>Click "Add..." in the "Work with:" area.</para></listitem>
<listitem><para>Enter <listitem><para>Enter
<filename>http://downloads.yoctoproject.org/releases/eclipse-plugin/1.1.1</filename> <filename>&ECLIPSE_DL_PLUGIN_URL;</filename>
in the URL field and provide a meaningful name in the "Name" field.</para></listitem> in the URL field and provide a meaningful name in the "Name" field.</para></listitem>
<listitem><para>Click "OK" to have the entry added to the "Work with:" <listitem><para>Click "OK" to have the entry added to the "Work with:"
drop-down list.</para></listitem> drop-down list.</para></listitem>
@@ -204,9 +212,9 @@
name of the Git branch along with the Yocto Project release you are name of the Git branch along with the Yocto Project release you are
using. using.
Here is an example that uses the <filename>master</filename> Git repository Here is an example that uses the <filename>master</filename> Git repository
and the <filename>1.1.1</filename> release: and the <filename>&DISTRO;</filename> release:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ scripts/build.sh master 1.1.1 $ scripts/build.sh master &DISTRO;
</literallayout> </literallayout>
After running the script, the file After running the script, the file
<filename>org.yocto.sdk-&lt;release&gt;-&lt;date&gt;-archive.zip</filename> <filename>org.yocto.sdk-&lt;release&gt;-&lt;date&gt;-archive.zip</filename>
@@ -322,7 +330,7 @@
</para></listitem> </para></listitem>
<listitem><para><emphasis>Point to the Toolchain:</emphasis> <listitem><para><emphasis>Point to the Toolchain:</emphasis>
If you are using a stand-alone pre-built toolchain, you should be pointing to the If you are using a stand-alone pre-built toolchain, you should be pointing to the
<filename>/opt/poky/1.1.1</filename> directory. <filename>&YOCTO_ADTPATH_DIR;</filename> directory.
This is the location for toolchains installed by the ADT Installer or by hand. This is the location for toolchains installed by the ADT Installer or by hand.
Sections "<link linkend='configuring-and-running-the-adt-installer-script'>Configuring Sections "<link linkend='configuring-and-running-the-adt-installer-script'>Configuring
and Running the ADT Installer Script</link>" and and Running the ADT Installer Script</link>" and
@@ -354,7 +362,7 @@
The pull-down menu should have the supported architectures. The pull-down menu should have the supported architectures.
If the architecture you need is not listed in the menu, you If the architecture you need is not listed in the menu, you
will need to build the image. will need to build the image.
See the "<ulink url='http://www.yoctoproject.org/docs/1.1.1/yocto-project-qs/yocto-project-qs.html#building-image'>Building an Image</ulink>" section See the "<ulink url='&YOCTO_DOCS_QS_URL;#building-image'>Building an Image</ulink>" section
of The Yocto Project Quick Start for more information.</para></listitem> of The Yocto Project Quick Start for more information.</para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
@@ -581,14 +589,14 @@
host can use, you must have <filename>oprofile</filename> version 0.9.4 or host can use, you must have <filename>oprofile</filename> version 0.9.4 or
greater installed on the host.</para> greater installed on the host.</para>
<para>You can locate both the viewer and server from <para>You can locate both the viewer and server from
<ulink url='http://git.yoctoproject.org/cgit/cgit.cgi/oprofileui/'></ulink>. <ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/oprofileui/'></ulink>.
<note>The <filename>oprofile-server</filename> is installed by default on <note>The <filename>oprofile-server</filename> is installed by default on
the <filename>core-image-sato-sdk</filename> image.</note></para></listitem> the <filename>core-image-sato-sdk</filename> image.</note></para></listitem>
<listitem><para><emphasis><filename>Lttng-ust</filename>:</emphasis> Selecting this tool runs <listitem><para><emphasis><filename>Lttng-ust</filename>:</emphasis> Selecting this tool runs
<filename>usttrace</filename> on the remote target, transfers the output data back to the <filename>usttrace</filename> on the remote target, transfers the output data back
local host machine, and uses <filename>lttv-gui</filename> to graphically display the output. to the local host machine, and uses the <filename>lttng</filename> Eclipse plug-in to
The <filename>lttv-gui</filename> must be installed on the local host machine to use this tool. graphically display the output.
For information on how to use <filename>lttng</filename> to trace an application, see For information on how to use <filename>lttng</filename> to trace an application, see
<ulink url='http://lttng.org/files/ust/manual/ust.html'></ulink>.</para> <ulink url='http://lttng.org/files/ust/manual/ust.html'></ulink>.</para>
<para>For <filename>Application</filename>, you must supply the absolute path name of the <para>For <filename>Application</filename>, you must supply the absolute path name of the
application to be traced by user mode <filename>lttng</filename>. application to be traced by user mode <filename>lttng</filename>.
@@ -596,7 +604,32 @@
<filename>usttrace /path/to/foo</filename> on the remote target to trace the <filename>usttrace /path/to/foo</filename> on the remote target to trace the
program <filename>/path/to/foo</filename>.</para> program <filename>/path/to/foo</filename>.</para>
<para><filename>Argument</filename> is passed to <filename>usttrace</filename> <para><filename>Argument</filename> is passed to <filename>usttrace</filename>
running on the remote target.</para></listitem> running on the remote target.</para>
<para>Before you use the <filename>lttng-ust</filename> tool, you need to setup
the <filename>lttng</filename> Eclipse plug-in and create a <filename>lttng</filename>
project.
Do the following:
<orderedlist>
<listitem><para>Follow these
<ulink url='http://wiki.eclipse.org/Linux_Tools_Project/LTTng#Downloading_and_installing_the_LTTng_parser_library'>instructions</ulink>
to download and install the <filename>lttng</filename> parser library.
</para></listitem>
<listitem><para>Select <filename>Window -> Open Perspective -> Other</filename>
and then select <filename>LTTng</filename>.</para></listitem>
<listitem><para>Click <filename>OK</filename> to change the Eclipse perspective
into the <filename>LTTng</filename> perspective.</para></listitem>
<listitem><para>Create a new <filename>LTTng</filename> project by selecting
<filename>File -> New -> Project</filename>.</para></listitem>
<listitem><para>Choose <filename>LTTng -> LTTng Project</filename>.</para></listitem>
<listitem><para>Click <filename>YoctoTools -> lttng-ust</filename> to start user mode
<filename>lttng</filename> on the remote target.</para></listitem>
</orderedlist></para>
<para>After the output data has been transferred from the remote target back to the local
host machine, new traces will be imported into the selected <filename>LTTng</filename> project.
Then you can go to the <filename>LTTng</filename> project, right click the imported
trace, and set the trace type as the <filename>LTTng</filename> kernel trace.
Finally, right click the imported trace and select <filename>Open</filename>
to display the data graphically.</para></listitem>
<listitem><para><emphasis><filename>PowerTOP</filename>:</emphasis> Selecting this tool runs <listitem><para><emphasis><filename>PowerTOP</filename>:</emphasis> Selecting this tool runs
<filename>powertop</filename> on the remote target machine and displays the results in a <filename>powertop</filename> on the remote target machine and displays the results in a
new view called <filename>powertop</filename>.</para> new view called <filename>powertop</filename>.</para>