Android

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m
Line 7: Line 7:
 
[[Image:android.png]]
 
[[Image:android.png]]
 
= Introduction =  
 
= Introduction =  
This page is dedicated to porting the [http://www.android.com Android OS] to the [[Neo 1973]] and [[Neo FreeRunner]] handsets. Since the Android OS was [http://source.android.com/posts/opensource  publically released] on 20081021, [http://benno.id.au/blog/2007/11/21/android-neo1973 work] [http://perpetual-notion.blogspot.com/search/label/android is] [http://groups.google.com/group/android-porting currently underway] to port Android to the [[Neo1973 Hardware|Neo 1973]] and [[Neo_FreeRunner_GTA02_Hardware|FreeRunner]] handsets.
+
This page is the central place for documentation about Android and[[Neo1973 Hardware|Neo 1973]] and [[Neo_FreeRunner_GTA02_Hardware|FreeRunner]] handsets.
  
== Goals ==
+
= Development =
# Systematically introduce patches for ARMv4T in the Android codebase
+
See: [[Android_porting]]
# Provide Neo1973 and Neo FreeRunner hardware-dependent patches in the Android codebase, leveraging the work already done by the Openmoko developers, without forcing Android-specific changes upstream
+
# Provide a useable Android filesystem and kernel on the [[Distributions]] page that conform to current Openmoko installation routines
+
  
== Early Attempts ==
+
= Usage =
Before the source code was released, kernel trap handlers were implemented to 'emulate' the ARMv5TE ISA. Although the results worked in many cases, trapping is costly and performance suffered as a result. Moreover, without explicitly knowing which conditions were set by various instructions, such as Thumb Mode execution, the result became non deterministic.
+
See: [[Android_usage]]
  
== Current State ==
+
= Installation =
With the release of the Android [http://source.android.com source code], the Open Source community is no longer limited to dealing with a binary-only product. The Open Handset Alliance (OHA) has let their source code become their product for everyone enrich and benefit from. Currently, porting efforts are underway in many circles.
+
See: [[Android_on_Freerunner]]
  
Patches should be submitted via the [http://source.android.com/submit-patches official Android channels].
+
= News =
 +
* 20090122 Koolu releases its Beta2 Android [http://freerunner.android.koolu.com/release-files release].
  
To track the status of which parts of the Android source tree contain ARMv5 specific code, I've created a table of where it is contained, and the status of patches. It can be found at: http://spreadsheets.google.com/pub?key=pzDEXnU19gkeTjpD28t-7fw [[User:Bricode]]
 
 
=== Updates ===
 
 
* 20081219 Koolu releases its Beta Android [http://forum.koolu.org/files/androidfs-koolu-1_0.jffs2 Image] and [http://forum.koolu.org/files/uImage-android-patched_bc2caff9cdef8a16.bin kernel].
 
* 20081219 Koolu releases its Beta Android [http://forum.koolu.org/files/androidfs-koolu-1_0.jffs2 Image] and [http://forum.koolu.org/files/uImage-android-patched_bc2caff9cdef8a16.bin kernel].
  
Line 31: Line 27:
 
* 20081104 The first Android-image has been successfully created by Sean McNeil!  - sms and calling works, wifi and bluetooth doesn't. [http://onlinedev.blogspot.com/2008/11/porting-android-phase-3-done.html ''news-source'']
 
* 20081104 The first Android-image has been successfully created by Sean McNeil!  - sms and calling works, wifi and bluetooth doesn't. [http://onlinedev.blogspot.com/2008/11/porting-android-phase-3-done.html ''news-source'']
  
== Installing Using Current Binaries ==
 
Detailed instructions for installing Android on the Freerunner Using Sean McNeil's kernel and rootfs image, With the Qi bootloader, can be found at [[Android_on_Freerunner]] or [http://www.copiesofcopies.org/webl/?p=34 here].
 
 
== Building the Koolu Android Source ==
 
# Configure your machine with the prerequisites documented in the [http://source.android.com/download#TOC-Setting-up-your-machine Setting up your machine] section of Google's build instructions.
 
# Install <tt>repo</tt> and download the source, as documented at http://trac.koolu.org/.
 
# After the build finishes you can put together a root file system by editing and running Sean McNeil's scripts, which are attached to [http://lists.openmoko.org/pipermail/community/2008-December/036982.html this message]. The first script (cp_android_OS) is used to copy the newly built files into a staging area. The second one (mkjffs2) makes a jffs2 image from the staging area. Be sure to edit the paths in the two files to match your environment. Alternatively, you can use the script [[#Building a jffs2 image|below]]
 
# The result of the previos step is a file, <tt>androidfs.jffs2</tt>, which may be flashed to your Freerunner.
 
 
 
If you don't have mkfs.jffs2 you need mtd-tools, in debian based distros like Ubuntu just do: <pre>sudo apt-get install mtd-tools</pre>
 
 
==== Building a jffs2 image ====
 
You can use this script:
 
<pre>
 
#!/bin/sh
 
 
currentdir=`pwd`
 
 
ANDROID_OUT=out
 
ANDROID_DEVICE=freerunner
 
EXPORT_ROOT=$currentdir/build_jffs2_tmp
 
 
Usage()
 
{
 
echo "Usage: $0 release|debug jffs2filename"
 
}
 
 
BuildImage()
 
{
 
 
if [ -d $1 ]
 
then
 
echo "[INFO] Copying from... $1"
 
 
sudo rm -rf $EXPORT_ROOT
 
mkdir $EXPORT_ROOT
 
mkdir $EXPORT_ROOT/root
 
 
# Copy the image...
 
cd $1
 
tar cf - root | (cd $EXPORT_ROOT; sudo tar xf -)
 
tar cf - system | (cd $EXPORT_ROOT/root; sudo tar xf -)
 
 
# Change owner and permissions...
 
cd $EXPORT_ROOT
 
sudo chown -R root:root root
 
sudo chmod -R 777 root
 
 
cd $currentdir
 
 
# Make the JFFS2 file
 
mkfs.jffs2 --pad=0x700000 -o $2 -e 0x20000 -n -d$EXPORT_ROOT/root/
 
echo "[INFO] Image written to $2"
 
 
sudo rm -rf $EXPORT_ROOT
 
else
 
echo "$1 does not exist!"
 
fi
 
}
 
 
if [ $# != 2 ]
 
then
 
Usage
 
else
 
 
case $1 in
 
    release)
 
BuildImage $ANDROID_OUT/target/product/$ANDROID_DEVICE $2
 
;;
 
    debug)
 
BuildImage $ANDROID_OUT/debug/target/product/$ANDROID_DEVICE $2
 
;;
 
    *)
 
Usage
 
esac
 
fi
 
 
</pre>
 
 
=== Windows Connectivity ===
 
It is possible to get Windows to at least recognize the Android "Ethernet Gadget" and charge the FreeRunner using the Android USB Windows driver (http://dl.google.com/android/android_usb_windows.zip) by modifying the android_usb.inf file in that package before attempting to install the driver.  The following modifications are required:
 
 
Add the following to the [Google.NTx86] section of the android_usb.inf file:
 
 
<pre>
 
; Neo FreeRunner
 
%USB\VID_1457&PID_5117.DeviceDescRelease%=androidusb.Dev, USB\VID_1457&PID_5117
 
%USB\VID_1457&PID_5117&MI_01.DeviceDescRelease%=androidusb.Dev, USB\VID_1457&PID_5117&MI_01
 
</pre>
 
 
and add the following to the to the [Strings] section of the android_usb.inf file:
 
 
<pre>
 
USB\VID_1457&PID_5117.DeviceDescRelease="Neo FreeRunner"
 
USB\VID_1457&PID_5117&MI_01.DeviceDescRelease="Neo FreeRunner Composite ADB Interface"
 
</pre>
 
 
The Windows version of adb does not appear to recognize the connected device yet but at least the FreeRunner charges and the device driver indicates that "This device is working properly."
 
 
= How to Help =
 
 
You can start by following the instructions to download and build the Android source from scratch. Please see [http://source.android.com/download http://source.android.com/download] and follow the instructions for your architecture.
 
 
== Publicize Your Efforts ==
 
 
It's generally a good idea to make your efforts known via wiki systems, public mailing lists, forums, and publically open version control systems.
 
 
Always take credit for your work but please don't do it in the form of comments. Some code is already hard enough to read without comments polluting the text. The best thing to do is to create a patch and put a header with your information at the top. Collaboration systems such as git might already do this for you (??).
 
 
If you create something new and have the ability to designate the license for it, please consider license compatibility issues.
 
 
== Porting Strategy ==
 
 
* Analysis and leverage of the existing build system
 
** buid/core/combo/arm-linux.mk
 
*** -D__ARCH_ARM_4__ -D__ARCH_ARM_4T__
 
*** -march=armv4t -mcpu=arm920t
 
** fix various static references to 'armv5'
 
* Isolating ARMv5TE ISA dependent code
 
** e.g. grep -n -R -i "${armv5te_isa_pattern}" ~/android
 
* Abstracting
 
** ( C/C++ )
 
*** Use inlined functions / #ifdef statments to implement functions in a portable manner
 
*** For inlined assembler calls, it's acceptable for now to use generic C code instead, so long as later on we optimize it by hand.
 
** ( ASM )
 
*** Proprocessor statements based on ISA / architecture, e.g. #ifdef __ARCH_ARM_5__ ... #endif #ifdef __ARCH_ARM_4__ ... #endif
 
*** It's highly suggested that preprocessor statements should not be nested (i.e. make them mutually exclusive)
 
*** Some people have suggested that we should not do #ifdef's based on ARCH or ISA, but rather based on an AndroidConfig.h which would define macros like PLD(...) #ifdef HAVE_ARM_PLD pld #else ... #endif .
 
 
For each ARMv5TE instruction, one could potentially
 
* Implement the instruction using general registers instead of DSP calls (i.e. eabi / softfloat)
 
* If that is a) nondeterministic, or b) slow, then sections of code need to be analyzed and hand-optimized for the ARMv4T isa
 
 
== List of Unsupported Instructions ==
 
 
This is a list of opcodes, extracted from the Android source, that are unsupported for ARMv4T compliant processors (specifically the arm920t). The opcodes represent instructions available for ARMv5, ARMv5T, and ARMv5TE architectures, which are not present in the ARMv4T ISA. The list was obtained by exhaustively editing the recompiling the Android source code until it compiled without error.
 
 
Please keep in mind, that in some cases, translating these instructions into a sequence of ARMv4T instructions will be impossible and / or result in nondeterministic execution because of
 
* the requirement of additional context
 
* the tendencies of certain opcodes to change condition registers that may or may not be present in the arm920t core
 
 
=== Opcodes ===
 
 
{{scroll box|height=480px|text=
 
<TABLE BORDER="1">
 
<TR>
 
<TH>Opcode</TH>
 
<TH>Desription</TH>
 
<TH>[[http://www.arm.com/miscPDFs/14128.pdf PDF]] Page Number</TH>
 
<TH>C</TH>
 
<TH>ASM</TH>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">BLX(1)</TH>
 
<TD>Branch, Link, and Exchange</TD>
 
<TD>166</TD>
 
<TD>N/A (Unused in Android)</TD>
 
<TD>N/A (Unused in Android)</TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">BLX(2)</TH>
 
<TD>Branch, Link, and Exchange</TD>
 
<TD>168</TD>
 
<TD>
 
[[User:Cfriedt]] 20081028
 
Remove from inline assembly with something like
 
<pre>
 
#ifdef HAVE_BLX
 
... (inline asm) ...
 
#else
 
... (inline asm with equivalent blx code, as shown to the right) ...
 
#endif
 
</pre>
 
</TD>
 
<TD>
 
[[User:Cfriedt]] 20081028
 
Substitute with a macro reference such as
 
<pre>
 
#ifdef HAVE_BLX
 
#define BLX(a) \
 
blx a
 
#else
 
#define BLX(a) \
 
mov pc,lr \
 
bx a
 
#endif
 
</pre>
 
</TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">CLZ</TH>
 
<TD>Count Leading Zeros</TD>
 
<TD>175</TD>
 
<TD>
 
[[User:Cfriedt]] 20081028
 
Remove from inline assembly with something like
 
<pre>
 
#ifdef HAVE_CLZ
 
... (inline asm) ...
 
#else
 
... (inline asm with equivalent clz code, as shown to the right) ...
 
#endif
 
</pre>
 
</TD>
 
<TD>
 
[[User:Cfriedt]] 20081029
 
<pre>
 
#ifdef HAVE_CLZ
 
#define CLZ(Rd,Rm) \
 
clz Rd,Rm
 
#else
 
#define CLZ(Rd,Rm) \
 
...
 
#endif
 
...
 
CLZ(Rd,Rm)
 
</pre>
 
</TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">LDRD</TH>
 
<TD>Load Registers Doubleword</TD>
 
<TD>200</TD>
 
<TD>
 
[[User:Cfriedt]] 20081028
 
Substitute different inline assembly code with something like
 
<pre>
 
#ifdef HAVE_LDRD
 
... (inline asm) ...
 
#else
 
... (inline asm with ldrd substituted) ...
 
#endif
 
</pre>
 
</TD>
 
<TD>
 
[[User:Cfriedt]] 20081028
 
Substitute with a macro reference such as
 
<pre>
 
#ifdef HAVE_LDRD
 
#define LDRD(a,b) \
 
ldrd a,b
 
#else
 
#define LDRD(a,b) \
 
...
 
#endif
 
</pre>
 
</TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">PLD</TH>
 
<TD>Preload Data</TD>
 
<TD>240</TD>
 
<TD>
 
[[User:Cfriedt]] 20081028
 
Remove from inline assembly with something like
 
<pre>
 
#ifdef HAVE_PLD
 
... (inline asm) ...
 
#else
 
... (inline asm with pld removed) ...
 
#endif
 
</pre>
 
</TD>
 
<TD>
 
[[User:Cfriedt]] 20081028
 
Remove or substitute with a macro reference such as
 
<pre>
 
#ifdef HAVE_PLD
 
#define PLD(a,b) \
 
pld a,b
 
#else
 
#define PLD(a,b)
 
#endif
 
...
 
PLD(r0,#0)
 
</pre>
 
</TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">SMLA&lt;x&gt;&lt;y&gt;</TH>
 
<TD>Signed Multiply-Accumulate</TD>
 
<TD>291</TD>
 
<TD></TD>
 
<TD></TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">SMLAL&lt;x&gt;&lt;y&gt;</TH>
 
<TD>Signed Multiply Accumulate Long</TD>
 
<TD>298</TD>
 
<TD></TD>
 
<TD></TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">SMLAW&lt;y&gt;</TH>
 
<TD>Signed Multiply-Accumulate Word</TD>
 
<TD>302</TD>
 
<TD></TD>
 
<TD></TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">SMUL&lt;x&gt;&lt;y&gt;</TH>
 
<TD>Signed Multiply</TD>
 
<TD>316</TD>
 
<TD></TD>
 
<TD></TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">SMULW&lt;y&gt;</TH>
 
<TD>Signed Multiply Word</TD>
 
<TD>320</TD>
 
<TD></TD>
 
<TD></TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">QADD</TH>
 
<TD>Saturating Add</TD>
 
<TD>242</TD>
 
<TD></TD>
 
<TD></TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">QDADD</TH>
 
<TD>Saturating Double and Add</TD>
 
<TD>249</TD>
 
<TD></TD>
 
<TD></TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">QDSUB</TH>
 
<TD>Saturating Double and Subtract</TD>
 
<TD>251</TD>
 
<TD></TD>
 
<TD></TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">QSUB</TH>
 
<TD>Saturating Subtract</TD>
 
<TD>253</TD>
 
<TD></TD>
 
<TD></TD>
 
</TR>
 
<TR>
 
<TH VALIGN="TOP">STRD</TH>
 
<TD>Store Registers Doubleword</TD>
 
<TD>349</TD>
 
<TD>
 
[[User:Cfriedt]] 20081028
 
Substitute different inline assembly code with something like
 
<pre>
 
#ifdef HAVE_STRD
 
... (inline asm) ...
 
#else
 
... (inline asm without strd) ...
 
#endif
 
</pre>
 
</TD>
 
<TD>
 
[[User:Cfriedt]] 20081028
 
Substitute with a macro reference such as
 
<pre>
 
#ifdef HAVE_STRD
 
#define STRD(a,b) \
 
strd a,b
 
#else
 
#define STRD(a,b) \
 
...
 
#endif
 
</pre>
 
 
</TD>
 
</TR>
 
</TABLE>
 
}}
 
 
=== Scanning for Files That Use the ARMv5TE ISA ===
 
 
Using the above list of opcodes, one can scan the Android source code for ARMv4T-incompatible instruction sequences.
 
 
'''Code:'''
 
{{scroll box|height=240px|text=
 
<pre>
 
#!/bin/sh
 
 
# $1 is the android directory
 
 
if [ $# -ne 1 ]; then
 
exit -1
 
fi
 
 
cd "${1}"
 
 
opcodes="blx clz ldrd pld smlabb smlabt smlatt
 
smlal smlawb smlawt smulbb smulbt smultt smulwb
 
smulwt qadd qdadd qdsub qsub strd"
 
 
for op in ${opcodes}; do
 
 
echo "* ${op} ====================================="
 
 
if [ ! -e .files.${op} ]; then
 
 
files="$(grep -R -i "${op} " * 2>/dev/null)"
 
files="$(echo $files | grep -v "^Binary file" | sed -e 's/:.*//')"
 
files="$(echo $files| grep -v "CREDIT\|README\|^\(kernel/\|.git/\)\|\(\.txt\)$" | sort -u)"
 
 
echo "${files}" > .files.${op}
 
 
else
 
files="$(cat .files.${op})"
 
fi
 
 
for fil in ${files}; do
 
lines="$(grep -n -i "${op} " ${fil} | sed -e 's/:.*//g' )"
 
lines="$(echo $lines | sed -e 's/ /,/g')"
 
echo "** ${fil}: lines {${lines}}"
 
done
 
done
 
</pre>
 
}}
 
 
=== Source Files in Android that Use the ARMv5TE ISA ===
 
 
The list of files below may or may not be complete. There might also be some assembly code that is generated with a python script (verification?).
 
 
{{scroll box|height=150px|text=
 
* blx =====================================
 
** bionic/libc/tools/gensyscalls.py: lines {168,186}
 
** bootloader/legacy/nandwrite/init.S: lines {77}
 
** bootloader/legacy/usbloader/init.S: lines {95}
 
** dalvik/vm/arch/arm/CallEABI.S: lines {239}
 
** dalvik/vm/arch/arm/CallOldABI.S: lines {145}
 
** development/emulator/qtools/thumbdis.cpp: lines {187,265}
 
** external/qemu/target-arm/translate.c: lines {1151,1971,2444}
 
** external/qemu/trace.c: lines {774,1353,1358}
 
** system/core/libpixelflinger/codeflinger/disassem.c: lines {416}
 
* clz =====================================
 
** development/emulator/qtools/armdis.cpp: lines {654}
 
** external/opencore/codecs_v2/audio/aac/dec/src/pv_normalize.h: lines {67,84}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/norm_l.h: lines {137}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/normalize_amr_wb.h: lines {78,95}
 
** external/opencore/codecs_v2/audio/mp3/dec/src/pvmp3_normalize.h: lines {67,84}
 
** external/opencore/codecs_v2/video/avc_h264/dec/src/vlc.cpp: lines {23}
 
** external/opencore/codecs_v2/video/m4v_h263/enc/src/vlc_encode_inline.h: lines {125,162,168,204,218}
 
** external/qemu/target-arm/translate.c: lines {1247}
 
** external/skia/libcorecg/Sk64.cpp: lines {340,341,343}
 
** external/skia/libcorecg/SkMatrix.cpp: lines {500,501}
 
** external/skia/libsgl/effects/SkColorMatrixFilter.cpp: lines {135}
 
** external/skia/libsgl/sgl/SkBitmap.cpp: lines {945,946,947}
 
** external/skia/libsgl/sgl/SkBitmapShader.cpp: lines {32,33,34}
 
** external/skia/libsgl/sgl/SkGraphics.cpp: lines {429,437}
 
* ldrd =====================================
 
** dalvik/vm/mterp/armv5/OP_AGET_WIDE.S: lines {28}
 
** dalvik/vm/mterp/armv5/OP_IGET_WIDE.S: lines {37}
 
** dalvik/vm/mterp/armv5/OP_IGET_WIDE_QUICK.S: lines {10}
 
** dalvik/vm/mterp/armv5/OP_SGET_WIDE.S: lines {17}
 
** dalvik/vm/mterp/out/InterpAsm-armv5.S: lines {2653,7464,8318,8390}
 
** system/core/libpixelflinger/rotate90CW_4x4_16v6.S: lines {40,41,42,43}
 
* pld =====================================
 
** bionic/libc/arch-arm/bionic/memcmp.S: lines {37,44,45,56,57,107,108,195,196}
 
** bionic/libc/arch-arm/bionic/memcmp16.S: lines {37,44,45,67,68,116,117,198,199}
 
** bionic/libc/arch-arm/bionic/memcpy.S: lines {55,56,57,145,266,293,320}
 
** bionic/libc/arch-arm/bionic/strlen.c: lines {59,65}
 
** bionic/libc/kernel/arch-arm/asm/arch/irqs.h: lines {162}
 
** external/elfutils/src/Makefile: lines {243}
 
** external/elfutils/src/Makefile.am: lines {32}
 
** external/elfutils/src/Makefile.in: lines {243}
 
** external/jpeg/jidctfst.S: lines {69,235,247}
 
** external/qemu/target-arm/translate.c: lines {1149}
 
** system/core/libpixelflinger/codeflinger/ARMAssembler.cpp: lines {368}
 
** system/core/libpixelflinger/codeflinger/ARMAssemblerInterface.cpp: lines {104,108,117}
 
** system/core/libpixelflinger/t32cb16blend.S: lines {111,112,134,143}
 
* smlabb =====================================
 
** external/jpeg/jidctfst.S: lines {110,115,155,156}
 
** external/neven/Embedded/common/src/b_BasicEm/Math.c: lines {584,589}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {147,166}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {120,129}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {514,533}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {418,429}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {202}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {250}
 
** external/opencore/codecs_v2/video/m4v_h263/enc/src/dct_inline.h: lines {119,155,167,278,326,341}
 
** external/opencore/codecs_v2/video/m4v_h263/enc/src/fastquant_inline.h: lines {178,225,437,517}
 
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {405,436}
 
* smlabt =====================================
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {184}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {138}
 
** external/opencore/codecs_v2/video/m4v_h263/enc/src/dct_inline.h: lines {131,143,294,310}
 
* smlatt =====================================
 
** external/neven/Embedded/common/src/b_BasicEm/Math.c: lines {585,590}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {157}
 
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {441}
 
* smlal =====================================
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v4.h: lines {179,223,236,257,267}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v4_gcc.h: lines {264,341}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {178,188,198}
 
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_dct_9.s: lines {84,90,96,101,109,114,116,118,121,132,138,150,163,165,167,174,176,178}
 
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_dct_9_gcc.s: lines {73,79,86,90,98,103,105,107,110,121,127,139,152,154,156,163,165,167}
 
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18.asm: lines {143,162,178,188,192,199,207,217,225,231,237,241,244}
 
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18.s: lines {145,164,180,190,194,201,209,219,227,233,239,243,246}
 
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18_gcc.s: lines {143,162,178,188,192,199,207,217,225,231,237,241,244}
 
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window.asm: lines {62,63,66,72,76,77,81,82,85,90,94,97,99,100,103,108,113,114,118,119,122,129,136,137,176,179,183,187,190,193}
 
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window.s: lines {67,68,71,77,81,82,86,87,90,95,99,102,104,105,108,113,118,119,123,124,127,134,141,142,181,184,188,192,195,198}
 
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window_gcc.s: lines {65,66,69,75,79,80,84,85,88,93,97,100,102,103,106,111,116,117,121,122,125,132,139,140,179,182,186,190,193,196}
 
** external/opencore/codecs_v2/audio/mp3/dec/src/pv_mp3dec_fxd_op_arm.h: lines {148}
 
** external/qemu/trace.c: lines {813}
 
** frameworks/base/opengl/libagl/iterators.S: lines {66,67}
 
** frameworks/base/opengl/libagl/matrix.h: lines {67,68,96,126,127,282,283,314,315,316}
 
* smlawb =====================================
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {203,259}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {166,416}
 
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {93,109}
 
** frameworks/base/opengl/libagl/matrix.h: lines {163,203}
 
* smlawt =====================================
 
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {114}
 
** frameworks/base/opengl/libagl/matrix.h: lines {162,202,243,244}
 
* smulbb =====================================
 
** external/jpeg/jidctfst.S: lines {109,114,151,153}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {79}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {71,81}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {207,251,297,348,361,375,427,440,487}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {199,234,274,314,316,326,367,369,404}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mac.h: lines {121,137}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_msu.h: lines {123,142}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mult.h: lines {122,140}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32.h: lines {132,134,138,164,177,191}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32_16.h: lines {127,129,150,163}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mult.h: lines {121,141}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {115,139,151,163,189,190,212}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {112,113,164,183,201,218,265}
 
** external/opencore/codecs_v2/video/m4v_h263/enc/src/fastquant_inline.h: lines {250,457,531}
 
** external/skia/include/corecg/SkMath.h: lines {170}
 
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {420,462}
 
** system/core/libpixelflinger/t32cb16blend.S: lines {39,66,74,82}
 
* smulbt =====================================
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {115}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {109}
 
** system/core/libpixelflinger/codeflinger/texturing.cpp: lines {1091}
 
** system/core/libpixelflinger/t32cb16blend.S: lines {47,55}
 
* smultt =====================================
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {131}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {100}
 
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {467}
 
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {73}
 
* smulwb =====================================
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {221}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {373}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {222}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {283}
 
** external/opencore/codecs_v2/audio/sbc/enc/src/sbcenc_filter.h: lines {33}
 
** frameworks/base/opengl/libagl/matrix.h: lines {161,201,242}
 
* smulwt =====================================
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {202,240}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {385,415}
 
* qadd =====================================
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {64}
 
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {60}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {130,256}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {128,235}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_add.h: lines {122,137}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mult.h: lines {123,145}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {71,102,152,176,192}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {91,115,148,202,234}
 
** external/openssl/crypto/bn/bn_prime.c: lines {454,455}
 
* qdadd =====================================
 
** external/opencore/codecs_v2/audio/aac/dec/src/calc_sbr_synfilterbank.cpp: lines {116,162}
 
** external/opencore/codecs_v2/audio/aac/dec/src/trans4m_freq_2_time_fxp.cpp: lines {472,494}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {212,356,370,385,435,449}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {200,315,321,331,368,371}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mac.h: lines {122,142}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32.h: lines {133,136,140,172,186,201}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32_16.h: lines {128,131,158,172}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {116}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {184}
 
* qdsub =====================================
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {302}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {275}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_msu.h: lines {124,147}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {140}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {165}
 
* qsub =====================================
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {167}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {162}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_sub.h: lines {121,138}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {88,127}
 
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {70,133}
 
* strd =====================================
 
** dalvik/vm/mterp/armv5/OP_APUT_WIDE.S: lines {31}
 
** dalvik/vm/mterp/armv5/OP_IPUT_WIDE.S: lines {39}
 
** dalvik/vm/mterp/armv5/OP_IPUT_WIDE_QUICK.S: lines {14}
 
** dalvik/vm/mterp/armv5/OP_SPUT_WIDE.S: lines {21}
 
** dalvik/vm/mterp/out/InterpAsm-armv5.S: lines {2834,7530,8331,8542}
 
** dalvik/vm/oo/Object.h: lines {589}
 
** external/opencore/fileformats/avi/parser/include/pv_avifile_streamlist.h: lines {179}
 
** external/opencore/fileformats/avi/parser/src/pv_avifile_streamlist.cpp: lines {153}
 
** system/core/libpixelflinger/rotate90CW_4x4_16v6.S: lines {47,52,56,60}
 
}}
 
 
=== Discussion ===
 
The file ''system/core/libpixelflinger/codeflinger/ARMAssembler.cpp'' will need special attention. It's responsible for dynamic generation of DSP code.
 
 
[[User:Cfriedt]] 20081024 I'm not sure how feasible this is, given that the [http://wiki.openmoko.org/wiki/Neo_FreeRunner_Hardware_Issues#SMedia_3362_Documentation_.26_OpenGL_ES_Drivers SMedia 3362 is heavily NDA'd]. However, since the arm920t lacks a floating-point unit / DSP core, is it possible to use the SMedia chip for general-purpose math? This would help in the Android platform, at least, for things like audio and video codecs. Aside from an OpenGL ES driver, OpenMoko documentation for the SMedia would be highly appreciated.
 
 
= Important Links =
 
=== Documentation ===
 
* [http://source.android.com/documentation Android Documentation]
 
* [http://www.arm.com/documentation/ ARM Documentation], (keywords: armv4t, armv5t, armv5te, arm920t, arm926ej-s)
 
* [http://www.arm.com/miscPDFs/9658.pdf ARM Assembly Language Programming]
 
* [http://www.cse.unsw.edu.au/~cs3221/labs/assembler-intro.pdf An Introduction to the GNU Assembler]
 
* [http://www.heyrick.co.uk/assembler/apcsintro.html ARM Procedure Call Standard], [http://en.wikipedia.org/wiki/Calling_convention#ARM ARM Calling Conventions]
 
 
=== Instruction Set References ===
 
* [http://www.arm.com/miscPDFs/14128.pdf ARM Architecture Reference Manual], The definitive ISA documentation
 
* [http://www.simplemachines.it/doc/QRC0001H_rvct_v2.1_arm.pdf ARM Instruction Set Quick Reference Card]
 
* [http://infocenter.arm.com/help/topic/com.arm.doc.qrc0001l/QRC0001_UAL.pdf ARM and Thumb -2 Instruction Set Quick Reference Card]
 
* [http://infocenter.arm.com/help/topic/com.arm.doc.dvi0025b/DVI0025.pdf ARMv4T] (See section 1.4.13)
 
* [http://infocenter.arm.com/help/topic/com.arm.doc.dvi0014a/DVI0014A_ARM10T_PO.pdf ARMv5T] (See section 4.16)
 
* [http://www.arm.com/pdfs/ARM-DSP.pdf ARM DSP Enhanced Instruction Set]
 
* [http://infocenter.arm.com/help/topic/com.arm.doc.ihi0042c/IHI0042C_aapcs.pdf Procedure Call Standard for the ARM Architecture]
 
 
=== Hardware Reference ===
 
 
* [[Neo1973 Hardware]]
 
* [[Neo FreeRunner GTA02 Hardware]]
 
 
=== Communities ===
 
* [http://source.android.com/discuss Android Public Mailing Lists]
 
** Specifically, [http://groups.google.com/group/android-porting android-porting]
 
* [http://lists.openmoko.org/mailman/listinfo OpenMoko Mailing Lists]
 
** Specifically, [http://lists.openmoko.org/mailman/listinfo/openmoko-kernel openmoko-kernel]
 
* [http://forum.koolu.org/viewforum.php?f=10 Android on FreeRunner] at KoolU.com
 
* [[Openmoko Local Groups]]
 
* [[Openmoko:Community_Portal]]
 
  
 
= See also =
 
= See also =
Line 670: Line 33:
 
* [[Debug_Board]]
 
* [[Debug_Board]]
 
* [http://tw.youtube.com/watch?v=m4NbsLmF9j0 YouTube Video 1]
 
* [http://tw.youtube.com/watch?v=m4NbsLmF9j0 YouTube Video 1]
 
 
* [http://tw.youtube.com/watch?v=r6Op-7tNTiw YouTube Video 2]
 
* [http://tw.youtube.com/watch?v=r6Op-7tNTiw YouTube Video 2]
  
 
[[Category:Distributions]]
 
[[Category:Distributions]]

Revision as of 11:34, 24 January 2009

Android is one of the many distributions that currently work on the Openmoko phones. You can compare a distribution with an Operating System on normal computers. It gives the phone all the software needed for operating. For more information about the different flavors, see distributions.

Contents

Android.png

Introduction

This page is the central place for documentation about Android andNeo 1973 and FreeRunner handsets.

Development 

See: Android_porting

Usage

See: Android_usage

Installation

See: Android_on_Freerunner

News

  • 20090122 Koolu releases its Beta2 Android release.
  • 20081219 Koolu releases its Beta Android Image and kernel.
  • 20081104 The first Android-image has been successfully created by Sean McNeil! - sms and calling works, wifi and bluetooth doesn't. news-source


See also

Personal tools

Android is one of the many distributions that currently work on the Openmoko phones. You can compare a distribution with an Operating System on normal computers. It gives the phone all the software needed for operating. For more information about the different flavors, see distributions.

Contents

Android.png

Introduction

This page is the central place for documentation about Android andNeo 1973 and FreeRunner handsets.

Development 

See: Android_porting

Usage

See: Android_usage

Installation

See: Android_on_Freerunner

News

  • 20090122 Koolu releases its Beta2 Android release.
  • 20081219 Koolu releases its Beta Android Image and kernel.
  • 20081104 The first Android-image has been successfully created by Sean McNeil! - sms and calling works, wifi and bluetooth doesn't. news-source


See also