Installing OpeniBoot

From iDroid Project

Jump to: navigation, search

Contents

Purpose

This guide is aimed to help you get OpeniBoot 0.2 running on your iPhone 2G, 3G or iPod Touch 1G. For an automated installation, use Bootlace.

This is for users who do not want to install Bootlace or for other distributions like iX or PS Freedom.

OpeniBoot can be installed using Linux, OS X or on Windows.

Requirements

Device and iOS Software

Currently OpeniBoot are compatible with the following devices:

  • iPhone 2G
  • iPhone 3G
  • iPod Touch 1G (1st Generation)

OpeniBoot is compatible with iOS (also known as iPhone OS) up to to 4.1. iOS 4.2.1 is not yet compatible.

Jailbreak

OpeniBoot requires a compatible jailbreak; one that allows for unsigned NOR images to be run. Currently these include redsn0w, PwnageTool or Blackra1n.

OpeniBoot will NOT work with the Spirit or Jailbreakme.com jailbreaks.

Preparing your computer's OS

Linux Preparation

These steps are designed for Linux users.

Type these commands into the terminal window (don't forget to enter your password when asked):

sudo apt-get install libusb-1.0-0 libusb-1.0-0-dev libreadline6-dev readline-common libreadline6 libreadline-dev
Please note that the apt-get or aptitude command is only for Debian or Ubuntu distros. Use the appropriate command for your Linux distro, for example emerge or portage for Gentoo, yum for Fedora, and yast for SUSE distros.

OS X 10.6 Preparation

These steps are designed for users of OS X 10.6 (Snow Leopard).

  • Libusb and libreadline are needed. Please download and run the following package:
http://cdn.idroidproject.org/release/tools/OpeniBoot-Tools-Installer-1.0-OSX.pkg
WARNING: This will overwrite any versions you have installed with Homebrew.

Windows Preparation

You need to have the Microsoft .NET Framework installed. Download it via Windows Update or from Microsoft.

  1. Download the OIB tools for windows from here:
    http://cdn.idroidproject.org/release/tools/OIBTools-installer-windows-1.0.zip
  2. Extract/unzip the archive. Run the executable installer.
  3. Run the Add Hardware Wizard (Start -> Run -> "hdwwiz")

Add Hardware Wizard

  1. Read the warnings, then click "Next"
  2. Choose "Install the hardware that I manually select from a list (Advanced)" this is the 2nd option, then click "Next"
  3. Select "Show All Devices", then click "Next"
  4. You are going to see a grayed-out text box with "(Retrieving a list of all devices)", click the "Have Disk..." button
  5. "Browse" to the where you installed OpeniBoot Tools (default is C:/Program Files/OpeniBoot Tools/) and then to your OS version. It will be looking of a .inf file so select "oibdev.inf" and click "Open" then "OK". It's the only file there so you shouldn't go wrong.
  6. Select "Apple Mobile Device (OpeniBoot Mode)" then click the "Next" button
  7. Install the driver. When a warning comes up about trusting Richard Ian Taylor (ricky26) click "Install" and "Always trust software from "Richard Ian Taylor""
  8. Wait for the confirmation. It should warn about "Device cannot start", click the "Finish" button.
  9. Now open Device Manager (Start -> Run -> "devmgmt.msc").
  10. Expand the Portable Devices tab to see that "Apple Mobile Device (OpeniBoot Mode)" is listed but has a yellow exclamation mark.
  11. Uninstall the driver with the yellow exclamation mark but do not delete the software for the driver. This is too stop Windows from popping up with new Hardware found on every start-up.

Download and Installation

  1. Navigate to http://cdn.idroidproject.org/release/openiboot/0.2/ and choose the folder that corresponds to your device:
    • iPhone1,1 corresponds to iPhone 2G
    • iPhone1,2 corresponds to iPhone 3G
    • iPod1,1 corresponds to iPod Touch 1G
  2. Download the file (openiboot.img3) to a convenient location such as your Desktop.
  3. Depending on your Operating System, download the tools to install OpeniBoot from here:
    http://cdn.idroidproject.org/release/tools/
    These tools have been improved and updated from the original ones created by planetbeing. For best results and optimum installation, it is advised to use the tools from the download link.
  4. Extract/unzip the archive. You should end up with a folder named for your type of OS; i.e. Linux-x86 for 32-bit Linux, Linux-x86_64 for 64-bit Linux, and OSX for Mac OS X 10.6. Please note that the OS X tools were built using 10.6 Snow Leopard so they may or may not work on 10.5 Leopard.
  5. Copy/Move the files from the folder extracted (corresponding to your OS) to the same convenient location where openiboot.img was extracted to (ex. Desktop).
  6. The convenient location must contain: loadibec, oibc, openiboot.img3, and linux (if you are using 64-bit Linux). If you are using Windows, the folder must contain loadibec.exe, oibc.exe, README.txt, syringe.dll and 3 windows folders containing the drivers for iPhone OpeniBoot mode.
  7. Open up a Terminal or a command prompt and navigate to the convenient location containing loadibec, oibc, and openiboot.img3. The following is only an example command:
    cd Desktop
  8. Turn off your device and place it in Recovery mode:
    • When the device is turned off, hold down the Home button, then connect the USB cable (make sure that is connected to the PC), keep holding the Home button until a screen with the iTunes logo and and a cable pointing towards it. For OS X and Windows users, don't forget to kill iTunesHelper or else iTunes will automatically open upon detecting an iDevice in Recovery Mode.
  9. Go back to the Terminal window and type the following command (don't forget to enter your password when asked):
    sudo ./loadibec openiboot.img3
    • In Windows command prompt, enter the command:
    loadibec openiboot.img3
    The device's screen should flash for a brief second and the OpeniBoot menu will load.
  10. If you would like to test Android before installing OpeniBoot, simply navigate with the volume buttons (or Power button if you are on iPod Touch 1G) to the Android logo and press the Home button. You will have to repeat the loading OpeniBoot process in order to install it later.
  11. Using the volume buttons (or Power button if you are on iPod Touch 1G), navigate to the console selection (the cog icon) but don't press the Home button yet.
  12. In the Terminal window type the following command:
    sudo ./oibc
    • In Windows command prompt, enter:
    oibc
    Do not press enter yet - this is where your quick reflexes will pay off.
  13. Press the Home button on the device, wait 1 or 2 seconds and then press enter on your PC to send the command, this is necessary as there is a current problem with OpeniBoot where the computer often does not connect to the device if the console screen has been on for a long time. You will know if the computer has failed to connect to the device if you receive only this output:
    !<filename>[@<address>] to send a file, ~<filename>[@<address>]:<len> to receive a file
    ---------------------------------------------------------------------------------------------------------
    The command will succeed if you see the OpeniBoot ASCII art on the Terminal screen on your PC. Windows users may have to try entering oibc multiple times before the drivers are loaded and ready to go (depending on your USB port speed and PC processing power).
  14. In the Terminal window or command prompt type this command:
    install
    Note: If you get a error like this:
    **ABORTED** Writing total image size: 0xeb240, new ibot size: 0x3b180 at 0x20000 would overflow NOR!
    Try to remove any custom bootlogo/recovery images by jailbreaking the device again without this option.
    • The install process should take around 30 seconds to 1 minute to complete. When completed, it will display this message on the iDevice: Openiboot installation complete. It may also display the message on the Terminal/command prompt screen on your PC.
    • This command will have also copied a file to your PC: norbackup.dump (usually a 1MB file). Keep this file in a safe location as it is the backup of the original bootloader, if the bootloader corrupts and you do not have this dump file, your device may become a very expensive paperweight.
  15. Type this command in the Terminal or command prompt:
    reboot
  16. Your device should reboot and you shall be presented with the OpeniBoot menu again. Select the iOS option (press Power/volume buttons to select) and boot iOS by pressing the Home button.

Congratulations. You have installed OpeniBoot on your iOS Device.

Adding an OS

OpeniBoot 0.1.2 and above uses the iOS directory /private/var/idroid, instead of /private/var like in previous OpeniBoot versions.

Make sure you place your OS images (iX, PS Freedom, iDroid) in /private/var/idroid. An empty idroid directory will cause OpeniBoot to boot into console mode when you select the Android boot option.