summaryrefslogtreecommitdiffstats
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
parenta6e76529448d5b5c70988fcfe3b9f4beb022b784 (diff)
downloadpoky-276abb19ce524ba1d45d01530c5f44f51d6468b6.tar.gz
handbook: review and correct CH5(development)
Signed-off-by: Lianhao Lu <lianhao.lu@intel.com> Signed-off-by: Liping Ke <liping.ke@intel.com>
-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 @@
61 <para> 61 <para>
62 To use the plugin, a toolchain and SDK built by Poky is required along with Anjuta it's development 62 To use the plugin, a toolchain and SDK built by Poky is required along with Anjuta it's development
63 headers and the Anjuta plugin. The Poky Anjuta plugin is available to download as a tarball at the 63 headers and the Anjuta plugin. The Poky Anjuta plugin is available to download as a tarball at the
64 <ulink url='http://labs.o-hand.com/sources/anjuta-plugin-sdk/'>OpenedHand labs</ulink> page or 64 <ulink url='http://labs.o-hand.com/anjuta-poky-sdk-plugin/'>OpenedHand labs</ulink> page or
65 directly from the Poky Git repository located at git://git.pokylinux.org/anjuta-poky; a web interface 65 directly from the Poky Git repository located at git://git.pokylinux.org/anjuta-poky; a web interface
66 to the repository can be accessed at <ulink url='http://git.pokylinux.org/cgit.cgi/anjuta-poky/'/>. 66 to the repository can be accessed at <ulink url='http://git.pokylinux.org/?p=anjuta-poky.git;a=summary'/>.
67 </para> 67 </para>
68 <para> 68 <para>
69 See the README file contained in the project for more information on dependencies and building 69 See the README file contained in the project for more information on dependencies and building
70 the plugin. It's recommended you enable the experimental gdb integration by passing configure the 70 the plugin. If you want to disable remote gdb debugging, please pass --diable-gdb-integration
71 --enable-gdb-integration switch. 71 switch when doing configure.
72 </para> 72 </para>
73 73
74 <section id="platdev-appdev-external-anjuta-setup"> 74 <section id="platdev-appdev-external-anjuta-setup">
@@ -101,23 +101,33 @@
101 101
102 <itemizedlist> 102 <itemizedlist>
103 103
104 <listitem><para><guilabel>SDK root</guilabel>: this is the root directory of the SDK's sysroot 104 <listitem><para><guilabel>SDK root</guilabel>: If we use external toolchain, we need to set SDK root.
105 for an i586 SDK this will be <filename 105 this is the root directory of the SDK's sysroot. For an i586 SDK this will be <filename
106 class="directory">/opt/poky/sysroots/i586-poky-linux</filename>. 106 class="directory">/opt/poky/</filename>.
107 This directory will contain directories named like "bin", 107 This directory will contain directories named like "bin",
108 "include", "var", etc. With the file chooser it is important 108 "include", "var", etc. under your selected target architecture subdirectory<filename class="directory">
109 to enter into the "i586-poky-linux" subdirectory for this 109 /opt/poky/sysroot/i586-poky-linux/</filename>. Needed cross compile tools are under
110 example.</para></listitem> 110 <filename class ="directory">/opt/poky/sysroot/i586-pokysdk-linux/</filename>
111 111 </para></listitem>
112 <listitem><para><guilabel>Toolchain triplet</guilabel>: this is the cross compile 112
113 triplet, e.g. "i586-poky-linux".</para></listitem> 113 <listitem><para><guilabel>Poky root</guilabel>: If we have local poky build tree, we need to set the Poky root.
114 this is the root directory of the poky build tree, if you build your i586 target architecture
115 under the subdirectory of build_x86 within your poky tree, the Poky root directory should be
116 <filename class="directory">${Poky_tree}/build_x86/</filename>.
117 </para></listitem>
118
119 <listitem><para><guilabel>Target Architecture</guilabel>: this is the cross compile
120 triplet, e.g. "i586-poky-linux". This target triplet is the prefix extracted from
121 the set up script file name. For examle, "i586-poky-linux" is extracted from set up script file
122 <filename>/opt/poky/environment-setup-i586-poky-linux</filename>
123 </para></listitem>
114 124
115 <listitem><para><guilabel>Kernel</guilabel>: use the file chooser to select the kernel 125 <listitem><para><guilabel>Kernel</guilabel>: use the file chooser to select the kernel
116 to use with QEMU</para></listitem> 126 to use with QEMU</para></listitem>
117 127
118 <listitem><para><guilabel>Root filesystem</guilabel>: use the file chooser to select 128 <listitem><para><guilabel>Root filesystem</guilabel>: use the file chooser to select
119 the root filesystem image, this should be an image (not a 129 the root filesystem directory, this is the directory where you use "poky-extract-sdk" command to
120 tarball)</para></listitem> 130 extract the poky-image-sdk tarball.</para></listitem>
121 </itemizedlist> 131 </itemizedlist>
122<!-- DISBALED, TOO BIG! 132<!-- DISBALED, TOO BIG!
123 <screenshot> 133 <screenshot>
@@ -448,8 +458,8 @@ $ bitbake matchbox-desktop -c devshell
448 A suitable gdb cross binary is required which runs on your host computer but 458 A suitable gdb cross binary is required which runs on your host computer but
449 knows about the the ABI of the remote target. This can be obtained from 459 knows about the the ABI of the remote target. This can be obtained from
450 the the Poky toolchain, e.g. 460 the the Poky toolchain, e.g.
451 <filename>/usr/local/poky/eabi-glibc/arm/bin/arm-poky-linux-gnueabi-gdb</filename> 461 <filename>/opt/poky/sysroots/x86_64-pokysdk-linux/usr/bin/armv5te-poky-linux-gnueabi/arm-poky-linux-gnueabi-gdb</filename>
452 which "arm" is the target architecture and "linux-gnueabi" the target ABI. 462 which "x86_64" is the host architecture, "arm" is the target architecture and "linux-gnueabi" the target ABI.
453 </para> 463 </para>
454 464
455 <para> 465 <para>
@@ -457,7 +467,8 @@ $ bitbake matchbox-desktop -c devshell
457 the gdb-cross package so for example you would run: 467 the gdb-cross package so for example you would run:
458 <programlisting>bitbake gdb-cross</programlisting> 468 <programlisting>bitbake gdb-cross</programlisting>
459 Once built, the cross gdb binary can be found at 469 Once built, the cross gdb binary can be found at
460 <programlisting>tmp/sysroots/&lt;host-arch&lt;/usr/bin/&lt;target-abi&gt;-gdb </programlisting> 470 <programlisting>tmp/sysroots/&lt;host-arch&gt;/usr/bin/\
471&lt;target-arch&gt;-poky-&lt;target-abi&gt;/&lt;target-arch&gt;-poky-&lt;target-abi&gt;-gdb </programlisting>
461 </para> 472 </para>
462 473
463 </section> 474 </section>
@@ -494,17 +505,17 @@ $ bitbake matchbox-desktop -c devshell
494 by doing: 505 by doing:
495 </para> 506 </para>
496 <programlisting>tmp/sysroots/i686-linux/usr/bin/opkg-cl -f \ 507 <programlisting>tmp/sysroots/i686-linux/usr/bin/opkg-cl -f \
497tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/temp/opkg.conf -o \ 508tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/opkg.conf -o \
498tmp/rootfs/ update</programlisting> 509tmp/rootfs/ update</programlisting>
499 <para> 510 <para>
500 then, 511 then,
501 </para> 512 </para>
502 <programlisting>tmp/sysroots/i686-linux/usr/bin/opkg-cl -f \ 513 <programlisting>tmp/sysroots/i686-linux/usr/bin/opkg-cl -f \
503tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/temp/opkg.conf \ 514tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/opkg.conf \
504-o tmp/rootfs install foo 515-o tmp/rootfs install foo
505 516
506tmp/sysroots/i686-linux/usr/bin/opkg-cl -f \ 517tmp/sysroots/i686-linux/usr/bin/opkg-cl -f \
507tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/temp/opkg.conf \ 518tmp/work/&lt;target-abi&gt;/poky-image-sato-1.0-r0/opkg.conf \
508-o tmp/rootfs install foo-dbg</programlisting> 519-o tmp/rootfs install foo-dbg</programlisting>
509 <para> 520 <para>
510 which installs the debugging information too. 521 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 \
517 <para> 528 <para>
518 To launch the host GDB, run the cross gdb binary identified above with 529 To launch the host GDB, run the cross gdb binary identified above with
519 the inferior binary specified on the commandline: 530 the inferior binary specified on the commandline:
520 <programlisting>&lt;target-abi&gt;-gdb rootfs/usr/bin/foo</programlisting> 531 <programlisting>&lt;target-arch&gt;-poky-&lt;target-abi&gt;-gdb rootfs/usr/bin/foo</programlisting>
521 This loads the binary of program <emphasis>foo</emphasis> 532 This loads the binary of program <emphasis>foo</emphasis>
522 as well as its debugging information. Once the gdb prompt 533 as well as its debugging information. Once the gdb prompt
523 appears, you must instruct GDB to load all the libraries 534 appears, you must instruct GDB to load all the libraries