manual/getting_started/sansa_install.tex

   1 % $Id$ %
   2 \opt{e200}{\fixme{NOTE: These instructions will not work on the
   3 ``Rhapsody'' version of the E200 series (also known as E200R).  Please
   4 follow the instructions at
   5 \url{http://www.rockbox.org/twiki/bin/view/Main/SansaE200RInstallation}.}}
   6
   7 In order to make your \playertype{} load and execute the Rockbox firmware you
   8 have just installed, you will need to install the Rockbox
   9 bootloader. Unless bugs are found in the bootloader code, or
  10 significant new feature are added, you will only have to perform this
  11 step once.
  12
  13 These steps use the sansapatcher tool. Source code is available in the Rockbox
  14 SVN repository (\url{http://svn.rockbox.org/viewvc.cgi/trunk/rbutil/sansapatcher/}).
  15
  16 \subsubsection{Bootloader installation from Windows}
  17
  18 \begin{enumerate}
  19
  20 \item Make sure you are logged into your computer as Administrator, or a
  21 user with Administrator privileges and connect your \dap{}.
  22
  23 \item Download sansapatcher.exe from
  24 \download{bootloader/sandisk-sansa/sansapatcher/win32/sansapatcher.exe}
  25 and run it.
  26
  27 \item If all has gone well, you should see some information displayed about
  28 your \playertype{} and a message asking you if you wish to install the Rockbox
  29 bootloader. Press i followed by ENTER, and sansapatcher will now
  30 install the bootloader. After a short time you should see the message
  31 ``[INFO] Bootloader installed successfully.'' Press ENTER again to exit
  32 sansapatcher.
  33
  34 \item Disconnect your \dap{} in the usual way. The bootloader is now installed.
  35
  36 \end{enumerate}
  37
  38 \subsubsection{Bootloader installation from Mac OS X}
  39
  40 \begin{enumerate}
  41
  42 \item Attach your \dap{} to your Mac and wait for its icon to appear in
  43 Finder.
  44
  45 \item\label{subsec:macos_umount} Open up Disk Utility
  46 (in Applications $\rightarrow$ Utilities) and click
  47 on the name of your \dap{} (e.g. Sansa \opt{e200}{e280}\opt{c200}{c250})
  48 in the list on the left pane. Then click on the ``unmount'' icon at the top.
  49 \warn{Do \emph{not} click on the ``eject'' icon.}
  50
  51 \item Download and open sansa.dmg from
  52 \download{bootloader/sandisk-sansa/sansapatcher/macosx/sansapatcher.dmg}
  53 and then double-click on the sansapatcher icon inside.
  54
  55 \item If all has gone well, you should see some
  56 information displayed about your \dap{} and a message asking you if you
  57 wish to install the Rockbox bootloader. Press i followed by ENTER, and
  58 sansapatcher will now install the bootloader. After a short time you
  59 should see the message ``[INFO] Bootloader installed successfully.'' Press
  60 ENTER again to exit sansapatcher and then quit the Terminal application.
  61
  62 \item \warn{If you received a ``Resource busy'' error from
  63 sansapatcher, then this means you did not complete step
  64 \ref{subsec:macos_umount}. Go back to Disk Utility, unmount your
  65 \dap{} and then run sansapatcher again.}
  66
  67 \item Your \dap{} will now automatically reconnect itself to your Mac.
  68 Wait for it to connect, and then eject and unplug it in the normal way.
  69
  70 \end{enumerate}
  71
  72 \subsubsection{Bootloader installation from Linux}
  73
  74 \begin{enumerate}
  75
  76 \item Download sansapatcher from
  77 \download{bootloader/sandisk-sansa/sansapatcher/linux32x86/sansapatcher} (32-bit x86
  78 binary) or \download{bootloader/sandisk-sansa/sansapatcher/linux64amd64/sansapatcher}
  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.
  81
  82 \item Attach your \dap{} to your computer.
  83
  84 \item Open up a terminal window and type the following commands:
  85
  86 \begin{code}
  87     cd $HOME
  88     chmod +x sansapatcher
  89     ./sansapatcher
  90 \end{code}
  91
  92 \warn{You may need to be the root user in order for sansapatcher to have
  93 sufficient permission to perform raw disk access to your \dap{}.}
  94
  95 \item If all has gone well, you should see some information displayed about
  96 your \playertype{} and a message asking you if you wish to install the Rockbox
  97 bootloader. Press i followed by ENTER, and sansapatcher will now install the
  98 bootloader. After a short time you should see the message ``[INFO] Bootloader
  99 installed successfully.'' Press ENTER again to exit sansapatcher.
 100
 101 \item Disconnect your \dap{} in the usual way. The bootloader is now installed.
 102
 103 \end{enumerate}