diff options
Diffstat (limited to 'documentation/adt-manual/adt-intro.xml')
-rw-r--r-- | documentation/adt-manual/adt-intro.xml | 108 |
1 files changed, 58 insertions, 50 deletions
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 @@ | |||
13 | 13 | ||
14 | <section id='book-intro'> | 14 | <section id='book-intro'> |
15 | <title>Introducing the Application Development Toolkit (ADT)</title> | 15 | <title>Introducing the Application Development Toolkit (ADT)</title> |
16 | |||
16 | <para> | 17 | <para> |
17 | Fundamentally, the ADT consists of an architecture-specific cross-toolchain and | 18 | Fundamentally, the ADT consists of an architecture-specific cross-toolchain and |
18 | a matching sysroot that are both built by the Poky build system. | 19 | a matching sysroot that are both built by the Yocto Project build system Poky. |
19 | The toolchain and sysroot are based on a metadata configuration and extensions, | 20 | The toolchain and sysroot are based on a metadata configuration and extensions, |
20 | which allows you to cross develop for the target on the host machine. | 21 | which allows you to cross-develop on the host machine for the target. |
21 | </para> | 22 | </para> |
23 | |||
22 | <para> | 24 | <para> |
23 | Additionally, to provide an effective development platform, the Yocto Project | 25 | Additionally, to provide an effective development platform, the Yocto Project |
24 | makes available and suggests other tools you can use with the ADT. | 26 | makes available and suggests other tools you can use with the ADT. |
25 | These other tools include the Eclipse IDE Yocto Plug-in, an emulator (QEMU), | 27 | These other tools include the Eclipse IDE Yocto Plug-in, an emulator (QEMU), |
26 | and various user-space tools that greatly enhance your development experience. | 28 | and various user-space tools that greatly enhance your development experience. |
27 | </para> | 29 | </para> |
30 | |||
28 | <para> | 31 | <para> |
29 | The resulting combination of the architecture-specific cross-toolchain and sysroot | 32 | The resulting combination of the architecture-specific cross-toolchain and sysroot |
30 | along with these additional tools yields a custom-built, cross-development platform | 33 | along with these additional tools yields a custom-built, cross-development platform |
31 | for a user-targeted product. | 34 | for a user-targeted product. |
32 | </para> | 35 | </para> |
36 | </section> | ||
37 | |||
38 | <section id='adt-components'> | ||
39 | <title>ADT Components</title> | ||
40 | |||
41 | <para> | ||
42 | This section provides a brief description of what comprises the ADT. | ||
43 | </para> | ||
33 | 44 | ||
34 | <section id='the-cross-toolchain'> | 45 | <section id='the-cross-toolchain'> |
35 | <title>The Cross-Toolchain</title> | 46 | <title>The Cross-Toolchain</title> |
47 | |||
36 | <para> | 48 | <para> |
37 | The cross-toolchain consists of a cross-compiler, cross-linker, and cross-debugger | 49 | The cross-toolchain consists of a cross-compiler, cross-linker, and cross-debugger |
38 | that are used to develop for targeted hardware. | 50 | that are used to develop user-space applications for targeted hardware. |
39 | This toolchain is created either by running the ADT Installer script or | 51 | This toolchain is created either by running the ADT Installer script or |
40 | through a Yocto Project build tree that is based on your metadata | 52 | through a Yocto Project build tree that is based on your metadata |
41 | configuration or extension for your targeted device. | 53 | configuration or extension for your targeted device. |
@@ -45,80 +57,76 @@ | |||
45 | 57 | ||
46 | <section id='sysroot'> | 58 | <section id='sysroot'> |
47 | <title>Sysroot</title> | 59 | <title>Sysroot</title> |
60 | |||
48 | <para> | 61 | <para> |
49 | The matching target sysroot contains needed headers and libraries for generating | 62 | The matching target sysroot contains needed headers and libraries for generating |
50 | binaries that run on the target architecture. | 63 | binaries that run on the target architecture. |
51 | The sysroot is based on the target root filesystem image that is built by | 64 | The sysroot is based on the target root filesystem image that is built by |
52 | Poky and uses the same metadata configuration used to build the cross-toolchain. | 65 | the Yocto Project's build system Poky and uses the same metadata configuration |
66 | used to build the cross-toolchain. | ||
53 | </para> | 67 | </para> |
54 | </section> | 68 | </section> |
55 | 69 | ||
56 | <section id='the-qemu-emulator'> | 70 | <section id='the-qemu-emulator'> |
57 | <title>The QEMU Emulator</title> | 71 | <title>The QEMU Emulator</title> |
72 | |||
58 | <para> | 73 | <para> |
59 | The QEMU emulator allows you to simulate your hardware while running your | 74 | The QEMU emulator allows you to simulate your hardware while running your |
60 | application or image. | 75 | application or image. |
61 | QEMU is made available a number of ways: | 76 | QEMU is made available a number of ways: |
62 | <itemizedlist> | 77 | <itemizedlist> |
63 | <listitem><para>If you use the ADT Installer script to install ADT you can | 78 | <listitem><para>If you use the ADT Installer script to install ADT, you can |
64 | specify whether or not to install QEMU.</para></listitem> | 79 | specify whether or not to install QEMU.</para></listitem> |
65 | <listitem><para>If you have downloaded a Yocto Project release and unpacked | 80 | <listitem><para>If you have downloaded a Yocto Project release and unpacked |
66 | it to create a Yocto Project source directory followed by sourcing | 81 | it to create a Yocto Project file structure and you have sourced |
67 | the Yocto Project environment setup script, QEMU is installed and automatically | 82 | the Yocto Project environment setup script, QEMU is installed and automatically |
68 | available.</para></listitem> | 83 | available.</para></listitem> |
69 | <listitem><para>If you have installed the cross-toolchain | 84 | <listitem><para>If you have installed the cross-toolchain |
70 | tarball followed by sourcing the toolchain's setup environment script, QEMU | 85 | tarball and you have sourcing the toolchain's setup environment script, QEMU |
71 | is installed and automatically available.</para></listitem> | 86 | is also installed and automatically available.</para></listitem> |
72 | </itemizedlist> | 87 | </itemizedlist> |
73 | </para> | 88 | </para> |
74 | </section> | 89 | </section> |
75 | 90 | ||
76 | <section id='user-space-tools'> | 91 | <section id='user-space-tools'> |
77 | <title>User-Space Tools</title> | 92 | <title>User-Space Tools</title> |
93 | |||
78 | <para> | 94 | <para> |
79 | User-space tools are included as part of the distribution. | 95 | User-space tools are included as part of the distribution. |
80 | You will find these tools helpful during development. | 96 | You will find these tools helpful during development. |
81 | The tools include LatencyTOP, PowerTOP, OProfile, Perf, SystemTap, and Lttng-ust. | 97 | The tools include LatencyTOP, PowerTOP, OProfile, Perf, SystemTap, and Lttng-ust. |
82 | These tools are common development tools for the Linux platform. | 98 | These tools are common development tools for the Linux platform. |
83 | <itemizedlist> | 99 | <itemizedlist> |
84 | <listitem><para><emphasis>LatencyTOP</emphasis> – LatencyTOP focuses on latency | 100 | <listitem><para><emphasis>LatencyTOP:</emphasis> LatencyTOP focuses on latency |
85 | that causes skips in audio, | 101 | that causes skips in audio, |
86 | stutters in your desktop experience, or situations that overload your server | 102 | stutters in your desktop experience, or situations that overload your server |
87 | even when you have plenty of CPU power left. | 103 | even when you have plenty of CPU power left. |
88 | You can find out more about LatencyTOP at | 104 | You can find out more about LatencyTOP at |
89 | <ulink url='http://www.latencytop.org/'></ulink>. | 105 | <ulink url='http://www.latencytop.org/'></ulink>.</para></listitem> |
90 | </para></listitem> | 106 | <listitem><para><emphasis>PowerTOP:</emphasis> Helps you determine what |
91 | <listitem><para><emphasis>PowerTOP</emphasis> – Helps you determine what | 107 | software is using the most power. |
92 | software is using the most power. | 108 | You can find out more about PowerTOP at |
93 | You can find out more about PowerTOP at | 109 | <ulink url='http://www.linuxpowertop.org/'></ulink>.</para></listitem> |
94 | <ulink url='http://www.linuxpowertop.org/'></ulink>. | 110 | <listitem><para><emphasis>OProfile:</emphasis> A system-wide profiler for Linux |
95 | </para></listitem> | 111 | systems that is capable of profiling all running code at low overhead. |
96 | <listitem><para><emphasis>OProfile</emphasis> – A system-wide profiler for Linux | 112 | You can find out more about OProfile at |
97 | systems that is capable | 113 | <ulink url='http://oprofile.sourceforge.net/about/'></ulink>.</para></listitem> |
98 | of profiling all running code at low overhead. | 114 | <listitem><para><emphasis>Perf:</emphasis> Performance counters for Linux used |
99 | You can find out more about OProfile at | 115 | to keep track of certain types of hardware and software events. |
100 | <ulink url='http://oprofile.sourceforge.net/about/'></ulink>. | 116 | For more information on these types of counters see |
101 | </para></listitem> | 117 | <ulink url='https://perf.wiki.kernel.org/index.php'></ulink> and click |
102 | <listitem><para><emphasis>Perf</emphasis> – Performance counters for Linux used | 118 | on “Perf tools.”</para></listitem> |
103 | to keep track of certain | 119 | <listitem><para><emphasis>SystemTap:</emphasis> A free software infrastructure |
104 | types of hardware and software events. | 120 | that simplifies information gathering about a running Linux system. |
105 | For more information on these types of counters see | 121 | This information helps you diagnose performance or functional problems. |
106 | <ulink url='https://perf.wiki.kernel.org/index.php'></ulink> and click | 122 | SystemTap is not available as a user-space tool through the Yocto Eclipse IDE Plug-in. |
107 | on “Perf tools.” | 123 | See <ulink url='http://sourceware.org/systemtap'></ulink> for more information |
108 | </para></listitem> | 124 | on SystemTap.</para></listitem> |
109 | <listitem><para><emphasis>SystemTap</emphasis> – A free software infrastructure | 125 | <listitem><para><emphasis>Lttng-ust:</emphasis> A User-space Tracer designed to |
110 | that simplifies | 126 | provide detailed information on user-space activity. |
111 | information gathering about a running Linux system. | 127 | See <ulink url='http://lttng.org/ust'></ulink> for more information on Lttng-ust. |
112 | This information helps you diagnose performance or functional problems. | 128 | </para></listitem> |
113 | SystemTap is not available as a user-space tool through the Yocto Eclipse IDE Plug-in. | 129 | </itemizedlist> |
114 | See <ulink url='http://sourceware.org/systemtap'></ulink> for more information | ||
115 | on SystemTap. | ||
116 | </para></listitem> | ||
117 | <listitem><para><emphasis>Lttng-ust</emphasis> – A User-space Tracer designed to | ||
118 | provide detailed information on user-space activity. | ||
119 | See <ulink url='http://lttng.org/ust'></ulink> for more information on Lttng-ust. | ||
120 | </para></listitem> | ||
121 | </itemizedlist> | ||
122 | </para> | 130 | </para> |
123 | </section> | 131 | </section> |
124 | </section> | 132 | </section> |