From 77d1ba446c153afbe9fde7fcfa7afdd734104f9e Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Thu, 1 Sep 2011 09:18:33 -0700 Subject: documentation/adt-manual: General edits. I made a pass through the manual and made some general formatting changes, updated some links in anticipation for the 1.1 release. (From yocto-docs rev: f2d3a012fbe4e8db3cf07e5497acfdf732e55d97) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/adt-manual/adt-intro.xml | 108 ++++++++++++++++++--------------- 1 file changed, 58 insertions(+), 50 deletions(-) (limited to 'documentation/adt-manual/adt-intro.xml') diff --git a/documentation/adt-manual/adt-intro.xml b/documentation/adt-manual/adt-intro.xml index 220eb4b54b..211b174dc6 100644 --- a/documentation/adt-manual/adt-intro.xml +++ b/documentation/adt-manual/adt-intro.xml @@ -13,29 +13,41 @@
Introducing the Application Development Toolkit (ADT) + Fundamentally, the ADT consists of an architecture-specific cross-toolchain and - a matching sysroot that are both built by the Poky build system. + a matching sysroot that are both built by the Yocto Project build system Poky. The toolchain and sysroot are based on a metadata configuration and extensions, - which allows you to cross develop for the target on the host machine. + which allows you to cross-develop on the host machine for the target. + Additionally, to provide an effective development platform, the Yocto Project makes available and suggests other tools you can use with the ADT. These other tools include the Eclipse IDE Yocto Plug-in, an emulator (QEMU), and various user-space tools that greatly enhance your development experience. + The resulting combination of the architecture-specific cross-toolchain and sysroot along with these additional tools yields a custom-built, cross-development platform for a user-targeted product. +
+ +
+ ADT Components + + + This section provides a brief description of what comprises the ADT. +
The Cross-Toolchain + The cross-toolchain consists of a cross-compiler, cross-linker, and cross-debugger - that are used to develop for targeted hardware. + that are used to develop user-space applications for targeted hardware. This toolchain is created either by running the ADT Installer script or through a Yocto Project build tree that is based on your metadata configuration or extension for your targeted device. @@ -45,80 +57,76 @@
Sysroot + The matching target sysroot contains needed headers and libraries for generating binaries that run on the target architecture. The sysroot is based on the target root filesystem image that is built by - Poky and uses the same metadata configuration used to build the cross-toolchain. + the Yocto Project's build system Poky and uses the same metadata configuration + used to build the cross-toolchain.
The QEMU Emulator + The QEMU emulator allows you to simulate your hardware while running your application or image. QEMU is made available a number of ways: - If you use the ADT Installer script to install ADT you can - specify whether or not to install QEMU. + If you use the ADT Installer script to install ADT, you can + specify whether or not to install QEMU. If you have downloaded a Yocto Project release and unpacked - it to create a Yocto Project source directory followed by sourcing - the Yocto Project environment setup script, QEMU is installed and automatically - available. + it to create a Yocto Project file structure and you have sourced + the Yocto Project environment setup script, QEMU is installed and automatically + available. If you have installed the cross-toolchain - tarball followed by sourcing the toolchain's setup environment script, QEMU - is installed and automatically available. + tarball and you have sourcing the toolchain's setup environment script, QEMU + is also installed and automatically available.
User-Space Tools + User-space tools are included as part of the distribution. You will find these tools helpful during development. The tools include LatencyTOP, PowerTOP, OProfile, Perf, SystemTap, and Lttng-ust. These tools are common development tools for the Linux platform. - - LatencyTOP – LatencyTOP focuses on latency - that causes skips in audio, - stutters in your desktop experience, or situations that overload your server - even when you have plenty of CPU power left. - You can find out more about LatencyTOP at - . - - PowerTOP – Helps you determine what - software is using the most power. - You can find out more about PowerTOP at - . - - OProfile – A system-wide profiler for Linux - systems that is capable - of profiling all running code at low overhead. - You can find out more about OProfile at - . - - Perf – Performance counters for Linux used - to keep track of certain - types of hardware and software events. - For more information on these types of counters see - and click - on “Perf tools.” - - SystemTap – A free software infrastructure - that simplifies - information gathering about a running Linux system. - This information helps you diagnose performance or functional problems. - SystemTap is not available as a user-space tool through the Yocto Eclipse IDE Plug-in. - See for more information - on SystemTap. - - Lttng-ust – A User-space Tracer designed to - provide detailed information on user-space activity. - See for more information on Lttng-ust. - - + + LatencyTOP: LatencyTOP focuses on latency + that causes skips in audio, + stutters in your desktop experience, or situations that overload your server + even when you have plenty of CPU power left. + You can find out more about LatencyTOP at + . + PowerTOP: Helps you determine what + software is using the most power. + You can find out more about PowerTOP at + . + OProfile: A system-wide profiler for Linux + systems that is capable of profiling all running code at low overhead. + You can find out more about OProfile at + . + Perf: Performance counters for Linux used + to keep track of certain types of hardware and software events. + For more information on these types of counters see + and click + on “Perf tools.” + SystemTap: A free software infrastructure + that simplifies information gathering about a running Linux system. + This information helps you diagnose performance or functional problems. + SystemTap is not available as a user-space tool through the Yocto Eclipse IDE Plug-in. + See for more information + on SystemTap. + Lttng-ust: A User-space Tracer designed to + provide detailed information on user-space activity. + See for more information on Lttng-ust. + +
-- cgit v1.2.3-54-g00ecf