set YOFS to 0 for portrait LCDs.
[kugel-rb.git] / manual / getting_started / gigabeats_install.tex
blob317e190fe0b5eb1393e62f5e10e21389898eff13
1 % $Id$
3 \warn{Before starting this procedure, ensure that you have a copy
4 of the original \playerman{} firmware. Without this, it is
5 \emph{not} possible to uninstall Rockbox. The \playerman{}
6 firmware can be downloaded from
7 \url{http://www.tacp.toshiba.com/tacpassets-images/firmware/MESV12US.zip}.\\}
9 Installing the bootloader is only needed once. It involves replacing the
10 existing firmware file on your \dap{} with another version.
11 When running the original \playerman{} firmware (a version of Windows CE), it is
12 only possible to connect the \dap{} to a PC in ``MTP mode'', which hides
13 the actual content of your \daps{} disk and provides restricted access
14 to its contents.
15 In reality, the \daps{} hard disk contains two partitions, a small
16 (150MB) ``firmware partition'' containing the \daps{} firmware (operating
17 system), and a second ``data partition'' containing your media files. The main
18 firmware file in the bootloader partition is called \fname{nk.bin}, and
19 this is the file that is loaded into RAM (by the \daps{} ROM-based
20 bootloader) and executed when your \dap{} is powered on.
22 \subsubsection{Bootloader installation from Windows}
24 \begin{enumerate}
26 \item Attach your \dap{} to your computer.
28 \item Download \fname{beastpatcher.exe} from
29 \fixme{add download location}
30 and run it.
32 \item You should see some information displayed about
33 your \dap{} and a message asking you if you wish to install the Rockbox
34 bootloader. Press i followed by ENTER, and beastpatcher will
35 install the bootloader. After a short time you should see the message
36 ``[INFO] Bootloader installed successfully'' followed by some error
37 messages that you can safely ignore. Press ENTER again to exit
38 beastpatcher.
40 \item After a successful installation, your \dap{} will immediately turn off.
41 Turn it on again, and (because it is still connected to your PC)
42 it will enter the Rockbox bootloader's
43 ``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
44 as a standard USB Mass Storage device.
45 \end{enumerate}
47 \subsubsection{Bootloader installation from Mac OS X}
48 \begin{enumerate}
49 \item Attach your \dap{} to your computer.
51 \item Download and open beastpatcher.dmg from
52 \fixme{add download location}
53 and then double-click on the beastpatcher icon inside. You can also
54 drag the beastpatcher icon to a location on your hard drive and launch
55 it from the Terminal.
57 \item If all has gone well, you should see some
58 information displayed about your \dap{} and a message asking you if you
59 wish to install the Rockbox bootloader. Press i followed by ENTER, and
60 beastpatcher will now install the bootloader. After a short time you
61 should see the message ``[INFO] Bootloader installed successfully''
62 followed by some error messages that you can safely ignore. Press
63 ENTER again to exit beastpatcher and then quit the Terminal application.
65 \item After a successful installation, your \dap{} will immediately turn off.
66 Turn it on again, and (because it is still connected to your Mac)
67 it will enter the Rockbox bootloader's
68 ``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
69 as a standard USB Mass Storage device.
70 \end{enumerate}
72 \subsubsection{Bootloader installation from Linux}
74 \begin{enumerate}
76 \item Download beastpatcher from
77 \fixme{add download location} (32-bit x86
78 binary) or \fixme{add download location}
79 (64-bit amd64 binary). You can save this anywhere you wish, but the next
80 steps will assume you have saved it in your home directory.
82 \item Attach your \dap{} to your computer.
84 \item Open up a terminal window and type the following commands:
86 \begin{code}
87 cd $HOME
88 chmod +x beastpatcher
89 ./beastpatcher
90 \end{code}
92 \item If all has gone well, you should see some information displayed about
93 your \dap{} and a message asking you if you wish to install the Rockbox
94 bootloader. Press i followed by ENTER, and beastpatcher will now install the
95 bootloader. After a short time you should see the message ``[INFO] Bootloader
96 installed successfully'' followed by some error
97 messages that you can safely ignore. Press ENTER again to exit beastpatcher.
99 \item After a successful installation, your \dap{} will immediately turn off.
100 Turn it on again, and (because it is still connected to your PC)
101 it will enter the Rockbox bootloader's
102 ``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
103 as a standard USB Mass Storage device.
105 \end{enumerate}