Android/zh cn
From Openmoko
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à |
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 |
Updates
- 20081202 Koolu.com 在Koolu GIT Koolu GIT (Press Release已释出给FreeRunner使用的 Android 源码。
- 20081120 Koolu.com 推动销售搭载 Android的Openmoko Freerunner 。如提供现有的FreeRunner 下载可搭载的Android。直到 December 2008。
- 20081104 第一个可以在FreeRunner上执行的 Android-image已经成功的被 Sean McNeil编译出来! - sms 及通话可以使用,wifi 及蓝芽则否。news-source
- 20081029 User:Cfriedt Benno 修改了Android's build system,因此可以放置JFFS2 image,而不是YAFFS。 不像是JFFS2,只可以mount 到只读的情况下,要挂载 YAFFS映像档在它被写入 flash 后才有可能使用。(it complains about the block device being of type '1' and not 'NAND'). JFFS2 仍然有标准的 Openmoko image 格式的优点 (请参考 烧制映像档到FreeRunner 或 烧制映像档到Neo 1973)。
- 20081023 User:Bricode 追踪包含ARMv5规格的 Android source tree状态,我建立了一个表格表示它会包含什么内容,及patche档的状态。它可以在 http://spreadsheets.google.com/pub?key=pzDEXnU19gkeTjpD28t-7fw 这个网址找到。
- 20081022 User:Cfriedt 可以在移除了v5TE指令下 ,没有错误的'trivially' 为ARMv4T编译 Android source code。虽然它不预期它可以被执行,至少我针对 build/core/combo/arm-linux.mk做了一些小小的取代。关于此点,我可以继续像执行v4T指令顺序般的,重新执行 v5TE 指令。(或者,重新执行整个 hand-optimized v4T 指令组合)。
- 20081021 User:Cfriedt Android -> FreeRunner ,在我的部落格上有讨论。
- 20081021 Google 释出Apache free 及 open-source手机下,大部份的source code 、 license, 部份被涵盖在现有的授权(licenses)下,如 Linux kernel 是属于 GPLv2授权。
- 200810?? Koolu.com 宣布他们将会 销售搭载Android的Openmoko Freerunner ,这个计划会在2008年11月开始,并且提供现有的FreeRunner用户 免费下载可搭载在Freerunner上的Android 。 知名的 open-source 爱好者Jon "maddog" Hall 是Koolu的CTO及代表。
简介
本网页撰写的目地在于将Android OS 移植到 Neo 1973 及 Neo FreeRunner 手机上。Android OS 于2008年10月21日公开的发布 。 下列的信息,可以提供您暸解在 Neo 1973及 FreeRunner 移植工作 目前的运作情形 及现状。
目标
- 有系统化的在Android codebase下使用提供给 ARMv4T 的patch檔。
- 提供在Android codebase在下Neo1973 与 Neo FreeRunner hardware-dependent patches 文件, 这项任务已经被 Openmoko 工程师完成,在不强迫变更 Android-specific upstream下。
- 在Distributions网页中,提供有用的Android 档案系统及kernel。
使用现有的二进制文件安装
详尽的在FreeRunner上安装Android (使用 Sean McNeil的kernel及rootfs 套件,及 Qi bootloader) ,何以在http://www.copiesofcopies.org/webl/?p=34此网址找到。
早期目标
就如同 Ben Leslie 在 blog 中所提到的,在 source code释出之前,Android 被设计为使用ARMv5TE 架构instruction set architecture (ISA),允许 DSP 扩充的指令。 相较于 ARMv5TE ISA, the Neo1973 及 FreeRunner 电话听筒都着重在arm920t core,并可以应用到 ARMv4T ISA。
在源码开放之前,kernel trap handlers 被用来 '模拟' ARMv5TE ISA。虽然这个结果在不同的案例下运作,trapping 是较花成本及效能的一种结果。甚至于,在没有明确的暸解哪个状况是被不同的指令所设定的情兄下,如Thumb Mode execution,这个结果成为没有定论。
目前的状态
随着 Android释出 source code,Open Source社群不再受限于使用binary-only 产品。The Open Handset Alliance (OHA)已经让他们的source code 成为能让大家致富及受益的产品。
目前,porting 以不同的循环模式运做。Patches需要透过 official Android channels提交。
Koolu,Freerunner 的经销商, 在http://git.koolu.com释出了他们搭载FreeRunner的源码。参考 #Building the Koolu Android Source下的说明可以暸解到如何制作供给Freerunner使用的Android image。
为了要追踪Android source tree的哪个部份包含了特定的 ARMv5 程序,我制作了包含patches状态的表格。这个表格可以在 http://spreadsheets.google.com/pub?key=pzDEXnU19gkeTjpD28t-7fw 找到。User:Bricode
Sean McNeil 指出他可以在FreeRunner上执行包含通话功能的 Android。
Ben Leslie 也在android-porting list上指出他可以在Neo 1973 show出他的Android logo。
建立Koolu Android Source
- 参考Setting up your machine 中的Google build 说明,进行设定。
- 安装 repo 并下载源码,你可以在 http://trac.koolu.org/找到它的文件。
- 在完成build后,你可以藉由的讯息编辑及执行McNeil的 scripts,将root file system 放在一起。第一个 script (cp_android_OS) 用来复制最新的built files到 staging area。 第二个(mkjffs2) 则从staging area会制作一个jffs2 image。请确定在二个档案中编辑你的路径。或者,你可以使用以下的script
- 上面执行的结果是androidfs.jffs2的档案,它可以被烧进你的Freerunner。
制作jffs2 image
你可以使用以下的script:
#!/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
目前并没有与建置 Freerunner/Android kernel相关的说明文件。Sean McNeil 目前已经在 http://people.openmoko.org/sean_mcneil/ 这个位置释出Kernel。大部份的patche 需要与andy-tracking kernel branch 配合执行,而此Kernel终将成为最稳定的kernel版本。 一旦所有的 patche都放到 kernel后,即可在stock kernel上执行 Android 。
与 Windows 连结性
让 Windows 能组织 Android "网络零件(Ethernet Gadget)" ,并且使用Android USB Windows driver (http://dl.google.com/android/android_usb_windows.zip) 充电,在你安装驱动程序前,你可以透过修改套件中的android_usb.inf 档案,来完成这项工作。你必须做出下面的修改动作:
将下面[Google.NTx86] 的内容加到android_usb.inf 档案中:
; 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
并且在android_usb.inf档案的 [Strings] 区块下加入以下的内容:
USB\VID_1457&PID_5117.DeviceDescRelease="Neo FreeRunner" USB\VID_1457&PID_5117&MI_01.DeviceDescRelease="Neo FreeRunner Composite ADB Interface"
adb的Windows版本并不会出现,并且连接到装置上,但至少FreeRunner会开始充电,装置驱动程序会出现"This device is working properly(此装置的功能运作正常)"的讯息。
取得帮助
Getting Started
你可以藉由下面的操作指引下载及建立Android source,请参考 http://source.android.com/download并且依照你的架构参考操作指引。
发布你的作品
最好的方法是透过 wiki systems、公开的 mailing list、讨论群组及公开的系统来发表你的作品。
对于你的工作,永远加入自己的credit,但请不要使用批注的方式,因为有些程序在没有批注的情况下已经不易阅读困难,这个方式将增加困难度。最好的情况是,建立patch,并且在表头放入你的个人连络信息。但协同运作的系统,如git可能已经帮你完成这个工作了。
若你建立了新的东西,并且能够指定它的授权,请考虑授权兼容性上的问题。
Porting 策略
- 分析它对现有的build system的影响力
- buid/core/combo/arm-linux.mk
- -D__ARCH_ARM_4__ -D__ARCH_ARM_4T__
- -march=armv4t -mcpu=arm920t
- 修补不同的静态参考数据到 'armv5'
- buid/core/combo/arm-linux.mk
- 隔离 ARMv5TE ISA 相依的程序代码
- e.g. grep -n -R -i "${armv5te_isa_pattern}" ~/android
- 摘要
- ( C/C++ )
- 使用 inlined functions / #ifdef 状态式来完成移植性的功能
- 针对 inlined assembler calls,目前使用一般的 C 程序也是可以被接受的,之后,我们再用手动的方式来进行最佳化的工作。
- ( ASM )
- 处理器的状态是根据 ISA / architecture,如 #ifdef __ARCH_ARM_5__ ... #endif #ifdef __ARCH_ARM_4__ ... #endif
- 强烈的建议处理器状态应该不要套迭在一起(如让他们彼此独占)
- 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 .
- ( C/C++ )
针对ARMv5TE 指令(instruction),可能潜藏着:
- 使用一般的registers(登录子),而不是使用 DSP 呼叫 (如 eabi / softfloat)
- 若它是 a) 无法判别的 或者 b) 速度缓慢,则这个区段的程序则必须要分析,针对ARMv4T isa,必须使用hand-optimized 的方法
不支持的指令
以下是opcodes列表,它是自Android Source解压缩出来的,它不支持ARMv4T 兼容的处理器 (尤其是 arm920t)。 opcodes 代表ARMv5、ARMv5T及ARMv5TE 架构下可以使用的指令。它无法在 ARMv4T ISA下执行。这个列表耗费了许多时间编辑,直到编译无误的状态下,才会列出。
请牢记一件事,在一些状况下,将这些指令顺序的传送到ARMv4T 指令下是不可能的,或者是会出现无预期的结果:
- 必须要有额外的context。
- opcodes变更登录子的状态,可能无法表现在 arm920t 核心上
Opcodes
|
扫瞄使用ARMv5TE ISA的档案
使用下列的opcodes,可以扫瞄到与ARMv4T与不兼容的 Android source code指令顺序。
Code:
#!/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 |
在Android下使用 ARMv5TE ISA 的源文件
以下的档案可能是完整的,也可能是不完整的。也可能有些程序内容是透过 python script产生的.
|
讨论
附注
档案
system/core/libpixelflinger/codeflinger/ARMAssembler.cpp
必须要特别的注意。它负责动态产生DSP程序。
建议
- User:Cfriedt 20081024 我不确定它的可行性多高,因为SMedia 3362 被NDA保护。 然而,arm920t 缺乏浮点单元 / DSP core,它可能使用 SMedia chip 产生特定目地的方法?这对Android 平台来讲很有用,至少像是audio及 video codecs。 撇开OpenGL ES 驱动程序,欢迎提供针对SMedia 的 Openmoko文件。
重要连结
(欢迎大家在这里加入重要连结)
文件
- Android Documentation
- ARM Documentation, (keywords: armv4t, armv5t, armv5te, arm920t, arm926ej-s)
- ARM Assembly Language Programming
- An Introduction to the GNU Assembler
- ARM Procedure Call Standard, ARM Calling Conventions
指令设定参考
- ARM Architecture Reference Manual,最后的ISA文件
- 设定Quick Reference Card的ARM 指令
- 设定Quick Reference Card 的ARM及Thumb -2 指令
- ARMv4T (请参考1.4.13小节)
- ARMv5T (请参考 4.16小节)
- ARM DSP 延伸指令集
- ARM架构下的Procedure Call Standard
硬件参考
社群讨论
- Android Public Mailing Lists
- Specifically, android-porting
- OpenMoko Mailing Lists
- Specifically, openmoko-kernel
- Android on FreeRunner at KoolU.com
- Openmoko Local Groups
- Openmoko:Community_Portal