Languages: |
English • العربية • Български • Česky • Dansk • Deutsch • Esperanto • Eesti • Español • فارسی • Suomi • Français • עברית • Magyar • Italiano • 한국어 • Nederlands • Norsk (bokmål) • Polski • Português • Română • Русский • Svenska • Slovenčina • Українська • 中文(中国大陆) • 中文(台灣) • Euskara • Català |
BitBake is the build tool used by OpenEmbedded. BitBake recipes are simple, declarative files. Here is an example for the openmoko-calculator2 application:
DESCRIPTION = "A Calculator for Openmoko" SECTION = "openmoko/tools" DEPENDS = "libmokoui2" PV = "0.1.0+svnr${SRCREV}" PR = "r0"
inherit openmoko2
The user manual is available at the BitBake berlios page.
Basically, using bitbake to build your image is very easy.
All you need is these four things. Lets assume you are using a account named build, and you are working under directory moko.
$cd ~/moko # Enter the directory $git clone git://git.openmoko.org/git/bitbake.git bitbake-om # get the bitbake of openmoko.
Bitbake come for OpenEmbedded, however Openmoko has its own bitbake, named bitbake-om. After cloning the bitbake-om, you have the kitchen comprehensive. You also need recipes to tell you how to cook.
$git clone git://git.openmoko.org/git/openmoko.git openmoko
It will clone an OE tree from Openmoko git server. This is the recipes what tell bitbake how to cook. The cloning process spend little time, get a cup of coffee is a good idea when you are waiting.
$install -d /home/build/moko/local/conf #create the direcotry $vim local/conf/local.conf # use your favorite editor
Paste these line into the file
ALLOW_EMPTY = "1" BBFILES := "/home/build/moko/openmoko/packages/*/*.bb" BB_GIT_CLONE_FOR_SRCREV = "1" BBINCLUDELOGS = "yes" BBMASK = "" DISTRO = "openmoko" DL_DIR := "/home/build/moko/sources" EXTENDPE = "" GLIBC_GENERATE_LOCALES = "en_US.UTF-8" IMAGE_FSTYPES = "jffs2 tar.gz" INHERIT += "om-utils" MACHINE = "om-gta02" PARALLEL_MAKE = "-j 4" QA_LOG = "1" TMPDIR := "/home/build/moko/build/"
Let me explain the meanings of some variables.
$vim build_env # use your favorite editor
Paste these lines into the file
export BBPATH="/home/build/moko/local:/home/build/moko/openmoko" export PATH=/home/build/moko/bitbake-om/bin:$PATH
bitbake-om won't change often. But the OE tree (/home/build/moko/openmoko) almost change everyday. Update them is important so you can get the latest fix.
$cd /home/build/moko/bitbake-om $git pull $cd /home/build/moko/openmoko $git pull
The first time you use bitbake will spend many hours. It have to fetch every source code what you need. To build the meta toolchain, and many basic libraries like glibc.
$source /home/build/moko/build_env #read in the environment variables. $bitbake helloworld # build the simplest case. Playing video game for 5 hours, Watching movie for 3 hours and Sleeping for 8 hours.
If you wanna try something like fso image, just ask bitbake to cook another food.
$bitbake fso-image
All the recipe are placed in /home/build/moko/openmoko/packages. For example, fso-image recipe is placed in /home/build/moko/openmoko/packages/images/fso-image.bb.
After the building process complete, the opk files are placed in /home/build/moko/build/deploy/glibc/opk, and the image is in /home/build/moko/build/deploy/images.