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 AndroidOS
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:
- The Ringtones bug has still not been fixed. Setting Ringtones will only show Silent because iDroid cannot find the ringtones. Please wait for a fix in the next versions or copy the ringtones to your SDcard folder (/private/var/sdcard) in iOS.
- 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!!!
- Graphics Acceleration Drivers do not work (no 3D, video or YouTube playback).
- Power Management is still in development, so the iDroid will run hot and be drained of a full battery in around 2 hours.
- Due to lack of graphics driver and power management/clock gating, iDroid will be a bit slower than native or real Android Devices.
- WiFi Drivers work but can be buggy at times (You have to turn on/off WiFi until you connect).
- 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.
- Internet access over the cellular network is not implemented at present, we are working on this.
Q: What are the requirements for installing iDroid?
- A: You will need:
- A compatible Apple device (iPhone, iPhone 3G, iPod Touch 1G)
- This device must be jailbroken using a non userland jailbreaking solution. (iDroid is incompatible with Spirit Jailbreak or Jailbreakme. Use redsn0w or another alternative).
- USB connector cables to connect your PC to your Apple Device
- A computer running Linux / Mac OSX or Windows with a Virtual Machine
- 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: What version of Android will be installed?
- A: FroYo or Android 2.2.1 will be installed onto your device. The original release was Donut or Android 1.6, but this is no longer supported.
Q: Can I install Android on my iPhone 3GS ?
- A: No you cannot. The new bootroms do not have an exploit and as such OpeniBoot can not be installed. The old bootroms on the other have not been developed.
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 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. For not mention the impossibility to navigate through the iDroid menus or even shutdown it.
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, there is now a guide for installation using OS X. However, if you can't access OS X, you can download a live CD image from the Ubuntu Download page and run Linux from a CD without installing anything on your machine. You can also use a virtual machine such as VMWare or Virtualbox but it is recommended to run Linux in natively.
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?
- A: If you've read the Installing iDroid (Linux) guide and are asking this, then you must have missed the special mention on the VirtualBox guide to get USB working.
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 OSX, 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 post your concerns/issues in the appropriate subforum in the Forums. Someone might have already had the same problem and had it solved. If none of that helps, it is recommended to manually install iDroid; refer to the Installation Guide. Also iPhodroid has been removed because the creator does not want to share the source code, which the OpeniBoot GPL requires; iPhodroid is breaking the law.
- 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. Open Linux or OS X terminal, and enter the command:
- 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.
Q: MoJo is so slow. It's slower that iOS4 and Android 1.6. I thought Android 2.2 was supposed to be faster. Why so?
- A: MoJo 1.0.1 uses Launcher2.apk. Launcher2.apk requires the use of a GPU and 3D graphics. As of writing (August 2010), there is no GPU driver yet so graphics acceleration is still in development. Android 1.6 uses Launcher.apk, which does not need the GPU -- that's why it's faster. Of course iOS has all the drivers working properly. As of MoJo 1.0.2, Launcher2.apk has been replaced with ADW Launcher 1.1.4 so it should be much faster.
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. There is no way to unlock a SIM in iDroid (known bug) so you will have to boot into iOS and unlock it there. Make sure you disable asking for SIM PIN in iOS Settings. Once you have done this you will be able to use the SIM with iDroid.
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
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
- A2: Perform a Factory data reset by going into Settings > Privacy > Factory data reset.
- A3: In MoJo 1.0.2, you can reboot your iDroid by using the included Rebooter app.
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: 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, 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 SDcard emulation guide has a section called Having a Shared Library. Be careful though as any wrong move or deviation from the instructions on the guide will screw iOS requiring a restore.
Q: Where are the Ringtones? Sound Settings only lists Silent.
- A: The Ringtones are in /system/media. Unfortunately, there is a bug that prevents Android from seeing this. You would have to copy /system/media into /sdcard/media, then run Media Scanner from the Dev Tools app.
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 ./oibccommand on the terminal, after the text is synced write
uninstall, after it gives the done message write
rebootand 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. http://www.idroidproject.org/forum/idroid-development-14/how-to-get-gapps-on-ifroyo/ is a very useful guide however please be warned that this method is not perfect and may cause you to reinstall iDroid (no need to reinstall OpeniBoot). Also it is best if you do this with a clean/blank userdata.img.
NOTE: EVEN IF YOU DO MANAGE TO GET GOOGLE APPS AND ANDROID MARKET INSTALLED, IT WILL NOT WORK (READ THE NEXT QUESTION), SAVE YOURSELF THE TROUBLE AND WAIT FOR FURTHER INFORMATION AND UPDATES.
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.
Q: I have done everything correctly and my phone is no longer booting and the screen remains black!
- A: It is very unlikely that the phone is broken. Simply open iTunes on your pc, connect the device and then restore it.
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 0you 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).
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, check out iDroid Project Development area for a list of bugs needing to be solved, feature requests, and more. Maybe you can resolve those issues that the other devs can't.
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: email@example.com