Openmoko

Text Text Android Porting by Jollen Chen email: jollen@jollen.org blog: jollen.org/blog plurk: www.plurk.com/jollenchen www.jollen.tw

www.jolle.tw Section 1. Android Kernel

Android Porting Android porting, Android hardware product

Android Porting Application (API) Product Framework / Library Android kernel

Android Porting: new product Android cupcake armv4/armv5/x86 API Level Android Vanilla Kernel Configs Android framework Non-Vanilla Kernel Merge Android framework

Android Porting: Android framework library Android framework ASHMEM wakelock shared library Android framework case study: FreeRunner

API Level System Image API Level Release Android 1.5 3 2009.4.27 Android 1.1 2 2009.2.10 Android 1.0 1 2008.9.23 2007.11.5: Android 2007.11.12: Adnroid SDK early look version 2008.1.3: Adnroid Developer Challenge 2008.2.13: Android SDK m5-rc15 2008.5.12: Top 50 Android Application

Devices misc... Netbook x86 Phone ARMv4/v5

Cupcake MMS WebView Touch events WebView SquirrelFish (JavaScript engine) IME Basic x86 support SIM Application Toolkit 1.0...

android-porting

Android Source Code android.git.kernel.org 1. Cupcake x86 ports 2../.repo/manifest.xml eee_701 platform x86 ports

Android / armv4 git.koolu.org armv4 Koolu s3c2410 / s3c244x Neo FreeRunner

Android / armv4 $ mkdir koolu-android $ cd koolu-android $ repo init -u git://git.koolu.org/freerunner/platform/manifest.git -b koolu-1.0 $ repo sync

Application Developers Applications change Application Framework Surface Manager Media Framework Dalvik VM Shared Libraries System Image Linux Kernel

Product Branch Maintainer Applications Application Framework Surface Manager Dalvik VM rebuild Media Framework Shared Libraries Linux Kernel

Hardware Developing Applications Application Framework Surface Manager Dalvik VM change Media Framework Shared Libraries Linux Kernel change

Architecture Porting Applications Application Framework Surface Manager Media Framework Dalvik VM Shared Libraries porting Linux Kernel

Android Toolchain android-toolchain-20081019 http://android.git.kernel.org/pub/ gcc 4.2.1 / binutils 2.17 / gdb 6.6 ARMV5te+ ABI: EABI, AAPCS --with-float=soft --with=fpu-vfp --enable-threads (single)

Android Kernel Binder Ashmem (Android shared memory) PMEM (Processor memory allocator) logcat (Android Logger) wakelock (Android Power Management) Alarm

Key Features 2.6.23 2.6.25 2.6.27 2.6.29 1 Alarm Driver O O O O 2 Android Logger O O O O 3 Low Memory Killer O O O O 4 Power Management O O O O 5 USB Gadget O O O O 6 ASHMEM X O O O 7 PMEM X X O O 8 x86 Support X X O O 9./drivers/staging/Android/ X X X O

binder Android IPC /proc/binder state stats transactions transation_log failed_transation_log

Ashmem kernel/mm/ashmem.c /dev/ashmem

PMEM drivers/misc/pmem.c userspace driver

$ arm-eabi-gcc -o hello hello.c -Wl,-rpath-link=./cupcake/out/ target/product/generic/obj/lib -L./cupcake/out/target/product/ generic/obj/lib -nostdlib./cupcake/out/target/product/generic/ obj/lib/crtbegin_dynamic.o -lc Android OS native program

Android Android source code (Cupcake) Toolchain EeePC

Linux native C programs glibc & shared libs S!"#$%!&'(( Kernel Hardware

Android Android Framework Application JNI bionic & shared libs S!"#$%!&'(( Kernel Hardware

Android Activity oncreate() myactivity oncreate() MediaPlayer JNI OpenCore bionic S!"#$%!&'((

www.jolle.tw Section 2. Build Android

Android Build system (toolchain). Dalvik::JNI Dalvik::Interpreter Bionic System call

<android>/build/core/combo darwin-x86.mk Makefile macros javac.mk linux-arm.mk linux-x86.mk select.mk target_linux-x86.mk windows-x86.mk

GLOBAL CFLAGS $(combo_target)global_cflags += \ -march=armv5te -mtune=xscale \ -msoft-float -fpic \ -mthumb-interwork \ -ffunction-sections \ -funwind-tables \ -fstack-protector \ -fno-short-enums \ -D ARM_ARCH_5 -D ARM_ARCH_5T \ -D ARM_ARCH_5E -D ARM_ARCH_5TE \ -include $(call select-android-config-h,linux-arm)

GLOBAL CFLAGS for ARMv4 $(combo_target)global_cflags += \ -march=armv4t -mcpu=arm920t -mtune=xscale \ -msoft-float -fpic \ -mthumb-interwork \ -ffunction-sections \ -funwind-tables \ -fstack-protector \ -fno-short-enums \ -D ARM_ARCH_4 -D ARM_ARCH_4T \ -D ARM_ARCH_5E -D ARM_ARCH_5TE \ -include $(call select-android-config-h,linux-arm)

<android>/dalvik/vm/arch JNI Porting generic/ arm/ CallEABI.S CallOldABI.S x86 Call386ABI.S

ARM EABI r0-r3 hold first 4 args to a method r9 is given special treatment in some situations, but not for us r10 (sl) seems to be generally available r11 (fp) is used by gcc (unless -fomit-frame-pointer is set) r12 (ip) is scratch -- not preserved across method calls r13 (sp) should be managed carefully in case a signal arrives r14 (lr) must be preserved r15 (pc) can be tinkered with directly

JNI Entry r0 JNIEnv (can be left alone) r1 clazz (NULL for virtual method calls, non-null for static) r2 arg info * r3 argc (number of 32-bit values in argv) [sp] argv [sp,#4] short signature [sp,#8] func [sp,#12] preturn

Assembly Code #1: armv4/armv5.lcopy_done: @ call the method ldr ip, [r4, #8] @ func #ifndef ARM_ARCH_4 blx ip #else mov lr, pc bx ip #endif

Assembly Code #2: armv4/armv5 #ifndef ARM_ARCH_4 ldmdb r4, {r4, r5, r6, r7, r8, r9, sp, pc} #else ldmdb r4, {r4, r5, r6, r7, r8, r9, sp, lr} bx lr #endif

Dalvik Interpreter <android>/dalvik/vm/mterp common/ armv4/ armv5te/ x86/

Bionic Small and custom C library for the Android platform. A mainly port of BSD C library. Its own small implementation of pthreads based on Linux futexes. Support for x86, ARM and ARM thumb.

<android>/bionic Bionic libc/ libdl/ libm/ libstdc++/ libthread_db/ linker/

<android>/bionic/libc Bionic::libc arch-arm/ arch-x86/ kernel/ arch-arm/asm/ arch-x86/asm/

Android Generated Kernel Header bionic/libc/kernel/ kernel header files Android kernel header Linux kernel header userspace

External Library Android library shared library library opencore ~/google-android/external/opencore$ find./ -name "*.s" -print./codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window_gcc.s./codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18.s./codecs_v2/audio/mp3/dec/src/asm/pvmp3_dct_9.s./codecs_v2/audio/mp3/dec/src/asm/pvmp3_dct_9_gcc.s./codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18_gcc.s./codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window.s./codecs_v2/audio/mp3/dec/src/asm/pvmp3_dct_16_gcc.s

sonivox & OpenSSL./sonivox/arm-hybrid-22k/lib_src/ARM-E_filter_gnu.s./sonivox/arm-hybrid-22k/lib_src/ARM-E_mastergain_gnu.s./sonivox/arm-hybrid-22k/lib_src/ARM-E_voice_gain_gnu.s./sonivox/arm-hybrid-22k/lib_src/ARM-E_interpolate_noloop_gnu.s./sonivox/arm-hybrid-22k/lib_src/ARM-E_interpolate_loop_gnu.s./sonivox/arm-wt-22k/lib_src/ARM-E_filter_gnu.s./sonivox/arm-wt-22k/lib_src/ARM-E_mastergain_gnu.s./sonivox/arm-wt-22k/lib_src/ARM-E_voice_gain_gnu.s./sonivox/arm-wt-22k/lib_src/ARM-E_interpolate_loop_gnu.s./openssl/crypto/bn/asm/pa-risc2W.s./openssl/crypto/bn/asm/pa-risc2.s./openssl/crypto/bn/asm/mips3.s./openssl/crypto/0.9.9-dev/aes/aes-armv4.s./openssl/crypto/0.9.9-dev/bn/armv4-mont.s./openssl/crypto/0.9.9-dev/sha/sha256-armv4.s./openssl/crypto/0.9.9-dev/sha/sha512-armv4.s./openssl/crypto/0.9.9-dev/sha/sha1-armv4-large.s

Android & Kernel SurfaceHolder type SURFACE_TYPE_GPU GPU Graphics Processing Unit SurfaceHolder type SURFACE_TYPE_HARDWARE DMA userspace

Android Surface Manager Media Framework SurfaceHolder type SURFACE_TYPE_GPU GPU Graphics Processing Unit SurfaceHolder type SURFACE_TYPE_HARDWARE DMA MediaPlayer OpenCore

Surface Manager private SurfaceView mpreview; private SurfaceHolder holder; public void oncreate(bundle icicle) { super.oncreate(icicle); setcontentview(r.layout.mediaplayer_2); mpreview = (SurfaceView) findviewbyid(r.id.surface); holder = mpreview.getholder(); holder.addcallback(this); holder.settype(surfaceholder.surface_type_push_buffers); } Surface Manager

Media Framework private MediaPlayer mmediaplayer; } public void surfacecreated(surfaceholder holder) { mmediaplayer = new MediaPlayer(); mmediaplayer.setdatasource(path); mmediaplayer.setdisplay(holder); mmediaplayer.prepare(); mmediaplayer.setonbufferingupdatelistener(this); mmediaplayer.setoncompletionlistener(this); mmediaplayer.setonpreparedlistener(this); mmediaplayer.setaudiostreamtype(audiomanager.stream_music); Media Framework OpenCore

New Product File Tree <company_name> <board_name> + Android.mk + product_config.mk + system.prop products + AndroidProducts.mk + <first_product_name>.mk + <second_product_name>.mk

Android x86 port (target product = EeePC 701) 1. Get Google Android $ repo init -u git://android.git.kernel.org/platform/manifest.git -b cupcake $ repo sync 2. Manifest file. <manifest>... <project name="platform/vendor/asus/eee_701" \ path="vendor/asus/eee_701"/>... </manifest> 3. Get EeePC platform. $ repo sync 4. Build Android image. $ TARGET_ARCH=x86 TARGET_PRODUCT=eee_701 DISABLE_DEXPREOPT=true make -j2 installer_img 5. Create USB boot stick. Use make-live script. https://review.source.android.com/gerrit#change,6475

Build EeePC 701 Product Tips # Google API issue $(call inherit-product, $(SRC_TARGET_DIR)/product/generic.mk) PRODUCT_NAME := eee_701 PRODUCT_DEVICE := eee_701 PRODUCT_POLICY := android.policy_mid PRODUCT_PROPERTY_OVERRIDES += \ ro.com.android.dataroaming=true Cupcake Google APIs add-ons

Build EeePC 701 Product Tips # e2fsprogs issue external/e2fsprogs/android.mk: --- a/android.mk +++ b/android.mk @@ -1,3 +1,3 @@ ifneq ($(TARGET_SIMULATOR),true) -# include $(call all-subdir-makefiles) + include $(call all-subdir-makefiles) endif

Android Image Files boot.img installer.img ramdisk.img system.img userdata.img

$ make-live Android

VirtualBox AMD PCnet32 PCI support VESA VGA graphics support VGA 8x8 font VGA 8x16 font

installer.img VDI $ VBoxManage convertromraw -format VDI./installer.img./android.vdi

Android Kernerl Configs

Android Init Process device/system/init device/system/init/init.c /etc/init.rc mount file system ( /etc/fstab)

Running Applications /system/bin/logd /sbin/adbd /system/bin/usbd /system/bin/debuggerd /system/bin/rild /system/bin/app_process /system/bin/runtime /system/bin/dbus-daemon system_server

Zygote Process Startup

Android FreeRunner s3c2410 / s3c244x Neo FreeRunner Mokofly (coming...)

Text Text android-way.com www.jollen.tw FAQ Jollen Chen <jollen@jollen.org> Embedded Linux Embedded Linux Linux Openmoko Openmoko Android OS Android Jollen - www.jollen.org/blog Jollen - www.plurk.com/jollenchen