From 49c911f7051c5483b0280b189f71017bce9c00fb Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 23 Mar 2012 12:23:09 -0600 Subject: documentation/adt-manual: Edits to fix ADT manual for 1.2 per bug 2025 Addressed all issues specified by [YOCTO #2025] except for the very first one that says bring the versions up to 1.2. This will be accomplished by the poky.ent bump at release time. Fixes [YOCTO #2025] (From yocto-docs rev: 926e5635d8cd74fff7e00002108ce8c039252203) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/adt-manual/adt-eclipse.xml | 62 ++++++++++++++++++++++---------- documentation/adt-manual/adt-prepare.xml | 10 +++--- 2 files changed, 49 insertions(+), 23 deletions(-) (limited to 'documentation/adt-manual') diff --git a/documentation/adt-manual/adt-eclipse.xml b/documentation/adt-manual/adt-eclipse.xml index cb642ebed7..dcc201cdc8 100644 --- a/documentation/adt-manual/adt-eclipse.xml +++ b/documentation/adt-manual/adt-eclipse.xml @@ -41,7 +41,7 @@ Installing the Eclipse IDE - It is recommended that you have the Indigo 3.7 version of the + It is recommended that you have the Indigo 3.7.2 version of the Eclipse IDE installed on your development system. If you don’t have this version, you can find it at . @@ -106,6 +106,8 @@ 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. @@ -144,19 +146,19 @@ Installing or Accessing the Eclipse Yocto Plug-in - You can install the Eclipse Yocto Plug-in into the Eclipse application - one of two ways: using the Eclipse IDE and installing the plug-in as new software, or - using a built zip file. + You can install the Eclipse Yocto Plug-in into the Eclipse IDE + one of two ways: use the Yocto Project update site to install the pre-built plug-in, + or build and install the plug-in from the latest source code. If you don't want to permanently install the plug-in but just want to try it out within the Eclipse environment, you can import the plug-in project from the Yocto Project source repositories.
- Installing the Plug-in as New Software + Installing the Pre-built Plug-in from the Yocto Project Eclipse Update Site - To install the Eclipse Yocto Plug-in as new software directly into the Eclipse IDE, + To install the Eclipse Yocto Plug-in from the update site, follow these steps: Start up the Eclipse IDE. @@ -179,10 +181,9 @@
- Installing the Plug-in from a Zip File + Installing the Plug-in Using the Latest Source Code - To install the Eclipse Yocto Plug-in by building and installing a plug-in - zip file, follow these steps: + To install the Eclipse Yocto Plug-in from the latest source code, follow these steps: Open a shell and create a Git repository with: @@ -257,9 +258,9 @@ and then click "Next". Select the root directory and browse to ~/yocto-eclipse/plugins. - There will be three things there. - Select each one and install one at a time. - Do all three. + Three plug-ins exist: "org.yocto.bc.ui", "org.yocto.sdk.ide", and + "org.yocto.sdk.remotetools". + Select and import all of them. @@ -585,11 +586,11 @@ . 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. @@ -597,7 +598,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. diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index 9880fcc7d1..3ced7f6ded 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml @@ -168,7 +168,7 @@ After you have configured the adt_installer.conf file, run the installer using the following command: - $ adt_installer + $ ./adt_installer @@ -384,11 +384,11 @@ Set up the cross-development environment as described in the "Setting Up the Cross-Development Environment" section. - Get the tcf-agent source code, which is - stored using the Subversion SCM, using the following command: + Get the tcf-agent source code using + the following commands: - $ svn checkout svn://dev.eclipse.org/svnroot/dsdp/org.eclipse.tm.tcf/trunk/agent \ - <-r #rev_number> + $ git clone http://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.agent.git + $ cd agent Modify the Makefile.inc file for the cross-compilation environment by setting the -- cgit v1.2.3-54-g00ecf