From 4d5dc4a8908c4f67268f2058e1ea6d76f72ca0ef Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 12 Aug 2016 10:20:16 -0700 Subject: sdk-manual: Created new Mars Eclipse appendix Fixes [YOCTO #7546] First draft of the new appendix supporting the Mars version of eclipse. New appendix file created and entry made to the sdk-manual.xml file to include that new appendix file into the main book. (From yocto-docs rev: 2fb79c29bcbb5c0801f67d4c245c07c3aa9d2ca2) Signed-off-by: Scott Rifenbark sdk-manual: WIP on appendix C Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/sdk-manual/sdk-using.xml | 152 +++------------------------------ 1 file changed, 14 insertions(+), 138 deletions(-) (limited to 'documentation/sdk-manual/sdk-using.xml') diff --git a/documentation/sdk-manual/sdk-using.xml b/documentation/sdk-manual/sdk-using.xml index 9354ace3b9..f8e2f005bd 100644 --- a/documentation/sdk-manual/sdk-using.xml +++ b/documentation/sdk-manual/sdk-using.xml @@ -533,10 +533,10 @@ Test and debug the application: Once your application is deployed, you need to test it. - Within the Eclipse IDE, you can use the debugging environment along with the - set of installed user-space tools to debug your application. - Of course, the same user-space tools are available separately if you choose - not to use the Eclipse IDE. + Within the Eclipse IDE, you can use the debugging + environment along with supported performance enhancing + tools. + @@ -565,9 +565,11 @@ execution of your output into a QEMU emulation session as well as actual target hardware. You can also perform cross-debugging and profiling. - The environment also supports a suite of tools that allows you - to perform remote profiling, tracing, collection of power data, - collection of latency data, and collection of performance data. + The environment also supports performance enhancing + tools that + allow you to perform remote profiling, tracing, collection of + power data, collection of latency data, and collection of + performance data. @@ -1317,144 +1319,18 @@ -
- Running User-Space Tools +
+ Running Performance Tools As mentioned earlier in the manual, several tools exist that enhance your development experience. These tools are aids in developing and debugging applications and images. - You can run these user-space tools from within the Eclipse + You can run these tools from within the Eclipse IDE through the "YoctoProjectTools" menu. - - - - Once you pick a tool, you need to configure it for the remote - target. - Every tool needs to have the connection configured. - You must select an existing TCF-based RSE connection to the - remote target. - If one does not exist, click "New" to create one. - - - - Here are some specifics about the remote tools: - - Lttng2.0 trace import: - Selecting this tool transfers the remote target's - Lttng tracing 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 - and the - "LTTng (Linux Trace Toolkit, next generation)" - section, which is in the Yocto Project Profiling and - Tracing Manual. - Do not use - Lttng-user space (legacy) tool. - This tool no longer has any upstream support. - - Before you use the - Lttng2.0 trace import tool, - you need to setup the Lttng Eclipse plug-in and create a - Tracing project. - Do the following: - - Select "Open Perspective" from the - "Window" menu and then select "Other..." to - bring up a menu of other perspectives. - Choose "Tracing". - - Click "OK" to change the Eclipse - perspective into the Tracing perspective. - - Create a new Tracing project by - selecting "Project" from the "File -> New" menu. - - Choose "Tracing Project" from the - "Tracing" menu and click "Next". - - Provide a name for your tracing - project and click "Finish". - - Generate your tracing data on the - remote target. - Select "Lttng2.0 trace import" - from the "Yocto Project Tools" menu to - start the data import process. - Specify your remote connection name. - - For the Ust directory path, specify - the location of your remote tracing data. - Make sure the location ends with - ust (e.g. - /usr/mysession/ust). - - Click "OK" to complete the import - process. - The data is now in the local tracing project - you created. - Right click on the data and then use - the menu to Select "Generic CTF Trace" from the - "Trace Type... -> Common Trace Format" menu to - map the tracing type. - Right click the mouse and select - "Open" to bring up the Eclipse Lttng Trace - Viewer so you view the tracing data. - - - PowerTOP: - Selecting this tool runs PowerTOP on the remote target - machine and displays the results in a new view called - PowerTOP. - The "Time to gather data(sec):" field is the time - passed in seconds before data is gathered from the - remote target for analysis. - The "show pids in wakeups list:" field corresponds - to the -p argument passed to - PowerTOP. - LatencyTOP and Perf: - LatencyTOP identifies system latency, while - Perf monitors the system's performance counter - registers. - Selecting either of these tools causes an RSE terminal - view to appear from which you can run the tools. - Both tools refresh the entire screen to display results - while they run. - For more information on setting up and using - perf, see the - "perf" - section in the Yocto Project Profiling and Tracing - Manual. - - SystemTap: - Systemtap is a tool that lets you create and reuse - scripts to examine the activities of a live Linux - system. - You can easily extract, filter, and summarize data - that helps you diagnose complex performance or - functional problems. - For more information on setting up and using - SystemTap, see the - SystemTap Documentation. - - yocto-bsp: - The yocto-bsp tool lets you - quickly set up a Board Support Package (BSP) layer. - The tool requires a Metadata location, build location, - BSP name, BSP output location, and a kernel - architecture. - For more information on the - yocto-bsp tool outside of Eclipse, - see the - "Creating a new BSP Layer Using the yocto-bsp Script" - section in the Yocto Project Board Support Package - (BSP) Developer's Guide. - - + For more information on these tools, see + http://www.eclipse.org/linuxtools/.
-- cgit v1.2.3-54-g00ecf