0xdroid beagle-cupcake-0x1 release note

[Tick Chen]

Hi List,

 0xlab 在 beagleboard 上做了許多 Android 的 hacking.
這是我們第一次的 code drop, 我們也將會在這上頭持讀開發。
0xdroid 這個案子是放在 http://gitorious.org/0xdroid.
如果你想加入討論及開發，我們的 mailing list 是
0xlab-...@googlegroups.com
和 0xlab...@googlegroups.com.

Happy hacking,

Tick

The following is the release note:
Release Note: beagle-cupcake-0x1
0xlab is very glad to release our works about running Android on
Beagle board and this release is based on the cupcake branch.
We were busy on making improvements recently. This release note covers
our version naming rule, the differences from the
original cupcake, a brief introduction regarding how to setup the
development environment and how to work with us.

Version: beagle-cupcake-0x1

Branch naming rule:
   * [HW-board/arch]-[Android-branch]

Release naming rule:
   * [branch]-0x[release_number]

Date: Aug, 7, 2009

Release Image:
Version number comes from the SHA1 hash code of all projects' HEAD.
Therefore this number can be viewed as a unique ID of this image.
There is a version.txt in the root directory. It contains the unique
hash code and they are the HEAD commit from each project.

   * File: http://downloads.0xlab.org/release/beagle-cupcake-0x1/android-beagle.ubi
   * Version: f76980be1219a38f445cb047cd488b71c037062a
   * Image SHA1: 564ca54d35ed0bc999d704e046a2cb626eb18dde
   * Related kernel Image:
http://downloads.0xlab.org/release/beagle-cupcake-0x1/0xkernel-beagle.bin
         o kernel image SHA1: d4e9f1fb6f3facffaf1fe9fb9e1f8d5812222386

What's new:
 What we changed from original cupcake:
   * Product for beagleboard
   * Revised initialization sequence for Beagleboard related settings
   * Replace yaffs2 with new and fast flash file system -- ubifs
   * Add software cursor and new keyboard layouts
   * ARMv7 tuned GNU toolchain based on gcc 4.4.1 (ARM NEON and Thumb2)
   * Tweaked memory operation routines for Cortex A8 to gain better performance
   * Enable ALSA for sound.
   * Provide GPIO keyboard
   * Fix the framebuffer flipping issue
   * Disable battery check for beagleboard
   * Disable unusable camera/video force rotation
   * Dalvik backports from donut
   * Several bug fixes.
Currently we have 16 projects into our own repository and we made 69
patches in this release. The full change log is as the attached file.
We release the source code on http://gitorious.org/0xdroid and we will
keep working there.

How to build:
 $ mkdir beagle-cupcake
 $ cd beagle-cupcake
 $ # initialize the workspace
 $ repo init -u git://gitorious.org/0xdroid/manifest.git -b beagle-cupcake
 $ # make buildspec.mk set target product
 $ echo "TARGET_PRODUCT := beagleboard" > buildspec.mk
 $ # If you want to put prebuild demo apks you can add:
 $ echo "INSTALL_PREBUILT_DEMO_APKS := true" >> buildspec.mk
 $ # pull the whole workspace
 $ # because of the host server may be too slow or encounter some
other network issues keep repo sync if failed.
 $ # This step will take a long time (depends on your network)
 $ cd .repo/manifests/
 $ git checkout -b release/beagle-cupcake-0x1 beagle-cupcake-0x1
 $ repo sync
 $ # Then choose the tag of beagle-cupcake-0x1
 $ repo forall -c "git checkout -b beagle-cupcake-0x1"
 $ # after pull all stuff, just make, and wait for a long time.
(depends on you CPU power and memory size.)
 $ cd ../../
 $ make  # if you have 4 cpus you can use "make -j4"

After build success you can do:
 $ cd out/target/product/beagleboard
 $ wget http://downloads.0xlab.org/release/beagle-cupcake-0x1/ubi_scripts.tgz
 $ tar xvf (where you put ubi scripts)/ubi_scripts.tgz
 $ mv ubi_scripts/* .
 $ ./generateubifs.sh

If you encounter problem on mkfs.ubifs, you may need to
 $ sudo apt-get install liblzo2-dev uuid-dev

Note: compile your own mkfs.ubifs and ubinize is recommended.
git://git.infradead.org/mtd-utils.git

0xlab will keep maintaining on beagle-cupcake branch. If you are
interested in following the latest development,
you can just follow the branch but not the release tag.

Bug report:
When you find any bug from this image. You can send a ticket to
http://code.google.com/p/0xdroid/issues/list.
Please point out the version number from /version.txt and the image built date.
This information could help developers know how to reproduce it or
determine if it is a known/solved issue.


Installation
for dummies:
 - Format the first partition over than 100MB with VFAT on a SD card.
 - download the installer
http://downloads.0xlab.org/installer/beagle-cupcake-0x1/uImage.bin
into SD card
 - download the
http://downloads.0xlab.org/release/beagle-cupcake-0x1/0xkernel-beagle.bin
 - download the
http://downloads.0xlab.org/release/beagle-cupcake-0x1/android-beagle.ubi
 - save 0xkernel-beagle.bin and android-beagle.ubi into SD card first partition
 - plug the SD card in beagleboard SD slot and restart the beagleboard
 - wait for UI installer over
 - unplug the beagleboard and restart it
 - enjoy it

for geeks:
 - you can check the http://gitorious.org/0xdroid/pages/Nandboot as a reference.

[Eric Huang]

beagleoard is a nice board. good job to see Android running on top of that! /eric

2009/8/11 Tick Chen <ti...@0xlab.org>

--
funder of Jmap.
facebook: http://www.facebook.com/erichuang2009
twitter: http://www.twitter.com/erichuang623
web: http://www.frienzplay.com

[gasolin]

恭喜恭喜！