Now, that there are much fancier phones out there, like the Nexus One and Motorola Milestone, there must be a reason for people to buy them. The consequence about that is that they are holding back any updates to Android 2.0 or 2.1 for older phones. At least that’s my impression.

I also ever wanted to build and run my own Android since it is open source. At least that’s what Google says.
My first steps were quite disappointing since there was no device specific package for my G2 in the source tree. There was only one for the HTC Dream (G1).

Yesterday I wanted to give it another try and it was a success. I will post my steps here which are especially for the HTC Magic (or G2, HTC Sapphire, MyTouch 3G, Google IO – they are all the same) but it should be possible to do this with other phones as long as you have all the device specific blobs like the GSM Baseband layer or low level hardware drivers for your specific device.
Also keep in mind that this won’t be a normal guide like “How can I root this phone?” I assume that you more or less know what you are doing. So don’t blame me when you brick your phone: Shit happens and I’m not going to fix it.

Also, be careful what phone you have. There are 2 versions of the HTC Magic. One is the PVT32A and the other is PVT32B.
The A version has more RAM compared to B. The phone sold by HTC on their own is the A version. Almost all others are B versions. My phone is a B variant.
Check this site for any further information.

The SPL

The SPL is the Secondary Program Loader. The Initial Program Loader, which runs before the SPL is responsible for the basic bootstrapping of the processor inside the phone. Most of the time it is located on some on-die ROM and loads the SPL from flash.

The SPL itself is responsible for all kinds of boot services like booting from flash or receiving and handling data from the USB port with the fastboot protocol, which can be used for several maintenance tasks.

Usually, if you buy an OEM phone, you will get a shipment bootloader. Development phones will have an engineering bootloader.
The difference between those two is that with the shipment bootloader, you will not be able to write the flash directly from your computer over the fastboot protocol, which you definitely want if you compile/develop your own Android. So the first step is to install an engineering loader.
You can get several SPLs here. I installed the Crios  loader.
Just put the zip file on your SD-Card, boot a modified recovery image via fastboot and apply the zip file from your SD:

fastboot boot cm-recovery-1.4.img

The fastboot utility is available here or from your compiled Android in the out/host/<platform>/bin/ subdirectory.
To get your phone into fastboot mode, turn it off and hold the “back”-key while turning it on.

After flashing the new SPL you will have the engineering bootloader with security turned off.

Getting the Android sourcecode

If you want to build your own Android you obviously need to get the sourcecode. I did all the work on a Gentoo Linux. I don’t know how to do it under Windows or Mac OS.

First I thought to take the CyanogenMod repositories but they won’t check out completely because there seems to be missing at least one repository on github.

To get the official Google tree, just follow this guide.

Essentially you just install the required packages, get the repo client, do the repo init, repo sync and you should be done.

Get the binary blobs

For the Sapphire board package, you will need to get some binary blobs for the camera, WLAN, baseband and several other things.

You can download them on the HTC page for the Google IO. Just download the recovery image for Android 1.6 and put it into the root of your Android source tree.
After that you need to change the directory to vendor/htc/sapphire-open and execute the unzip-files.sh which extracts the blobs from the downloaded zipfile and puts them into the appropriate places.

Building it

After you prepared your environment, get back to the root of the source tree and do a

source build/envsetup.sh
lunch

to setup several environment variables and select the build target, which will be aosp_sapphire_eu-userdebug in our case.

After that you can just execute a

make -j3

to start the build. You can adjust the number behind the -j parameter to your machine. If you have n cores, the number you normally use is n+1. This is not essential for a successful build, but if you have 2 or more cores, you should use them for the build.
Now it’s time to ge some beautiful delicious black coffee or a cold bootle of Club-Mate, go for a walk or take a nap. This will take quite some time.

Common errors during the build

I ran into several erros while buildng. All of them were specific to my environment.

• no rule to make target `run-java-tool’ during build
  Solution: Just execute a export PATH=$(java-config -O)/bin:$PATH and the error you should be gone
• Java 1.6 is installed.
  Solution: Do an ACCEPT_LICENSE=”*” emerge =sun-jdk-1.5.0.22 and select the 1.5 JDK with eselect.
• Building the emulator fails with something like prebuilt/linux-x86/sdl/include/SDL/SDL_syswm.h:55:22: error: X11/Xlib.h: No such file or directory
  Solution: Do an emerge libX11

Installing the built images on your phone

After the build finished successful you will have everything in the out subdirectory.

Thanks to the engineering SPL, you can now install the built images using fastboot:

export ANDROID_PRODUCT_OUT="/path/to/android/root/out/target/product/sapphire-open"
fastboot flashall

Be sure your phone is in fastboot mode.

After you flashed the images you should boot the recovery image, mentioned in the SPL section, again and wipe the userdata partition.
This will cause a data loss. Anyway, you should have done a backup with nandroid in the modified recory image before messing around with your phone’s firmware

The result

Next steps

As you can see from the images above, all of the Google applications are missing. The next step would be to take them from an official Google image and put them on your phone. I think cyanogen already wrote a script for doing this for his builds. I haven’t checked this out yet.

Anyway, we have our very own Android 2.1 running.
If you want to use it on a daily basis you should consider building a stable branch and using this instead of the master branch.

If you’ve got any questions or problems, just leave them in the comments and we will try to figure them out.

Update: The cyanogenmod repositories do check out. I just used the wrong manifest repository.
If you want to give it a try, just do a

repo init -u git://github.com/cyanogen/android.git -b eclair
repo sync

instead of using the Google repository. Have a look here for more information.

General useful information, like adding your own target, creating keys for signing etc. can be found here.

Feel free to Flattr this post at flattr.com, if you like it.

Seit seiner Einmottung verstaubte dieses schöne Stück Computergeschichte auf unserem Dachboden und ich habe dieses Gerät nie vorher angefasst… Bis letztes Wochenende.

Ich hole das Teil also vom Speicher, schließe den UHF-Konverter an den Antennenausgang meines Fernsehers und schalte ihn ein. Man hört ein “MIEP” und das Floppy rattert kurz.
Nachdem ich dann versuchte ein lesbares Bild auf meinem Fernseher zu bekommen und es nach 15 Minuten immernoch Schatten warf und krisselig war, sodass man es kaum lesen konnte, gab ich auf und fand mich damit ab. Bunt kam da auch nichts raus Also kein “hochauflösender Grafikmodus”.

Im Laufe des Abends/der Nacht blätterte ich also durch ein, ebenfalls vom Speicher gekramtes, Buch, in dem die Nutzung dieser schönen Maschine beschrieben war und irgendwann hab ich dann auch mal ein kleines Basic Programm auf eine, sogar noch leere, Diskette gespeichert.

Am nächsten Tag habe ich mir dann auch mal ein Chinch-Kabel und einen Scart-Adapter gesucht, um endlich mal ein vernünftiges Bild (hoffentlich auch mit Farbe) zu bekommen. Hinten am Apple fällt nämlich sowieso Composite raus, das man direkt in einen heutigen Fernseher schieben kann. Die UHF-Konverter waren vor 20 Jahren nur nötig, weil kein Fernseher Composite Signale verarbeiten konnte. Das konnten damals halt nur Monitore – und die waren teuer.
Also Flux angeklemmt und man bekam ein extrem cooles und um Welten besseres 40×25 Zeichen großes Bild zu Gesicht. Die Color-Demos auf der Apple DOS 3.3 Master Disk blieben allerdings schwarz/weiß:

Weil ich weitere Informationen über den Computer gesucht habe, bin ich auch über die Software ADTPro gestolpert. Mit ihr ist es Möglich Diskettenimages, die man auch im Netz findet, per Audio-Interface des Apples, an den man normalerweile einen Kasettenrekorder anschließt, zu übertragen und auch auf eine reale Diskette zu schreiben. Getestet habe ich das mangels Klinkenkabel noch nicht. Die Videos sehen aber sehr vielversprechend aus.

Genauso fand ich das FAQ der Usenetgruppe comp.sys.apple2, um überhaupt erstmal rauszufinden, was das denn nun genau für ein Apple 2 war, da es einige verschiedene gab: Apple II, Apple II+, Apple IIe(uro), Apple IIe(uro)+ etc.
Was hier vor mir stand war also dann ein Nachbau eines Apple IIe oder IIe+, mit Apple II+-Tastatur und Apple IIe+ Roms.
Wieso? Der Apple hat seit II+ hat einen sogenannten Autostart-Monitor, der einen nach dem Einschalten nicht direkt auf den Monitor-Prompt wirft, sondern, falls eine Floppy- oder SCSI-Karte installiert ist wird versucht ein DOS zu laden.
Zusätzlich muss man, damit der “Reset”-Knopf auf der Tastatur seine Wirkung zeigt gleichzeitig Control drücken. Der Apple II (ohne +) hatte das noch nicht.
Laut Originalrechnung ist das aber kein richtiger Apple IIe+ von Apple, sondern ein MEWA II, den ich im Netz nur auf einer Webseite mit der Bezeichnung MEWA-48 gefunden habe.

Später habe ich dann das Buch “Understanding the Apple 2″ gefunden. Sehr interessant. Der komplette Computer ist erklärt. Jedes einzelne Teil vom Taktgenerator bis hin zur Adressdekodierung am Bus. Das schöne ist, dass man bei diesen alten Computern wirklich noch alles nachvollziehen kann. Keine hochwissenschaftlichen, mit Marketing-Buzzwords gespickten und bis unter die Zähne patentierte Bussysteme oder generische Chips, über die es keine Information gibt.

Das Problem an diesem Gerät ist nur, dass es wahrscheinlich ein IIe+ ist. Steve Wozniak hat damals, um das Composite Signal PAL-Kompatibel zu bekommen einiges am Videogenerator ändern müssen. Leider fiel diesen Änderungen auch der Farbmodus zum Opfer. Es gibt PAL-Karten, die man einstecken kann, um Farbe als PAL-Signal zu bekommen, nach denen ich aber bisher nicht gesucht habe.
Ich bin mir da nicht sicher, weil ich nicht wirklich weiß, was da jetzt für ein Signal rauskommt. NTSC kann dieser kleine Billigfernseher aber höchstwahrscheinlich nicht anzeigen. Ich geh also mal von einem IIe+ aus, der PAL rauswirft.

Was ich mir noch für Extension Karten besorgen möchte sind die PAL-Karte und eine Serial-Karte für eine serielle Schnittstelle. PAL-Karte für ein buntes Bild und Serial kann man immer brauchen, wenn man mit der “mordernen Welt” einigermaßen kommunizieren möchte.

Auf jeden Fall macht das Teil Spaß!

Update: Es ist doch kein IIe. Wie ich grade im Buch “Understanding the Apple IIe” gelesen habe, besitzt der einen “Auxiliary Slot”. Den hat mein Apple definitiv nicht. Das heißt entweder spuckt der wirklich NTSC aus oder es ist ein II+ mit angepasstem Videosignalgenerator. Die Möglichkeit besteht, weil das ja swieso ein Klon ist, den man ja dann entsprechend anpassen könnte.

Feel free to Flattr this post at flattr.com, if you like it.

Die alte Rails Webseite ist nie wirklich fertig geworden. Mit Rails selber konnte ich mich auch nie so wirklich anfreunden. Und die Lust zum Webdevelopment fehlte auch gänzlich.

Also schnell ein WordPress Template umgehackt und hier ist es. Sieht doch ganz gut aus.
Jetzt fehlt wie immer der Content.

Feel free to Flattr this post at flattr.com, if you like it.