aboutsummaryrefslogtreecommitdiffstats
path: root/handbook/development.xml
diff options
context:
space:
mode:
authorLianhao Lu <lianhao.lu@intel.com>2010-09-09 15:56:30 +0800
committerRichard Purdie <rpurdie@linux.intel.com>2010-09-10 12:17:48 +0100
commit276abb19ce524ba1d45d01530c5f44f51d6468b6 (patch)
treed6204fbd2aeadedff2528a749783e50f7125f7e4 /handbook/development.xml
parenta6e76529448d5b5c70988fcfe3b9f4beb022b784 (diff)
downloadopenembedded-core-contrib-276abb19ce524ba1d45d01530c5f44f51d6468b6.tar.gz
openembedded-core-contrib-276abb19ce524ba1d45d01530c5f44f51d6468b6.tar.bz2
openembedded-core-contrib-276abb19ce524ba1d45d01530c5f44f51d6468b6.zip
handbook: review and correct CH5(development)
Signed-off-by: Lianhao Lu <lianhao.lu@intel.com> Signed-off-by: Liping Ke <liping.ke@intel.com>
Diffstat (limited to 'handbook/development.xml')
-rw-r--r--handbook/development.xml55
1 files changed, 33 insertions, 22 deletions
diff --git a/handbook/development.xml b/handbook/development.xml
index 3bcf40506c..a383a2f4a8 100644
--- a/handbook/development.xml
+++ b/handbook/development.xml
@@ -61,14 +61,14 @@
<para>
To use the plugin, a toolchain and SDK built by Poky is required along with Anjuta it's development
headers and the Anjuta plugin. The Poky Anjuta plugin is available to download as a tarball at the
- <ulink url='http://labs.o-hand.com/sources/anjuta-plugin-sdk/'>OpenedHand labs</ulink> page or
+ <ulink url='http://labs.o-hand.com/anjuta-poky-sdk-plugin/'>OpenedHand labs</ulink> page or
directly from the Poky Git repository located at git://git.pokylinux.org/anjuta-poky; a web interface
- to the repository can be accessed at <ulink url='http://git.pokylinux.org/cgit.cgi/anjuta-poky/'/>.
+ to the repository can be accessed at <ulink url='http://git.pokylinux.org/?p=anjuta-poky.git;a=summary'/>.
</para>
<para>
See the README file contained in the project for more information on dependencies and building
- the plugin. It's recommended you enable the experimental gdb integration by passing configure the
- --enable-gdb-integration switch.
+ the plugin. If you want to disable remote gdb debugging, please pass --diable-gdb-integration
+ switch when doing configure.
</para>
<section id="platdev-appdev-external-anjuta-setup">
@@ -101,23 +101,33 @@
<itemizedlist>
- <listitem><para><guilabel>SDK root</guilabel>: this is the root directory of the SDK's sysroot
- for an i586 SDK this will be <filename
- class="directory">/opt/poky/sysroots/i586-poky-linux</filename>.
+ <listitem><para><guilabel>SDK root</guilabel>: If we use external toolchain, we need to set SDK root.
+ this is the root directory of the SDK's sysroot. For an i586 SDK this will be <filename
+ class="directory">/opt/poky/</filename>.
This directory will contain directories named like "bin",
- "include", "var", etc. With the file chooser it is important
- to enter into the "i586-poky-linux" subdirectory for this
- example.</para></listitem>
-
- <listitem><para><guilabel>Toolchain triplet</guilabel>: this is the cross compile
- triplet, e.g. "i586-poky-linux".</para></listitem>
+ "include", "var", etc. under your selected target architecture subdirectory<filename class="directory">
+ /opt/poky/sysroot/i586-poky-linux/</filename>. Needed cross compile tools are under
+ <filename class ="directory">/opt/poky/sysroot/i586-pokysdk-linux/</filename>
+ </para></listitem>
+
+ <listitem><para><guilabel>Poky root</guilabel>: If we have local poky build tree, we need to set the Poky root.
+ this is the root directory of the poky build tree, if you build your i586 target architecture
+ under the subdirectory of build_x86 within your poky tree, the Poky root directory should be
+ <filename class="directory">${Poky_tree}/build_x86/</filename>.
+ </para></listitem>
+
+ <listitem><para><guilabel>Target Architecture</guilabel>: this is the cross compile
+ triplet, e.g. "i586-poky-linux". This target triplet is the prefix extracted from
+ the set up script file name. For examle, "i586-poky-linux" is extracted from set up script file
+ <filename>/opt/poky/environment-setup-i586-poky-linux</filename>
+ </para></listitem>
<listitem><para><guilabel>Kernel</guilabel>: use the file chooser to select the kernel
to use with QEMU</para></listitem>
<listitem><para><guilabel>Root filesystem</guilabel>: use the file chooser to select
- the root filesystem image, this should be an image (not a
- tarball)</para></listitem>
+ the root filesystem directory, this is the directory where you use "poky-extract-sdk" command to
+ extract the poky-image-sdk tarball.</para></listitem>
</itemizedlist>
<!-- DISBALED, TOO BIG!
<screenshot>
@@ -448,8 +458,8 @@ $ bitbake matchbox-desktop -c devshell
A suitable gdb cross binary is required which runs on your host computer but
knows about the the ABI of the remote target. This can be obtained from
the the Poky toolchain, e.g.
- <filename>/usr/local/poky/eabi-glibc/arm/bin/arm-poky-linux-gnueabi-gdb</filename>
- which "arm" is the target architecture and "linux-gnueabi" the target ABI.
+ <filename>/opt/poky/sysroots/x86_64-pokysdk-linux/usr/bin/armv5te-poky-linux-gnueabi/arm-poky-linux-gnueabi-gdb</filename>
+ which "x86_64" is the host architecture, "arm" is the target architecture and "linux-gnueabi" the target ABI.
</para>
<para>
@@ -457,7 +467,8 @@ $ bitbake matchbox-desktop -c devshell
the gdb-cross package so for example you would run:
<programlisting>bitbake gdb-cross</programlisting>
Once built, the cross gdb binary can be found at
- <programlisting>tmp/sysroots/&lt;host-arch&lt;/usr/bin/&lt;target-abi&gt;-gdb </programlisting>
+ <programlisting>tmp/sysroots/&lt;host-arch&gt;/usr/bin/\
+&lt;target-arch&gt;-poky-&lt;target-abi&gt;/&lt;target-arch&gt;-poky-&lt;target-abi&gt;-gdb </programlisting>
</para>
</section>
@@ -494,17 +505,17 @@ $ bitbake matchbox-desktop -c devshell
by doing:
</para>
<programlisting>tmp/sysroots/i686-linux/usr/bin/opkg-cl -f \
-tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/temp/opkg.conf -o \
+tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/opkg.conf -o \
tmp/rootfs/ update</programlisting>
<para>
then,
</para>
<programlisting>tmp/sysroots/i686-linux/usr/bin/opkg-cl -f \
-tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/temp/opkg.conf \
+tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/opkg.conf \
-o tmp/rootfs install foo
tmp/sysroots/i686-linux/usr/bin/opkg-cl -f \
-tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/temp/opkg.conf \
+tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/opkg.conf \
-o tmp/rootfs install foo-dbg</programlisting>
<para>
which installs the debugging information too.
@@ -517,7 +528,7 @@ tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/temp/opkg.conf \
<para>
To launch the host GDB, run the cross gdb binary identified above with
the inferior binary specified on the commandline:
- <programlisting>&lt;target-abi&gt;-gdb rootfs/usr/bin/foo</programlisting>
+ <programlisting>&lt;target-arch&gt;-poky-&lt;target-abi&gt;-gdb rootfs/usr/bin/foo</programlisting>
This loads the binary of program <emphasis>foo</emphasis>
as well as its debugging information. Once the gdb prompt
appears, you must instruct GDB to load all the libraries