diff options
Diffstat (limited to 'documentation/adt-manual/adt-prepare.xml')
-rw-r--r-- | documentation/adt-manual/adt-prepare.xml | 54 |
1 files changed, 27 insertions, 27 deletions
diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index c3e4f6e987..0cda17846c 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml | |||
@@ -51,8 +51,8 @@ | |||
51 | If you use this method, you just get the cross-toolchain and QEMU - you do not | 51 | If you use this method, you just get the cross-toolchain and QEMU - you do not |
52 | get any of the other mentioned benefits had you run the ADT Installer script.</para></listitem> | 52 | get any of the other mentioned benefits had you run the ADT Installer script.</para></listitem> |
53 | <listitem><para><emphasis>Use the Toolchain from within a Yocto Project Build Tree:</emphasis> | 53 | <listitem><para><emphasis>Use the Toolchain from within a Yocto Project Build Tree:</emphasis> |
54 | If you already have a Yocto Project build tree, you can build the cross-toolchain | 54 | If you already have a build directory, you can build the cross-toolchain |
55 | within tree. | 55 | within that structure. |
56 | However, like the previous method mentioned, you only get the cross-toolchain and QEMU - you | 56 | However, like the previous method mentioned, you only get the cross-toolchain and QEMU - you |
57 | do not get any of the other benefits without taking separate steps.</para></listitem> | 57 | do not get any of the other benefits without taking separate steps.</para></listitem> |
58 | </itemizedlist> | 58 | </itemizedlist> |
@@ -75,22 +75,21 @@ | |||
75 | <ulink url='&YOCTO_DL_URL;/releases'>Index of Releases</ulink>, specifically | 75 | <ulink url='&YOCTO_DL_URL;/releases'>Index of Releases</ulink>, specifically |
76 | at | 76 | at |
77 | <ulink url='&YOCTO_ADTINSTALLER_DL_URL;'></ulink>. | 77 | <ulink url='&YOCTO_ADTINSTALLER_DL_URL;'></ulink>. |
78 | Or, you can use BitBake to generate the tarball inside the existing Yocto Project | 78 | Or, you can use BitBake to generate the tarball inside the existing build directory. |
79 | build tree. | ||
80 | </para> | 79 | </para> |
81 | 80 | ||
82 | <para> | 81 | <para> |
83 | If you use BitBake to generate the ADT Installer tarball, you must | 82 | If you use BitBake to generate the ADT Installer tarball, you must |
84 | <filename>source</filename> the Yocto Project environment setup script | 83 | <filename>source</filename> the environment setup script |
85 | (<filename>oe-init-build-env</filename>) located | 84 | (<filename>oe-init-build-env</filename>) located |
86 | in the Yocto Project file structure before running the <filename>bitbake</filename> | 85 | in the source directory before running the <filename>bitbake</filename> |
87 | command that creates the tarball. | 86 | command that creates the tarball. |
88 | </para> | 87 | </para> |
89 | 88 | ||
90 | <para> | 89 | <para> |
91 | The following example commands download the Yocto Project release tarball, set up the Yocto | 90 | The following example commands download the Yocto Project release tarball, set up the |
92 | Project files structure, set up the environment while also creating the | 91 | source directory, set up the environment while also creating the |
93 | default Yocto Project build tree, | 92 | default build directory, |
94 | and run the <filename>bitbake</filename> command that results in the tarball | 93 | and run the <filename>bitbake</filename> command that results in the tarball |
95 | <filename>~/yocto-project/build/tmp/deploy/sdk/adt_installer.tar.bz2</filename>: | 94 | <filename>~/yocto-project/build/tmp/deploy/sdk/adt_installer.tar.bz2</filename>: |
96 | <literallayout class='monospaced'> | 95 | <literallayout class='monospaced'> |
@@ -151,7 +150,7 @@ | |||
151 | or not to install the emulator QEMU.</para></listitem> | 150 | or not to install the emulator QEMU.</para></listitem> |
152 | <listitem><para><filename>YOCTOADT_NFS_UTIL</filename>: Indicates whether | 151 | <listitem><para><filename>YOCTOADT_NFS_UTIL</filename>: Indicates whether |
153 | or not to install user-mode NFS. | 152 | or not to install user-mode NFS. |
154 | If you plan to use the Yocto Eclipse IDE plug-in against QEMU, | 153 | If you plan to use the Eclipse IDE Yocto plug-in against QEMU, |
155 | you should install NFS. | 154 | you should install NFS. |
156 | <note>To boot QEMU images using our userspace NFS server, you need | 155 | <note>To boot QEMU images using our userspace NFS server, you need |
157 | to be running <filename>portmap</filename> or <filename>rpcbind</filename>. | 156 | to be running <filename>portmap</filename> or <filename>rpcbind</filename>. |
@@ -244,17 +243,17 @@ | |||
244 | poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.tar.bz2 | 243 | poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.tar.bz2 |
245 | </literallayout> | 244 | </literallayout> |
246 | <note><para>As an alternative to steps one and two, you can build the toolchain tarball | 245 | <note><para>As an alternative to steps one and two, you can build the toolchain tarball |
247 | if you have a Yocto Project build tree. | 246 | if you have a build directory. |
248 | If you need GMAE, you should use the <filename>bitbake meta-toolchain-gmae</filename> | 247 | If you need GMAE, you should use the <filename>bitbake meta-toolchain-gmae</filename> |
249 | command. | 248 | command. |
250 | The resulting tarball will support such development. | 249 | The resulting tarball will support such development. |
251 | However, if you are not concerned with GMAE, | 250 | However, if you are not concerned with GMAE, |
252 | you can generate the tarball using <filename>bitbake meta-toolchain</filename>.</para> | 251 | you can generate the tarball using <filename>bitbake meta-toolchain</filename>.</para> |
253 | <para>Use the appropriate <filename>bitbake</filename> command only after you have | 252 | <para>Use the appropriate <filename>bitbake</filename> command only after you have |
254 | sourced the <filename>oe-build-init-env</filename> script located in the Yocto | 253 | sourced the <filename>oe-build-init-env</filename> script located in the source |
255 | Project files. | 254 | directory. |
256 | When the <filename>bitbake</filename> command completes, the tarball will | 255 | When the <filename>bitbake</filename> command completes, the tarball will |
257 | be in <filename>tmp/deploy/sdk</filename> in the Yocto Project build tree. | 256 | be in <filename>tmp/deploy/sdk</filename> in the build directory. |
258 | </para></note></para></listitem> | 257 | </para></note></para></listitem> |
259 | <listitem><para>Make sure you are in the root directory with root privileges and then expand | 258 | <listitem><para>Make sure you are in the root directory with root privileges and then expand |
260 | the tarball. | 259 | the tarball. |
@@ -267,11 +266,11 @@ | |||
267 | </section> | 266 | </section> |
268 | 267 | ||
269 | <section id='using-the-toolchain-from-within-the-build-tree'> | 268 | <section id='using-the-toolchain-from-within-the-build-tree'> |
270 | <title>Using BitBake and the Yocto Project Build Tree</title> | 269 | <title>Using BitBake and the Build Directory</title> |
271 | 270 | ||
272 | <para> | 271 | <para> |
273 | A final way of making the cross-toolchain available is to use BitBake | 272 | A final way of making the cross-toolchain available is to use BitBake |
274 | to generate the toolchain within an existing Yocto Project build tree. | 273 | to generate the toolchain within an existing build directory. |
275 | This method does not install the toolchain into the | 274 | This method does not install the toolchain into the |
276 | <filename>/opt</filename> directory. | 275 | <filename>/opt</filename> directory. |
277 | As with the previous method, if you need to install the target sysroot, you must | 276 | As with the previous method, if you need to install the target sysroot, you must |
@@ -282,12 +281,12 @@ | |||
282 | Follow these steps to generate the toolchain into the build tree: | 281 | Follow these steps to generate the toolchain into the build tree: |
283 | <orderedlist> | 282 | <orderedlist> |
284 | <listitem><para>Source the environment setup script | 283 | <listitem><para>Source the environment setup script |
285 | <filename>oe-init-build-env</filename> located in the Yocto Project | 284 | <filename>oe-init-build-env</filename> located in the source directory. |
286 | files.</para></listitem> | 285 | </para></listitem> |
287 | <listitem><para>At this point, you should be sure that the | 286 | <listitem><para>At this point, you should be sure that the |
288 | <filename>MACHINE</filename> variable | 287 | <filename>MACHINE</filename> variable |
289 | in the <filename>local.conf</filename> file found in the | 288 | in the <filename>local.conf</filename> file found in the |
290 | <filename>conf</filename> directory of the Yocto Project build directory | 289 | <filename>conf</filename> directory of the build directory |
291 | is set for the target architecture. | 290 | is set for the target architecture. |
292 | Comments within the <filename>local.conf</filename> file list the values you | 291 | Comments within the <filename>local.conf</filename> file list the values you |
293 | can use for the <filename>MACHINE</filename> variable. | 292 | can use for the <filename>MACHINE</filename> variable. |
@@ -305,9 +304,9 @@ | |||
305 | after checking or editing the <filename>local.conf</filename> but without | 304 | after checking or editing the <filename>local.conf</filename> but without |
306 | changing out of your working directory.</note> | 305 | changing out of your working directory.</note> |
307 | Once the <filename>bitbake</filename> command finishes, | 306 | Once the <filename>bitbake</filename> command finishes, |
308 | the cross-toolchain is generated and populated within the Yocto Project build tree. | 307 | the cross-toolchain is generated and populated within the build directory. |
309 | You will notice environment setup files for the cross-toolchain in the | 308 | You will notice environment setup files for the cross-toolchain in the |
310 | Yocto Project build tree in the <filename>tmp</filename> directory. | 309 | build directory in the <filename>tmp</filename> directory. |
311 | Setup script filenames contain the strings <filename>environment-setup</filename>. | 310 | Setup script filenames contain the strings <filename>environment-setup</filename>. |
312 | </para></listitem> | 311 | </para></listitem> |
313 | </orderedlist> | 312 | </orderedlist> |
@@ -325,7 +324,7 @@ | |||
325 | then you can find this script in the <filename>&YOCTO_ADTPATH_DIR;</filename> | 324 | then you can find this script in the <filename>&YOCTO_ADTPATH_DIR;</filename> |
326 | directory. | 325 | directory. |
327 | If you installed the toolchain in the build tree, you can find the environment setup | 326 | If you installed the toolchain in the build tree, you can find the environment setup |
328 | script for the toolchain in the Yocto Project build tree's <filename>tmp</filename> directory. | 327 | script for the toolchain in the build directory's <filename>tmp</filename> directory. |
329 | </para> | 328 | </para> |
330 | 329 | ||
331 | <para> | 330 | <para> |
@@ -363,14 +362,15 @@ | |||
363 | </para> | 362 | </para> |
364 | 363 | ||
365 | <para> | 364 | <para> |
366 | The Yocto Project provides basic kernel and filesystem images for several | 365 | The Yocto Project ships basic kernel and filesystem images for several |
367 | architectures (<filename>x86</filename>, <filename>x86-64</filename>, | 366 | architectures (<filename>x86</filename>, <filename>x86-64</filename>, |
368 | <filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>) | 367 | <filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>) |
369 | that you can use unaltered in the QEMU emulator. | 368 | that you can use unaltered in the QEMU emulator. |
370 | These kernel images reside in the Yocto Project release | 369 | These kernel images reside in the release |
371 | area - <ulink url='&YOCTO_MACHINES_DL_URL;'></ulink> | 370 | area - <ulink url='&YOCTO_MACHINES_DL_URL;'></ulink> |
372 | and are ideal for experimentation within Yocto Project. | 371 | and are ideal for experimentation using Yocto Project. |
373 | For information on the image types you can build using the Yocto Project, see the | 372 | For information on the image types you can build using the OpenEmbedded build system, |
373 | see the | ||
374 | "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Reference: Images</ulink>" appendix in | 374 | "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Reference: Images</ulink>" appendix in |
375 | The Yocto Project Reference Manual. | 375 | The Yocto Project Reference Manual. |
376 | </para> | 376 | </para> |
@@ -389,7 +389,7 @@ | |||
389 | you can do so one of two ways: | 389 | you can do so one of two ways: |
390 | <itemizedlist> | 390 | <itemizedlist> |
391 | <listitem><para>Modify the <filename>conf/local.conf</filename> configuration in | 391 | <listitem><para>Modify the <filename>conf/local.conf</filename> configuration in |
392 | the Yocto Project build directory and then rebuild the image. | 392 | the build directory and then rebuild the image. |
393 | With this method, you need to modify the <filename>EXTRA_IMAGE_FEATURES</filename> | 393 | With this method, you need to modify the <filename>EXTRA_IMAGE_FEATURES</filename> |
394 | variable to have the value of "tools-debug" before rebuilding the image. | 394 | variable to have the value of "tools-debug" before rebuilding the image. |
395 | Once the image is rebuilt, the <filename>tcf-agent</filename> will be included | 395 | Once the image is rebuilt, the <filename>tcf-agent</filename> will be included |