diff options
Diffstat (limited to 'documentation/dev-manual/dev-manual-intro.xml')
-rw-r--r-- | documentation/dev-manual/dev-manual-intro.xml | 240 |
1 files changed, 240 insertions, 0 deletions
diff --git a/documentation/dev-manual/dev-manual-intro.xml b/documentation/dev-manual/dev-manual-intro.xml new file mode 100644 index 0000000000..21fba29670 --- /dev/null +++ b/documentation/dev-manual/dev-manual-intro.xml | |||
@@ -0,0 +1,240 @@ | |||
1 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | ||
2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" | ||
3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
4 | |||
5 | <chapter id='dev-manual-intro'> | ||
6 | |||
7 | <title>The Yocto Project Development Manual</title> | ||
8 | <section id='intro'> | ||
9 | <title>Introduction</title> | ||
10 | |||
11 | <para> | ||
12 | Welcome to the Yocto Project Development Manual! | ||
13 | This manual provides information on how to use the Yocto Project to | ||
14 | develop embedded Linux images and user-space applications that | ||
15 | run on targeted devices. | ||
16 | The manual provides an overview of image, kernel, and | ||
17 | user-space application development using the Yocto Project. | ||
18 | Because much of the information in this manual is general, it | ||
19 | contains many references to other sources where you can find more | ||
20 | detail. | ||
21 | For example, you can find detailed information on Git, repositories, | ||
22 | and open source in general in many places on the Internet. | ||
23 | Another example specific to the Yocto Project is how to quickly | ||
24 | set up your host development system and build an image, which you | ||
25 | find in the | ||
26 | <ulink url='&YOCTO_DOCS_QS_URL;'>Yocto Project Quick Start</ulink>. | ||
27 | </para> | ||
28 | |||
29 | <para> | ||
30 | The Yocto Project Development Manual does, however, provide | ||
31 | guidance and examples on how to change the kernel source code, | ||
32 | reconfigure the kernel, and develop an application using the | ||
33 | popular <trademark class='trade'>Eclipse</trademark> IDE. | ||
34 | </para> | ||
35 | |||
36 | <note> | ||
37 | By default, using the Yocto Project creates a Poky distribution. | ||
38 | However, you can create your own distribution by providing key | ||
39 | <link linkend='metadata'>Metadata</link>. | ||
40 | A good example is Angstrom, which has had a distribution | ||
41 | based on the Yocto Project since its inception. | ||
42 | Other examples include commercial distributions like | ||
43 | <ulink url='https://www.yoctoproject.org/organization/wind-river-systems'>Wind River Linux</ulink>, | ||
44 | <ulink url='https://www.yoctoproject.org/organization/mentor-graphics'>Mentor Embedded Linux</ulink>, | ||
45 | <ulink url='https://www.yoctoproject.org/organization/enea-ab'>ENEA Linux</ulink> | ||
46 | and <ulink url='https://www.yoctoproject.org/ecosystem/member-organizations'>others</ulink>. | ||
47 | See the "<link linkend='creating-your-own-distribution'>Creating Your Own Distribution</link>" | ||
48 | section for more information. | ||
49 | </note> | ||
50 | </section> | ||
51 | |||
52 | <section id='what-this-manual-provides'> | ||
53 | <title>What This Manual Provides</title> | ||
54 | |||
55 | <para> | ||
56 | The following list describes what you can get from this manual: | ||
57 | <itemizedlist> | ||
58 | <listitem><para>Information that lets you get set | ||
59 | up to develop using the Yocto Project.</para></listitem> | ||
60 | <listitem><para>Information to help developers who are new to | ||
61 | the open source environment and to the distributed revision | ||
62 | control system Git, which the Yocto Project uses. | ||
63 | </para></listitem> | ||
64 | <listitem><para>An understanding of common end-to-end | ||
65 | development models and tasks.</para></listitem> | ||
66 | <listitem><para>Information about common development tasks | ||
67 | generally used during image development for | ||
68 | embedded devices. | ||
69 | </para></listitem> | ||
70 | <listitem><para>Information on using the Yocto Project | ||
71 | integration of the QuickEMUlator (QEMU), which lets you | ||
72 | simulate running on hardware an image you have built using | ||
73 | the OpenEmbedded build system. | ||
74 | </para></listitem> | ||
75 | <listitem><para>Many references to other sources of related | ||
76 | information.</para></listitem> | ||
77 | </itemizedlist> | ||
78 | </para> | ||
79 | </section> | ||
80 | |||
81 | <section id='what-this-manual-does-not-provide'> | ||
82 | <title>What this Manual Does Not Provide</title> | ||
83 | |||
84 | <para> | ||
85 | This manual will not give you the following: | ||
86 | <itemizedlist> | ||
87 | <listitem><para><emphasis>Step-by-step instructions when those instructions exist in other Yocto | ||
88 | Project documentation:</emphasis> | ||
89 | For example, the Yocto Project Application Developer's Guide contains detailed | ||
90 | instructions on how to run the | ||
91 | <ulink url='&YOCTO_DOCS_ADT_URL;#installing-the-adt'>ADT Installer</ulink>, | ||
92 | which is used to set up a cross-development environment.</para></listitem> | ||
93 | <listitem><para><emphasis>Reference material:</emphasis> | ||
94 | This type of material resides in an appropriate reference manual. | ||
95 | For example, system variables are documented in the | ||
96 | <ulink url='&YOCTO_DOCS_REF_URL;'>Yocto Project Reference Manual</ulink>.</para></listitem> | ||
97 | <listitem><para><emphasis>Detailed public information that is not specific to the Yocto Project:</emphasis> | ||
98 | For example, exhaustive information on how to use Git is covered better through the | ||
99 | Internet than in this manual.</para></listitem> | ||
100 | </itemizedlist> | ||
101 | </para> | ||
102 | </section> | ||
103 | |||
104 | <section id='other-information'> | ||
105 | <title>Other Information</title> | ||
106 | |||
107 | <para> | ||
108 | Because this manual presents overview information for many different | ||
109 | topics, supplemental information is recommended for full | ||
110 | comprehension. | ||
111 | The following list presents other sources of information you might find helpful: | ||
112 | <itemizedlist> | ||
113 | <listitem><para><emphasis><ulink url='&YOCTO_HOME_URL;'>Yocto Project Website</ulink>: | ||
114 | </emphasis> The home page for the Yocto Project provides lots of information on the project | ||
115 | as well as links to software and documentation. | ||
116 | </para></listitem> | ||
117 | <listitem><para><emphasis> | ||
118 | <ulink url='&YOCTO_DOCS_QS_URL;'>Yocto Project Quick Start</ulink>:</emphasis> | ||
119 | This short document lets you get started | ||
120 | with the Yocto Project and quickly begin building an image. | ||
121 | </para></listitem> | ||
122 | <listitem><para><emphasis> | ||
123 | <ulink url='&YOCTO_DOCS_REF_URL;'>Yocto Project Reference Manual</ulink>:</emphasis> | ||
124 | This manual is a reference | ||
125 | guide to the OpenEmbedded build system, which is based on BitBake. | ||
126 | The build system is sometimes referred to as "Poky". | ||
127 | </para></listitem> | ||
128 | <listitem><para><emphasis> | ||
129 | <ulink url='&YOCTO_DOCS_ADT_URL;'>Yocto Project Application Developer's Guide</ulink>:</emphasis> | ||
130 | This guide provides information that lets you get going with the Application | ||
131 | Development Toolkit (ADT) and stand-alone cross-development toolchains to | ||
132 | develop projects using the Yocto Project. | ||
133 | </para></listitem> | ||
134 | <listitem><para><emphasis> | ||
135 | <ulink url='&YOCTO_DOCS_BSP_URL;'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>:</emphasis> | ||
136 | This guide defines the structure for BSP components. | ||
137 | Having a commonly understood structure encourages standardization. | ||
138 | </para></listitem> | ||
139 | <listitem><para><emphasis> | ||
140 | <ulink url='&YOCTO_DOCS_KERNEL_DEV_URL;'>Yocto Project Linux Kernel Development Manual</ulink>:</emphasis> | ||
141 | This manual describes how to work with Linux Yocto kernels as well as provides a bit | ||
142 | of conceptual information on the construction of the Yocto Linux kernel tree. | ||
143 | </para></listitem> | ||
144 | <listitem><para><emphasis> | ||
145 | <ulink url='&YOCTO_DOCS_PROF_URL;'>Yocto Project Profiling and Tracing Manual</ulink>:</emphasis> | ||
146 | This manual presents a set of common and generally useful tracing and | ||
147 | profiling schemes along with their applications (as appropriate) to each tool. | ||
148 | </para></listitem> | ||
149 | <listitem><para><emphasis> | ||
150 | <ulink url='http://www.youtube.com/watch?v=3ZlOu-gLsh0'> | ||
151 | Eclipse IDE Yocto Plug-in</ulink>:</emphasis> | ||
152 | A step-by-step instructional video that | ||
153 | demonstrates how an application developer uses Yocto Plug-in features within | ||
154 | the Eclipse IDE. | ||
155 | </para></listitem> | ||
156 | <listitem><para><emphasis> | ||
157 | <ulink url='&YOCTO_WIKI_URL;/wiki/FAQ'>FAQ</ulink>:</emphasis> | ||
158 | A list of commonly asked questions and their answers. | ||
159 | </para></listitem> | ||
160 | <listitem><para><emphasis> | ||
161 | <ulink url='&YOCTO_RELEASE_NOTES;'>Release Notes</ulink>:</emphasis> | ||
162 | Features, updates and known issues for the current | ||
163 | release of the Yocto Project. | ||
164 | </para></listitem> | ||
165 | <listitem><para><emphasis> | ||
166 | <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/hob'>Hob</ulink>:</emphasis> | ||
167 | A graphical user interface for BitBake. | ||
168 | Hob's primary goal is to enable a user to perform common tasks more easily. | ||
169 | </para></listitem> | ||
170 | <listitem><para><emphasis> | ||
171 | <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/toaster'>Toaster</ulink>:</emphasis> | ||
172 | An Application Programming Interface (API) and web-based | ||
173 | interface to the OpenEmbedded build system, which uses | ||
174 | BitBake, that reports build information. | ||
175 | </para></listitem> | ||
176 | <listitem><para><emphasis> | ||
177 | <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/build-appliance'>Build Appliance</ulink>:</emphasis> | ||
178 | A virtual machine that | ||
179 | enables you to build and boot a custom embedded Linux image | ||
180 | with the Yocto Project using a non-Linux development system. | ||
181 | </para></listitem> | ||
182 | <listitem><para><emphasis> | ||
183 | <ulink url='&YOCTO_BUGZILLA_URL;'>Bugzilla</ulink>:</emphasis> | ||
184 | The bug tracking application the Yocto Project uses. | ||
185 | If you find problems with the Yocto Project, you should report them using this | ||
186 | application. | ||
187 | </para></listitem> | ||
188 | <listitem><para><emphasis>Yocto Project Mailing Lists:</emphasis> | ||
189 | To subscribe to the Yocto Project mailing | ||
190 | lists, click on the following URLs and follow the instructions: | ||
191 | <itemizedlist> | ||
192 | <listitem><para><ulink url='&YOCTO_LISTS_URL;/listinfo/yocto'></ulink> | ||
193 | for a Yocto Project Discussions mailing list. | ||
194 | </para></listitem> | ||
195 | <listitem><para><ulink url='&YOCTO_LISTS_URL;/listinfo/poky'></ulink> | ||
196 | for a Yocto Project Discussions mailing list about the | ||
197 | OpenEmbedded build system (Poky). | ||
198 | </para></listitem> | ||
199 | <listitem><para><ulink url='&YOCTO_LISTS_URL;/listinfo/yocto-announce'></ulink> | ||
200 | for a mailing list to receive official Yocto Project announcements | ||
201 | as well as Yocto Project milestones. | ||
202 | </para></listitem> | ||
203 | <listitem><para><ulink url='&YOCTO_LISTS_URL;/listinfo'></ulink> | ||
204 | for a listing of all public mailing lists on | ||
205 | <filename>lists.yoctoproject.org</filename>. | ||
206 | </para></listitem> | ||
207 | </itemizedlist></para></listitem> | ||
208 | <listitem><para><emphasis>Internet Relay Chat (IRC):</emphasis> | ||
209 | Two IRC channels on freenode are available | ||
210 | for Yocto Project and Poky discussions: <filename>#yocto</filename> and | ||
211 | <filename>#poky</filename>, respectively. | ||
212 | </para></listitem> | ||
213 | <listitem><para><emphasis> | ||
214 | <ulink url='&OE_HOME_URL;'>OpenEmbedded</ulink>:</emphasis> | ||
215 | The build system used by the Yocto Project. | ||
216 | This project is the upstream, generic, embedded distribution | ||
217 | from which the Yocto Project derives its build system (Poky) | ||
218 | and to which it contributes. | ||
219 | </para></listitem> | ||
220 | <listitem><para><emphasis> | ||
221 | <ulink url='http://www.openembedded.org/wiki/BitBake'>BitBake</ulink>:</emphasis> | ||
222 | The tool used by the OpenEmbedded build system | ||
223 | to process project metadata. | ||
224 | </para></listitem> | ||
225 | <listitem><para><emphasis> | ||
226 | <ulink url='&YOCTO_DOCS_BB_URL;'>BitBake User Manual:</ulink></emphasis> | ||
227 | A comprehensive guide to the BitBake tool. | ||
228 | If you want information on BitBake, see this manual. | ||
229 | </para></listitem> | ||
230 | <listitem><para><emphasis> | ||
231 | <ulink url='http://wiki.qemu.org/Index.html'>Quick EMUlator (QEMU)</ulink>:</emphasis> | ||
232 | An open-source machine emulator and virtualizer. | ||
233 | </para></listitem> | ||
234 | </itemizedlist> | ||
235 | </para> | ||
236 | </section> | ||
237 | </chapter> | ||
238 | <!-- | ||
239 | vim: expandtab tw=80 ts=4 | ||
240 | --> | ||