From iDroid Project

Jump to: navigation, search

This is for troubleshooting or any other concerns.

Take note: to make it clear iDevice means iPhone 2G, iPhone3G, or iPod Touch 1G running iOS, iDroid means iPhone currently running the Android OS



iDroid is still in Alpha Software Stage. It is not yet meant to replace iOS, but that will be the long term goal. Here are some issues that you should take note of:

  1. Camera does not work, so don't think about trying the Camera App. Opening the Camera App may hang iDroid requiring a Hard Reset. Hard Resets can mess up iOS too!!!
  2. Graphics Acceleration Drivers do not work (no 3D, video or YouTube playback).
  3. Power Management is still in development, so the iDroid will run hot and be drained of a full battery in around 2 hours.
  4. Due to lack of graphics driver and power management/clock gating, iDroid will be a bit slower than native or real Android Devices.
  5. WiFi Drivers work but can be buggy at times (You have to turn on/off WiFi until you connect).
  6. iDroid Project does not have permission from Google to include Google Apps and Android Market. Although you can install it if you have your own native Android Device, Google's servers will block you from logging-in properly with your Google Account, so Android Market will not work.
  7. Internet access over the cellular network is not implemented at present, we are working on this.

Basic Concerns

Q: What are the requirements for installing iDroid?

A: You will need:
  1. A compatible Apple device (iPhone, iPhone 3G, iPod Touch 1G)
  2. This device must be jailbroken using a non userland jailbreaking solution. (iDroid is incompatible with Spirit Jailbreak or Jailbreakme. Use redsn0w or another alternative).
  3. Internet Connection with WiFi access if installing through Bootlace.
  4. A computer running Linux, Mac OS X or Windows and USB connector cables to connect your PC to your Apple Device if you want to install the old-fashioned way.
  5. Refer to the Installation Guide for instructions on how to go about installation.

Q: Which devices are supported for iDroid?

A: iPhone, iPhone 3G, and iPod Touch 1G (1st Generation) are supported. We are working on support for other devices. See Status Page for Changes

Q: My device is not listed above. Can I install Android on my iPhone 3GS, iPhone 4, iPad, or iPod Touch 2G/3G/4G?

A: No you cannot. OpeniBoot has not been ported to those devices. We are working on support for other devices. See Status Page for Changes

Q: What version of Android will be installed?

A: Gingerbread or Android 2.3.2 will be installed onto your device. The original release was Donut or Android 1.6, but this is no longer supported.

Q: Can iDroid harm my iPhone?

A: Yes and no, if you follow instructions in a guide without messing with some core commands it is unlikely that you will break your iPhone. However, if you run commands without knowing what are you doing you could permanently break your phone.
The best practice is to make a backup on iTunes before trying to install iDroid in case you need to restore the iPhone. Be sure to backup your NOR as well after installation.

Q: My Power/Home button is broken, can I install iDroid?

A: Yes you can BUT this is NOT RECOMMENDED. This could lead to having at the end a non-working device since you cannot boot your iPhone if your home button is broken and you can have very hard times to power on your device if your power button is broken. Not to mention the impossibility to navigate through the iDroid menus or even shutdown it. Restoring it or entering DFU mode will also be near impossible. Do NOT install iDroid if your Power and/or Home button is non-functional.

Installation Concerns

Q: I had Bootlace installed before but I upgraded my iOS firmware and reinstalled Bootlace from Cydia. But now Bootlace tells me that my jailbreak/kernel is incompatible and automatically quits. I am pretty sure I am using a compatible jailbreak method. How do I fix this? Do I need to restore to my older firmware?

A: Good news, you do not need to restore your firmware. To solve this, SSH or use a USB file manager/explorer and copy /var/mobile/Library/Preferences/be.dawson.bootlace.plist from your iDevice to your PC. This is to serve as a backup in case anything goes wrong. Once the file is backed-up, delete /var/mobile/Library/Preferences/be.dawson.bootlace.plist and restart Bootlace.
If that does not work, please make a post in the Forums but don't forget to include your /var/tmp/bootlace.log.

Q: Is Linux really necessary? I don't want to format my computer to use a Linux distro!

A: No, you can use Bootlace, a Cydia App to install iDroid, eliminating the need for a computer. But if you want to do things manually and the old-fashioned way, you can now install OpeniBoot and iDroid using Windows, Linux or Mac OS X. Refer to the Installation Guide for more details.

Q: I don't have Linux or OS X, I'm stuck with Windows. I used VirtualBox to emulate Linux but the command sudo ./loadibec keeps telling me that iPhone must be in Recovery Mode. I am pretty sure it is in Recovery Mode and connected via USB. I installed all the necessary libraries as instructed from the Installing iDroid (Linux) guide. The iPhone is not found in Linux. Can anyone help me?

A1: You can install OpeniBoot and iDroid using Windows so you no longer need to use VirtualBox. Refer to the Installing iDroid (Windows) guide.
A2: If you prefer to use VirtualBox, read the VirtualBox guide to get USB working for a Linux guest on a Windows host.

Q: I am trying to run the sudo ./loadibec command but the Linux terminal keeps me telling that I am missing some readline libraries, why?

A: It is probable that you are using a 64-bit distribution of Linux. Either install the 32-bit version of the readline5 library (In Ubuntu it is called lib32readline5), or download a 32-bit live-CD distibution (Ubuntu works fine).

Q: Nothing happens when I type sudo client/loadibec openiboot.img3 or sudo client/oibc

A: If you are using SpiritJB, switch to an alternative jailbreaking solution (blackra1n on iPod Touch 1G). If not, check to see if you have libusb-dev and lib32readline5 installed (Linux). These can be installed via the command sudo apt-get install libusb-dev lib32readline5 libreadline5 (Ubuntu)

Q: I am trying to run the sudo ./loadibec command but the Linux terminal keeps me telling that "sudo: ./loadibec: command not found", why?

A: You should give loadibec and oibc execute permission by typing: chmod +x loadibec oibc

Q: I am trying to do the sudo ./loadibec command but the Linux terminal keeps me telling that my device is not connected, why?

A1: Are the USB libraries installed? If not run the command sudo apt-get install libusb-1.0-0
A2: Do you happen to have a 64-bit distribution? Follow the instructions listed under "Preparing a 64-bit environment" on Installing iDroid.
A3: Your iDevice will need to be connected in Recovery mode (not DFU). To put the iPhone in recovery mode:
  • [Method 1]: While the iDevice is powered off, connect it to your computer using the USB cable while holding down the Home button until the Connect to iTunes screen appears.
  • [Method 2]: Turn on the iDevice with Power and Home buttons, release the Power button and keep holding the Home button until the "Connect to iTunes" screen shows up.

Q: When I try to run the ./sudo oibc command the program does not show the text on my device but instead it displays: Client connected: !<filename>[@<address>] to send a file, ~<filename>[@<address>]:<len> to receive a file, what is happening?

A1: The cause of the error is not clear at the moment. However, it can be fixed by rebooting your machine or unplugging and plugging back in your device's USB cable. Also make sure you aren't accessing the oibc tool from a special folder like the Trash Bin.
A2: On OS X, it seems you must load oibc as soon as you press the console button on your phone, seems to work only if the boot output has been sent. (May work on Ubuntu too)

Q: Help, [insert automated-installer's name here, like iPhodroid] does not work. It shows [insert error here]. What should I do?

A1: As much as we'd love to help, unfortunately we cannot. It's because we don't know how to. Most automated-installers have not released their source code so the iDroid devs and admins do not know how they work and don't know what or why [insert your issue here] happens. The best thing you can do is to manually install iDroid; refer to the Installation Guide.
A2: We have compiled a list of common issues and workarounds from iPhodroid in this Guide

Booting into iDroid

Q: I recently installed/upgraded to OpeniBoot 0.1.2, however when I select the Android option or use Bootlace's quickboot function, it goes into the Openiboot console. Why is this happening? How can I boot into Android?

A: Beginning with OpeniBoot 0.1.2, the 5 android images (android.img.gz, cache.img, system.img, userdata.img, & zImage) should now be placed in /private/var/idroid. In OpeniBoot 0.1.1 (the older versions) the 5 android images were in /private/var. Just copy/move the 5 android images into /private/var/idroid (create the folder if you have to). Remember to check the file sizes to avoid corrupt images.

Q: I entered command ./loadibec openiboot.img and it went directly into OpeniBoot console. I did not even get a chance to select the OS. I was able to install it but on reboot it went directly again to the console. Why doesn't the OS Menu appear?

A: This problem is often experienced by users who have recently upgraded to use OpeniBoot from iPhodroid. The OS Menu does not display and "WELCOME TO OPENIBOOT" is shown instead. This is because "opib-hide-menu true" is set in iPhodroid. This flag is saved into settings and will persist even after uninstall and install of OpeniBoot. To fix this:
1. Install OpeniBoot if you haven't.
2. It will automatically boot into the OpeniBoot console.
3. On your computer, run the OpeniBoot Console oibc.
4. Once you are in the OpeniBoot console, enter these commands:
If it displays "opib-hide-menu true" then set it to false by entering the command:
setenv opib-hide-menu false
5. Then reboot:
The Menu should now be displayed.

Q: I am trying to boot iDroid but at the very first screen it gets stuck at the radio: reading baseband nvram... done line; why?

A: You may have uploaded the Android images onto your iPhone with WinSCP which does not always work. We suggest that you instead use an ftp client (such as FileZilla) or a USB File Explorer (faster but you need to install afc2add from Cydia). Once you have uploaded the images into the folder /private/var/idroid you must also set the image permissions to 0777. If everything fails then maybe you need to redownload the Android image files.

Q: I am trying to boot iDroid and after some loading it gets stuck at the kernel panic - not syncing: VFS: unable to mount root fs on unknown-block(1,0) line; why?

A: The files you have uploaded are corrupted, just reupload them as described above.

iDroid Concerns

Q: I successfully installed Android but my phone is getting hot, the battery is draining very quickly and the screen is always on. Can I put iDroid into standby?

A: At the moment there aren't power management features in iDroid. This means that it is currently impossible to put a phone running iDroid into standby. Please wait for future releases as the screen can now be turned off on standby and turned on upon resume.

Q: iDroid tells me that the SIM is locked, how can I unlock it?

A: You probably have the PIN code enabled in iPhoneOS. The easiest way to unlock a SIM in iDroid (known bug) is to boot into iOS and disable SIM PIN. However, if you still want SIM PIN support, enter the PIN in iDroid (upon boot), then enable/disable Airplane mode. Airplane mode can be activated by pressing the Home and Power button for more than 2 seconds. If you have Haptic Feedback enabled, you will feel a short vibration before the Phone options menu pops out. Touch the Airplane mode option.

Q: How can I shutdown or turn off my iDroid?

A1: Starting with MoJo 1.0.3, the Phone options menu can be revealed by pressing the Home and Power button for more than 2 seconds. If you have Haptic Feedback enabled, you will feel a short vibration before the Phone options menu pops out. Touch the Power off option and you will be asked to confirm if you want iDroid to shutdown.
A2: Starting with MoJo 1.0.3, one can turn off iDroid by going to Dev tools > Terminal Emulator, type su, then reboot - p.
A3: There is the hardware power-off or the Hard Reset, which is performed by holding the Power and Home buttons until it shuts down (generally it takes 10 seconds). The hardware power-off is NOT RECOMMENDED since it could lead to unclean shutdowns breaking the Android images making it slow or even impossible to boot the next time you try to boot iDroid. This also called a Hard Reset.

Q: How can I reboot my iDroid?

Rebooting iDroid causes Android image corruption. It is recommended to shut iDroid down properly using the Power off function (see above).
A1: In Dev tools > Terminal Emulator, type su, then reboot.
A2: Perform a Factory data reset by going into Settings > Privacy > Factory data reset.

Q: iDroid always boots and shows a warning saying the process.acore has stopped unexpectedly and only makes me Force close it. Also my touchscreen is unresponsive. Why is that?

A: The situation above is typical of faulty zephyr firmware. Make sure the zephyr files (zephyr_main.bin and zephyr_aspeed.bin for iPhone 2G, or zephyr2.bin for iPhone 3G and iPod Touch 1G) are in /private/var/firmware and that the filesizes from the PC and in your iOS match. Also the extraction method to get the zephyr firmware may cause problems. Using Dripwn on iOS 4 and above can cause faulty zephyr firmware (but works fine on 3.1.3 and below). Try using Bootlace or Ninn's Extraction Technique to solve firmware problems.

Q: Touchscreen is unresponsive / touch does not work.

A1: Make sure zephyr_aspeed.bin and zephyr_main.bin for iPhone 2G, or zephyr2.bin for iPhone 3G and iPod Touch 1G are/is in iOS /private/var/firmware. Make sure the filesizes from your PC and in your iOS match.
A2: If you used Bootlace to install iDroid, don't forget to extract the Multitouch firmware by opening Bootlace app in iOS, touching the iDroid tab (lower right), then pressing the (i) on the upper right. This will bring up the menu to extract the Multitouch firmware or download the WiFi firmware.

Q: My WiFi does not work.

A1: Make sure sd8686.bin and sd8686_helper.bin are in iOS /private/var/firmware. Make sure the filesizes of the 2 files from your PC and in your iOS match.
A2: If does not work means no networks are detected, manually enter the SSID and a list of networks may suddenly show up.
A3: Are you using V8 or V9 WiFi firmware? V8 seems to have the most compatibility. Just try either to see which works best with your device.
A4: If does not work means you're connected to WiFi but cannot browse or check e-mail, then maybe you need to apply the DNS Fix. Note: DNS Fix is already implemented in MoJo.
A5: Wifi will apparently stop working if the formatting of the init/init.rc is lost. Make sure you edit these files using a terminal editor such as nano or vim.

Q: I'm trying to connect with ADB to my iDroid, I'm using Windows and when I write adb connect xxx.xxx.xxx.xxx:5555 the command prompt tells me that the program cannot be found, why?

A1: You aren't in the ..\androidsdk\tools\ directory, you need to go on that directory and run the adb command there
A2: If you wanna access it from everywhere from your system you need to copy the adb.exe and relative .dll file to the C:\Windows\system32\ folder. There are some people reporting that the "system32 method" doesn't work on WindowsXP 64-bit, in that case just use the third method,which works better anyway because it allows access to all android sdk tools.
A3: If you are on windows (or linux with different instructions) you can just add the tools folder to your PATH and it will be able to be run from anywhere,and it has the advantage of working for all of the programs in the android sdk, not just adb (like fastboot). Go to Control Panel, then System, then click on the Advanced tab, then click Environment Variables, then click New and in the variable name box type PATH (in all caps), and for the variable value, type where you extracted the sdk to, for example "C:\android-sdk-windows\tools\". Make sure you include tools and the end \ otherwise it will only be looking in the main folder and it won't work.

Q: I'm trying to connect ADB over TCP to my iDroid it says: unable to connect to xxx.xxx.xxx.xxx:5555, why?

A: You need to connect your iDroid to the wifi and to the USB cable, then enable the USB Debug Mode or it won't work.

Q: iDroid does not detect my SD Card?

A1: If you are using MoJo or better versions, then make sure you've created a sdcard folder in iOS /private/var (appears as /private/var/sdcard)
A2: If you are not on MoJo, please refer to the SDcard emulation guide.

Q: How can I have a shared library with iOS? I want my music all in one place.

A: The Shared Library guide is a very informative guide. Be careful though as any wrong move or deviation from the instructions on the guide will screw iOS requiring a restore.

Q: I don't like this stuff and I wanna get rid of this, how can I uninstall Android and OpeniBoot?

A: Why? =( Anyways, power up your device and enter on the OpeniBoot console, connect it on the pc and run the sudo ./oibc command on the terminal, after the text is synced write uninstall, after it gives the done message write reboot and once it reboots on iPhoneOS connect via SSH/SFTP and delete the Android images from the /private/var folder. Refer to the main article: Uninstall iDroid

Android Market and Google Apps

Q: Why isn't Android Market and Google Apps included?

A: Because the iDroid Project does not have permission from Google to distribute them. Doing so is illegal because Market and Google Apps are proprietary software.

Q: Okay, how then can I install Android Market and Google Apps?

A: You can only do this is you have an Android Device with Google Apps in it. Copy the Google Apps from your Android Device to iDroid's system.img/apps. There may be more detailed tutorials for this on other websites.


Q: Ok I got the Google Apps installed. Why do I keep getting an error saying "Data Connection cannot be established" when trying to sign-in with my Google Account?

A: The iDroid Project is not an official or authorized Android Device (unlike HTC, Motorola Droid, Samsung Galaxy, etc). iDroid tries to accessing Google's Servers but because of incompatibilities or unauthorized signatures, data connection errors occur. The problem is with Google's Servers unless the iDroid is emulated to act like an HTC or a Droid.

Q: If we are not allowed to use Google Apps, how do I sync my Google Contacts?

A: Krazy-Killa from the Forums has found an alternate way and this has been added to the User Manual. Read about it here.

General Problems

Q: Help! OpeniBoot Console and iDroid seem to booting fine, except when I try to boot into iOS, the Apple Logo is shown then it turns off/reboots back into the OpeniBoot OS selection menu? What should I do? Can I uninstall OpeniBoot?

A: This problem commonly happens because of FTL/nand corruption. Some files required in booting iOS have been corrupted and as a result, iOS will reboot as a failsafe. The best thing to do is to restore using DFU. Take note that DFU Restore will remove OpeniBoot and iDroid. Uninstalling iDroid will remove OpeniBoot but the booting error will still be there; however some users may find it easier to go into DFU without OpeniBoot installed.

Q: I have done everything correctly and my iDevice is no longer booting and the screen remains black!

A: It is very unlikely that the iDevice is broken. Simply open iTunes on your PC, connect the iDevice and then restore it. If you have other problems, post in the Forums, ask in the IRC channels (#iphonelinux or #idroid-dev), or take it to Apple (but your warranty may have been voided).

Q: I tried to restore my phone with iTunes after Android broke it, I keep getting Error 28 (or other errors) when trying to restore. Is my iPhone toast?

A: Possibly. Error 23, 28, 29, 1011, 1012, 1611, may indicate Hardware failures. Before you start banging your head on the table, load up openiboot when your device is in the recovery screen. Load it into console mode, and open up oibc. Once all is loaded type in nand_erase 0 0. This will reset your nand flash requiring it to be repartitioned entirely. Once this is done reboot, and try to restore via iTunes again. If good, be sure to COMPLETELY FILL your iphone with files, writing to the NAND flash. Reason is due to the nand_erase 0 0 you lost your BBT which means there is no record any longer of bad blocks, so you will need iOS to do so. If none of that works, post in the Forums, ask in the IRC channels (#iphonelinux or #idroid-dev), or take it to Apple (but your warranty may have been voided).

Miscellaneous Questions

Q: Who is developing this project?

A: Planetbeing is the primary developer of this project but he is now working on iPhone 4 stuff. Nickp666 is the project leader. Bluerise and ricky26 are the main devs. Neonkoala is the Bootlace developer.

Q: Where can I get the source code for OpeniBoot?

A: http://github.com/iDroid-Project/openiBoot contains the latest repo for OpeniBoot. OpeniBoot is under GPLv2 License so if you plan to make any changes, you have to specify what they are.

Q: How do we contribute to the project?

A: If you have some programming skills and want to help develop, chat with the Devs at #idroid-dev IRC channel on irc.freenode.net. The Devs really need help since there are only less than 10 of them.

Q: Great job guys!!! How do we donate to the iDroid Project?

A: Thanks for the interest in helping us finance server hosting costs and other miscellaneous needs. There is a Donate button to the right of "Welcome to iDroid Project Wiki" on the Main Page. All donations go to: donations@idroidproject.org