EM Open Source Project
Embedded Master Open source project is managed by OESF Distribution Working Group to produce, develop, and maintain the extensional functions base on Android. This document describe the overview of the project and how to set up your local work environment, how to use Repo to get the Embedded Master files, and how to build the files on your machine.
Getting Started
If you would like to work with Embedded Master source code and build it, You have to set up your local machine environment.And you have to use Repo and Git. If you are not accustom with Repo and Git, please refer Android open source project site's using Repo and Git page.
Open Source Project site
OESF Embedded Master Open Source Project is public open.Please visit the following site and join our open development project. http://github.com/oesf/embedded-master
http://github.com/oesf/embedded-master-arm
http://github.com/oesf/embedded-master-mips
Target Platform
Embedded Master now support the following hardware platform. These platform will be changed time by time, and release by release.| Device Name | Procuced by | App. Processor | CPU |
| Armadillo-500 FX | Atmark Techno | Freescale i.MX31 | ARM1136JF-S |
| RMI Alchemy Home Media Player | RMI | RMI Alchemy Au1250 Processor | Enhanced MIPS32 CPU Core |
| BeagleBoard | Texas Instruments | OMAP 3530 | ARM Coretex A8 |
Mile stone
The following list is Embedded Master release mile stone that currently be planed.| Distribution | Project Code | Member Release | Public Release | Android version |
| EM1 | Blueberry | Nov/2009 | Feb/2010 | 1.6 |
| EM2 | Cinnamon | Apr/2010 | Jun/2010 | 2.0 |
| EM3 | Durian | TBD | TBD | TBD |
| EM4 | Egg | TBD | TBD | TBD |
Setting up your machine
Currently we support the following platform to build OESF Embedded Master. we do not support Windows environment. If you are using Windows, we recommend you to use VMware player and install Ubuntu top on that.Ubuntu Linux (32-bit x86)
To set up your Linux development environment, make sure you have the following:Required Packages:
■ Git 1.5.4 or newer and the GNU Privacy Guard.
■ JDK 5.0, update 12 or higher. Java 6 is not supported, because of incompatibilities with @Override.
■ flex, bison, gperf, libsdl-dev, libesd0-dev, libwxgtk2.6-dev (optional), build-essential, zip, curl.
|
$ sudo apt-get install git-core gnupg sun-java5-jdk flex bison gperf libsdl-dev libesd0-dev libwxgtk2.6-dev build-essential zip curl libncurses5-dev zlib1g-dev |
You might also want Valgrind, a tool that will help you find memory leaks, stack corruption, array bounds overflows, etc.
|
$ sudo apt-get install valgrind |
To install Repo, follow these steps:
Repo is a tool that makes it easier to work with Git in the context of Embedded Master.
Make sure you have a ~/bin directory in your home directory, and check to be sure that this bin directory is in your path:
|
$ cd ~ $ mkdir bin $ echo $PATH |
Download the repo script and make sure it is executable:
|
$ curl http://android.git.kernel.org/repo >~/bin/repo $ chmod a+x ~/bin/repo |
Intrepid (8.10) users may need a newer version of libreadline:
|
$ sudo apt-get install lib32readline5-dev |
Running Linux in a virtual machine
If you are running Linux in a virtual machine, you will need at least 1.5GB of RAM and 10GB or more of disk space in order to build the Embedded Master tree.Verifying Git Tags
Load the following public/private key into your GnuPG key database. The key is used to sign annotated tags that represent releases.|
$ gpg --import |
|
$ git tag -v tagname |
Public key will be available on Feb/2010 after Embedded Master Public Release.
Privae key will be published only for OESF Regular member. Please contact to our EM Administrator(em@oesf.biz).
Licenses
The Embedded Master Open Source Project apply the same licenses policy with the Android Open Source Project. We also use a few open source initiative approved open source licenses to enable availability of source code and to accept contributions from individuals and/or corporations.Embedded Master Open Source Project license
The preferred license for the Embedded Master Open Source Project is Apache 2.0. Apache 2.0 is a commercial and open source friendly open source license. The majority of the Embedded Master platform is licensed under the Apache 2.0 license.Some portion of the Embedded Master Open Source apply different license policies, Please check each file's license pliocy notification.