mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-06-03 13:49:49 +00:00
Code Issues Projects Releases Wiki Activity

documentation/adt-manual/adt-prepare.xml: 1.1.2 variables and updates

Browse Source 
First pass at implementing the poky.ent variables.  Also updated
text as needed.

(From yocto-docs rev: 3472d1c2e7c69e0b544a223204830c0d000033f8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2012-06-15 06:22:29 -07:00
committed by Richard Purdie
parent 7ce46066a5
commit 678f6ee437
1 changed files with 34 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/adt-manual/adt-prepare.xml
+34 -42
View File
@@ -1,5 +1,6 @@
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
<chapter id='adt-prepare'> <chapter id='adt-prepare'>
@@ -56,9 +57,9 @@
<para> <para>
The ADT Installer is contained in the ADT Installer tarball. The ADT Installer is contained in the ADT Installer tarball.
You can download the tarball into any directory from the You can download the tarball into any directory from the
<ulink url='http://downloads.yoctoproject.org/releases'>Index of Releases</ulink>, specifically <ulink url='&YOCTO_DL_URL;/releases'>Index of Releases</ulink>, specifically
at at
<ulink url='http://downloads.yoctoproject.org/releases/yocto/yocto-1.1.1/adt_installer'></ulink>. <ulink url='&YOCTO_ADTINSTALLER_DL_URL;'></ulink>.
Or, you can use BitBake to generate the tarball inside the existing Yocto Project Or, you can use BitBake to generate the tarball inside the existing Yocto Project
build tree. build tree.
</para> </para>
@@ -81,9 +82,9 @@
$ cd ~ $ cd ~
$ mkdir yocto-project $ mkdir yocto-project
$ cd yocto-project $ cd yocto-project
$ wget http://downloads.yoctoproject.org/releases/yocto/yocto-1.1.1/poky-edison-6.0.1.tar.bz2 $ wget &YOCTO_RELEASE_DL_URL;/&YOCTO_POKY_TARBALL;
$ tar xjf poky-edison-6.0.1.tar.bz2 $ tar xjf &YOCTO_POKY_TARBALL;
$ source poky-edison-6.0.1/oe-init-build-env $ source &OE_INIT_PATH;
$ bitbake adt-installer $ bitbake adt-installer
</literallayout> </literallayout>
</para> </para>
@@ -100,7 +101,7 @@
a top-level directory named <filename>adt-installer</filename>: a top-level directory named <filename>adt-installer</filename>:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ cd ~ $ cd ~
$ cp ~/yocto-project/build/tmp/deploy/sdk/adt_installer.tar.bz2 $HOME $ cp ~/poky/build/tmp/deploy/sdk/adt_installer.tar.bz2 $HOME
$ tar -xjf adt_installer.tar.bz2 $ tar -xjf adt_installer.tar.bz2
</literallayout> </literallayout>
Unpacking it creates the directory <filename>adt-installer</filename>, Unpacking it creates the directory <filename>adt-installer</filename>,
@@ -165,20 +166,17 @@
<para> <para>
After you have configured the <filename>adt_installer.conf</filename> file, After you have configured the <filename>adt_installer.conf</filename> file,
run the installer for this example using the following commands: run the installer using the following command:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ cd ~/adt-installer
$ ./adt_installer $ ./adt_installer
</literallayout> </literallayout>
</para> </para>
<note> <note>
The ADT Installer requires the <filename>libtool</filename> package to complete. The ADT Installer requires the <filename>libtool</filename> package to complete.
If you install the recommended packages as described in the If you install the recommended packages as described in
"<ulink url='http://www.yoctoproject.org/docs/1.1.1/yocto-project-qs/yocto-project-qs.html#packages'>Packages</ulink>" "<ulink url='&YOCTO_DOCS_QS_URL;#packages'>The Packages</ulink>"
section of section of The Yocto Project Quick Start, then you will have libtool installed.
<ulink url='http://www.yoctoproject.org/docs/1.1.1/yocto-project-qs/yocto-project-qs.html'>
The Yocto Project Quick Start</ulink>, then you will have libtool installed.
</note> </note>
<para> <para>
@@ -192,7 +190,7 @@
<para> <para>
Once the installation completes, the ADT, which includes the cross-toolchain, is installed. Once the installation completes, the ADT, which includes the cross-toolchain, is installed.
You will notice environment setup files for the cross-toolchain in You will notice environment setup files for the cross-toolchain in
<filename>/opt/poky/1.1.1</filename>, <filename>&YOCTO_ADTPATH_DIR;</filename>,
and image tarballs in the <filename>adt-installer</filename> and image tarballs in the <filename>adt-installer</filename>
directory according to your installer configurations, and the target sysroot located directory according to your installer configurations, and the target sysroot located
according to the <filename>YOCTOADT_TARGET_SYSROOT_LOC_&lt;arch&gt;</filename> variable according to the <filename>YOCTOADT_TARGET_SYSROOT_LOC_&lt;arch&gt;</filename> variable
@@ -215,17 +213,17 @@
Follow these steps: Follow these steps:
<orderedlist> <orderedlist>
<listitem><para>Go to <listitem><para>Go to
<ulink url='http://downloads.yoctoproject.org/releases/yocto/yocto-1.1.1/toolchain'></ulink> <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink>
and find the folder that matches your host development system and find the folder that matches your host development system
(i.e. <filename>i686</filename> for 32-bit machines or (i.e. <filename>i686</filename> for 32-bit machines or
<filename>x86_64</filename> for 64-bit machines).</para></listitem> <filename>x86-64</filename> for 64-bit machines).</para></listitem>
<listitem><para>Go into that folder and download the toolchain tarball whose name <listitem><para>Go into that folder and download the toolchain tarball whose name
includes the appropriate target architecture. includes the appropriate target architecture.
For example, if your host development system is an Intel-based 64-bit system and For example, if your host development system is an Intel-based 64-bit system and
you are going to use your cross-toolchain for an Intel-based 32-bit target, go into the you are going to use your cross-toolchain for an Intel-based 32-bit target, go into the
<filename>x86_64</filename> folder and download the following tarball: <filename>x86_64</filename> folder and download the following tarball:
<literallayout class='monospaced'> <literallayout class='monospaced'>
poky-eglibc-x86_64-i586-toolchain-1.1.1.tar.bz2 poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.tar.bz2
</literallayout> </literallayout>
<note><para>As an alternative to steps one and two, you can build the toolchain tarball <note><para>As an alternative to steps one and two, you can build the toolchain tarball
if you have a Yocto Project build tree. if you have a Yocto Project build tree.
@@ -242,15 +240,9 @@
</para></note></para></listitem> </para></note></para></listitem>
<listitem><para>Make sure you are in the root directory with root privileges and then expand <listitem><para>Make sure you are in the root directory with root privileges and then expand
the tarball. the tarball.
The tarball expands into <filename>/opt/poky/1.1.1</filename>. The tarball expands into <filename>&YOCTO_ADTPATH_DIR;</filename>.
Once the tarball is expanded, the cross-toolchain is installed. Once the tarball is expanded, the cross-toolchain is installed.
You will notice environment setup files for the cross-toolchain in the directory. You will notice environment setup files for the cross-toolchain in the directory.
Here is an example where the tarball exists in the user's <filename>Downloads</filename>
directory:
<literallayout class='monospaced'>
# cd /
# tar -xjf /home/scottrif/Downloads/poky-eglibc-x86_64-i586-toolchain-gmae-1.1.tar.bz2
</literallayout>
</para></listitem> </para></listitem>
</orderedlist> </orderedlist>
</para> </para>
@@ -287,7 +279,7 @@
command.</note></para></listitem> command.</note></para></listitem>
<listitem><para>Run <filename>bitbake meta-ide-support</filename> to complete the <listitem><para>Run <filename>bitbake meta-ide-support</filename> to complete the
cross-toolchain installation. cross-toolchain installation.
<note>If you change out of your working directory after you <note>If change out of your working directory after you
<filename>source</filename> the environment setup script and before you run <filename>source</filename> the environment setup script and before you run
the <filename>bitbake</filename> command, the command might not work. the <filename>bitbake</filename> command, the command might not work.
Be sure to run the <filename>bitbake</filename> command immediately Be sure to run the <filename>bitbake</filename> command immediately
@@ -311,21 +303,21 @@
Before you can develop using the cross-toolchain, you need to set up the Before you can develop using the cross-toolchain, you need to set up the
cross-development environment by sourcing the toolchain's environment setup script. cross-development environment by sourcing the toolchain's environment setup script.
If you used the ADT Installer or used an existing ADT tarball to install the ADT, If you used the ADT Installer or used an existing ADT tarball to install the ADT,
then you can find this script in the <filename>/opt/poky/1.1.1</filename> then you can find this script in the <filename>&YOCTO_ADTPATH_DIR;</filename>
directory. directory.
If you installed the toolchain in the build tree, you can find the environment setup If you installed the toolchain in the build tree, you can find the environment setup
script for the toolchain in the Yocto Project build tree's <filename>tmp</filename> directory. script for the toolchain in the Yocto Project build tree's <filename>tmp</filename> directory.
</para> </para>
<para> <para>
Be sure to source the environment setup script that matches the architecture for Be sure to run the environment setup script that matches the architecture for
which you are developing. which you are developing.
Environment setup scripts begin with the string “<filename>environment-setup</filename>” Environment setup scripts begin with the string “<filename>environment-setup</filename>”
and include as part of their name the architecture. and include as part of their name the architecture.
For example, the command to source the toolchain environment setup script For example, the toolchain environment setup script for a 64-bit IA-based architecture would
for a 64-bit IA-based machine would be the following: be the following:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ source /opt/poky/1.1.1/environment-setup-x86_64-poky-linux &YOCTO_ADTPATH_DIR;/environment-setup-x86_64-poky-linux
</literallayout> </literallayout>
</para> </para>
</section> </section>
@@ -347,8 +339,8 @@
To get the kernel and filesystem images, you either have to build them or download To get the kernel and filesystem images, you either have to build them or download
pre-built versions. pre-built versions.
You can find examples for both these situations in the You can find examples for both these situations in the
"<ulink url='http://www.yoctoproject.org/docs/1.1.1/yocto-project-qs/yocto-project-qs.html#test-run'>A "<ulink url='&YOCTO_DOCS_QS_URL;#test-run'>A Quick Test Run</ulink>" section of
Quick Test Run</ulink>" section of The Yocto Project Quick Start. The Yocto Project Quick Start.
</para> </para>
<para> <para>
@@ -357,10 +349,11 @@
<filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>) <filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>)
that you can use unaltered in the QEMU emulator. that you can use unaltered in the QEMU emulator.
These kernel images reside in the Yocto Project release These kernel images reside in the Yocto Project release
area - <ulink url='http://downloads.yoctoproject.org/releases/yocto/yocto-1.1.1/machines/'></ulink> area - <ulink url='&YOCTO_MACHINES_DL_URL;'></ulink>
and are ideal for experimentation within Yocto Project. and are ideal for experimentation within Yocto Project.
For information on the image types you can build using the Yocto Project, see the For information on the image types you can build using the Yocto Project, see the
"<ulink url='http://www.yoctoproject.org/docs/1.1.1/poky-ref-manual/poky-ref-manual.html#ref-images'>Reference: Images</ulink>" appendix in The Yocto Project Reference Manual. "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Reference: Images</ulink>" appendix in
The Yocto Project Reference Manual.
</para> </para>
<para> <para>
@@ -391,11 +384,11 @@
<listitem><para>Set up the cross-development environment as described in the <listitem><para>Set up the cross-development environment as described in the
"<link linkend='setting-up-the-cross-development-environment'>Setting "<link linkend='setting-up-the-cross-development-environment'>Setting
Up the Cross-Development Environment</link>" section.</para></listitem> Up the Cross-Development Environment</link>" section.</para></listitem>
<listitem><para>Get the <filename>tcf-agent</filename> source code, which is <listitem><para>Get the <filename>tcf-agent</filename> source code using
stored using the Subversion SCM, using the following command: the following commands:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ svn checkout svn://dev.eclipse.org/svnroot/dsdp/org.eclipse.tm.tcf/trunk/agent \ $ git clone http://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.agent.git
&lt;-r #rev_number&gt; $ cd agent
</literallayout></para></listitem> </literallayout></para></listitem>
<listitem><para>Modify the <filename>Makefile.inc</filename> file <listitem><para>Modify the <filename>Makefile.inc</filename> file
for the cross-compilation environment by setting the for the cross-compilation environment by setting the
@@ -432,9 +425,8 @@
To extract the root filesystem, first <filename>source</filename> To extract the root filesystem, first <filename>source</filename>
the cross-development environment setup script and then the cross-development environment setup script and then
use the <filename>runqemu-extract-sdk</filename> command on the use the <filename>runqemu-extract-sdk</filename> command on the
filesystem image tarball. filesystem image.
For example, the following commands set up the environment by sourcing For example, the following commands set up the environment and then extract
the setup script from within the build directory and then extracting
the root filesystem from a previously built filesystem image tarball named the root filesystem from a previously built filesystem image tarball named
<filename>core-image-sato-sdk-qemux86.tar.bz2</filename>. <filename>core-image-sato-sdk-qemux86.tar.bz2</filename>.
The example extracts the root filesystem into the <filename>$HOME/qemux86-sato</filename> The example extracts the root filesystem into the <filename>$HOME/qemux86-sato</filename>