manual/getting_started/sansa_install.tex

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