Difference between revisions of "How to get the Poky Linux distribution"

From IGEP - ISEE Wiki

Jump to: navigation, search
 
(20 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
== How to get the Poky Linux distribution ==
+
#REDIRECT:[[How to use the Yocto Project to develop Embedded Linux]]
  
−
[http://www.pokylinux.org/about Poky] is an open source platform build tool. It is a complete software development environment for the creation of Linux devices. It enables you to design, develop, build, debug, and test a complete, modern, software stack using Linux, the X Window System and GNOME Mobile based application frameworks for both x86 and ARM based platforms. Key features include:
+
= How to get the Yocto Linux distribution  =
  
−
*Full, fast, cross device filesystem creation with Linux Kernel 2.6.x, GCC, GNU C library, Busybox, networking and much more.
+
'''It's not an embedded Linux distribution – it creates a custom one for you'''
−
*Highly configurable and extendable with full documentation, granular feature control, packaging, and wide machine coverage.
 
−
*Developer friendly with QEMU device virtulisation, SDK generation, Anjuta IDE, OProfile and GDB integration.
 
−
*Complete GNOME Mobile platform with the X Window System, Matchbox, GTK+ 2.12, D-Bus, GStreamer and 'Sato' reference implementation.
 
−
*Support for bleeding edge OpenGL user interfaces with the Clutter toolkit.
 
−
*A supported, stable and proven base for real world products built on Linux and open source software.
 
  
−
=== Overview of How-To ===
+
Much of this How-To is extracted from different sources. If you would like to read some of the original articles or resources, please visit them and thank the authors:
−
This How-To is meant to be a starting point for people to learn build and run Poky images for IGEP v2 devices as quickly and easily as possible.
 
  
−
This How-To works with the '''Ubuntu 8.04 IGEP v2.0 SDK Virtual Machine''' but most of the contents are valid also for other GNU/Linux distributions. We do not issue any guarantee that this will work on other distributions.
+
*The Yocto project website ( http://www.yoctoproject.org )
 +
*The Yocto project documentation ( http://www.yoctoproject.org/documentation )
 +
*The Openembedded website ( http://www.openembedded.org/ )
  
−
This How-To will start out by a '''Poky Platform Setup Environment''' introducing you to the Poky environment and the way you can build an Poky-based image.
+
== Overview of How-To ==
  
−
Next, we will cover the '''Poky images supported'''.
+
This How-To is meant to be a starting point for people to learn build and run Yocto-based images for IGEP Technology devices as quickly and easily as possible.  
  
−
Lastly, we will learn how to '''Installing and Using the Result on a NFS-mounted root filesystem'''.
+
== About the Yocto Project™  ==
  
−
=== Requirements ===
+
The [http://www.yoctoproject.org Yocto Project™] is an open source collaboration project that provides templates, tools and methods to help you create custom Linux-based systems for embedded products regardless of the hardware architecture. It was founded in 2010 as a collaboration among many hardware manufacturers, open-source operating systems vendors, and electronics companies to bring some order to the chaos of embedded Linux development.  
−
*'''Ubuntu 8.04 IGEP v2.0 SDK Virtual Machine'''
 
  
−
=== Feedback and Contributing ===
+
== Why use the Yocto Project™  ==
−
At any point, if you see a mistake you can contribute to this How-To.
 
  
−
==== How to get involved (http://pokylinux.org/support/) ====
+
Because it's a complete embedded Linux development environment with tools, metadata, and documentation - everything you need. The free tools are easy to get started with, powerful to work with (including emulation environments, debuggers, an Application Toolkit Generator, etc.) and they allow projects to be carried forward over time without causing you to lose optimizations and investments made during the project’s prototype phase. The Yocto Project fosters community adoption of this open source technology allowing its users to focus on their specific product features and development
  
−
There are many ways to get involved with the Poky project. Poky has a friendly community providing informal support and discussion.
+
== Build Platform Setup Environment  ==
  
−
'''Mailing list'''
+
In order to build an image with BSP support for a given release, you need to download the corresponding BSP repository. At this time latest stable branch for IGEP devices is denzil.
  
−
To subscribe send mail to;
+
  $ git clone -b denzil git://git.isee.biz/pub/scm/poky.git
  
−
poky+subscribe <at> openedhand <dot> com
+
Enter to the poky directory,
  
−
And follow simple instructions in subsequent reply. Archives are available here.
+
  $ cd poky
  
−
'''Bugs'''
+
and clone the meta-isee layer.
  
−
Problems with Poky should be reported in the bug tracker: http://bugzilla.o-hand.com/
+
  $ git clone -b denzil git://git.isee.biz/pub/scm/meta-isee.git
  
−
'''IRC'''
+
  $ source oe-init-build-env
  
−
Chat with the Poky development team and community in #poky on freenode.
+
Having done that, and assuming you downloaded the BSP contents at the top-level of your yocto build tree, you can build a igep image by adding the location of the 'meta-igep' layer to 'bblayers.conf'
  
−
=== References ===
+
Add below line into .../poky/build/conf/bblayers.conf:  
−
Much of this How-To is extracted from different sources. If you would like to read some of the original articles or resources, please visit them and thank the authors:
 
  
−
*The Poky website ( http://www.pokylinux.org/ )
+
        &lt;path to&gt;/poky/meta-isee \
−
*The Poky Handbook ( http://www.pokylinux.org/doc/poky-handbook.html )
+
 
−
*Using the Anjuta Poky SDK plugin ( http://pokylinux.org/blog/index.php/2010/03/using-the-anjuta-poky-sdk-plugin )
+
To enable the isee layer, add the 'igep00x0 MACHINE' to .../poky/build/conf/local.conf:
−
*The Openembedded website ( http://www.openembedded.org/ )
+
 
 +
  MACHINE&nbsp;?= "igep00x0"
 +
 
 +
You should then be able to build a image as such:  
  
−
=== Poky Platform Setup Environment ===
+
  $ bitbake demo-image-sato
  
−
Poky is derivative of the Open Embedded. In order to function properly, the Virtual Machine need some adaptations of the development system.
+
At the end of a successful build, you should have an image that you could use for boot device from flash or a micro-SD card.  
  
−
The first thing we need to do is set Bash as default sh shell, execute
+
== Extending the available packages with others layers ==
−
<pre>
 
−
$ sudo dpkg-reconfigure dash
 
−
</pre>
 
−
and answer no when asked whether you want to install dash as /bin/sh.
 
−
So, now, "/bin/sh" file links to "/bin/bash" (not to "/bin/dash").
 
  
−
An other change we need to perform is to change some default settings of the kernel. Edit the /etc/sysctl.conf file as root with your preferred editor and set the vm.mmpap_min_addr to 0
+
You can append more layers to your environment in order to build more packages, in following wxample you'll download the meta-openembedded layer. In your poky directory
−
<pre>
 
−
$ sudo nano /etc/sysctl.conf
 
−
vm.mmap_min_addr = 0
 
−
</pre>
 
−
then, run this command
 
−
<pre>
 
−
$ sudo sysctl -p
 
−
</pre>
 
  
−
Install extra packages necessary for bitbake to function.
+
  $ git clone -b denzil git://git.openembedded.org/meta-openembedded
−
<pre>
 
−
$ sudo apt-get update
 
−
$ sudo aptitude install subversion cvs git-core \
 
−
      build-essential help2man diffstat texi2html texinfo \
 
−
      libncurses5-dev gawk python-dev python-psyco python-pysqlite2 \
 
−
      scrollkeeper gnome-doc-utils gettext automake mercurial libx11-dev \
 
−
      libgl1-mesa-dev libglu1-mesa-dev libsdl1.2-dev
 
−
</pre>
 
  
−
==== Poky version 3.2 codename Purple (stable branch) ====
+
Add the layer into build/conf/bblayers.conf:
−
Poky version 3.2 ( stable branch) is available from a GIT repository located at git://git.igep.es/pub/scm/poky.git. The first thing you will do is clone the Poky project.
 
  
−
<pre>
+
        &lt;path to&gt;/poky/meta-openembedded/meta-oe \
−
$ git clone git://git.igep.es/pub/scm/poky.git
 
−
Initialized empty Git repository in /home/eballetbo/Software/staging/poky/.git/
 
−
remote: Counting objects: 52944, done.
 
−
remote: Compressing objects: 100% (16209/16209), done.
 
−
remote: Total 52944 (delta 34820), reused 52910 (delta 34806)
 
−
Receiving objects: 100% (52944/52944), 35.52 MiB | 249 KiB/s, done.
 
−
Resolving deltas: 100% (34820/34820), done.
 
−
</pre>
 
−
Then, switch to stable branch (Purple v3.2)
 
−
<pre>
 
−
$ cd poky
 
−
$ git checkout origin/release/purple -b release/purple
 
−
warning: You appear to be on a branch yet to be born.
 
−
warning: Forcing checkout of origin/release/purple.
 
−
Branch release/purple set up to track remote branch refs/remotes/origin/release/purple.
 
−
Switched to a new branch "release/purple"
 
−
</pre>
 
−
After that, you need to link an user board configuration (local.conf). The configuration file who defines various configuration variables which govern what Poky platform does.
 
−
<pre>
 
−
$ ln -s ../../meta-contrib/build/conf/local.conf.igep0020 build/conf/local.conf
 
−
</pre>
 
  
−
At this point the Poky build environment needs to be set up, you will do this with the poky-init-build-env script. Sourcing this file in a shell makes changes to PATH and sets other core bitbake variables based on the current working directory.
+
Now you can build any of the new packages added, for example:
  
−
Refer to http://www.pokylinux.org/doc/poky-handbook.html#ref-images for standard images
+
  $ bitbake postgresql
  
−
Refer to [[Ubuntu 8.04 IGEP v2.0 SDK Virtual Machine]] to how to install and use poky images on a NFS-mounted root filesystem.
+
== Create your own Linux image ==
  
−
==== Poky version 3.3 codename Green (under development) ====
+
TODO
  
−
Poky version 3.3 is available from a GIT repository located at git://git.igep.es/pub/scm/poky.git. The first thing you will do is clone the Poky project.
+
== Yocto 1.2 'denzil' documentation ==
  
−
$ git clone git://git.igep.es/pub/scm/poky.git
+
'''Official documentation'''
−
$ cd poky
 
  
−
At this point the Poky build environment needs to be set up, you will do this with the poky-init-build-env script. Sourcing this file in a shell makes changes to PATH and sets other core bitbake variables based on the current working directory.
+
* [http://www.yoctoproject.org/docs/1.2/yocto-project-qs/yocto-project-qs.html Yocto Project Quick Start]: This short document lets you get started with the Yocto Project quickly and start building an image.
 +
* [http://www.yoctoproject.org/docs/1.2/adt-manual/adt-manual.html The Yocto Project Application Development Toolkit (ADT) User's Guide]: This manual provides information that lets you get going with the ADT to develop projects using the Yocto Project.
 +
* [http://www.yoctoproject.org/docs/1.2/bsp-guide/bsp-guide.html The Yocto Project Board Support Package (BSP) Developer's Guide]: This brief document defines a structure for BSP components. Having a commonly understood layout encourages standardization.
 +
* [http://www.yoctoproject.org/docs/1.2/dev-manual/dev-manual.html The Yocto Project Development Manual]: This Manual provides an overview of the development process for images and user-space applications.
 +
* [http://www.yoctoproject.org/docs/1.2/poky-ref-manual/poky-ref-manual.html The Yocto Project Reference Manual]: This manual is the complete reference guide to the Yocto Project, including the Poky reference system which contains a worki
  
−
... Please contribute ...
+
= See also  =
  
−
--- That's all folks ---
+
*[[How to get the Angstrom distribution]]
 +
*[[How to get the Ubuntu distribution]]
 +
*[[How to get the Linaro distribution]]
 +
*[[How to get the Android distribution]]
 +
*[[How to get the Meego distribution]]
  
−
[[Category:Software distributions|Poky]]
+
[[Category:Software_distributions|Poky]]

Latest revision as of 13:55, 26 July 2013

Redirect to:

How to get the Yocto Linux distribution

It's not an embedded Linux distribution – it creates a custom one for you

Much of this How-To is extracted from different sources. If you would like to read some of the original articles or resources, please visit them and thank the authors:

Overview of How-To

This How-To is meant to be a starting point for people to learn build and run Yocto-based images for IGEP Technology devices as quickly and easily as possible.

About the Yocto Project™

The Yocto Project™ is an open source collaboration project that provides templates, tools and methods to help you create custom Linux-based systems for embedded products regardless of the hardware architecture. It was founded in 2010 as a collaboration among many hardware manufacturers, open-source operating systems vendors, and electronics companies to bring some order to the chaos of embedded Linux development.

Why use the Yocto Project™

Because it's a complete embedded Linux development environment with tools, metadata, and documentation - everything you need. The free tools are easy to get started with, powerful to work with (including emulation environments, debuggers, an Application Toolkit Generator, etc.) and they allow projects to be carried forward over time without causing you to lose optimizations and investments made during the project’s prototype phase. The Yocto Project fosters community adoption of this open source technology allowing its users to focus on their specific product features and development

Build Platform Setup Environment

In order to build an image with BSP support for a given release, you need to download the corresponding BSP repository. At this time latest stable branch for IGEP devices is denzil. 

 $ git clone -b denzil git://git.isee.biz/pub/scm/poky.git

Enter to the poky directory, 

 $ cd poky

and clone the meta-isee layer. 

 $ git clone -b denzil git://git.isee.biz/pub/scm/meta-isee.git

 $ source oe-init-build-env

Having done that, and assuming you downloaded the BSP contents at the top-level of your yocto build tree, you can build a igep image by adding the location of the 'meta-igep' layer to 'bblayers.conf'

Add below line into .../poky/build/conf/bblayers.conf: 

       <path to>/poky/meta-isee \

To enable the isee layer, add the 'igep00x0 MACHINE' to .../poky/build/conf/local.conf: 

 MACHINE ?= "igep00x0"

You should then be able to build a image as such: 

 $ bitbake demo-image-sato

At the end of a successful build, you should have an image that you could use for boot device from flash or a micro-SD card.

Extending the available packages with others layers

You can append more layers to your environment in order to build more packages, in following wxample you'll download the meta-openembedded layer. In your poky directory 

 $ git clone -b denzil git://git.openembedded.org/meta-openembedded

Add the layer into build/conf/bblayers.conf: 

       <path to>/poky/meta-openembedded/meta-oe \

Now you can build any of the new packages added, for example: 

 $ bitbake postgresql

Create your own Linux image

TODO

Yocto 1.2 'denzil' documentation

Official documentation

See also

Retrieved from "http://labs.isee.biz/index.php?title=How_to_get_the_Poky_Linux_distribution&oldid=9138"