diff options
Diffstat (limited to 'documentation/adt-manual/adt-prepare.xml')
-rw-r--r-- | documentation/adt-manual/adt-prepare.xml | 48 |
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_<arch></filename> variable | 196 | according to the <filename>YOCTOADT_TARGET_SYSROOT_LOC_<arch></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> |