diff options
| -rw-r--r-- | documentation/yocto-project-qs/yocto-project-qs.xml | 80 |
1 files changed, 54 insertions, 26 deletions
diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml index d67ff41edc..3f2f73788a 100644 --- a/documentation/yocto-project-qs/yocto-project-qs.xml +++ b/documentation/yocto-project-qs/yocto-project-qs.xml @@ -12,23 +12,35 @@ <title>Welcome!</title> <para> Welcome to the Yocto Project! - The Yocto Project is an open-source Linux development environment. - This short document will give you some basic information about the environment as well as let you experience it in its simplest form. - After reading this document you will have a basic understanding of what the Yocto Project is and how to work within it. - This document also steps you through a simple example showing you how to build a small image and run it using the QEMU emulator. + The Yocto Project (YP) is an open-source collaboration project focused on embedded Linux + developers. + Amongst other things, YP uses the Poky build tool to construct complete Linux images. </para> <para> - For complete information on the Yocto Project you should check out the <ulink url='http://www.yoctolinux.org'>Public Yocto Website</ulink>. - You can find the latest builds, breaking news, full development documentation, and a rich Yocto Project Development Community into which you can tap. + This short document will give you some basic information about the environment as well + as let you experience it in its simplest form. + After reading this document you will have a basic understanding of what the Yocto Project is + and how to use some of its core components. + This document steps you through a simple example showing you how to build a small image + and run it using the QEMU emulator. + </para> + <para> + For complete information on the Yocto Project you should check out the + <ulink url='http://www.yoctolinux.org'>Yocto Project Website</ulink>. + You can find the latest builds, breaking news, full development documentation, and a + rich Yocto Project Development Community into which you can tap. </para> </section> <section id='yp-intro'> <title>Introducing the Yocto Project Development Environment</title> - <para> - Yocto Project is an open source development environment that creates Linux-based images suitable for many types of devices (large or small) based on architectures such as x86, x86-64, Xeon, ARM, and MIPS as well as PowerPC and device emulation. - You can use Yocto Project to design, develop, build, debug, simulate, and test the complete software stack using Linux, the X Window System, GNOME Mobile-based application frameworks, and Qt frameworks. + The Yocto Project through the Poky build tool provides an open source development + environment targeting the ARM, MIPS, PowerPC and x86 architectures for a variety of + platforms including x86-64 and emulated ones. + You can use components from the the Yocto Project to design, develop, build, debug, simulate, + and test the complete software stack using Linux, the X Window System, GNOME Mobile-based + application frameworks, and Qt frameworks. </para> <para></para> @@ -52,27 +64,38 @@ <para>Provides an open source Linux kernel along with a set of system commands and libraries suitable for the embedded environment.</para> </listitem> <listitem> - <para>Makes available system components such as X11, Matchbox, GTK+, Pimlico, Clutter, and Qt (among others) so you can create a richer user interface experience on devices that use displays or have a GUI. -For devices that don't have a GUI or display you simply would not employ these components.</para> + <para>Makes available system components such as X11, Matchbox, GTK+, Pimlico, Clutter, + GuPNP and Qt (among others) so you can create a richer user interface experience on + devices that use displays or have a GUI. + For devices that don't have a GUI or display you simply would not employ these + components.</para> </listitem> <listitem> - <para>Creates a focused and stable subset of OpenEmbedded on which you can easily and reliably build and develop.</para> + <para>Creates a focused and stable core compatible with the OpenEmbedded + project with which you can easily and reliably build and develop.</para> </listitem> <listitem> - <para>Fully supports a wide range of hardware and device emulation through the QEMU Emulator or other supported emulators.</para> + <para>Fully supports a wide range of hardware and device emulation through the QEMU + Emulator.</para> </listitem> </itemizedlist> <para> - Yocto Project generates file system images based on open source software such as the Kdrive X server, the Matchbox Window Manager, the GTK+ Toolkit and the D-Bus Message Bus System. Yocto Project can generate images for many kinds of devices. - However, the standard example machines target QEMU full system emulation for x86, ARM, MIPS, and PPC based architectures as well as specific hardware such as the Intel Desktop Board DH55TC. - Because an image developed with Yocto Project can boot inside a QEMU emulator, the development environment works nicely as a test platform for developing embedded software. + However, the standard example machines target QEMU full system emulation for x86, ARM, MIPS, + and PPC based architectures as well as specific hardware such as the Intel Desktop Board + DH55TC. + Because an image developed with Yocto Project can boot inside a QEMU emulator, the + development environment works nicely as a test platform for developing embedded software. </para> <para> - Another important Yocto Project feature is the Sato component. - The optional Sato component, a GNOME mobile-based user interface environment well suited for devices with restricted screen sizes, sits neatly on top of any device using the GNOME Mobile Stack providing a well defined user experience. + Another important Yocto Project feature is the Sato reference User Interface. + This optional GNOME mobile-based UI, which is intended for devices with + resolution but restricted size screens, sits neatly on top of a device using the + GNOME Mobile Stack providing a well defined user experience. + Implemented in its own layer, it makes it clear to developers how they can implement ] + their own UIs on top of Yocto Linux. </para> </section> @@ -113,7 +136,7 @@ For devices that don't have a GUI or display you simply would not employ these c </para> <literallayout class='monospaced'> - Sudo apt-get install sed wget cvs subversion git-core coreutils + sudo apt-get install sed wget cvs subversion git-core coreutils unzip texi2html texinfo libsdll.2-dev docbook-utils gawk python-pysqlite2 diffstat help2man make gcc build-essential g++ desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev @@ -130,8 +153,10 @@ For devices that don't have a GUI or display you simply would not employ these c <title>Yocto Project Release</title> <para> - The latest releases for Yocto Project are kept at http://yoctoproject.org/releases. - Nightly and developmental builds are also maintained. However, for this document a released version of Yocto Project is used. + The latest releases for Yocto Project are kept at + <ulink url="http://yoctoproject.org/releases"></ulink>. + Nightly and developmental builds are also maintained. However, for this + document a released version of Yocto Project is used. </para> </section> </section> @@ -182,9 +207,8 @@ For devices that don't have a GUI or display you simply would not employ these c <literallayout class='monospaced'> $ wget http://pokylinux.org/releases/poky-green-3.3.tar.bz2 $ tar xjvf poky-green-3.3.tar.bz2 - $ cd green-3.3-build $ source green-3.3/poky-init-build-env green-3.3-build - $ bitbake qemu-native + $ cd green-3.3-build $ bitbake poky-image-sato $ poky-qemu qemux86 </literallayout> @@ -202,15 +226,19 @@ For devices that don't have a GUI or display you simply would not employ these c </listitem> <listitem> <para> - After changing to the build directory the source command sets up the Yocto Project build environment. + The next two commands create the directory and place you there. The build directory contains all the object files used during the build. The default build directory is poky-dir/build. + Note that you can change the target architecture by editing the + <command><build_directory>/conf/local.conf</command> file. + By default the target architecture is qemux86. </para> </listitem> <listitem> <para> - The two bitbake commands build the OS image and the emulator for the target. - Here poky-image-sato is the name of the target. The qemu-native target is the customized QEMU Emulator.</para> + The bitbake command builds the OS image for the target. + Here poky-image-sato is the name of the target. + </para> </listitem> <listitem> <para> |