diff options
author | Barry Wardell <rockbox@barrywardell.net> | 2007-03-23 17:06:29 +0000 |
---|---|---|
committer | Barry Wardell <rockbox@barrywardell.net> | 2007-03-23 17:06:29 +0000 |
commit | 8986cb7a2e61414a6060047d088adef8b7b3a0f1 (patch) | |
tree | 8807593dc7505a600118a29f07bd5d560994ba55 /manual/getting_started | |
parent | 74b9ec0bbe11a06a42a609ab03ac536cf7b5e840 (diff) | |
download | rockbox-8986cb7a2e61414a6060047d088adef8b7b3a0f1.tar.gz 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/getting_started')
-rw-r--r-- | manual/getting_started/sansa_install.tex | 124 |
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 @@ | |||
1 | % $Id$ % | 1 | % $Id$ % |
2 | \fixme{This information is new and might contain errors. Please | 2 | In order to make your e200 load and execute the Rockbox firmware you |
3 | \emph{always} check out the installation page in the wiki at | 3 | have just installed, you will need to install the Rockbox |
4 | \wikilink{SansaE200Install} and the troubleshooting page at | 4 | bootloader. Unless bugs are found in the bootloader code, or |
5 | \wikilink{SansaE200TroubleShooting} first. If you have any doubts | 5 | significant new feature are added, you will only have to perform this |
6 | about installation, \emph{stop now!} Errors during the installation might | 6 | step once. |
7 | render your player useless!} | 7 | |
8 | 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 | The installation of the bootloader is the most critical part of the | 9 | |
10 | installation. Please make sure to read the instructions completely | 10 | \subsubsection{Bootloader installation from Windows} |
11 | first before doing any installation step. You \emph{need} to | ||
12 | prepare your \dap{} for dual boot as explained below as you | ||
13 | otherwise \emph{will not} have USB access to your player. | ||
14 | 11 | ||
15 | \begin{enumerate} | 12 | \begin{enumerate} |
16 | \item Save a backup copy of your original firmware onto your computer's hard drive. | 13 | |
17 | You can obtain a firmware file from \url{http://daniel.haxx.se/sansa/mi4.html}, | 14 | \item Make sure you are logged into your computer as Administrator, or a |
18 | another way to obtain the file is to intercept the file during the firmware | 15 | user with Administrator privileges and connect your \dap{}. |
19 | upgrade. | 16 | |
20 | \item Install a version of the mi4code program on your system. | 17 | \item Download sansapatcher.exe from |
21 | You can get a windows binary from | 18 | \download{bootloader/sandisk-sansa/e200/win32/sansapatcher.exe} |
22 | \url{http://daniel.haxx.se/sansa/mi4code.html}. | 19 | and run it. |
23 | \item Decrypt the mi4 firmware file with the following command | 20 | |
24 | \begin{code} | 21 | \item If all has gone well, you should see some information displayed about |
25 | mi4code decrypt -s SKU_E-PP5022.mi4 OF.bin | 22 | your e200 and a message asking you if you wish to install the Rockbox |
26 | \end{code} | 23 | bootloader. Press i followed by ENTER, and sansapatcher will now |
27 | \item Copy the decrypted original firmware file \fname{OF.bin} to the | 24 | install the bootloader. After a short time you should see the message |
28 | \fname{/SYSTEM} folder on your \dap{}. (This folder might be hidden). | 25 | ``[INFO] Bootloader installed successfully.'' Press ENTER again to exit |
29 | \item Download the Rockbox bootloader from | 26 | sansapatcher. |
30 | \url{http://download.rockbox.org/bootloader/sandisk-sansa/}. | 27 | |
31 | \item Copy the bootloader you just downloaded to the root directory | 28 | \item Disconnect your \dap{} in the usual way. The bootloader is now installed. |
32 | of your \dap{}. | 29 | |
33 | \item Safely remove your \dap{} from the computer and then disconnect the | ||
34 | USB cable. This will reboot the \dap{}, then it will install the Rockbox | ||
35 | bootloader and reboot again into Rockbox. | ||
36 | \end{enumerate} | 30 | \end{enumerate} |
37 | 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} | ||