summaryrefslogtreecommitdiffstats
path: root/documentation/adt-manual/adt-prepare.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/adt-manual/adt-prepare.xml')
-rw-r--r--documentation/adt-manual/adt-prepare.xml48
1 files changed, 22 insertions, 26 deletions
diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml
index 37d355e275..9880fcc7d1 100644
--- a/documentation/adt-manual/adt-prepare.xml
+++ b/documentation/adt-manual/adt-prepare.xml
@@ -1,5 +1,6 @@
1<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 1<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
2"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> 2"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
3[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
3 4
4<chapter id='adt-prepare'> 5<chapter id='adt-prepare'>
5 6
@@ -56,9 +57,9 @@
56 <para> 57 <para>
57 The ADT Installer is contained in the ADT Installer tarball. 58 The ADT Installer is contained in the ADT Installer tarball.
58 You can download the tarball into any directory from the 59 You can download the tarball into any directory from the
59 <ulink url='http://downloads.yoctoproject.org/releases'>Index of Releases</ulink>, specifically 60 <ulink url='&YOCTO_DL_URL;/releases'>Index of Releases</ulink>, specifically
60 at 61 at
61 <ulink url='http://downloads.yoctoproject.org/releases/yocto/yocto-1.1/adt_installer'></ulink>. 62 <ulink url='&YOCTO_ADTINSTALLER_DL_URL;'></ulink>.
62 Or, you can use BitBake to generate the tarball inside the existing Yocto Project 63 Or, you can use BitBake to generate the tarball inside the existing Yocto Project
63 build tree. 64 build tree.
64 </para> 65 </para>
@@ -81,9 +82,9 @@
81 $ cd ~ 82 $ cd ~
82 $ mkdir yocto-project 83 $ mkdir yocto-project
83 $ cd yocto-project 84 $ cd yocto-project
84 $ wget http://downloads.yoctoproject.org/releases/yocto/yocto-1.1/poky-edison-6.0.tar.bz2 85 $ wget &YOCTO_RELEASE_DL_URL;/&YOCTO_POKY_TARBALL;
85 $ tar xjf poky-edison-6.0.tar.bz2 86 $ tar xjf &YOCTO_POKY_TARBALL;
86 $ source poky-edison-6.0/oe-init-build-env 87 $ source &OE_INIT_PATH;
87 $ bitbake adt-installer 88 $ bitbake adt-installer
88 </literallayout> 89 </literallayout>
89 </para> 90 </para>
@@ -173,11 +174,9 @@
173 174
174 <note> 175 <note>
175 The ADT Installer requires the <filename>libtool</filename> package to complete. 176 The ADT Installer requires the <filename>libtool</filename> package to complete.
176 If you install the recommended packages as described in the 177 If you install the recommended packages as described in
177 "<ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#packages'>Packages</ulink>" 178 "<ulink url='&YOCTO_DOCS_QS_URL;#packages'>The Packages</ulink>"
178 section of 179 section of The Yocto Project Quick Start, then you will have libtool installed.
179 <ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html'>
180 The Yocto Project Quick Start</ulink>, then you will have libtool installed.
181 </note> 180 </note>
182 181
183 <para> 182 <para>
@@ -191,7 +190,7 @@
191 <para> 190 <para>
192 Once the installation completes, the ADT, which includes the cross-toolchain, is installed. 191 Once the installation completes, the ADT, which includes the cross-toolchain, is installed.
193 You will notice environment setup files for the cross-toolchain in 192 You will notice environment setup files for the cross-toolchain in
194 <filename>/opt/poky/1.1</filename>, 193 <filename>&YOCTO_ADTPATH_DIR;</filename>,
195 and image tarballs in the <filename>adt-installer</filename> 194 and image tarballs in the <filename>adt-installer</filename>
196 directory according to your installer configurations, and the target sysroot located 195 directory according to your installer configurations, and the target sysroot located
197 according to the <filename>YOCTOADT_TARGET_SYSROOT_LOC_&lt;arch&gt;</filename> variable 196 according to the <filename>YOCTOADT_TARGET_SYSROOT_LOC_&lt;arch&gt;</filename> variable
@@ -214,17 +213,17 @@
214 Follow these steps: 213 Follow these steps:
215 <orderedlist> 214 <orderedlist>
216 <listitem><para>Go to 215 <listitem><para>Go to
217 <ulink url='http://downloads.yoctoproject.org/releases/yocto/yocto-1.1/toolchain'></ulink> 216 <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink>
218 and find the folder that matches your host development system 217 and find the folder that matches your host development system
219 (i.e. <filename>i686</filename> for 32-bit machines or 218 (i.e. <filename>i686</filename> for 32-bit machines or
220 <filename>x86_64</filename> for 64-bit machines).</para></listitem> 219 <filename>x86-64</filename> for 64-bit machines).</para></listitem>
221 <listitem><para>Go into that folder and download the toolchain tarball whose name 220 <listitem><para>Go into that folder and download the toolchain tarball whose name
222 includes the appropriate target architecture. 221 includes the appropriate target architecture.
223 For example, if your host development system is an Intel-based 64-bit system and 222 For example, if your host development system is an Intel-based 64-bit system and
224 you are going to use your cross-toolchain for an Intel-based 32-bit target, go into the 223 you are going to use your cross-toolchain for an Intel-based 32-bit target, go into the
225 <filename>x86_64</filename> folder and download the following tarball: 224 <filename>x86_64</filename> folder and download the following tarball:
226 <literallayout class='monospaced'> 225 <literallayout class='monospaced'>
227 poky-eglibc-x86_64-i586-toolchain-gmae-1.1.tar.bz2 226 poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.tar.bz2
228 </literallayout> 227 </literallayout>
229 <note><para>As an alternative to steps one and two, you can build the toolchain tarball 228 <note><para>As an alternative to steps one and two, you can build the toolchain tarball
230 if you have a Yocto Project build tree. 229 if you have a Yocto Project build tree.
@@ -241,7 +240,7 @@
241 </para></note></para></listitem> 240 </para></note></para></listitem>
242 <listitem><para>Make sure you are in the root directory with root privileges and then expand 241 <listitem><para>Make sure you are in the root directory with root privileges and then expand
243 the tarball. 242 the tarball.
244 The tarball expands into <filename>/opt/poky/1.1</filename>. 243 The tarball expands into <filename>&YOCTO_ADTPATH_DIR;</filename>.
245 Once the tarball is expanded, the cross-toolchain is installed. 244 Once the tarball is expanded, the cross-toolchain is installed.
246 You will notice environment setup files for the cross-toolchain in the directory. 245 You will notice environment setup files for the cross-toolchain in the directory.
247 </para></listitem> 246 </para></listitem>
@@ -304,7 +303,7 @@
304 Before you can develop using the cross-toolchain, you need to set up the 303 Before you can develop using the cross-toolchain, you need to set up the
305 cross-development environment by sourcing the toolchain's environment setup script. 304 cross-development environment by sourcing the toolchain's environment setup script.
306 If you used the ADT Installer or used an existing ADT tarball to install the ADT, 305 If you used the ADT Installer or used an existing ADT tarball to install the ADT,
307 then you can find this script in the <filename>/opt/poky/1.1</filename> 306 then you can find this script in the <filename>&YOCTO_ADTPATH_DIR;</filename>
308 directory. 307 directory.
309 If you installed the toolchain in the build tree, you can find the environment setup 308 If you installed the toolchain in the build tree, you can find the environment setup
310 script for the toolchain in the Yocto Project build tree's <filename>tmp</filename> directory. 309 script for the toolchain in the Yocto Project build tree's <filename>tmp</filename> directory.
@@ -318,7 +317,7 @@
318 For example, the toolchain environment setup script for a 64-bit IA-based architecture would 317 For example, the toolchain environment setup script for a 64-bit IA-based architecture would
319 be the following: 318 be the following:
320 <literallayout class='monospaced'> 319 <literallayout class='monospaced'>
321 /opt/poky/1.1/environment-setup-x86_64-poky-linux 320 &YOCTO_ADTPATH_DIR;/environment-setup-x86_64-poky-linux
322 </literallayout> 321 </literallayout>
323 </para> 322 </para>
324</section> 323</section>
@@ -340,10 +339,8 @@
340 To get the kernel and filesystem images, you either have to build them or download 339 To get the kernel and filesystem images, you either have to build them or download
341 pre-built versions. 340 pre-built versions.
342 You can find examples for both these situations in the 341 You can find examples for both these situations in the
343 "<ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#test-run'>A 342 "<ulink url='&YOCTO_DOCS_QS_URL;#test-run'>A Quick Test Run</ulink>" section of
344 Quick Test Run</ulink>" section of 343 The Yocto Project Quick Start.
345 <ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html'>
346 The Yocto Project Quick Start</ulink>.
347 </para> 344 </para>
348 345
349 <para> 346 <para>
@@ -352,12 +349,11 @@
352 <filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>) 349 <filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>)
353 that you can use unaltered in the QEMU emulator. 350 that you can use unaltered in the QEMU emulator.
354 These kernel images reside in the Yocto Project release 351 These kernel images reside in the Yocto Project release
355 area - <ulink url='http://downloads.yoctoproject.org/releases/yocto/yocto-1.1/machines/'></ulink> 352 area - <ulink url='&YOCTO_MACHINES_DL_URL;'></ulink>
356 and are ideal for experimentation within Yocto Project. 353 and are ideal for experimentation within Yocto Project.
357 For information on the image types you can build using the Yocto Project, see the 354 For information on the image types you can build using the Yocto Project, see the
358 "<ulink url='http://www.yoctoproject.org/docs/latest/poky-ref-manual/poky-ref-manual.html#ref-images'>Reference: Images</ulink>" appendix in 355 "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Reference: Images</ulink>" appendix in
359 <ulink url='http://www.yoctoproject.org/docs/latest/poky-ref-manual/poky-ref-manual.html'> 356 The Yocto Project Reference Manual.
360 The Yocto Project Reference Manual</ulink>.
361 </para> 357 </para>
362 358
363 <para> 359 <para>