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