From ad050e29125982d1ff7ba434e8668ba2dff70060 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 15 Jun 2012 06:11:48 -0700 Subject: documentation/adt-manual/adt-eclipse.xml: 1.1.2 variables and updates First pass at implementing the poky.ent variables. Also corrected text as needed. (From yocto-docs rev: 1eecf5e4f706db5abbee7d819e612002f2425d6e) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/adt-manual/adt-eclipse.xml | 69 +++++++++++++++++++++++--------- 1 file changed, 51 insertions(+), 18 deletions(-) diff --git a/documentation/adt-manual/adt-eclipse.xml b/documentation/adt-manual/adt-eclipse.xml index 95d71c4c93..2123198064 100644 --- a/documentation/adt-manual/adt-eclipse.xml +++ b/documentation/adt-manual/adt-eclipse.xml @@ -1,5 +1,6 @@ +"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" +[ %poky; ] > Working Within Eclipse @@ -34,6 +35,11 @@ Install the Eclipse Yocto Plug-in. Configure the Eclipse Yocto Plug-in. + + 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. +
@@ -43,7 +49,7 @@ It is recommended that you have the Indigo 3.7 version of the Eclipse IDE installed on your development system. If you don’t have this version, you can find it at - . + . From that site, choose the Eclipse Classic version particular to your development host. This version contains the Eclipse Platform, the Java Development @@ -100,20 +106,22 @@ Make sure you are in your Workbench and select "Install New Software" from the "Help" pull-down menu. - Select indigo - http://download.eclipse.org/releases/indigo + Select indigo - &ECLIPSE_INDIGO_URL; from the "Work with:" pull-down menu. Expand the box next to Programming Languages and select the Autotools Support for CDT (incubation) and C/C++ Development Tools boxes. + Expand the box next to "Linux Tools" and select the + "LTTng - Linux Tracing Toolkit(incubation)" boxes. Complete the installation and restart the Eclipse IDE. After the Eclipse IDE restarts and from the Workbench, select "Install New Software" from the "Help" pull-down menu. Click the "Available Software Sites" link. Check the box next to - http://download.eclipse.org/tm/updates/3.3 + &ECLIPSE_UPDATES_URL; and click "OK". - Select http://download.eclipse.org/tm/updates/3.3 + Select &ECLIPSE_UPDATES_URL; from the "Work with:" pull-down menu. Check the box next to TM and RSE Main Features. @@ -127,7 +135,7 @@ After clicking "Available Software Sites", check the box next to http://download.eclipse.org/tools/cdt/releases/indigo and click "OK". - Select http://download.eclipse.org/tools/cdt/releases/indigo + Select &ECLIPSE_INDIGO_CDT_URL; from the "Work with:" pull-down menu. Check the box next to CDT Main Features. @@ -162,7 +170,7 @@ In Eclipse, select "Install New Software" from the "Help" menu. Click "Add..." in the "Work with:" area. Enter - http://downloads.yoctoproject.org/releases/eclipse-plugin/1.1.1 + &ECLIPSE_DL_PLUGIN_URL; in the URL field and provide a meaningful name in the "Name" field. Click "OK" to have the entry added to the "Work with:" drop-down list. @@ -204,9 +212,9 @@ name of the Git branch along with the Yocto Project release you are using. Here is an example that uses the master Git repository - and the 1.1.1 release: + and the &DISTRO; release: - $ scripts/build.sh master 1.1.1 + $ scripts/build.sh master &DISTRO; After running the script, the file org.yocto.sdk-<release>-<date>-archive.zip @@ -322,7 +330,7 @@ Point to the Toolchain: If you are using a stand-alone pre-built toolchain, you should be pointing to the - /opt/poky/1.1.1 directory. + &YOCTO_ADTPATH_DIR; directory. This is the location for toolchains installed by the ADT Installer or by hand. Sections "Configuring and Running the ADT Installer Script" and @@ -354,7 +362,7 @@ The pull-down menu should have the supported architectures. If the architecture you need is not listed in the menu, you will need to build the image. - See the "Building an Image" section + See the "Building an Image" section of The Yocto Project Quick Start for more information. @@ -581,14 +589,14 @@ host can use, you must have oprofile version 0.9.4 or greater installed on the host. You can locate both the viewer and server from - . + . The oprofile-server is installed by default on the core-image-sato-sdk image. - Lttng-ust: Selecting this tool runs - usttrace on the remote target, transfers the output data back to the - local host machine, and uses lttv-gui to graphically display the output. - The lttv-gui must be installed on the local host machine to use this tool. - For information on how to use lttng to trace an application, see + Lttng-ust: Selecting this tool runs + usttrace on the remote target, transfers the output data back + to the local host machine, and uses the lttng Eclipse plug-in to + graphically display the output. + For information on how to use lttng to trace an application, see . For Application, you must supply the absolute path name of the application to be traced by user mode lttng. @@ -596,7 +604,32 @@ usttrace /path/to/foo on the remote target to trace the program /path/to/foo. Argument is passed to usttrace - running on the remote target. + running on the remote target. + Before you use the lttng-ust tool, you need to setup + the lttng Eclipse plug-in and create a lttng + project. + Do the following: + + Follow these + instructions + to download and install the lttng parser library. + + Select Window -> Open Perspective -> Other + and then select LTTng. + Click OK to change the Eclipse perspective + into the LTTng perspective. + Create a new LTTng project by selecting + File -> New -> Project. + Choose LTTng -> LTTng Project. + Click YoctoTools -> lttng-ust to start user mode + lttng on the remote target. + + 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 LTTng project. + Then you can go to the LTTng project, right click the imported + trace, and set the trace type as the LTTng kernel trace. + Finally, right click the imported trace and select Open + to display the data graphically. PowerTOP: Selecting this tool runs powertop on the remote target machine and displays the results in a new view called powertop. -- cgit v1.2.3-54-g00ecf