Collaborative development of openiBoot for the iDroid Project
C C++ Other
Switch branches/tags
Nothing to show
Pull request Compare This branch is 4 commits ahead, 2 commits behind iDroid-Project:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
acm
arch-arm
docs
doxygen
ftl-yaftl
hfs
images
includes
installer
menu
mk8900image
nor-cfi
nor-spi
pcf
plat-a4
plat-s5l8720
plat-s5l8900
plat-s5l8920
radio-pmb8876
radio-pmb8878
radio-xgold618
scons
usb-synopsys
vfl-vfl
vfl-vsvfl
.gitignore
.gitmodules
Doxyfile
LICENSE.txt
Makefile
README.md
SConstruct
actions.c
aes_wrap.c
audiohw-null.c
audiohw.c
bdev.c
commands.c
device.c
framebuffer.c
ftl.c
images.c
init.c
malloc.c
mtd.c
nand.c
nvram.c
openiboot.S.h
openiboot.c
printf.c
scripting.c
sentinel.c
sha1.c
stb_image.c
syscfg.c
tasks.c
util.c
vfl.c

README.md

iDroid Project openiBoot

Copyright (C) 2008 David Wang (planetbeing).

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

NOTE: Version 0.3 and above will not boot iDroid 2.6.32 series kernels without additional parameters being passed to the kernel.

Warnung

IT IS STRONGLY ADVISED THAT YOU DO NOT ATTEMPT TO RUN NAND WRITE FUNCTIONS IN THE A4 VERSION AT THIS POINT IN TIME.

DOING SO WILL INEVITABLY CAUSE YOU TO NEED TO RESTORE YOUR DEVICE, MAY LEAVE PERMANENT NAND BLOCK DAMAGE AND MAY ALSO CAUSE GREMLINS TO CRAWL OUT OF YOUR ARSE.

(If you read this warning properly, really unless you know wtf you are looking at - leave it alone until we stablise it)

Compiling

To run openiboot from recovery mode (a.k.a iboot), you’ll need to create an img3 image. To run openiboot from DFU mode, you'll need to create a bin.

You will need a system capable of running x86 Linux binaries (Build requires scons, libssl, libpng, libcurl, libusb, libreadline and pthread).

Change into the openiboot subfolder

For iPod Touch 1G, run: scons iPodTouch1G

For iPhone 2G, run: scons iPhone2G

For iPhone 3G, run: scons iPhone3G

For iPod Touch 2G, run: scons iPodTouch2G

For iPhone 3GS, run: scons iPhone3GS

For iPhone 4, run: scons iPhone4

For iPod Touch 4G, run: scons iPodTouch4G

For iPad 1G, run: scons iPad1G

For Apple TV 2G, run: scons aTV2G

Alternatively a Makefile has been provided in the openiboot subfolder should you prefer to use it this way - this is not covered by this README but is provided for your convenience should you wish to use it

Menu Configuration

As of version 0.3 OpeniBoot now has a grub-style configurable menu system, OpeniBoot looks for /boot/menu.lst at boot. Below is an example menu.lst - put it in /boot (This section will be expanded upon at a later date, when newer device ports are further ahead)

title iOS
auto

title Android
kernel "(hd0,1)/idroid/zImage" "console=tty root=/dev/ram0 init=/init rw"
initrd "(hd0,1)/idroid/android.img.gz"

title iX
kernel "(hd0,1)/iX/zImage" "console=tty root=/dev/ram0 init=/init rw"
initrd "(hd0,1)/iX/initrd.img.gz"

Reporting issues/requesting features

Please leave bug reports/pull requests in the Github tracker.

For anything else, we can be found lurking in #idroid-dev on irc.freenode.net