diff options
Diffstat (limited to 'manual/getting_started')
-rwxr-xr-x | manual/getting_started/ipod_install.tex | 61 |
1 files changed, 33 insertions, 28 deletions
diff --git a/manual/getting_started/ipod_install.tex b/manual/getting_started/ipod_install.tex index 9de982c834..32b9794b38 100755 --- a/manual/getting_started/ipod_install.tex +++ b/manual/getting_started/ipod_install.tex | |||
@@ -1,21 +1,25 @@ | |||
1 | % $Id$ % | ||
1 | \subsection{Installing the bootloader} | 2 | \subsection{Installing the bootloader} |
3 | \warn{These instructions are preliminary! Please check the wiki for up-to-date | ||
4 | and improved installation instructions!} | ||
5 | |||
2 | Installing the bootloader is the trickiest part of the installation. | 6 | Installing the bootloader is the trickiest part of the installation. |
3 | The process is different depending on your operating system, but before | 7 | The process is different depending on your operating system, but before |
4 | starting, connect the \dap\ to the computer using either an USB \fixme{or | 8 | starting, connect the \dap\ to the computer using either an USB \fixme{or |
5 | Firewire?} cable. Next, create a folder on the computer's harddrive and | 9 | Firewire?} cable. Next, create a folder on the computer's harddrive and |
6 | download the following file to that folder: | 10 | download the following file to that folder: |
7 | \opt{ipodvideo}{\url{http://www.rockbox.org/twiki/pub/Main/IpodInstallation/bootloader-video.bin}} | 11 | \opt{ipodvideo}{\wikilink{IpodInstallation/bootloader-video.bin}} |
8 | \opt{ipodnano}{\url{http://www.rockbox.org/twiki/pub/Main/IpodInstallation/bootloader-nano.bin}} | 12 | \opt{ipodnano}{\wikilink{IpodInstallation/bootloader-nano.bin}} |
9 | \opt{ipodmini}{\url{http://www.rockbox.org/twiki/pub/Main/IpodInstallation/bootloader-mini1g.bin} or \url{http://www.rockbox.org/twiki/pub/Main/IpodInstallation/bootloader-mini1g.bin} depending on which generation your \dap\ is.\fixme{Describe how to identify 1/2G}} | 13 | \opt{ipodmini}{\wikilink{IpodInstallation/bootloader-mini1g.bin} or |
10 | \opt{ipodcolor}{\url{http://www.rockbox.org/twiki/pub/Main/IpodInstallation/bootloader-color.bin}} | 14 | \wikilink{IpodInstallation/bootloader-mini1g.bin} depending on which |
11 | \opt{ipod4g}{\url{http://www.rockbox.org/twiki/pub/Main/IpodInstallation/bootloader-4g.bin}} | 15 | generation your \dap\ is.\fixme{Describe how to identify 1/2G}} |
16 | \opt{ipodcolor}{\wikilink{IpodInstallation/bootloader-color.bin}} | ||
17 | \opt{ipod4g}{\wikilink{IpodInstallation/bootloader-4g.bin}} | ||
12 | 18 | ||
13 | When that is done, proceed to the section below that matches the operating | 19 | When that is done, proceed to the section below that matches the operating |
14 | system on the computer. | 20 | system on the computer. |
15 | |||
16 | \note{These instructions all require you to have administrator rights | 21 | \note{These instructions all require you to have administrator rights |
17 | on your computer, regardless of the operating system.} | 22 | on your computer, regardless of the operating system.} |
18 | |||
19 | \note{Rockbox only works on FAT32 partitions (called Windows formatted by | 23 | \note{Rockbox only works on FAT32 partitions (called Windows formatted by |
20 | Apple). So if your \dap\ is Mac formatted (HFS+), you should first convert | 24 | Apple). So if your \dap\ is Mac formatted (HFS+), you should first convert |
21 | it to FAT32. Information on how to do this can be found on the Rockbox | 25 | it to FAT32. Information on how to do this can be found on the Rockbox |
@@ -26,12 +30,9 @@ | |||
26 | \item Download the following two programs and save them in the folder just | 30 | \item Download the following two programs and save them in the folder just |
27 | created. These programs will be used in the next steps: | 31 | created. These programs will be used in the next steps: |
28 | \begin{itemize} | 32 | \begin{itemize} |
29 | \item \url{http://www.rockbox.org/twiki/pub/Main/IpodInstallation/ipodpatcher.exe} | 33 | \item \wikilink{IpodInstallation/ipodpatcher.exe} |
30 | \item \url{http://www.rockbox.org/twiki/pub/Main/IpodInstallation/ipod_fw.exe} | 34 | \item \wikilink{IpodInstallation/ipod_fw.exe} |
31 | \end{itemize} | 35 | \end{itemize} |
32 | \fixme{Is this needed?} | ||
33 | These two programs are both licensed under the GPL, just like Rockbox | ||
34 | itself. The source can be downloaded from the Rockbox website. | ||
35 | \item Locate the \dap\ by opening a commandprompt, change directory to the | 36 | \item Locate the \dap\ by opening a commandprompt, change directory to the |
36 | folder you created and run the following commands: | 37 | folder you created and run the following commands: |
37 | \begin{verbatim} | 38 | \begin{verbatim} |
@@ -58,10 +59,10 @@ | |||
58 | ipodpatcher -r N bootpartition.bin | 59 | ipodpatcher -r N bootpartition.bin |
59 | \end{verbatim} | 60 | \end{verbatim} |
60 | \opt{ipodvideo}{ | 61 | \opt{ipodvideo}{ |
61 | \item Similarly, extract the Broadcom firmware: \fixme{Formatting broken. Let's cause a break.} | 62 | \item Similarly, extract the Broadcom firmware: |
63 | \fixme{Formatting broken. Let's cause a break.} | ||
62 | } | 64 | } |
63 | \optv{ipodvideo}{\verb|ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin|} | 65 | \optv{ipodvideo}{\verb|ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin|} |
64 | |||
65 | \begin{verbatim} | 66 | \begin{verbatim} |
66 | ipod_fw -g GEN -o rockboot.bin -i apple_os.bin bootloader-GEN.bin | 67 | ipod_fw -g GEN -o rockboot.bin -i apple_os.bin bootloader-GEN.bin |
67 | \end{verbatim} | 68 | \end{verbatim} |
@@ -72,21 +73,19 @@ | |||
72 | \end{verbatim} | 73 | \end{verbatim} |
73 | \end{enumerate} | 74 | \end{enumerate} |
74 | 75 | ||
75 | Now, proceed to \fixme{insert ref?} Installing the firmware. | 76 | Now you can proceed installing the firmware itself. |
76 | 77 | ||
77 | \subsubsection{Mac OS X users} | 78 | \subsubsection{Mac OS X users} |
78 | \begin{enumerate} | 79 | \begin{enumerate} |
79 | \item Download the following two programs and save them in the folder just | 80 | \item Download the following two programs and save them in the folder just |
80 | created. These programs will be used in the next steps: | 81 | created. These programs will be used in the next steps: |
81 | \begin{itemize} | 82 | \begin{itemize} |
82 | \item \url{http://www.rockbox.org/twiki/pub/Main/IpodInstallationFromMacOSX/diskdump} | 83 | \item \wikilink{IpodInstallationFromMacOSX/diskdump} |
83 | \item \url{http://www.rockbox.org/twiki/pub/Main/IpodInstallationFromMacOSX/ipod_fw} | 84 | \item \wikilink{IpodInstallationFromMacOSX/ipod_fw} |
84 | \end{itemize} | 85 | \end{itemize} |
85 | Start a Terminal and type navigate into the folder you created. Before | 86 | Start a Terminal and type navigate into the folder you created. Before |
86 | you can continue, you need to ensure that Mac OS knows that the | 87 | you can continue, you need to ensure that Mac OS knows that the |
87 | \begin{verbatim} | 88 | \fname{ipod\_fw} |
88 | ipod_fw | ||
89 | \end{verbatim} | ||
90 | and diskdump files you downloaded are executable programs. To do this, | 89 | and diskdump files you downloaded are executable programs. To do this, |
91 | type the following command: | 90 | type the following command: |
92 | \begin{verbatim} | 91 | \begin{verbatim} |
@@ -117,7 +116,8 @@ Now, proceed to \fixme{insert ref?} Installing the firmware. | |||
117 | \begin{verbatim} | 116 | \begin{verbatim} |
118 | ./diskdump -r /dev/disk1 bootpartition.bin | 117 | ./diskdump -r /dev/disk1 bootpartition.bin |
119 | \end{verbatim} | 118 | \end{verbatim} |
120 | \note{You should keep a safe backup of this \fname{bootpartition.bin} file for use if you ever wish to either upgrade the Rockbox bootloader or | 119 | \note{You should keep a safe backup of this \fname{bootpartition.bin} file |
120 | for use if you ever wish to either upgrade the Rockbox bootloader or | ||
121 | uninstall Rockbox from your iPod | 121 | uninstall Rockbox from your iPod |
122 | } | 122 | } |
123 | \item Extract the Apple firmware from this partition image: | 123 | \item Extract the Apple firmware from this partition image: |
@@ -125,12 +125,14 @@ Now, proceed to \fixme{insert ref?} Installing the firmware. | |||
125 | ./ipod_fw -o apple_os.bin -e 0 bootpartition.bin | 125 | ./ipod_fw -o apple_os.bin -e 0 bootpartition.bin |
126 | \end{verbatim} | 126 | \end{verbatim} |
127 | \opt{ipodvideo}{ | 127 | \opt{ipodvideo}{ |
128 | \item Similarly, extract the Broadcom firmware: \fixme{Formatting broken. Let's cause a break.} | 128 | \item Similarly, extract the Broadcom firmware: |
129 | \fixme{Formatting broken. Let's cause a break.} | ||
129 | } | 130 | } |
130 | \optv{ipodvideo}{\verb|./ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin|} | 131 | \optv{ipodvideo}{\verb|./ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin|} |
131 | 132 | ||
132 | \item Merge the Rockbox bootloader you downloaded previously with the Apple | 133 | \item Merge the Rockbox bootloader you downloaded previously with the Apple |
133 | firmware \fixme{Substitute GEN with your \daps\ generation: color,video,nano,4g,mini1g,mini2g}: | 134 | firmware \fixme{Substitute GEN with your \daps\ generation: |
135 | color,video,nano,4g,mini1g,mini2g}: | ||
134 | \begin{verbatim} | 136 | \begin{verbatim} |
135 | ./ipod_fw -g GEN -o rockbox.bin -i apple_os.bin bootloader-GEN.bin | 137 | ./ipod_fw -g GEN -o rockbox.bin -i apple_os.bin bootloader-GEN.bin |
136 | \end{verbatim} | 138 | \end{verbatim} |
@@ -142,7 +144,7 @@ Now, proceed to \fixme{insert ref?} Installing the firmware. | |||
142 | \end{verbatim} | 144 | \end{verbatim} |
143 | \end{enumerate} | 145 | \end{enumerate} |
144 | 146 | ||
145 | Now, proceed to \fixme{insert ref?} Installing the firmware. | 147 | Now, proceed with installing the firmware itself. |
146 | 148 | ||
147 | \subsubsection{Linux users} | 149 | \subsubsection{Linux users} |
148 | \begin{enumerate} | 150 | \begin{enumerate} |
@@ -195,7 +197,8 @@ Device Boot Start End Blocks Id System | |||
195 | \begin{verbatim} | 197 | \begin{verbatim} |
196 | dd if=/dev/sdb1 of=bootpartition.bin | 198 | dd if=/dev/sdb1 of=bootpartition.bin |
197 | \end{verbatim} | 199 | \end{verbatim} |
198 | \note{You should keep a safe backup of this \fname{bootpartition.bin} file for use if you ever wish to either upgrade the Rockbox bootloader or | 200 | \note{You should keep a safe backup of this \fname{bootpartition.bin} file |
201 | for use if you ever wish to either upgrade the Rockbox bootloader or | ||
199 | uninstall Rockbox from your iPod | 202 | uninstall Rockbox from your iPod |
200 | } | 203 | } |
201 | \item Extract the Apple firmware from this partition image: | 204 | \item Extract the Apple firmware from this partition image: |
@@ -203,12 +206,14 @@ Device Boot Start End Blocks Id System | |||
203 | ./ipod_fw -o apple_os.bin -e 0 bootpartition.bin | 206 | ./ipod_fw -o apple_os.bin -e 0 bootpartition.bin |
204 | \end{verbatim} | 207 | \end{verbatim} |
205 | \opt{ipodvideo}{ | 208 | \opt{ipodvideo}{ |
206 | \item Similarly, extract the Broadcom firmware: \fixme{Formatting broken. Let's cause a break.} | 209 | \item Similarly, extract the Broadcom firmware: |
210 | \fixme{Formatting broken. Let's cause a break.} | ||
207 | } | 211 | } |
208 | \optv{ipodvideo}{\verb|./ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin|} | 212 | \optv{ipodvideo}{\verb|./ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin|} |
209 | 213 | ||
210 | \item Merge the Rockbox bootloader you downloaded previously with the Apple | 214 | \item Merge the Rockbox bootloader you downloaded previously with the Apple |
211 | firmware \fixme{Substitute GEN with your \daps\ generation: color,video,nano,4g,mini1g,mini2g}: | 215 | firmware \fixme{Substitute GEN with your \daps\ generation: |
216 | color,video,nano,4g,mini1g,mini2g}: | ||
212 | \begin{verbatim} | 217 | \begin{verbatim} |
213 | ./ipod_fw -g GEN -o rockbox.bin -i apple_os.bin bootloader-GEN.bin | 218 | ./ipod_fw -g GEN -o rockbox.bin -i apple_os.bin bootloader-GEN.bin |
214 | \end{verbatim} | 219 | \end{verbatim} |
@@ -218,5 +223,5 @@ Device Boot Start End Blocks Id System | |||
218 | dd if=rockboot.bin of=/dev/sdb1 | 223 | dd if=rockboot.bin of=/dev/sdb1 |
219 | \end{verbatim} | 224 | \end{verbatim} |
220 | \end{enumerate} | 225 | \end{enumerate} |
226 | Now you can install the firmware itself. | ||
221 | 227 | ||
222 | Now, proceed to \fixme{insert ref?} Installing the firmware. | ||