Alexander Eickhoff wrote at least two accepted patches that went in during 2003
[kugel-rb.git] / manual / getting_started / sansa_install.tex
blob4af65afa5b041bdaeac642004000aec3a1c8ed96
1 % $Id$ %
2 \fixme{NOTE: These instructions will not work on the ``Rhapsody'' version of the E200 series (also known as E200R). Please follow the instructions at \url{http://www.rockbox.org/twiki/bin/view/Main/SansaE200RInstallation}.}
4 In order to make your e200 load and execute the Rockbox firmware you
5 have just installed, you will need to install the Rockbox
6 bootloader. Unless bugs are found in the bootloader code, or
7 significant new feature are added, you will only have to perform this
8 step once.
10 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/}).
12 \subsubsection{Bootloader installation from Windows}
14 \begin{enumerate}
16 \item Make sure you are logged into your computer as Administrator, or a
17 user with Administrator privileges and connect your \dap{}.
19 \item Download sansapatcher.exe from
20 \download{bootloader/sandisk-sansa/e200/win32/sansapatcher.exe}
21 and run it.
23 \item If all has gone well, you should see some information displayed about
24 your e200 and a message asking you if you wish to install the Rockbox
25 bootloader. Press i followed by ENTER, and sansapatcher will now
26 install the bootloader. After a short time you should see the message
27 ``[INFO] Bootloader installed successfully.'' Press ENTER again to exit
28 sansapatcher.
30 \item Disconnect your \dap{} in the usual way. The bootloader is now installed.
32 \end{enumerate}
34 \subsubsection{Bootloader installation from Mac OS X}
36 \begin{enumerate}
38 \item Attach your \dap{} to your Mac and wait for its icon to appear in
39 Finder.
41 \item\label{subsec:macos_umount} Open up Disk Utility
42 (in Applications $\rightarrow$ Utilities) and click
43 on the name of your \dap{} (e.g. Sansa e280) in the list on the left
44 pane. Then click on the ``unmount'' icon at the top. \warn{Do \emph{not}
45 click on the ``eject'' icon.}
47 \item Download and open sansa.dmg from
48 \download{bootloader/sandisk-sansa/e200/macosx/sansapatcher.dmg}
49 and then double-click on the sansapatcher icon inside.
51 \item If all has gone well, you should see some
52 information displayed about your \dap{} and a message asking you if you
53 wish to install the Rockbox bootloader. Press i followed by ENTER, and
54 sansapatcher will now install the bootloader. After a short time you
55 should see the message ``[INFO] Bootloader installed successfully.'' Press
56 ENTER again to exit sansapatcher and then quit the Terminal application.
58 \item \warn{If you received a ``Resource busy'' error from
59 sansapatcher, then this means you didn't complete step
60 \ref{subsec:macos_umount}. Go back to Disk Utility, unmount your
61 \dap{} and then run sansapatcher again.}
63 \item Your \dap{} will now automatically reconnect itself to your Mac.
64 Wait for it to connect, and then eject and unplug it in the normal way.
66 \end{enumerate}
68 \subsubsection{Bootloader installation from Linux}
70 \begin{enumerate}
72 \item Download sansapatcher from
73 \download{bootloader/sandisk-sansa/e200/linux32x86/sansapatcher} (32-bit x86
74 binary) or \download{bootloader/sandisk-sansa/e200/linux64amd64/sansapatcher}
75 (64-bit amd64 binary). You can save this anywhere you wish, but the next
76 steps will assume you've saved it in your home directory.
78 \item Attach your \dap{} to your computer.
80 \item Open up a terminal window and type the following commands:
82 \begin{code}
83 cd $HOME
84 chmod +x sansapatcher
85 ./sansapatcher
86 \end{code}
88 \warn{You may need to be the root user in order for sansapatcher to have
89 sufficient permission to perform raw disk access to your \dap{}.}
91 \item If all has gone well, you should see some information displayed about
92 your e200 and a message asking you if you wish to install the Rockbox
93 bootloader. Press i followed by ENTER, and sansapatcher will now install the
94 bootloader. After a short time you should see the message ``[INFO] Bootloader
95 installed successfully.'' Press ENTER again to exit sansapatcher.
97 \item Disconnect your \dap{} in the usual way. The bootloader is now installed.
99 \end{enumerate}