Android/zh tw
From Openmoko
(→List of Unsupported Instructions) |
(→Scanning for Files That Use the ARMv5TE ISA) |
||
Line 430: | Line 430: | ||
}} | }} | ||
− | === | + | === 掃瞄使用ARMv5TE ISA的檔案 === |
+ | |||
+ | 使用下列的opcodes,可以掃瞄到與ARMv4T與不相容的 Android source code指令順序。 | ||
− | |||
'''Code:''' | '''Code:''' |
Revision as of 11:27, 11 December 2008
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 |
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?).
|
Discussion
Notes
The file
system/core/libpixelflinger/codeflinger/ARMAssembler.cpp
will need special attention. It's responsible for dynamic generation of DSP code.
Suggestions
- User:Cfriedt 20081024 I'm not sure how feasible this is, given that the 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
(Please Update Me)
Documentation
- 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
Instruction Set References
- ARM Architecture Reference Manual, The definitive ISA documentation
- ARM Instruction Set Quick Reference Card
- ARM and Thumb -2 Instruction Set Quick Reference Card
- ARMv4T (See section 1.4.13)
- ARMv5T (See section 4.16)
- ARM DSP Enhanced Instruction Set
- Procedure Call Standard for the ARM Architecture
Hardware Reference
Communities
- 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