8c9e22580e
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@10079 a1c6a512-1295-4272-9138-f99709370657
302 lines
11 KiB
TeX
Executable file
302 lines
11 KiB
TeX
Executable file
% $Id$ %
|
|
\subsection{Installing the bootloader}
|
|
\warn{These instructions are preliminary and may contain errors!
|
|
Please check the wiki for up-to-date and improved installation instructions!
|
|
If you find errors you're of course welcomed to report them so we can fix it
|
|
for the next daily builds.}
|
|
|
|
Installing the bootloader is the trickiest part of the installation.
|
|
The process is different depending on your operating system, but before
|
|
starting, connect the \dap{} to the computer using either an USB \fixme{or
|
|
Firewire?} cable. Next, create a folder on the computer's harddrive and
|
|
download the following file to that folder:
|
|
\opt{ipodvideo}{\wikilink{IpodInstallation/bootloader-video.bin}}
|
|
\opt{ipodnano}{\wikilink{IpodInstallation/bootloader-nano.bin}}
|
|
\opt{ipodmini}{\wikilink{IpodInstallation/bootloader-mini1g.bin} or
|
|
\wikilink{IpodInstallation/bootloader-mini1g.bin} depending on which
|
|
generation your \dap{} is.\fixme{Describe how to identify 1/2G}}
|
|
\opt{ipodcolor}{\wikilink{IpodInstallation/bootloader-color.bin}}
|
|
\opt{ipod4g}{\wikilink{IpodInstallation/bootloader-4g.bin}}
|
|
|
|
When that is done, proceed to the section below that matches the operating
|
|
system on the computer.
|
|
\note{These instructions all require you to have administrator rights
|
|
on your computer, regardless of the operating system.}
|
|
\note{Rockbox only works on FAT32 partitions (called ``Windows formatted'' by
|
|
Apple). So if your \dap{} is Mac formatted (HFS+), you should first convert
|
|
it to FAT32. Information on how to do this can be found on the Rockbox
|
|
website. \fixme{Include these instructions?}}
|
|
|
|
\subsubsection{Windows users}
|
|
\begin{enumerate}
|
|
\item Download the following two programs and save them in the folder just
|
|
created. These programs will be used in the next steps:
|
|
\begin{itemize}
|
|
\item \wikilink{IpodInstallation/ipodpatcher.exe}
|
|
\item \wikilink{IpodInstallation/ipod_fw.exe}
|
|
\end{itemize}
|
|
\item Locate the \dap{} by opening a command windows. You can do this by
|
|
clicking ``Start'', ``Execute'' and typing \fname{cmd}. Press Enter to
|
|
execute that command. Now change directory to the
|
|
folder you created and run the following commands:
|
|
\begin{code}
|
|
ipodpatcher 0
|
|
ipodpatcher 1
|
|
ipodpatcher 2
|
|
ipodpatcher 3
|
|
\end{code}
|
|
Keep increasing the number until the \dap{} is located. \fixme{What is the
|
|
output?} Remember the number that corresponds to your \dap{} -- in the
|
|
following steps, \emph{N} should be replaced with the number just found.
|
|
\item Now, extract the firmware partition currently on the \dap{} with the
|
|
following command:
|
|
\begin{code}
|
|
ipodpatcher -r \emph{N} bootpartition.bin
|
|
\end{code}
|
|
\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
|
|
uninstall Rockbox from your Ipod}
|
|
\item Extract the Apple firmware from the partition image image just created:
|
|
\begin{code}
|
|
ipodpatcher -r \emph{N} bootpartition.bin
|
|
\end{code}
|
|
\optv{ipodvideo}{
|
|
\item Similarly, extract the Broadcom firmware:
|
|
\begin{code}
|
|
ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin
|
|
\end{code}
|
|
}
|
|
\item Merge the Rockbox bootloader you downloaded previously with the Apple
|
|
firmware:
|
|
\optv{ipodnano}{
|
|
\begin{code}
|
|
ipod_fw -g nano -o rockboot.bin -i apple_os.bin bootloader-nano.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipodvideo}{
|
|
\begin{code}
|
|
ipod_fw -g video -o rockboot.bin -i apple_os.bin bootloader-video.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipodmini}{
|
|
\begin{code}
|
|
ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini1g.bin
|
|
\end{code}
|
|
Or, if you have a 2G mini:
|
|
\begin{code}
|
|
ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini2g.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipodcolor}{
|
|
\begin{code}
|
|
ipod_fw -g color -o rockboot.bin -i apple_os.bin bootloader-color.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipod4g}{
|
|
\begin{code}
|
|
ipod_fw -g 4g -o rockboot.bin -i apple_os.bin bootloader-4g.bin
|
|
\end{code}
|
|
}
|
|
\item
|
|
Install the Rockbox-enabled firmware:
|
|
\begin{code}
|
|
ipodpatcher -w \emph{N} rockboot.bin
|
|
\end{code}
|
|
\end{enumerate}
|
|
|
|
Now you can proceed installing the firmware itself.
|
|
|
|
\subsubsection{Mac OS X users}
|
|
\begin{enumerate}
|
|
\item Download the following two programs and save them in the folder just
|
|
created. These programs will be used in the next steps:
|
|
\begin{itemize}
|
|
\item \wikilink{IpodInstallationFromMacOSX/diskdump}
|
|
\item \wikilink{IpodInstallationFromMacOSX/ipod_fw}
|
|
\end{itemize}
|
|
Start a Terminal and type navigate into the folder you created. Before
|
|
you can continue, you need to ensure that Mac OS knows that the
|
|
\fname{ipod\_fw}
|
|
and diskdump files you downloaded are executable programs. To do this,
|
|
type the following command:
|
|
\begin{code}
|
|
chmod +x ipod_fw diskdump
|
|
\end{code}
|
|
\item Locate the \dap{} by running the following command:
|
|
\begin{code}
|
|
mount
|
|
\end{code}
|
|
The output will look something like this: \fixme{Add full example}
|
|
\begin{code}
|
|
/dev/disk1s2 on /Volumes/DAVE_S IPOD 1 (local, nodev, nosuid)
|
|
\end{code}
|
|
In this example, the \dap\ is located at /dev/disk1s2 Remember the
|
|
location of your \dap\ -- in the following steps, /dev/disk1s2 should be
|
|
replaced with the location just found.
|
|
\item Before continuing, the \dap\ must be ``unmounted'', which is
|
|
done with the following command:
|
|
\begin{code}
|
|
diskutil unmount /dev/disk1s2
|
|
\end{code}
|
|
\item Now, extract the Apple firmware currently on the \dap{} with the
|
|
following command:
|
|
\note{The last part of the location is left out.}
|
|
\begin{code}
|
|
./diskdump -r /dev/disk1 bootpartition.bin
|
|
\end{code}
|
|
\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
|
|
uninstall Rockbox from your iPod
|
|
}
|
|
\item Extract the Apple firmware from this partition image:
|
|
\begin{code}
|
|
./ipod_fw -o apple_os.bin -e 0 bootpartition.bin
|
|
\end{code}
|
|
\optv{ipodvideo}{
|
|
\item Similarly, extract the Broadcom firmware:
|
|
\begin{code}
|
|
./ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin
|
|
\end{code}
|
|
}
|
|
\item Merge the Rockbox bootloader you downloaded previously with the Apple
|
|
firmware:
|
|
\optv{ipodnano}{
|
|
\begin{code}
|
|
./ipod_fw -g nano -o rockboot.bin -i apple_os.bin bootloader-nano.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipodvideo}{
|
|
\begin{code}
|
|
./ipod_fw -g video -o rockboot.bin -i apple_os.bin bootloader-video.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipodmini}{
|
|
\begin{code}
|
|
./ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini1g.bin
|
|
\end{code}
|
|
Or, if you have a 2G Mini:
|
|
\begin{code}
|
|
./ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini2g.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipodcolor}{
|
|
\begin{code}
|
|
./ipod_fw -g color -o rockboot.bin -i apple_os.bin bootloader-color.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipod4g}{
|
|
\begin{code}
|
|
./ipod_fw -g 4g -o rockboot.bin -i apple_os.bin bootloader-4g.bin
|
|
\end{code}
|
|
}
|
|
\item
|
|
Install the Rockbox-enabled firmware:
|
|
\note{The last part of the location is left out.}
|
|
\begin{code}
|
|
./diskdump -w /dev/disk1 rockboot.bin
|
|
\end{code}
|
|
\end{enumerate}
|
|
|
|
Now, proceed with installing the firmware itself.
|
|
|
|
\subsubsection{Linux users}
|
|
\begin{enumerate}
|
|
\item Download the following and save it in the folder just
|
|
created:
|
|
\begin{itemize}
|
|
\item \url{http://www.rockbox.org/viewcvs.cgi/*checkout*/tools/ipod_fw.c}
|
|
\end{itemize}
|
|
Now compile it to an executable by opening a command prompt and changing
|
|
to the folder created previously. Thn run the following command:
|
|
\begin{code}
|
|
gcc -o ipod_fw ipod_fw.c
|
|
\end{code}
|
|
If you get the message that the command gcc is not found, you need to
|
|
install gcc. How to do this depends on your Linux distribution, and
|
|
you should consult its documentation for help on this.
|
|
\item Locate your Ipod by running the command \verb|dmesg|. In the output
|
|
something like the following should be seen:
|
|
\begin{code}
|
|
usb 4-1: new high speed USB device using ehci_hcd and address 7
|
|
scsi4 : SCSI emulation for USB Mass Storage devices
|
|
usb-storage: device found at 7
|
|
usb-storage: waiting for device to settle before scanning
|
|
Vendor: Apple Model: iPod Rev: 1.62
|
|
Type: Direct-Access ANSI SCSI revision: 00
|
|
SCSI device sdb: 58605120 512-byte hdwr sectors (30006 MB)
|
|
\end{code}
|
|
You need the device name of your \dap, which you can find in the last line.
|
|
In this example, the \dap\ is located on \fname{/dev/sdb}. In the following,
|
|
\fname{/dev/sdb} should be replaced with the location just found.
|
|
\item Run \verb|fdisk -l /dev/sdb|. Verify that the
|
|
output is similar to the one below:
|
|
\begin{code}
|
|
Device Boot Start End Blocks Id System
|
|
/dev/sdb1 1 10 80293+ 0 Empty
|
|
/dev/sdb2 11 3648 29222235 b W95 FAT32
|
|
\end{code}
|
|
\item Back up the partition table using the following command:
|
|
\note{The last part of the location is left out.}
|
|
\begin{code}
|
|
dd if=/dev/\emph{sdb} of=mbr.bin count=1
|
|
\end{code}
|
|
|
|
\item Now, extract the firmware partition currently on the \dap{} with the
|
|
following command:
|
|
\begin{code}
|
|
dd if=/dev/\emph{sdb1} of=bootpartition.bin
|
|
\end{code}
|
|
\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
|
|
uninstall Rockbox from your Ipod
|
|
}
|
|
\item Extract the Apple firmware from this partition image:
|
|
\begin{code}
|
|
./ipod_fw -o apple_os.bin -e 0 bootpartition.bin
|
|
\end{code}
|
|
\optv{ipodvideo}{
|
|
\item Similarly, extract the Broadcom firmware:
|
|
\begin{code}
|
|
./ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin
|
|
\end{code}
|
|
}
|
|
|
|
\item Merge the Rockbox bootloader you downloaded previously with the Apple
|
|
firmware:
|
|
\optv{ipodnano}{
|
|
\begin{code}
|
|
./ipod_fw -g nano -o rockboot.bin -i apple_os.bin bootloader-nano.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipodvideo}{
|
|
\begin{code}
|
|
./ipod_fw -g video -o rockboot.bin -i apple_os.bin bootloader-video.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipodmini}{
|
|
\begin{code}
|
|
./ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini1g.bin
|
|
\end{code}
|
|
Or, if you have a 2G Mini:
|
|
\begin{code}
|
|
./ipod_fw -g mini -o rockboot.bin -i apple_os.bin bootloader-mini2g.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipodcolor}{
|
|
\begin{code}
|
|
./ipod_fw -g color -o rockboot.bin -i apple_os.bin bootloader-color.bin
|
|
\end{code}
|
|
}
|
|
\optv{ipod4g}{
|
|
\begin{code}
|
|
./ipod_fw -g 4g -o rockboot.bin -i apple_os.bin bootloader-4g.bin
|
|
\end{code}
|
|
}
|
|
\item
|
|
Install the Rockbox-enabled firmware:
|
|
\begin{code}
|
|
dd if=rockboot.bin of=/dev/\emph{sdb1}
|
|
\end{code}
|
|
\end{enumerate}
|
|
Now you can install the firmware itself.
|
|
|