manual/getting_started/gigabeats_install.tex

   1 % $Id$
   2
   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. It is also needed if you want to
   6 install the dual-boot bootloader. The \playerman{}
   7 firmware can be downloaded from
   8 \url{http://www.tacp.toshiba.com/tacpassets-images/firmware/MESV12US.zip}.\\}
   9 The single-boot bootloader can only boot Rockbox, whereas the dual-boot
  10 bootloader can boot both Rockbox and the \playerman{} firmware.
  11 The single-boot bootloader boots Rockbox more quickly if you no longer need
  12 access to the \playerman{} firmware.\\
  13
  14 Installing the bootloader is only needed once. It involves replacing the
  15 existing firmware file on your \dap{} with another version.
  16 When running the original \playerman{} firmware (a version of Windows CE), it is
  17 only possible to connect the \dap{} to a PC in ``MTP mode'', which hides
  18 the actual content of your \daps{} disk and provides restricted access
  19 to its contents.
  20 In reality, the \daps{} hard disk contains two partitions, a small
  21 (150MB) ``firmware partition'' containing the \daps{} firmware (operating
  22 system), and a second ``data partition'' containing your media files. The main
  23 firmware file in the bootloader partition is called \fname{nk.bin}, and
  24 this is the file that is loaded into RAM (by the \daps{} ROM-based
  25 bootloader) and executed when your \dap{} is powered on.
  26
  27 \subsubsection{Bootloader installation from Windows}
  28
  29 \begin{enumerate}
  30
  31 \item Attach your \dap{} to your computer.
  32
  33 \item Download \fname{beastpatcher.exe} from
  34 \download{bootloader/toshiba/gigabeat-s/beastpatcher/win32/beastpatcher.exe}
  35 and then perform one of the following, depending on whether you want single
  36 or dual-boot.
  37
  38 \item[Single Boot.] Run \fname{beastpatcher.exe}. You should see some
  39 information displayed about
  40 your \dap{} and a message asking you if you wish to install the Rockbox
  41 bootloader. Press i followed by ENTER, and beastpatcher will
  42 install the bootloader. After a short time you should see the message
  43 ``[INFO] Bootloader installed successfully'' followed by some error
  44 messages that you can safely ignore. Press ENTER again to exit
  45 beastpatcher.
  46
  47 \item[Dual Boot.]  Extract the \playerman{} firmware file \fname{nk.bin} from
  48 the archive you downloaded earlier (linked above) and place it in the same
  49 directory as \fname{beastpatcher.exe}.  Open a command prompt and navigate
  50 to this directory, and then type the following commands:
  51
  52 \begin{code}
  53     beastpatcher -d nk.bin
  54 \end{code}
  55
  56 After a short time you should see the message
  57 ``[INFO] Bootloader installed successfully'' followed by some error
  58 messages that you can safely ignore. Press ENTER again to exit
  59 beastpatcher.
  60
  61 \item After a successful installation, your \dap{} will immediately turn off.
  62 Turn it on again, and (because it is still connected to your PC)
  63 it will enter the Rockbox bootloader's
  64 ``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
  65 as a standard USB Mass Storage device.
  66 \end{enumerate}
  67
  68 \subsubsection{Bootloader installation from Mac OS X}
  69 \begin{enumerate}
  70 \item Attach your \dap{} to your computer.
  71
  72 \item Download and open beastpatcher.dmg from
  73 \fixme{add download location} and then perform one of the following,
  74 depending on whether you want single or dual-boot.
  75
  76 \item [Single Boot.] Double-click on the beastpatcher icon. You can also
  77 drag the beastpatcher icon to a location on your hard drive and launch
  78 it from the Terminal. If all has gone well, you should see some
  79 information displayed about your \dap{} and a message asking you if you
  80 wish to install the Rockbox bootloader. Press i followed by ENTER, and
  81 beastpatcher will now install the bootloader. After a short time you
  82 should see the message ``[INFO] Bootloader installed successfully''
  83 followed by some error messages that you can safely ignore. Press
  84 ENTER again to exit beastpatcher and then quit the Terminal application.
  85
  86 \item [Dual Boot.] Extract the \playerman{} firmware file \fname{nk.bin}
  87 from the archive you downloaded earlier (linked above) and place it in the
  88 same directory as \fname{beastpatcher}.  Open a terminal window and type the
  89 following command:
  90
  91 \begin{code}
  92     ./beastpatcher -d nk.bin
  93 \end{code}
  94
  95 \item After a successful installation, your \dap{} will immediately turn off.
  96 Turn it on again, and (because it is still connected to your Mac)
  97 it will enter the Rockbox bootloader's
  98 ``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
  99 as a standard USB Mass Storage device.
 100 \end{enumerate}
 101
 102 \subsubsection{Bootloader installation from Linux}
 103
 104 \begin{enumerate}
 105
 106 \item Download beastpatcher from
 107 \download{bootloader/toshiba/gigabeat-s/beastpatcher/linux32x86/beastpatcher}
 108 (32-bit x86 binary) or
 109 \download{bootloader/toshiba/gigabeat-s/beastpatcher/linux64amd64/beastpatcher}
 110 (64-bit amd64 binary). You can save this anywhere you wish, but the next
 111 steps will assume you have saved it in your home directory.
 112
 113 \item Attach your \dap{} to your computer and then perform one of the following,
 114 depending on whether you want single or dual-boot.
 115
 116 \item [Single Boot.] Open up a terminal window and type the following commands:
 117
 118 \begin{code}
 119     cd $HOME
 120     chmod +x beastpatcher
 121     ./beastpatcher
 122 \end{code}
 123
 124 If all has gone well, you should see some information displayed about
 125 your \dap{} and a message asking you if you wish to install the Rockbox
 126 bootloader. Press i followed by ENTER, and beastpatcher will now install the
 127 bootloader. After a short time you should see the message ``[INFO] Bootloader
 128 installed successfully'' followed by some error
 129 messages that you can safely ignore. Press ENTER again to exit beastpatcher.
 130
 131 \item [Dual Boot.] Extract the \playerman{} firmware file \fname{nk.bin} from
 132 the archive you downloaded earlier (linked above) and place it in the same
 133 directory as \fname{beastpatcher}.  Open a terminal window and type the
 134 following commands:
 135
 136 \begin{code}
 137     cd $HOME
 138     chmod +x beastpatcher
 139     ./beastpatcher -d nk.bin
 140 \end{code}
 141
 142 After a short time you should see the message
 143 ``[INFO] Bootloader installed successfully'' followed by some error
 144 messages that you can safely ignore. Press ENTER again to exit
 145 beastpatcher.
 146
 147 \item After a successful installation, your \dap{} will immediately turn off.
 148 Turn it on again, and (because it is still connected to your PC)
 149 it will enter the Rockbox bootloader's
 150 ``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
 151 as a standard USB Mass Storage device.
 152
 153 \end{enumerate}