diff options
Diffstat (limited to 'manual/getting_started/ipod_install.tex')
-rwxr-xr-x | manual/getting_started/ipod_install.tex | 552 |
1 files changed, 169 insertions, 383 deletions
diff --git a/manual/getting_started/ipod_install.tex b/manual/getting_started/ipod_install.tex index 08ed229c43..6c36edead3 100755 --- a/manual/getting_started/ipod_install.tex +++ b/manual/getting_started/ipod_install.tex | |||
@@ -1,391 +1,177 @@ | |||
1 | % $Id$ % | 1 | % $Id$ % |
2 | 2 | ||
3 | \warn{A significantly easier installation method has been | ||
4 | developed for the ipods, but is not yet included in this manual. Until this | ||
5 | manual is updated, please visit | ||
6 | \url{http://www.rockbox.org/twiki/bin/view/Main/IpodInstallationBeta} | ||
7 | for the most up-to-date version of the installation instructions.} | ||
8 | |||
9 | \opt{ipodvideo}{\warn{In addition, the instructions in this manual do not work | ||
10 | at all on the new ``5.5g'' video ipod. If you own such an ipod - you | ||
11 | \emph{must} use the new instructions at | ||
12 | \url{http://www.rockbox.org/twiki/bin/view/Main/IpodInstallationBeta}}} | ||
13 | |||
14 | \opt{ipodnano}{\warn{If your Nano has a stainless steel back and plastic front | 3 | \opt{ipodnano}{\warn{If your Nano has a stainless steel back and plastic front |
15 | it is a 1st generation and is compatible with Rockbox. If, on the other hand, | 4 | it is a 1st generation and is compatible with Rockbox. If, on the other hand, |
16 | your Nano has a one-piece aluminum body it is a 2nd generation Nano and there | 5 | your Nano has a one-piece aluminum body it is a 2nd generation Nano and there |
17 | is currently no Rockbox port available. Do not attempt to install the | 6 | is currently no Rockbox port available. Do not attempt to install the |
18 | bootloader on a 2nd generation Nano}} | 7 | bootloader on a 2nd generation Nano}} |
19 | 8 | ||
20 | Installing the boot loader is the trickiest part of the installation. | 9 | In order to make your iPod load and execute the Rockbox firmware you have just |
21 | \opt{ipodnano}{First, you need to find out which version of the Apple | 10 | installed, you will need to install the Rockbox bootloader. Unless bugs are |
22 | firmware you're running. To do this, start the Apple firmware and go to | 11 | found in the bootloader code, or significant new feature are added, you will |
23 | Settings screen. In the ``About'' screen you'll find the version number | 12 | only have to perform this step once. |
24 | of the Apple firmware. Depending on the version number the installation | 13 | |
25 | is slightly different.}% | 14 | The following instructions refer to the ``installation folder.'' For Windows |
26 | 15 | users, the "installation folder" is assumed to be a folder in the root (top- | |
27 | The process is different depending on your operating system, but before | 16 | level) of the C: drive called \fname{rockbox} (you will obviously need to |
28 | starting, connect the \dap{} to the computer using either an USB | 17 | create this folder yourself). For Mac OS X and Linux users, the ``installation |
29 | %\fixme{or Firewire?} % Firewire is currently not supported. | 18 | folder'' is assumed to be the Desktop folder. But you can use any folder |
30 | cable. Next, create a folder on the computer's hard drive and | 19 | you wish. Note that these files should be saved onto your computer's hard disk, |
31 | download the following file to that folder: | 20 | \emph{not} on your Ipod. |
32 | \opt{ipodvideo}{\url{http://download.rockbox.org/bootloader/ipod/bootloader-video.bin}} | 21 | |
33 | \opt{ipodnano}{\url{http://download.rockbox.org/bootloader/ipod/bootloader-nano.bin}} | 22 | \begin{enumerate} |
34 | \opt{ipodmini}{\url{http://download.rockbox.org/bootloader/ipod/bootloader-mini1g.bin} or | 23 | |
35 | \url{http://download.rockbox.org/bootloader/ipod/bootloader-mini2g.bin} depending on which | 24 | \item First, download the \fname{ipodpatcher} tool to your installation |
36 | generation your \dap{} is.\fixme{Describe how to identify 1/2G}} | 25 | folder. You can download the \fname{ipodpatcher} tool for your operating |
37 | \opt{ipodcolor}{\url{http://download.rockbox.org/bootloader/ipod/bootloader-color.bin}} | 26 | system at |
38 | \opt{ipod4g}{\url{http://download.rockbox.org/bootloader/ipod/bootloader-4g.bin}} | 27 | \url{http://www.rockbox.org/twiki/bin/view/Main/IpodInstallationBeta}. |
39 | \opt{ipod3g}{\url{http://download.rockbox.org/bootloader/ipod/bootloader-3g.bin}} | 28 | |
40 | 29 | \item Next, download the following file to the installation folder: | |
41 | When that is done, proceed to the section below that matches the operating | 30 | |
42 | system on the computer. | 31 | \opt{ipodvideo}{\url{http://download.rockbox.org/bootloader/ipod/bootloader- |
43 | \note{These instructions all require you to have administrator rights | 32 | video.ipod}} |
44 | on your computer, regardless of the operating system.} | 33 | \opt{ipodnano}{\url{http://download.rockbox.org/bootloader/ipod/bootloader- |
45 | \note{Rockbox only works on FAT32 partitions (called ``Windows formatted'' by | 34 | nano.ipod}} |
46 | Apple). So if your \dap{} is Mac formatted (HFS+), you should first convert | 35 | \opt{ipodmini}{\url{http://download.rockbox.org/bootloader/ipod/bootloader- |
47 | it to FAT32. Information on how to do this can be found on the Rockbox | 36 | mini1g.ipod} or \url{http://download.rockbox.org/bootloader/ipod/bootloader- |
48 | website. \fixme{Include these instructions?}} | 37 | mini2g.ipod} depending on which generation your \dap{} is. \fixme{Describe |
49 | 38 | how to identify 1/2G}} | |
50 | \subsubsection{Windows users} | 39 | \opt{ipodcolor}{\url{http://download.rockbox.org/bootloader/ipod/bootloader- |
51 | \begin{enumerate} | 40 | color.ipod}} |
52 | \item Download the following two programs and save them in the folder just | 41 | \opt{ipod4g}{\url{http://download.rockbox.org/bootloader/ipod/bootloader- |
53 | created. These programs will be used in the next steps: | 42 | 4g.ipod}} |
54 | \begin{itemize} | 43 | \opt{ipod3g}{\url{http://download.rockbox.org/bootloader/ipod/bootloader- |
55 | \item \url{http://download.rockbox.org/bootloader/ipod/ipodpatcher.exe} | 44 | 3g.ipod}} |
56 | \item \url{http://download.rockbox.org/bootloader/ipod/ipod_fw.exe} | 45 | |
57 | \end{itemize} | 46 | \item Next, open a command prompt (Windows) or terminal window (Mac OSX and Linux). |
58 | \item Locate the \dap{} by opening a command window. You can do this by | 47 | |
59 | clicking ``Start'', ``Run'' and typing \fname{cmd}. Press Enter to | 48 | Windows users will perform this and the following steps from the Windows |
60 | execute that command. Now change directory to the | 49 | command prompt. Start a command prompt and navigate to the isntallation |
61 | folder you created and run the following commands: | 50 | directory. |
62 | \begin{code} | 51 | |
63 | ipodpatcher 0 | 52 | Mac OS X and Linux/Unix users will perform these steps from the Terminal. |
64 | ipodpatcher 1 | 53 | Start a new terminal window and navigate to the Desktop folder (type cd |
65 | ipodpatcher 2 | 54 | Desktop into the terminal and press enter). You then need to ensure that the |
66 | ipodpatcher 3 | 55 | ipodpatcher program is ``executable'' by typing the command chmod +x |
67 | \end{code} | 56 | ipodpatcher and then pressing enter. |
68 | Keep increasing the number until the \dap{} is located. | 57 | |
69 | 58 | \item Connect your ipod to your computer. | |
70 | The output for an unsuccessful attempt to contact the \dap{} looks like | 59 | |
71 | this: | 60 | If you haven't already done so, you should now plug your iPod into your |
72 | \begin{code} | 61 | computer (via either the USB or Firewire cable). |
73 | C:\textbackslash{}rockbox>ipodpatcher 0 | 62 | |
74 | ipodpatcher v0.3 - (C) Dave Chapman 2006 | 63 | \fixme{Notes about closing itunes, enabling the ``show ipod as disk'' option |
75 | This is free software; see the source for copying conditions. There is NO | 64 | in ipod, anything else?} |
76 | warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | 65 | |
77 | 66 | \item Find your ipod with ipodpatcher (Windows users only) | |
78 | [INFO] Reading partition table from \textbackslash\textbackslash{}.\textbackslash{}PhysicalDrive0 | 67 | |
79 | Drive is not an iPod, aborting | 68 | Windows users: Type the following command to search for ipods attached to |
80 | \end{code} | 69 | your computer: |
81 | 70 | \begin{code} | |
82 | A successful connection to the \dap{} will look similar to this... | 71 | ipodpatcher \-\-scan |
83 | \begin{code} | 72 | \end{code} |
84 | C:\textbackslash{}rockbox>ipodpatcher 6 | 73 | |
85 | ipodpatcher v0.3 - (C) Dave Chapman 2006 | 74 | When ipodpatcher finds your ipod, remember the number it displays - this |
86 | This is free software; see the source for copying conditions. There is NO | 75 | will be the number you use to access your ipod in the following steps. |
87 | warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | 76 | |
88 | 77 | \note{Windows users require administrator rights for running ipodpatcher. | |
89 | [INFO] Reading partition table from \textbackslash\textbackslash{}.\textbackslash{}PhysicalDrive6 | 78 | Either re-login as administrator, or open a command prompt running under an |
90 | Part Start Sector End Sector Size (MB) Type | 79 | administrator account by using one of the "Run as" features of Windows XP.} |
91 | 0 63 160649 78.4 Empty (0x00) | 80 | |
92 | 1 160650 7984304 3820.1 W95 FAT32 (0x0b) | 81 | \item Find your ipod (Mac OS X users only) |
93 | \end{code} | 82 | |
94 | Remember the number that corresponds to your \dap{} -- in the | 83 | Attach your iPod to your Mac (using either USB or Firewire) and wait for |
95 | following steps, \emph{N} should be replaced with the number just found. | 84 | iTunes to open. When iTunes opens, close it down. In your Terminal window, |
96 | \item Now, extract the firmware partition currently on the \dap{} with the | 85 | type the command mount and press enter. This will list all the disks (and |
97 | following command: | 86 | other devices) that are "mounted" on your computer. The last drive in the |
98 | \begin{code} | 87 | list should be your iPod. For example: |
99 | ipodpatcher -r \emph{N} bootpartition.bin | 88 | \begin{code} |
100 | \end{code} | 89 | /dev/disk1s2 on /Volumes/DAVE_S IPOD 1 (local, nodev, nosuid) |
101 | \note{You should keep a safe backup of this \fname{bootpartition.bin} file | 90 | \end{code} |
102 | for use if you ever wish to either upgrade the Rockbox boot loader or | 91 | |
103 | uninstall Rockbox from your Ipod} | 92 | In order to install the ipod bootloader, you need to "unmount" this disk |
104 | \item Extract the Apple firmware from the partition image image just created: | 93 | using the following command: |
105 | \begin{code} | 94 | \begin{code} |
106 | ipod_fw -o apple_os.bin -e 0 bootpartition.bin | 95 | diskutil unmount /dev/disk1s2 |
107 | \end{code} | 96 | \end{code} |
108 | \opt{ipodnano}{\note{The following step is only necessary if your Apple | 97 | |
109 | firmware has version 1.2 or later. If this doesn't apply to you, simply | 98 | replacing ``/dev/disk1s2'' with the device name Mac OS has assigned to your |
110 | skip it.}} | 99 | ipod. This may take a few seconds, after which Mac OS will say ``Volume |
111 | \optv{ipodvideo,ipodnano}{ | 100 | /dev/disk1s2 unmounted.'' ``/dev/disk1s2'' refers to the second partition on |
112 | \item | 101 | /dev/disk1 - remember ``/dev/disk1'' for the next step. |
113 | Similarly, extract the Broadcom firmware: | 102 | |
114 | \begin{code} | 103 | It's possible that itunes will try to be ``helpful'' and remount your ipod |
115 | ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin | 104 | after you modify it with ipodpatcher. If this happens, you need to unmount |
116 | \end{code} | 105 | it again using the above command. |
117 | } | 106 | |
118 | \item Merge the Rockbox boot loader you downloaded previously with the Apple | 107 | \item Create a backup of your ipod's firmware partition |
119 | firm\-ware.% | 108 | |
120 | \optv{ipodnano}{ | 109 | Type the following command, replacing "[device]" with the number (for |
121 | If your firmware version is lower than 1.2 this works you need | 110 | Windows users) or the device name (Mac OS X and Unix users) assigned to |
122 | this command: | 111 | your ipod that you found in the previous step: |
123 | \begin{code} | 112 | \begin{code} |
124 | ipod_fw -g nano -o rockboot.bin -i apple_os.bin bootloader-nano.bin | 113 | ipodpatcher [device] -r bootpartition.bin (Windows) |
125 | \end{code} | 114 | \end{code} |
126 | If your firmware version is 1.2 or later you need to use the following | 115 | |
127 | command instead. Please note that the ``video'' is correct. | 116 | or |
128 | \begin{code} | 117 | |
129 | ipod_fw -g video -o rockboot.bin -i apple_os.bin bootloader-nano.bin | 118 | \begin{code} |
130 | \end{code} | 119 | ./ipodpatcher [device] -r bootpartition.bin (Mac OS X/Unix) |
131 | } | 120 | \end{code} |
132 | \optv{ipodvideo}{ | 121 | |
133 | \begin{code} | 122 | This should create a file in the current folder called bootpartition.bin |
134 | ipod_fw -g video -o rockboot.bin -i apple_os.bin bootloader-video.bin | 123 | (approximately 40MB for the iPod 3G, 4G and Color/Photo, 80MB for the Nano |
135 | \end{code} | 124 | 1st gen and 30GB Video, and 112MB for the 60GB Video) containing a copy of |
136 | } | 125 | the ``firmware partition'' from your iPod. |
137 | \optv{ipodmini}{ | 126 | |
138 | \begin{code} | 127 | If it ever becomes necessary (i.e. your ipod refuses to start), you can |
139 | ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini1g.bin | 128 | restore this backup to your ipod using the command ipodpatcher [device] -w |
140 | \end{code} | 129 | bootpartition.bin (Windows) or ./ipodpatcher [device] -w bootpartition.bin |
141 | Or, if you have a 2G mini: | 130 | (Mac OS X/Unix). |
142 | \begin{code} | 131 | |
143 | ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini2g.bin | 132 | \item Install the bootloader. |
144 | \end{code} | 133 | |
145 | } | 134 | Windows users should now type: |
146 | \optv{ipodcolor}{ | 135 | \begin{code} |
147 | \begin{code} | 136 | ipodpatcher [device] -a |
148 | ipod_fw -g color -o rockboot.bin -i apple_os.bin bootloader-color.bin | 137 | \opt{ipodvideo}{bootloader-video.ipod} |
149 | \end{code} | 138 | \opt{ipodnano}{bootloader-nano.ipod} |
150 | } | 139 | \opt{ipodmini}{bootloader-mini1g.ipod |
151 | \optv{ipod4g}{ | 140 | \end{code} |
152 | \begin{code} | 141 | or |
153 | ipod_fw -g 4g -o rockboot.bin -i apple_os.bin bootloader-4g.bin | 142 | \begin{code} |
154 | \end{code} | 143 | ipodpatcher [device] -a bootloader-mini2g.ipod |
155 | } | 144 | } |
156 | \optv{ipod3g}{ | 145 | \opt{ipodcolor}{bootloader-color.ipod} |
157 | \begin{code} | 146 | \opt{ipod4g}{bootloader-4g.ipod} |
158 | ipod_fw -g 3g -o rockboot.bin -i apple_os.bin bootloader-3g.bin | 147 | \opt{ipod3g}{bootloader-3g.ipod} |
159 | \end{code} | 148 | \end{code} |
160 | } | 149 | |
161 | \item | 150 | and Mac OS X/Unix users should type: |
162 | Install the Rockbox-enabled firmware: | 151 | \begin{code} |
163 | \begin{code} | 152 | ./ipodpatcher [device] -a |
164 | ipodpatcher -w \emph{N} rockboot.bin | 153 | \opt{ipodvideo}{bootloader-video.ipod} |
165 | \end{code} | 154 | \opt{ipodnano}{bootloader-nano.ipod} |
166 | \end{enumerate} | 155 | \opt{ipodmini}{bootloader-mini1g.ipod |
167 | 156 | \end{code} | |
168 | Now you can proceed installing the firmware itself. | 157 | or |
169 | 158 | \begin{code} | |
170 | \subsubsection{Mac OS X users} | 159 | or ipodpatcher [device] -a bootloader-mini2g.ipod |
171 | \begin{enumerate} | 160 | } |
172 | \item Download the following two programs and save them in the folder just | 161 | \opt{ipodcolor}{bootloader-color.ipod} |
173 | created. These programs will be used in the next steps: | 162 | \opt{ipod4g}{bootloader-4g.ipod} |
174 | \begin{itemize} | 163 | \opt{ipod3g}{bootloader-3g.ipod} |
175 | \item \url{http://download.rockbox.org/bootloader/ipod/diskdump} | 164 | \end{code} |
176 | \item \url{http://download.rockbox.org/bootloader/ipod/ipod_fw} | 165 | |
177 | \end{itemize} | 166 | Replace [device] with the number (Windows users) or device name (Mac OS X/Unix |
178 | Start a Terminal and type navigate into the folder you created. Before | 167 | users) you've been using to access your ipod. |
179 | you can continue, you need to ensure that Mac OS knows that the | 168 | |
180 | \fname{ipod\_fw} | 169 | You can now disconnect your ipod from your computer in the normal way. This |
181 | and diskdump files you downloaded are executable programs. To do this, | 170 | should cause your iPod to reboot and start Rockbox. |
182 | type the following command: | 171 | |
183 | \begin{code} | 172 | \item Troubleshooting. |
184 | chmod +x ipod_fw diskdump | 173 | |
185 | \end{code} | 174 | \fixme{Add some notes here about common problems - "rockbox error -1" is the |
186 | \item Locate the \dap{} by running the following command: | 175 | main one. Or maybe have a new troubleshooting page.} |
187 | \begin{code} | 176 | |
188 | mount | 177 | \end{enumerate} \ No newline at end of file |
189 | \end{code} | ||
190 | The output will look something like this: \fixme{Add full example} | ||
191 | \begin{code} | ||
192 | /dev/disk1s2 on /Volumes/DAVE_S IPOD 1 (local, nodev, nosuid) | ||
193 | \end{code} | ||
194 | In this example, the \dap\ is located at /dev/disk1s2 Remember the | ||
195 | location of your \dap\ -- in the following steps, /dev/disk1s2 should be | ||
196 | replaced with the location just found. | ||
197 | \item Before continuing, the \dap\ must be ``unmounted'', which is | ||
198 | done with the following command: | ||
199 | \begin{code} | ||
200 | diskutil unmount /dev/disk1s2 | ||
201 | \end{code} | ||
202 | \item Now, extract the Apple firmware currently on the \dap{} with the | ||
203 | following command: | ||
204 | \note{The last part of the location is left out.} | ||
205 | \begin{code} | ||
206 | ./diskdump -r /dev/disk1 bootpartition.bin | ||
207 | \end{code} | ||
208 | \note{You should keep a safe backup of this \fname{bootpartition.bin} file | ||
209 | for use if you ever wish to either upgrade the Rockbox bootloader or | ||
210 | uninstall Rockbox from your iPod | ||
211 | } | ||
212 | \item Extract the Apple firmware from this partition image: | ||
213 | \begin{code} | ||
214 | ./ipod_fw -o apple_os.bin -e 0 bootpartition.bin | ||
215 | \end{code} | ||
216 | \opt{ipodnano}{\note{The following step is only necessary if your Apple | ||
217 | firmware has version 1.2 or later. If this doesn't apply to you, simply | ||
218 | skip it.}} | ||
219 | \optv{ipodvideo,ipodnano}{ | ||
220 | \item | ||
221 | Similarly, extract the Broadcom firmware: | ||
222 | \begin{code} | ||
223 | ./ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin | ||
224 | \end{code} | ||
225 | } | ||
226 | \item Merge the Rockbox bootloader you downloaded previously with the Apple | ||
227 | firm\-ware.% | ||
228 | \optv{ipodnano}{ | ||
229 | If your firmware version is lower than 1.2 this works you need | ||
230 | this command: | ||
231 | \begin{code} | ||
232 | ./ipod_fw -g nano -o rockboot.bin -i apple_os.bin bootloader-nano.bin | ||
233 | \end{code} | ||
234 | If your firmware version is 1.2 or later you need to use the following | ||
235 | command instead. Please note that the ``video'' is correct. | ||
236 | \begin{code} | ||
237 | ./ipod_fw -g video -o rockboot.bin -i apple_os.bin bootloader-nano.bin | ||
238 | \end{code} | ||
239 | } | ||
240 | \optv{ipodvideo}{ | ||
241 | \begin{code} | ||
242 | ./ipod_fw -g video -o rockboot.bin -i apple_os.bin bootloader-video.bin | ||
243 | \end{code} | ||
244 | } | ||
245 | \optv{ipodmini}{ | ||
246 | \begin{code} | ||
247 | ./ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini1g.bin | ||
248 | \end{code} | ||
249 | Or, if you have a 2G Mini: | ||
250 | \begin{code} | ||
251 | ./ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini2g.bin | ||
252 | \end{code} | ||
253 | } | ||
254 | \optv{ipodcolor}{ | ||
255 | \begin{code} | ||
256 | ./ipod_fw -g color -o rockboot.bin -i apple_os.bin bootloader-color.bin | ||
257 | \end{code} | ||
258 | } | ||
259 | \optv{ipod4g}{ | ||
260 | \begin{code} | ||
261 | ./ipod_fw -g 4g -o rockboot.bin -i apple_os.bin bootloader-4g.bin | ||
262 | \end{code} | ||
263 | } | ||
264 | \optv{ipod3g}{ | ||
265 | \begin{code} | ||
266 | ./ipod_fw -g 3g -o rockboot.bin -i apple_os.bin bootloader-3g.bin | ||
267 | \end{code} | ||
268 | } | ||
269 | \item | ||
270 | Install the Rockbox-enabled firmware: | ||
271 | \note{The last part of the location is left out.} | ||
272 | \begin{code} | ||
273 | ./diskdump -w /dev/disk1 rockboot.bin | ||
274 | \end{code} | ||
275 | \end{enumerate} | ||
276 | |||
277 | Now, proceed with installing the firmware itself. | ||
278 | |||
279 | \subsubsection{Linux users} | ||
280 | \begin{enumerate} | ||
281 | \item Download the following and save it in the folder just | ||
282 | created: | ||
283 | \begin{itemize} | ||
284 | \item \url{http://www.rockbox.org/viewcvs.cgi/*checkout*/tools/ipod_fw.c} | ||
285 | \end{itemize} | ||
286 | Now compile it to an executable by opening a command prompt and changing | ||
287 | to the folder created previously. Then run the following command: | ||
288 | \begin{code} | ||
289 | gcc -o ipod_fw ipod_fw.c | ||
290 | \end{code} | ||
291 | If you get the message that the command gcc is not found, you need to | ||
292 | install gcc. How to do this depends on your Linux distribution, and | ||
293 | you should consult its documentation for help on this. | ||
294 | \item Locate your Ipod by running the command \verb|dmesg|. In the output | ||
295 | something like the following should be seen: | ||
296 | \begin{code} | ||
297 | usb 4-1: new high speed USB device using ehci_hcd and address 7 | ||
298 | scsi4 : SCSI emulation for USB Mass Storage devices | ||
299 | usb-storage: device found at 7 | ||
300 | usb-storage: waiting for device to settle before scanning | ||
301 | Vendor: Apple Model: iPod Rev: 1.62 | ||
302 | Type: Direct-Access ANSI SCSI revision: 00 | ||
303 | SCSI device sdb: 58605120 512-byte hdwr sectors (30006 MB) | ||
304 | \end{code} | ||
305 | You need the device name of your \dap, which you can find in the last line. | ||
306 | In this example, the \dap\ is located on \fname{/dev/sdb}. In the following, | ||
307 | \fname{/dev/sdb} should be replaced with the location just found. | ||
308 | \item Run \verb|fdisk -l /dev/sdb|. Verify that the | ||
309 | output is similar to the one below: | ||
310 | \begin{code} | ||
311 | Device Boot Start End Blocks Id System | ||
312 | /dev/sdb1 1 10 80293+ 0 Empty | ||
313 | /dev/sdb2 11 3648 29222235 b W95 FAT32 | ||
314 | \end{code} | ||
315 | \item Back up the partition table using the following command: | ||
316 | \note{The last part of the location is left out.} | ||
317 | \begin{code} | ||
318 | dd if=/dev/\emph{sdb} of=mbr.bin count=1 | ||
319 | \end{code} | ||
320 | |||
321 | \item Now, extract the firmware partition currently on the \dap{} with the | ||
322 | following command: | ||
323 | \begin{code} | ||
324 | dd if=/dev/\emph{sdb1} of=bootpartition.bin | ||
325 | \end{code} | ||
326 | \note{You should keep a safe backup of this \fname{bootpartition.bin} file | ||
327 | for use if you ever wish to either upgrade the Rockbox bootloader or | ||
328 | uninstall Rockbox from your Ipod | ||
329 | } | ||
330 | \item Extract the Apple firmware from this partition image: | ||
331 | \begin{code} | ||
332 | ./ipod_fw -o apple_os.bin -e 0 bootpartition.bin | ||
333 | \end{code} | ||
334 | \opt{ipodnano}{\note{The following step is only necessary if your Apple | ||
335 | firmware has version 1.2 or later. If this doesn't apply to you, simply | ||
336 | skip it.}} | ||
337 | \optv{ipodvideo,ipodnano}{ | ||
338 | \item | ||
339 | Similarly, extract the Broadcom firmware: | ||
340 | \begin{code} | ||
341 | ./ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin | ||
342 | \end{code} | ||
343 | } | ||
344 | |||
345 | \item Merge the Rockbox bootloader you downloaded previously with the Apple | ||
346 | firm\-ware.% | ||
347 | \optv{ipodnano}{ | ||
348 | If your firmware version is lower than 1.2 this works you need | ||
349 | this command: | ||
350 | \begin{code} | ||
351 | ./ipod_fw -g nano -o rockboot.bin -i apple_os.bin bootloader-nano.bin | ||
352 | \end{code} | ||
353 | If your firmware version is 1.2 or later you need to use the following | ||
354 | command instead. Please note that the ``video'' is correct. | ||
355 | \begin{code} | ||
356 | ./ipod_fw -g video -o rockboot.bin -i apple_os.bin bootloader-nano.bin | ||
357 | \end{code} | ||
358 | |||
359 | } | ||
360 | \optv{ipodvideo}{ | ||
361 | \begin{code} | ||
362 | ./ipod_fw -g video -o rockboot.bin -i apple_os.bin bootloader-video.bin | ||
363 | \end{code} | ||
364 | } | ||
365 | \optv{ipodmini}{ | ||
366 | \begin{code} | ||
367 | ./ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini1g.bin | ||
368 | \end{code} | ||
369 | Or, if you have a 2G Mini: | ||
370 | \begin{code} | ||
371 | ./ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini2g.bin | ||
372 | \end{code} | ||
373 | } | ||
374 | \optv{ipodcolor}{ | ||
375 | \begin{code} | ||
376 | ./ipod_fw -g color -o rockboot.bin -i apple_os.bin bootloader-color.bin | ||
377 | \end{code} | ||
378 | } | ||
379 | \optv{ipod4g}{ | ||
380 | \begin{code} | ||
381 | ./ipod_fw -g 4g -o rockboot.bin -i apple_os.bin bootloader-4g.bin | ||
382 | \end{code} | ||
383 | } | ||
384 | \item | ||
385 | Install the Rockbox-enabled firmware: | ||
386 | \begin{code} | ||
387 | dd if=rockboot.bin of=/dev/\emph{sdb1} | ||
388 | \end{code} | ||
389 | \end{enumerate} | ||
390 | Now you can install the firmware itself. | ||
391 | |||