Troubleshooting - Revision history

User890104 at 17:03, 19 August 2011

2011-08-19T17:03:47Z

← Older revision		Revision as of 17:03, 19 August 2011
Line 86:		Line 86:
	Connect via USB</pre>		Connect via USB</pre>

	Next, you need to upload and run another copy of [[emCORE]] Loader at a different address. You can build the required file yourself, or download it [http://files.freemyipod.org/tmp/emcoreldr-ipodnano2g.bin here] and then upload it to your device using the following commands:		If everything goes fine, you can proceed with the instructions from the previous sections ([[#Uploading_an_emCORE_installer\|Uploading an emCORE installer]] or [[#Uploading_an_emCORE_binary\|Uploading an emCORE binary]]) in order to recover your [[emCORE]] installation.

	~~<pre>python emcoreldr.py upload 0x22000000 emcoreldr-ipodnano2g.bin~~
	~~python emcoreldr.py execute 0x22000000 0x00000000</pre>~~

	If everything goes fine, ~~the display will show the same text as before entering these commands.You~~ can proceed with the instructions from the previous sections ([[#Uploading_an_emCORE_installer\|Uploading an emCORE installer]] or [[#Uploading_an_emCORE_binary\|Uploading an emCORE binary]]) in order to recover your [[emCORE]] installation.

User890104 at 11:11, 18 August 2011

2011-08-18T11:11:52Z

← Older revision		Revision as of 11:11, 18 August 2011
Line 96:		Line 96:
	==[[Classic_1G\|Classic 1G]] / [[Classic_2G\|Classic 2G]] / [[Classic_3G\|Classic 3G]]==		==[[Classic_1G\|Classic 1G]] / [[Classic_2G\|Classic 2G]] / [[Classic_3G\|Classic 3G]]==

	The DFU mode of the Classics is supported by iTunes. So you should always be able to enter DFU (holding MENU+SELECT for 10-15 seconds while connected to USB), and either restore with iTunes, or (re)install [[emCORE]]		===Recovery Mode===

			Since the Classics have DFU, recovery mode is not implemented.

			===DFU Mode===

			The DFU mode of the Classics is supported by iTunes. So you should always be able to enter DFU (holding MENU+SELECT for 10-15 seconds while connected to USB), and either restore with iTunes, or [[EmCORE_Installation\|(re)install emCORE]]

	If you're unable to enter DFU, please [[Contact\|contact us]].		If you're unable to enter DFU, please [[Contact\|contact us]].

User890104: add basic instructions about the classics

2011-08-18T11:07:53Z

add basic instructions about the classics

← Older revision		Revision as of 11:07, 18 August 2011
Line 96:		Line 96:
	==[[Classic_1G\|Classic 1G]] / [[Classic_2G\|Classic 2G]] / [[Classic_3G\|Classic 3G]]==		==[[Classic_1G\|Classic 1G]] / [[Classic_2G\|Classic 2G]] / [[Classic_3G\|Classic 3G]]==

	(to ~~be continued~~)		The DFU mode of the Classics is supported by iTunes. So you should always be able to enter DFU (holding MENU+SELECT for 10-15 seconds while connected to USB), and either restore with iTunes, or (re)install [[emCORE]]

			If you're unable to enter DFU, please [[Contact\|contact us]].

User890104 at 19:38, 11 July 2011

2011-07-11T19:38:56Z

← Older revision		Revision as of 19:38, 11 July 2011
Line 67:		Line 67:
	====Uploading an [[emCORE]] Loader====		====Uploading an [[emCORE]] Loader====

	First, you need to checkout [http://svn.freemyipod.org/tools/ipoddfu/ this folder]. Then you need a DFU image that contains [[emCORE]] Loader. You can build one yourself (but only if you have access to a working [[Nano_2G\|Nano 2G]]), or ~~ask someone on IRC~~. Then you put it in the same folder as ipoddfu.py, '''<big>turn your iPod's HOLD switch on</big>''' and enter the following command:		First, you need to checkout [http://svn.freemyipod.org/tools/ipoddfu/ this folder]. Then you need a DFU image that contains [[emCORE]] Loader. You can build one yourself (but only if you have access to a working [[Nano_2G\|Nano 2G]]), or download it [http://files.freemyipod.org/tmp/emcoreldr-ipodnano2g.dfu here]. Then you put it in the same folder as ipoddfu.py, '''<big>turn your iPod's HOLD switch on</big>''' and enter the following command:

	<pre>python ipoddfu.py emcoreldr-ipodnano2g.dfu</pre>		<pre>python ipoddfu.py emcoreldr-ipodnano2g.dfu</pre>
Line 86:		Line 86:
	Connect via USB</pre>		Connect via USB</pre>

	Next, you need to upload and run another copy of [[emCORE]] Loader at a different address using the following commands:		Next, you need to upload and run another copy of [[emCORE]] Loader at a different address. You can build the required file yourself, or download it [http://files.freemyipod.org/tmp/emcoreldr-ipodnano2g.bin here] and then upload it to your device using the following commands:

	<pre>python emcoreldr.py upload 0x22000000 emcoreldr-ipodnano2g.bin		<pre>python emcoreldr.py upload 0x22000000 emcoreldr-ipodnano2g.bin

User890104 at 21:37, 8 July 2011

2011-07-08T21:37:57Z

← Older revision		Revision as of 21:37, 8 July 2011
Line 86:		Line 86:
	Connect via USB</pre>		Connect via USB</pre>

	You can proceed with the instructions from the previous sections ([[#~~Uploading_an_installer~~\|Uploading an installer]] or [[#Uploading_an_emCORE_binary\|Uploading an emCORE binary]]) in order to recover your [[emCORE]] installation.		Next, you need to upload and run another copy of [[emCORE]] Loader at a different address using the following commands:

			<pre>python emcoreldr.py upload 0x22000000 emcoreldr-ipodnano2g.bin
			python emcoreldr.py execute 0x22000000 0x00000000</pre>

			If everything goes fine, the display will show the same text as before entering these commands.You can proceed with the instructions from the previous sections ([[#Uploading_an_emCORE_installer\|Uploading an emCORE installer]] or [[#Uploading_an_emCORE_binary\|Uploading an emCORE binary]]) in order to recover your [[emCORE]] installation.

User890104 at 20:30, 8 July 2011

2011-07-08T20:30:14Z

← Older revision		Revision as of 20:30, 8 July 2011
Line 67:		Line 67:
	====Uploading an [[emCORE]] Loader====		====Uploading an [[emCORE]] Loader====

	First, you need to checkout [http://svn.freemyipod.org/tools/ipoddfu/ this folder]. Then you need a DFU image that contains [[emCORE]] Loader. You can build one yourself (but only if you have access to a working [[Nano_2G\|Nano 2G]]), or ask someone on IRC. Then you put it in the same folder as ipoddfu.py, turn your iPod's HOLD switch on and enter the following command:		First, you need to checkout [http://svn.freemyipod.org/tools/ipoddfu/ this folder]. Then you need a DFU image that contains [[emCORE]] Loader. You can build one yourself (but only if you have access to a working [[Nano_2G\|Nano 2G]]), or ask someone on IRC. Then you put it in the same folder as ipoddfu.py, '''<big>turn your iPod's HOLD switch on</big>''' and enter the following command:

	<pre>python ipoddfu.py emcoreldr-ipodnano2g.dfu</pre>		<pre>python ipoddfu.py emcoreldr-ipodnano2g.dfu</pre>

User890104 at 13:53, 7 April 2011

2011-04-07T13:53:12Z

← Older revision		Revision as of 13:53, 7 April 2011
Line 3:		Line 3:
	Different devices have different methods for getting out of a "bricked" condition. Here is a summary of each device and the conditions that it may get into.		Different devices have different methods for getting out of a "bricked" condition. Here is a summary of each device and the conditions that it may get into.

	==Nano 2G==		==[[Nano_2G\|Nano 2G]]==

	After installing or updating [[emCORE]], your iPod may not complete the flashing process successfully. This will lead to a unfinished installation which does not work as expected. To recover your device you will need some Python scripts from [[SVN\|the SVN]], a [http://www.python.org/ Python] interpreter, [http://sourceforge.net/projects/pyusb/files/PyUSB%201.0/ pyUSB] and [http://files.freemyipod.org/misc/windows_driver.zip a driver] (for Windows only). You can get the script by checking out [http://svn.freemyipod.org/emcore/trunk/tools/ this folder].		After installing or updating [[emCORE]], your iPod may not complete the flashing process successfully. This will lead to a unfinished installation which does not work as expected. To recover your device you will need some Python scripts from [[SVN\|the SVN]], a [http://www.python.org/ Python] interpreter, [http://sourceforge.net/projects/pyusb/files/PyUSB%201.0/ pyUSB] and [http://files.freemyipod.org/misc/windows_driver.zip a driver] (for Windows only). You can get the script by checking out [http://svn.freemyipod.org/emcore/trunk/tools/ this folder].
Line 41:		Line 41:
	====Uploading an [[emCORE]] binary====		====Uploading an [[emCORE]] binary====

	You will need a known-working [[emCORE]] build, you can use one that you have built yourself, grab the latest from [http://builds.freemyipod.org/ the build server] by selecting the "~~bin~~" link for the device you need ('''not recommended''' because they might not have been tested yet), or ask on IRC for one. After you get one and place it in the same folder as the scripts, you can proceed with the following command:		You will need a known-working [[emCORE]] build, you can use one that you have built yourself (but only if you have access to a working [[Nano_2G\|Nano 2G]]), grab the latest from [http://builds.freemyipod.org/ the build server] by selecting the "ubi" link for the device you need ('''not recommended''' because they might not have been tested yet), or ask on IRC for one. After you get one and place it in the same folder as the scripts, you can proceed with the following command:

	<pre>python emcoreldr.py run emcore-ipodnano2g.bin</pre>		<pre>python emcoreldr.py run emcore-ipodnano2g.bin</pre>
Line 67:		Line 67:
	====Uploading an [[emCORE]] Loader====		====Uploading an [[emCORE]] Loader====

	First, you need to checkout [http://svn.freemyipod.org/tools/ipoddfu/ this folder]. Then you need a DFU image that contains [[emCORE]] Loader. You can build one yourself (but only if you have access to a working [~~Nano2G~~]), or ask someone on IRC. Then you put it in the same folder as ipoddfu.py, turn your iPod's HOLD switch on and enter the following command:		First, you need to checkout [http://svn.freemyipod.org/tools/ipoddfu/ this folder]. Then you need a DFU image that contains [[emCORE]] Loader. You can build one yourself (but only if you have access to a working [[Nano_2G\|Nano 2G]]), or ask someone on IRC. Then you put it in the same folder as ipoddfu.py, turn your iPod's HOLD switch on and enter the following command:

	<pre>python ipoddfu.py emcoreldr-ipodnano2g.dfu</pre>		<pre>python ipoddfu.py emcoreldr-ipodnano2g.dfu</pre>
Line 87:		Line 87:

	You can proceed with the instructions from the previous sections ([[#Uploading_an_installer\|Uploading an installer]] or [[#Uploading_an_emCORE_binary\|Uploading an emCORE binary]]) in order to recover your [[emCORE]] installation.		You can proceed with the instructions from the previous sections ([[#Uploading_an_installer\|Uploading an installer]] or [[#Uploading_an_emCORE_binary\|Uploading an emCORE binary]]) in order to recover your [[emCORE]] installation.


			==[[Classic_1G\|Classic 1G]] / [[Classic_2G\|Classic 2G]] / [[Classic_3G\|Classic 3G]]==

			(to be continued)

User890104: s/(emBIOS|iLoader)/emCORE/g

2011-04-07T13:47:44Z

s/(emBIOS|iLoader)/emCORE/g

← Older revision		Revision as of 13:47, 7 April 2011
Line 5:		Line 5:
	==Nano 2G==		==Nano 2G==

	After installing or updating ~~iLoader~~, your iPod may not complete the flashing process successfully. This will lead to a unfinished installation which does not work as expected. To recover your device you will need some Python scripts from the SVN, a Python interpreter, pyUSB and a driver (for Windows only). You can get the script by checking out [http://svn.freemyipod.org/~~embios~~/trunk/tools/ this folder].		After installing or updating [[emCORE]], your iPod may not complete the flashing process successfully. This will lead to a unfinished installation which does not work as expected. To recover your device you will need some Python scripts from [[SVN\|the SVN]], a [http://www.python.org/ Python] interpreter, [http://sourceforge.net/projects/pyusb/files/PyUSB%201.0/ pyUSB] and [http://files.freemyipod.org/misc/windows_driver.zip a driver] (for Windows only). You can get the script by checking out [http://svn.freemyipod.org/emcore/trunk/tools/ this folder].

	===Recovery mode===		===Recovery mode===

	Sometimes ~~iLoader~~ may not finish loading and crash before showing the menu, because you have installed a faulty build (for example, when making changes and then building the code yourself). In this case, you need to enter ~~emBIOS~~ Loader's Recovery mode.		Sometimes [[emCORE]] may not finish loading and crash before showing the menu, because you have installed a faulty build (for example, when making changes and then building the code yourself). In this case, you need to enter [[emCORE]] Loader's Recovery mode.

	====Getting to Recovery mode====		====Getting to Recovery mode====
Line 15:		Line 15:
	Restart your iPod by holding MENU+SELECT until the screen turns off, then '''immediately''' turn the HOLD switch on. If you manage to do this fast enough, your iPod will show some text, similar to the following:		Restart your iPod by holding MENU+SELECT until the screen turns off, then '''immediately''' turn the HOLD switch on. If you manage to do this fast enough, your iPod will show some text, similar to the following:

	<pre>~~emBIOS~~ Loader vX.X.X rXXX		<pre>emCORE Loader vX.X.X rXXX
	Switch HOLD on for recovery		Switch HOLD on for recovery

Line 21:		Line 21:
	Connect via USB</pre>		Connect via USB</pre>

	At that point you can either run an ~~emBIOS~~ build directly to manually fix the problem, or reinstall ~~iLoader~~, in case the problem was caused by a failed update.		At that point you can either run an [[emCORE]] build directly to manually fix the problem, or reinstall [[emCORE]], in case the problem was caused by a failed update.

	====Uploading an installer====		====Uploading an [[emCORE]] installer====

	After that, you need an installer binary. You can get the official version from [~~http://theseven.freemyipod.org/iloader/installation.php TheSeven's Installation~~ page] or build one yourself. Place it in the same folder as the previous files, then run:		After that, you need an installer binary. You can get the official version from [[EmCORE_Releases\|the releases page]] or build one yourself. Place it in the same folder as the previous files, then run:

	<pre>python ~~embiosldr~~.py run installer-*.~~bin~~</pre>		<pre>python emcoreldr.py run installer-*.ubi</pre>

	(if you are on *nix, you may need to prefix it with "sudo" or run it from a root shell)		(if you are on *nix, you may need to prefix it with "sudo" or run it from a root shell)
Line 33:		Line 33:
	You should see something similar to that in your terminal window:		You should see something similar to that in your terminal window:

	<pre>Connected to ~~emBIOS~~ Loader Recovery Mode on iPod Nano 2G, USB version 1		<pre>Connected to emCORE Loader Recovery Mode on iPod Nano 2G, USB version 1
	Uploading installer-XXXXX.~~bin~~ to 0x 8000000..... done		Uploading installer-XXXXX.ubi to 0x 8000000..... done
	Passing control to code at 0x 8000000... done</pre>		Passing control to code at 0x 8000000... done</pre>

	Your iPod should launch the installer program. Follow the instructions on the screen to update your ~~iLoader~~ installation.		Your iPod should launch the installer program. Follow the instructions on the screen to update your [[emCORE]] installation.

	====Uploading an ~~emBIOS~~ binary====		====Uploading an [[emCORE]] binary====

	You will need a known-working ~~emBIOS~~ build, you can use one that you have built yourself, grab the latest from [http://builds.freemyipod.org/ the build server] by selecting the "bin" link for the device you need (not recommended because they might not have been tested yet), or ask on IRC for one. After you get one and place it in the same folder as the scripts, you can proceed with the following command:		You will need a known-working [[emCORE]] build, you can use one that you have built yourself, grab the latest from [http://builds.freemyipod.org/ the build server] by selecting the "bin" link for the device you need ('''not recommended''' because they might not have been tested yet), or ask on IRC for one. After you get one and place it in the same folder as the scripts, you can proceed with the following command:

	<pre>python ~~embiosldr~~.py run ~~embios~~-ipodnano2g.bin</pre>		<pre>python emcoreldr.py run emcore-ipodnano2g.bin</pre>

	(if you are on *nix, you may need to prefix it with "sudo" or run it from a root shell)		(if you are on *nix, you may need to prefix it with "sudo" or run it from a root shell)
Line 49:		Line 49:
	You should see this text in your terminal window:		You should see this text in your terminal window:

	<pre>Connected to ~~emBIOS~~ Loader Recovery Mode on iPod Nano 2G, USB version 1		<pre>Connected to emCORE Loader Recovery Mode on iPod Nano 2G, USB version 1
	Uploading ~~embios~~-ipodnano2g.bin to 0x 8000000..... done		Uploading emcore-ipodnano2g.bin to 0x 8000000..... done
	Passing control to code at 0x 8000000... done</pre>		Passing control to code at 0x 8000000... done</pre>

	Then, you will (hopefully) see an ~~emBIOS~~ console on your iPod's screen. It will say somethins similar to this:		Then, you will (hopefully) see an [[emCORE]] console on your iPod's screen. It will say somethins similar to this:

	<pre>~~emBIOS~~ vX.X.X rXXX		<pre>emCORE vX.X.X rXXX

	Waiting for USB commands</pre>		Waiting for USB commands</pre>

	If everything goes as described here, you can connect to your device using the ~~embios~~.py script.		If everything goes as described here, you can connect to your device using the emcore.py script.

	===DFU Mode===		===DFU Mode===
Line 65:		Line 65:
	If something goes terribly wrong and your iPod does not display any contents on the screen when powering on, it means that it is in Bootrom DFU mode. This mode is a last resort for recovering your device.		If something goes terribly wrong and your iPod does not display any contents on the screen when powering on, it means that it is in Bootrom DFU mode. This mode is a last resort for recovering your device.

	====Uploading an ~~emBIOS~~ Loader====		====Uploading an [[emCORE]] Loader====

	First, you need to checkout [http://svn.freemyipod.org/tools/ipoddfu/ this folder]. Then you need a DFU image that contains ~~emBIOS~~ Loader. You can build one yourself (but only if you have access to a working Nano2G), or ask someone on IRC. Then you put it in the same folder as ipoddfu.py, turn your iPod's HOLD switch on and enter the following command:		First, you need to checkout [http://svn.freemyipod.org/tools/ipoddfu/ this folder]. Then you need a DFU image that contains [[emCORE]] Loader. You can build one yourself (but only if you have access to a working [Nano2G]), or ask someone on IRC. Then you put it in the same folder as ipoddfu.py, turn your iPod's HOLD switch on and enter the following command:

	<pre>python ipoddfu.py ~~embiosldr~~-ipodnano2g.dfu</pre>		<pre>python ipoddfu.py emcoreldr-ipodnano2g.dfu</pre>

	(if you are on *nix, you may need to prefix it with "sudo" or run it from a root shell)		(if you are on *nix, you may need to prefix it with "sudo" or run it from a root shell)
Line 78:		Line 78:
	Upload: ..... done</pre>		Upload: ..... done</pre>

	Then your iPod should be in ~~emBIOS~~ Loader's recovery mode. You can confirm that by looking at your device's display. It should print some text, similar to the following:		Then your iPod should be in [[emCORE]] Loader's recovery mode. You can confirm that by looking at your device's display. It should print some text, similar to the following:

	<pre>~~emBIOS~~ Loader vX.X.X rXXX		<pre>emCORE Loader vX.X.X rXXX
	Switch HOLD on for recovery		Switch HOLD on for recovery

Line 86:		Line 86:
	Connect via USB</pre>		Connect via USB</pre>

	You can proceed with the instructions from the previous sections ([[#Uploading_an_installer\|Uploading an installer]] or [[#~~Uploading_an_emBIOS_binary~~\|Uploading an ~~emBIOS~~ binary]]) in order to recover your ~~iLoader~~ installation.		You can proceed with the instructions from the previous sections ([[#Uploading_an_installer\|Uploading an installer]] or [[#Uploading_an_emCORE_binary\|Uploading an emCORE binary]]) in order to recover your [[emCORE]] installation.

User890104 at 14:05, 14 January 2011

2011-01-14T14:05:13Z

← Older revision		Revision as of 14:05, 14 January 2011
Line 41:		Line 41:
	====Uploading an emBIOS binary====		====Uploading an emBIOS binary====

	You will need a known-working emBIOS build, you can use one that you have built yourself, grab the latest from [http://builds.freemyipod.org/ the build server] (not recommended because they might not have been tested yet), or ask on IRC for one. After you get one and place it in the same folder as the scripts, you can proceed with the following command:		You will need a known-working emBIOS build, you can use one that you have built yourself, grab the latest from [http://builds.freemyipod.org/ the build server] by selecting the "bin" link for the device you need (not recommended because they might not have been tested yet), or ask on IRC for one. After you get one and place it in the same folder as the scripts, you can proceed with the following command:

	<pre>python embiosldr.py run embios-ipodnano2g.bin</pre>		<pre>python embiosldr.py run embios-ipodnano2g.bin</pre>

User890104: Undo revision 3543 by User890104 (talk)

2011-01-10T12:32:46Z

Undo revision 3543 by User890104 (talk)

← Older revision		Revision as of 12:32, 10 January 2011
Line 86:		Line 86:
	Connect via USB</pre>		Connect via USB</pre>

	You can proceed with the instructions from the previous sections ([[#Uploading_an_installer]] or [[#Uploading_an_emBIOS_binary]]) in order to recover your iLoader installation.		You can proceed with the instructions from the previous sections ([[#Uploading_an_installer\|Uploading an installer]] or [[#Uploading_an_emBIOS_binary\|Uploading an emBIOS binary]]) in order to recover your iLoader installation.