summaryrefslogtreecommitdiffstats
path: root/manual
diff options
context:
space:
mode:
authorBarry Wardell <rockbox@barrywardell.net>2007-03-23 17:06:29 +0000
committerBarry Wardell <rockbox@barrywardell.net>2007-03-23 17:06:29 +0000
commit8986cb7a2e61414a6060047d088adef8b7b3a0f1 (patch)
tree8807593dc7505a600118a29f07bd5d560994ba55 /manual
parent74b9ec0bbe11a06a42a609ab03ac536cf7b5e840 (diff)
downloadrockbox-8986cb7a2e61414a6060047d088adef8b7b3a0f1.tar.gz
rockbox-8986cb7a2e61414a6060047d088adef8b7b3a0f1.tar.bz2
rockbox-8986cb7a2e61414a6060047d088adef8b7b3a0f1.zip
Update Sansa install instructions now that we have sansapatcher. Based off the SansaE200Install wiki page.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@12899 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'manual')
-rw-r--r--manual/getting_started/sansa_install.tex124
1 files changed, 92 insertions, 32 deletions
diff --git a/manual/getting_started/sansa_install.tex b/manual/getting_started/sansa_install.tex
index d64f3032ff..ec947eb4e9 100644
--- a/manual/getting_started/sansa_install.tex
+++ b/manual/getting_started/sansa_install.tex
@@ -1,37 +1,97 @@
% $Id$ %
-\fixme{This information is new and might contain errors. Please
- \emph{always} check out the installation page in the wiki at
- \wikilink{SansaE200Install} and the troubleshooting page at
- \wikilink{SansaE200TroubleShooting} first. If you have any doubts
- about installation, \emph{stop now!} Errors during the installation might
- render your player useless!}
-
-The installation of the bootloader is the most critical part of the
-installation. Please make sure to read the instructions completely
-first before doing any installation step. You \emph{need} to
-prepare your \dap{} for dual boot as explained below as you
-otherwise \emph{will not} have USB access to your player.
+In order to make your e200 load and execute the Rockbox firmware you
+have just installed, you will need to install the Rockbox
+bootloader. Unless bugs are found in the bootloader code, or
+significant new feature are added, you will only have to perform this
+step once.
+
+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/}).
+
+\subsubsection{Bootloader installation from Windows}
\begin{enumerate}
-\item Save a backup copy of your original firmware onto your computer's hard drive.
- You can obtain a firmware file from \url{http://daniel.haxx.se/sansa/mi4.html},
- another way to obtain the file is to intercept the file during the firmware
- upgrade.
-\item Install a version of the mi4code program on your system.
- You can get a windows binary from
- \url{http://daniel.haxx.se/sansa/mi4code.html}.
-\item Decrypt the mi4 firmware file with the following command
- \begin{code}
- mi4code decrypt -s SKU_E-PP5022.mi4 OF.bin
- \end{code}
-\item Copy the decrypted original firmware file \fname{OF.bin} to the
- \fname{/SYSTEM} folder on your \dap{}. (This folder might be hidden).
-\item Download the Rockbox bootloader from
- \url{http://download.rockbox.org/bootloader/sandisk-sansa/}.
-\item Copy the bootloader you just downloaded to the root directory
- of your \dap{}.
-\item Safely remove your \dap{} from the computer and then disconnect the
- USB cable. This will reboot the \dap{}, then it will install the Rockbox
- bootloader and reboot again into Rockbox.
+
+\item Make sure you are logged into your computer as Administrator, or a
+user with Administrator privileges and connect your \dap{}.
+
+\item Download sansapatcher.exe from
+\download{bootloader/sandisk-sansa/e200/win32/sansapatcher.exe}
+and run it.
+
+\item If all has gone well, you should see some information displayed about
+your e200 and a message asking you if you wish to install the Rockbox
+bootloader. Press i followed by ENTER, and sansapatcher will now
+install the bootloader. After a short time you should see the message
+``[INFO] Bootloader installed successfully.'' Press ENTER again to exit
+sansapatcher.
+
+\item Disconnect your \dap{} in the usual way. The bootloader is now installed.
+
\end{enumerate}
+\subsubsection{Bootloader installation from Mac OS X}
+
+\begin{enumerate}
+
+\item Attach your \dap{} to your Mac and wait for its icon to appear in
+Finder.
+
+\item\label{subsec:macos_umount} Open up Disk Utility
+(in Applications $\rightarrow$ Utilities) and click
+on the name of your \dap{} (e.g. Sansa e280) in the list on the left
+pane. Then click on the ``unmount'' icon at the top. \warn{Do \emph{not}
+click on the ``eject'' icon.}
+
+\item Download and open sansa.dmg from
+\download{bootloader/sandisk-sansa/e200/macosx/sansapatcher.dmg}
+and then double-click on the sansapatcher icon inside.
+
+\item If all has gone well, you should see some
+information displayed about your \dap{} and a message asking you if you
+wish to install the Rockbox bootloader. Press i followed by ENTER, and
+sansapatcher will now install the bootloader. After a short time you
+should see the message ``[INFO] Bootloader installed successfully.'' Press
+ENTER again to exit sansapatcher and then quit the Terminal application.
+
+\item \warn{If you received a ``Resource busy'' error from
+sansapatcher, then this means you didn't complete step
+\ref{subsec:macos_umount}. Go back to Disk Utility, unmount your
+\dap{} and then run sansapatcher again.}
+
+\item Your \dap{} will now automatically reconnect itself to your Mac.
+Wait for it to connect, and then eject and unplug it in the normal way.
+
+\end{enumerate}
+
+\subsubsection{Bootloader installation from Linux}
+
+\begin{enumerate}
+
+\item Download sansapatcher from
+\download{bootloader/sandisk-sansa/e200/linux32x86/sansapatcher} (32-bit x86
+binary) or \download{bootloader/sandisk-sansa/e200/linux64amd64/sansapatcher}
+(64-bit amd64 binary). You can save this anywhere you wish, but the next
+steps will assume you've saved it in your home directory.
+
+\item Attach your \dap{} to your computer.
+
+\item Open up a terminal window and type the following commands:
+
+\begin{code}
+ cd $HOME
+ chmod +x sansapatcher
+ ./sansapatcher
+\end{code}
+
+\warn{You may need to be the root user in order for sansapatcher to have
+sufficient permission to perform raw disk access to your \dap{}.}
+
+\item If all has gone well, you should see some information displayed about
+your e200 and a message asking you if you wish to install the Rockbox
+bootloader. Press i followed by ENTER, and sansapatcher will now install the
+bootloader. After a short time you should see the message ``[INFO] Bootloader
+installed successfully.'' Press ENTER again to exit sansapatcher.
+
+\item Disconnect your \dap{} in the usual way. The bootloader is now installed.
+
+\end{enumerate}