This project uses OpenEmbedded (OE) as its build platform. This tutorial is based on  the OpenEmbedded.net Getting Started page, refer to it if anything on this page is not clear.

1. First, read the section relative to your linux distribution on the  OE and your distro page, install the recommended dependencies and resolve any possible issue listed on that page.

2. Create an empty folder, in this tutorial we use <tt>/usr/src/openaos</tt>. This folder will contain your entire OE environment, the openAOS overlay, and everything else you might ever need for this project.

mkdir -p /usr/src/openaos
cd /usr/src/openaos

3. The openAOS projet maintains its own overlay on top of the OpenEmbedded environment. This overlay is available in our Subversion repository, the first step to setup the environment is to check it out:

comming soon

And once in a while, run an update:

cd /usr/src/openaos/build
svn update

4. The next step is to download the build tool, BitBake:

cd /usr/src/openaos/build
wget http://download.berlios.de/bitbake/bitbake-1.8.18.tar.gz
tar -xzf bitbake-1.8.18.tar.gz bitbake
mv bitbake-1.8.18 bitbake

5. The last thing you need to do is to checkout the official OpenEmbedded source tree. The openAOS project is based around the stabe/2009 branch:

git clone git://git.openembedded.org/openembedded
...
git checkout stable/2009

The stable/2009 branch should not change much, but once in a while, run an update on your git repository:

cd /usr/src/openaos/openembedded
git pull

6. If you did not use <tt>/usr/src/openaos</tt> as the location of your OE environment, then edit the two files below and add the correct location:

/usr/src/openaos/build/profiles/openaos/profile.sh
/usr/src/openaos/build/profiles/openaos/conf/local.conf

7. At this point you should be ready to start your first build! Every time you want to use your OE environment for the openAOS project, you will need to run a script that will setup the proper environment variables for the build:

cd /usr/src/openaos/build/profiles/openaos
source profile.sh

To build anything in OpenEmbedded, the command to use is <tt>bitbake</tt> followed by a recipe name. The available recipes for the openAOS project are located under <tt>/usr/src/openaos/build/openaos/recipes</tt>. In general, if you are modifying anything outside of this folder, you are doing it wrong. The overlay recipes have priority over the openembedded recipes, so for instance, if you want to modify an OE recipe for any reason, first copy it from <tt>openembedded/recipes</tt> to <tt>openaos/recipes</tt> and then only proceed with your changes.