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 (150~MB) ``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 \begin{description}
  39 \item [Single Boot.] Run \fname{beastpatcher.exe}. You should see some
  40 information displayed about
  41 your \dap{} and a message asking you if you wish to install the Rockbox
  42 bootloader. Press i followed by ENTER, and beastpatcher will
  43 install the bootloader. After a short time you should see the message
  44 ``[INFO] Bootloader installed successfully''. Press ENTER again to exit
  45 beastpatcher.
  46
  47 \item [Dual Boot.] Inside the \fname{MESV12US.zip} file you downloaded earlier
  48 you should find an \fname{.iso} file.  Using e.g. 7zip
  49 (\url{http://www.7-zip.org} you can extract an \fname{.exe} file from this
  50 \fname{.iso} file.  Using 7zip again, extract the \playerman{} firmware file
  51 \fname{nk.bin} from the \fname{.exe} file and place it in the same
  52 directory as \fname{beastpatcher.exe}.  Open a command prompt and navigate
  53 to this directory, and then type the following commands:
  54
  55 \begin{code}
  56     beastpatcher -d nk.bin
  57 \end{code}
  58
  59 After a short time you should see the message
  60 ``[INFO] Bootloader installed successfully''. Press ENTER again to exit
  61 beastpatcher.
  62 \end{description}
  63
  64 \item After a successful installation, you need to disconnect your \dap{} from
  65 USB, and then immediately reconnect it. It should reboot then enter the Rockbox
  66 bootloader ``USB Mass Storage'' mode, which exposes your \daps{} disk to your
  67 computer as a standard USB Mass Storage device.
  68 \end{enumerate}
  69
  70 \subsubsection{Bootloader installation from Mac OS X}
  71 \begin{enumerate}
  72 \item Attach your \dap{} to your computer.
  73
  74 \item Download and open beastpatcher.dmg from
  75 \download{bootloader/toshiba/gigabeat-s/beastpatcher/macosx/beastpatcher.dmg}
  76 and then perform one of the following,
  77 depending on whether you want single or dual-boot.
  78
  79 \begin{description}
  80 \item [Single Boot.] Double-click on the beastpatcher icon. You can also
  81 drag the beastpatcher icon to a location on your hard drive and launch
  82 it from the Terminal. If all has gone well, you should see some
  83 information displayed about your \dap{} and a message asking you if you
  84 wish to install the Rockbox bootloader. Press i followed by ENTER, and
  85 beastpatcher will now install the bootloader. After a short time you
  86 should see the message ``[INFO] Bootloader installed successfully''
  87 followed by some error messages that you can safely ignore. Press
  88 ENTER again to exit beastpatcher and then quit the Terminal application.
  89
  90 \item [Dual Boot.] Inside the \fname{MESV12US.zip} file you downloaded earlier
  91 you should find an \fname{.iso} file.  Using e.g. 7zip
  92 (\url{http://www.7-zip.org} you can extract an \fname{.exe} file from this
  93 \fname{.iso} file.  Using 7zip again, extract the \playerman{} firmware file
  94 \fname{nk.bin} from the \fname{.exe} file and place it in the same
  95 directory as \fname{beastpatcher}.  Open a terminal window and type the
  96 following command:
  97
  98 \begin{code}
  99     ./beastpatcher -d nk.bin
 100 \end{code}
 101 \end{description}
 102
 103 \item After a successful installation, your \dap{} will immediately turn off.
 104 Turn it on again, and (because it is still connected to your Mac)
 105 it will enter the Rockbox bootloader's
 106 ``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
 107 as a standard USB Mass Storage device.
 108 \end{enumerate}
 109
 110 \subsubsection{Bootloader installation from Linux}
 111
 112 \begin{enumerate}
 113
 114 \item Download beastpatcher from
 115 \download{bootloader/toshiba/gigabeat-s/beastpatcher/linux32x86/beastpatcher}
 116 (32-bit x86 binary) or
 117 \download{bootloader/toshiba/gigabeat-s/beastpatcher/linux64amd64/beastpatcher}
 118 (64-bit amd64 binary). You can save this anywhere you wish, but the next
 119 steps will assume you have saved it in your home directory.
 120
 121 \item Attach your \dap{} to your computer and then perform one of the following,
 122 depending on whether you want single or dual-boot.
 123
 124 \begin{description}
 125 \item [Single Boot.] Open up a terminal window and type the following commands:
 126
 127 \begin{code}
 128     cd $HOME
 129     chmod +x beastpatcher
 130     ./beastpatcher
 131 \end{code}
 132
 133 If all has gone well, you should see some information displayed about
 134 your \dap{} and a message asking you if you wish to install the Rockbox
 135 bootloader. Press i followed by ENTER, and beastpatcher will now install the
 136 bootloader. After a short time you should see the message ``[INFO] Bootloader
 137 installed successfully'' followed by some error
 138 messages that you can safely ignore. Press ENTER again to exit beastpatcher.
 139
 140 \item [Dual Boot.] Inside the \fname{MESV12US.zip} file you downloaded earlier
 141 you should find an \fname{.iso} file.  Using e.g. 7zip
 142 (\url{http://www.7-zip.org} you can extract an \fname{.exe} file from this
 143 \fname{.iso} file.  Using 7zip again, extract the \playerman{} firmware file
 144 \fname{nk.bin} from the \fname{.exe} file and place it in the same
 145 directory as \fname{beastpatcher}.  Open a terminal window and type the
 146 following commands:
 147
 148 \begin{code}
 149     cd $HOME
 150     chmod +x beastpatcher
 151     ./beastpatcher -d nk.bin
 152 \end{code}
 153
 154 After a short time you should see the message
 155 ``[INFO] Bootloader installed successfully'' followed by some error
 156 messages that you can safely ignore. Press ENTER again to exit
 157 beastpatcher.
 158 \end{description}
 159
 160 \item After a successful installation, your \dap{} will immediately turn off.
 161 Turn it on again, and (because it is still connected to your PC)
 162 it will enter the Rockbox bootloader's
 163 ``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
 164 as a standard USB Mass Storage device.
 165
 166 \end{enumerate}