Changes between Version 7 and Version 8 of Setting_up_OpenEmbedded

Timestamp:

12/17/09 02:31:31 (3 years ago)

Author:

einstein

Comment:

--

Setting_up_OpenEmbedded

@@ -1 +1 @@
 This project uses !OpenEmbedded (OE) as its build platform. This tutorial is based on [http://wiki.openembedded.net/index.php/Getting_started the OpenEmbedded.net Getting Started page], refer to it if anything on this page is not clear.
 
-1. Create an empty folder, in this tutorial we use <tt>/usr/src/openaos</tt>. This folder will contain your entire OE environment.
+1. First, read the section relative to your linux distribution on the [http://wiki.openembedded.net/index.php/OEandYourDistro 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.
 
 {{{
@@ -8 +10 @@
 }}}
 
-2. Download and install !BitBake in this new folder.
+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
@@ -16 +32 @@
 }}}
 
-3. Checkout the OE git repository.
+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
 }}}
 
-Once in a while, run an update on your git repository:
+The stable/2009 branch ''should'' not change much, but once in a while, run an update on your git repository:
 
 {{{
@@ -29 +47 @@
 }}}
 
-4. Setup the environment before compiling. You will need to run these commands every time you use your OE environment, so we recommend you create a script <tt>/usr/src/openaos/setup_env</tt>.
+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:
 
 {{{
-export OETREE=/usr/src/openaos
-export BBPATH=${OETREE}/:${OETREE}/build/:${OETREE}/openembedded/
-export PATH=${OETREE}/bitbake/bin:$PATH
-export LANG=C
-export BB_ENV_EXTRAWHITE="MACHINE DISTRO OETREE ANGSTROM_MODE ANGSTROMLIBC LIBC"
-cd ${OETREE}/build/
+/usr/src/openaos/build/profiles/openaos/profile.sh
+/usr/src/openaos/build/profiles/openaos/conf/local.conf
 }}}
 
-And run it with <tt>source setup_env</tt>
+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:
 
-5. Checkout our OE overlay.
+{{{
+cd /usr/src/openaos/build/profiles/openaos
+source profile.sh
+}}}
 
- (to be continued!)
+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.