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