diff options
Diffstat (limited to 'manual/getting_started')
-rw-r--r-- | manual/getting_started/gigabeat_install.tex | 21 | ||||
-rw-r--r-- | manual/getting_started/h10_install.tex | 19 | ||||
-rw-r--r-- | manual/getting_started/iaudio_install.tex | 2 | ||||
-rw-r--r-- | manual/getting_started/installation.tex | 523 | ||||
-rw-r--r-- | manual/getting_started/ipod_install.tex | 51 | ||||
-rw-r--r-- | manual/getting_started/iriver_install.tex | 87 | ||||
-rw-r--r-- | manual/getting_started/mrobe100_install.tex | 4 | ||||
-rw-r--r-- | manual/getting_started/sansa_install.tex | 38 |
8 files changed, 338 insertions, 407 deletions
diff --git a/manual/getting_started/gigabeat_install.tex b/manual/getting_started/gigabeat_install.tex index cad94ccdab..c248527c20 100644 --- a/manual/getting_started/gigabeat_install.tex +++ b/manual/getting_started/gigabeat_install.tex | |||
@@ -1,11 +1,5 @@ | |||
1 | % $Id$ | 1 | % $Id$ |
2 | 2 | ||
3 | Installing the bootloader is only needed once. It simply requires you | ||
4 | to replace a file on your \dap{} with the Rockbox bootloader. To be able | ||
5 | booting the original firmware please make sure to rename the original file | ||
6 | properly. If you ever wish to uninstall Rockbox you should keep a backup copy | ||
7 | of the original file. | ||
8 | |||
9 | \begin{itemize} | 3 | \begin{itemize} |
10 | \item Download the Rockbox bootloader from | 4 | \item Download the Rockbox bootloader from |
11 | \url{http://download.rockbox.org/bootloader/gigabeat/} | 5 | \url{http://download.rockbox.org/bootloader/gigabeat/} |
@@ -16,17 +10,8 @@ of the original file. | |||
16 | \item In that directory you'll find a file called \fname{FWIMG01.DAT}. This too | 10 | \item In that directory you'll find a file called \fname{FWIMG01.DAT}. This too |
17 | may be hidden. Rename the file to \fname{FWIMG01.DAT.ORIG}. Make sure you | 11 | may be hidden. Rename the file to \fname{FWIMG01.DAT.ORIG}. Make sure you |
18 | spelled that name correctly as it is needed for booting the \playerman{} firmware. | 12 | spelled that name correctly as it is needed for booting the \playerman{} firmware. |
13 | \warn{If you do not complete this step then you will be unable to uninstall Rockbox | ||
14 | without a copy of the original firmware from the original install CD.} | ||
19 | \item Now copy the file \fname{FWIMG01.DAT} you downloaded to that directory. | 15 | \item Now copy the file \fname{FWIMG01.DAT} you downloaded to that directory. |
20 | Make sure the spelling is correct. | 16 | Make sure the spelling is correct. |
21 | \end{itemize} | 17 | \end{itemize} \ No newline at end of file |
22 | |||
23 | \warn{After installing the bootloader you \emph{need} to power-cycle the | ||
24 | \dap{} by doing the following steps. Failure to do so may result in problems.} | ||
25 | \begin{itemize} | ||
26 | \item Eject / unmount USB drive and unplug the USB cable. | ||
27 | \item Unplug any power adapter. | ||
28 | \item Hold the \ButtonPower{} button to turn off the \dap{}. | ||
29 | \item Slide the battery switch located on the bottom of the \dap{} from | ||
30 | `on' to `off' | ||
31 | \item Slide the battery switch back from `off' to `on' | ||
32 | \end{itemize} | ||
diff --git a/manual/getting_started/h10_install.tex b/manual/getting_started/h10_install.tex index bb212a6504..ff72f6661e 100644 --- a/manual/getting_started/h10_install.tex +++ b/manual/getting_started/h10_install.tex | |||
@@ -1,22 +1,3 @@ | |||
1 | \subsubsection{UMS and MTP} | ||
2 | The \playertype{} can be connected to a computer in two different modes: | ||
3 | \begin{itemize} | ||
4 | \item Universal Mass Storage (UMS): In this mode, it will appear on your computer as a regular disk. This mode works with all major operating systems, including Windows, Linux and Mac OS X. | ||
5 | \item Media Transfer Protocol (MTP): In this mode, it will appear on your computer as a Media Device. MTP was created by Microsoft for use with DAPs and only works with Windows XP and Media Player 10. | ||
6 | \end{itemize} | ||
7 | The \playerlongtype{} is \opt{h10}{only available as a MTP device, but}\opt{h10_5gb}{available as both a MTP and as a UMS device, depending on where and when you bought it. You can tell which you have by how it appears when you connect it to a computer. If it appears as a regular disk then it is UMS. If it appears as a Media Device on Windows XP, or if it does not appear at all on other operating systems, then it is MTP. Even if you have a MTP \dap{}, it} can be forced into UMS mode using the UMS trick. | ||
8 | |||
9 | \subsubsection{UMS mode and the UMS trick} | ||
10 | It is possible to force a MTP \playertype{} to start up in UMS mode using the following procedure: | ||
11 | \begin{enumerate} | ||
12 | \item Ensure the \dap{} is fully powered off by \opt{h10}{using a pin to push the small reset button inside the hole between the Hold switch and remote control connector.}\opt{h10_5gb}{removing the battery and putting it back in again.} | ||
13 | \item Connect your \playertype{} to the computer using the data cable. | ||
14 | \item Hold \ButtonRight{} and push \ButtonPower{} to turn the \dap{} on. | ||
15 | \item Continue holding \ButtonRight{} until the USB Connected screen appears. | ||
16 | \item The \dap{} will now appear as a regular disk on your computer. | ||
17 | \end{enumerate} | ||
18 | \note{Once Rockbox has been installed, when you shut down your \dap{} from Rockbox it will totally power the player off so step 1 is no longer necessary.} | ||
19 | |||
20 | \subsubsection{Installation} | 1 | \subsubsection{Installation} |
21 | \begin{enumerate} | 2 | \begin{enumerate} |
22 | \item Download | 3 | \item Download |
diff --git a/manual/getting_started/iaudio_install.tex b/manual/getting_started/iaudio_install.tex index d8af8bb200..41765eee24 100644 --- a/manual/getting_started/iaudio_install.tex +++ b/manual/getting_started/iaudio_install.tex | |||
@@ -15,6 +15,4 @@ Rockbox bootloader can therefore be very minimalistic, as it does not require | |||
15 | or X5L, use the \fname{x5\_fw.bin} file.} | 15 | or X5L, use the \fname{x5\_fw.bin} file.} |
16 | \opt{m5}{Use the \fname{m5\_fw.bin} file.} | 16 | \opt{m5}{Use the \fname{m5\_fw.bin} file.} |
17 | \item Copy it to the \fname{FIRMWARE} directory on your \dap{}. | 17 | \item Copy it to the \fname{FIRMWARE} directory on your \dap{}. |
18 | \item Turn the \dap{} off, remove the USB cable and insert the charger. The | ||
19 | Rockbox bootloader will automatically be flashed. | ||
20 | \end{itemize} | 18 | \end{itemize} |
diff --git a/manual/getting_started/installation.tex b/manual/getting_started/installation.tex index 39e5e2ee9c..bfcc7ea4d3 100644 --- a/manual/getting_started/installation.tex +++ b/manual/getting_started/installation.tex | |||
@@ -1,37 +1,143 @@ | |||
1 | % $Id$ % | 1 | % $Id$ % |
2 | \chapter{Installation}\label{sec:installation} | 2 | \chapter{Installation}\label{sec:installation} |
3 | 3 | ||
4 | \opt{ipodnano}{ | 4 | Installing Rockbox is generally a quick and easy procedure. However |
5 | \note{Rockbox presently runs only on the original Ipod Nano. Rockbox does | 5 | before beginning there are a few things it is important to know. |
6 | \emph{not} run on the second, third, or fourth generation Ipod Nano. | 6 | |
7 | For information on identifying which Ipod you own, see this page on | 7 | \section{Before Starting} |
8 | Apple's website: \url{http://www.info.apple.com/kbnum/n61688}. | 8 | |
9 | \opt{e200}{\fixme{NOTE: These instructions will not work on the | ||
10 | ``Rhapsody'' version of the E200 series (also known as E200R). Please | ||
11 | follow the instructions at | ||
12 | \url{http://www.rockbox.org/twiki/bin/view/Main/SansaE200RInstallation}.}} | ||
13 | |||
14 | \opt{ipodnano,ipodvideo,e200,c200}{ | ||
15 | \begin{description} | ||
16 | \item[Supported hardware versions.] | ||
17 | \opt{ipodnano}{ | ||
18 | The \playertype{} is available in multiple versions, not | ||
19 | all of which run Rockbox. Rockbox presently runs only on | ||
20 | the original Ipod Nano. Rockbox does | ||
21 | \emph{not} run on the second, third, or fourth generation Ipod Nano. | ||
22 | For information on identifying which Ipod you own, see this page on | ||
23 | Apple's website: \url{http://www.info.apple.com/kbnum/n61688}. | ||
9 | } | 24 | } |
25 | \opt{ipodvideo}{ | ||
26 | The \playertype{} is the 5th/5.5th generation \playerman{} only. | ||
27 | Rockbox does \emph{not} run on the newer, 6th/Classic generation Ipod. | ||
28 | For information on identifying which Ipod you own, see this page on Apple's | ||
29 | website: \url{http://www.info.apple.com/kbnum/n61688}. | ||
30 | } | ||
31 | \opt{e200,c200}{ | ||
32 | The \playertype{} is available in multiple versions, not | ||
33 | all of which run Rockbox. Rockbox doesn't run on the | ||
34 | newer v2 models. They can be identified | ||
35 | by checking the Sandisk firmware version number under | ||
36 | Settings $\rightarrow$ Info. The v1 | ||
37 | firmware is named 01.xx.xx, while the v2 firmware begins with 03. | ||
38 | } | ||
39 | \end{description} | ||
40 | } | ||
41 | |||
42 | \opt{h300}{ | ||
43 | \begin{description} | ||
44 | \item[DRM capability.] If your \dap{} has a US firmware, then by installing Rockbox you will | ||
45 | \emph{permanently} lose the ability to playback files with DRM. | ||
46 | \end{description} | ||
10 | } | 47 | } |
11 | \opt{ipodvideo}{ | 48 | |
12 | \note{Rockbox presently runs only on the 5th and 5.5th generation Ipod videos. | 49 | \begin{description} |
13 | Rockbox does \emph{not} run on the newer, 6th/Classic generation Ipod. | 50 | \item[USB connection.] To transfer Rockbox to your \dap{} you need to |
14 | For information on identifying which Ipod you own, see this page on Apple's | 51 | connect it to your computer. For manual installation/uninstallation, or |
15 | website: \url{http://www.info.apple.com/kbnum/n61688}. | 52 | should autodetection fail during automatic installation, you need to know |
53 | where to access the \dap{}. On Windows this means you need to know | ||
54 | the drive letter associated with the \dap{}. On Linux you need to know | ||
55 | the mount point of your \dap{}. On Mac OS X you need to know the volume | ||
56 | name of your \dap{}. | ||
57 | |||
58 | \opt{ipod}{ | ||
59 | If you have Itunes installed and it is configured to open automatically | ||
60 | when your \dap{} is attached (the default behaviour), | ||
61 | then wait for it to open and then quit it. You | ||
62 | also need to ensure the ``Enable use as disk'' option is enabled for | ||
63 | your \dap{} in Itunes. Your \dap{} should then enter disk mode | ||
64 | automatically when connected to a | ||
65 | computer via USB. If your computer does not recognise your \dap{}, you may | ||
66 | need to enter disk mode manually. Disconnect your \dap{} from the | ||
67 | computer. Hard reset the \dap{} by pressing and holding the \ButtonMenu{} and | ||
68 | \ButtonSelect{} buttons simultaneously. As soon as the \dap{} resets, press | ||
69 | and hold the \ButtonSelect{} and \ButtonPlay{} buttons simultaneously. Your | ||
70 | \dap{} should enter disk mode and you can try reconnecting to the computer. | ||
16 | } | 71 | } |
72 | \opt{ipod3g,ipod4g,ipodcolor,ipodmini}{ | ||
73 | \index{Firewire}Firewire detection is not supported in Rockbox at | ||
74 | the moment. Please use USB only. | ||
75 | } | ||
76 | \opt{x5}{ | ||
77 | When instructed to connect/disconnect the USB cable, always use | ||
78 | the USB port through the subpack, not the side 'USB Host' port. The side port | ||
79 | is intended to be used for USB OTG connections only (digital cameras, memory | ||
80 | sticks, etc.). | ||
81 | } | ||
82 | \opt{sansa}{The following steps require you to change the setting in | ||
83 | \setting{Settings $\rightarrow$ USB Mode} to \setting{MSC} from within the | ||
84 | original firmware. | ||
85 | |||
86 | \warn{Never extract files to your \dap{} while it is in recovery mode.} | ||
87 | } | ||
88 | \opt{h10,h10_5gb}{ | ||
89 | The installation requires you to use UMS mode and so | ||
90 | may require use of the UMS trick, whereby it is possible to force a MTP | ||
91 | \playertype{} to start up in UMS mode as follows: | ||
92 | \begin{enumerate} | ||
93 | \item Ensure the \dap{} is fully powered off by \opt{h10}{using a pin to | ||
94 | push the small reset button inside the hole between the Hold switch and | ||
95 | remote control connector.}\opt{h10_5gb}{removing the battery and putting it back in again.} | ||
96 | \item Connect your \playertype{} to the computer using the data cable. | ||
97 | \item Hold \ButtonRight{} and push \ButtonPower{} to turn the \dap{} on. | ||
98 | \item Continue holding \ButtonRight{} until the USB Connected screen appears. | ||
99 | \item The \dap{} will now appear as a regular disk on your computer. | ||
100 | \end{enumerate} | ||
101 | \note{Once Rockbox has been installed, when you shut down your \dap{} from Rockbox it will totally | ||
102 | power the player off so step 1 is no longer necessary.} | ||
103 | } | ||
104 | \opt{gigabeatf}{During installation, do not connect your \dap{} | ||
105 | using the cradle but plug the USB cable directly to the \dap{}. | ||
106 | } | ||
107 | \end{description} | ||
108 | |||
109 | \opt{ipod,sansa}{ | ||
110 | \begin{description} | ||
111 | \item[Administrator/Root rights.] Installing the bootloader portion of Rockbox | ||
112 | requires you to have administrative (Windows) or root (Linux) rights. | ||
113 | Consequently when doing either the automatic or manual bootloader install, | ||
114 | please ensure that you are logged in with an administrator account or have root rights. | ||
115 | \end{description} | ||
17 | } | 116 | } |
18 | \opt{e200,c200}{ | 117 | |
19 | \note{Rockbox doesn't function on the newer v2 models. They can be identified | 118 | \opt{ipod}{ |
20 | by checking the Sandisk firmware version number under | 119 | \begin{description} |
21 | Settings $\rightarrow$ Info. The v1 | 120 | \item[File system format.] Rockbox only works on Ipods formatted with |
22 | firmware is named 01.xx.xx, while the v2 firmware begins with 03.} | 121 | the FAT32 filesystem (i.e. Ipods initialised by Itunes |
122 | for Windows). It does not work with the HFS+ filesystem (i.e. Ipods | ||
123 | initialised by Itunes for the Mac). More information and instructions for | ||
124 | converting an Ipod to FAT32 can be found on the | ||
125 | \wikilink{IpodConversionToFAT32} wiki | ||
126 | page on the Rockbox website. Note that after conversion, you can still use | ||
127 | a FAT32 Ipod with a Mac. | ||
128 | \end{description} | ||
23 | } | 129 | } |
24 | 130 | ||
25 | \section{Overview} | 131 | \section{Installing Rockbox}\label{sec:installing_rockbox}\index{Installation} |
26 | There are two ways of installing Rockbox: automated and manual. While the | 132 | There are two ways to install Rockbox: automated and manual. The automated |
27 | manual way is older, more tested and proven to work correctly, the | 133 | way is the preferred method of installing Rockbox for the majority of |
28 | automated installation is based on a nice graphical application that does | 134 | people. Rockbox Utility is a graphical |
29 | almost everything for you. It is still important that you have | 135 | application that does almost everything for you. |
30 | an overview of the installation process to be able to select the correct | 136 | However, should you encounter a problem, then the manual way is |
31 | installation options. | 137 | still available to you. |
32 | 138 | ||
33 | \opt{MASCODEC}{Rockbox itself comes as a single package. There is no need | 139 | \opt{MASCODEC}{Rockbox itself comes as a single package. There is no need |
34 | to install additional software for running Rockbox.} | 140 | to install additional software to run Rockbox.} |
35 | \opt{swcodec} { | 141 | \opt{swcodec} { |
36 | \opt{HAVE_RB_BL_ON_DISK}{There are three separate components, | 142 | \opt{HAVE_RB_BL_ON_DISK}{There are three separate components, |
37 | two of which need to be installed in order to run Rockbox:} | 143 | two of which need to be installed in order to run Rockbox:} |
@@ -43,7 +149,7 @@ installation options. | |||
43 | \item[The \playerman{} bootloader.] | 149 | \item[The \playerman{} bootloader.] |
44 | The \playerman{} bootloader is the program that tells your \dap{} how to load | 150 | The \playerman{} bootloader is the program that tells your \dap{} how to load |
45 | and start the original firmware. It is also responsible for any emergency, | 151 | and start the original firmware. It is also responsible for any emergency, |
46 | recovery, or disk modes on your \dap{}. This bootloader is stored in special flash | 152 | recovery, or disk modes on your \dap{}. This bootloader is stored in special flash |
47 | memory in your \playerman{} and comes factory-installed. It is not necessary | 153 | memory in your \playerman{} and comes factory-installed. It is not necessary |
48 | to modify this in order to install Rockbox.} | 154 | to modify this in order to install Rockbox.} |
49 | 155 | ||
@@ -56,9 +162,10 @@ installation options. | |||
56 | 162 | ||
57 | \opt{HAVE_RB_BL_IN_FLASH}{ | 163 | \opt{HAVE_RB_BL_IN_FLASH}{ |
58 | The bootloader is the program that tells your | 164 | The bootloader is the program that tells your |
59 | \dap{} how to load and start other components of Rockbox. This is the | 165 | \dap{} how to load and start other components of Rockbox and for providing |
60 | component of Rockbox that is installed to the flash memory of your | 166 | the dual boot function. This is the component of Rockbox that is installed |
61 | \playerman.} | 167 | to the flash memory of your \playerman. |
168 | \opt{iaudio}{\note{Dual boot does not currently work on the \playertype{}.}}} | ||
62 | 169 | ||
63 | \item[The Rockbox firmware.] | 170 | \item[The Rockbox firmware.] |
64 | \opt{HAVE_RB_BL_IN_FLASH}{Unlike the \playerman{} firmware, which runs | 171 | \opt{HAVE_RB_BL_IN_FLASH}{Unlike the \playerman{} firmware, which runs |
@@ -82,168 +189,125 @@ installation options. | |||
82 | separately. They are not required to run Rockbox itself but | 189 | separately. They are not required to run Rockbox itself but |
83 | a lot of themes require the fonts package to be installed. | 190 | a lot of themes require the fonts package to be installed. |
84 | 191 | ||
85 | \item[Themes.] The view of Rockbox can be customized by themes. Depending | 192 | \item[Themes.] The appearance of Rockbox can be customised by themes. Depending |
86 | on your taste you might want to install additional themes to change | 193 | on your taste you might want to install additional themes to change |
87 | the look of Rockbox. | 194 | the look of Rockbox. |
88 | \end{description} | 195 | \end{description} |
89 | } | 196 | } |
90 | 197 | ||
91 | \section{Prerequisites}\label{sec:prerequisites} | ||
92 | \index{Installation!Prerequisites} | ||
93 | Before installing Rockbox you should make sure you meet the prerequisites. | ||
94 | You may need some additional tools for installation. In most cases these will already be available on your computer, but if not, installing some additional | ||
95 | software might be necessary. | ||
96 | |||
97 | \begin{description} | ||
98 | \item[USB connection.] To transfer Rockbox to your \dap{} you need to | ||
99 | connect it to your computer. For manual installation/uninstallation, or | ||
100 | should autodetection fail during automatic installation, you need to know | ||
101 | where to access the \dap{}. On Windows this means you need to figure out | ||
102 | the drive letter associated with the \dap{}. On Linux you need to know the | ||
103 | mount point of your \dap{}. | ||
104 | |||
105 | \opt{ipod}{ | ||
106 | Your \dap{} should enter disk mode automatically when connected to a | ||
107 | computer via USB. If your computer does not recognise your \dap{}, you may | ||
108 | need to enter the disk mode manually. Disconnect your \dap{} from the | ||
109 | computer. Hard reset the \dap{} by pressing and holding the \ButtonMenu{} and | ||
110 | \ButtonSelect{} buttons simultaneously. As soon as the \dap{} resets, press | ||
111 | and hold the \ButtonSelect{} and \ButtonPlay{} buttons simultaneously. Your | ||
112 | \dap{} should enter disk mode and you can try reconnecting to the computer. | ||
113 | } | ||
114 | |||
115 | \opt{ipod3g,ipod4g,ipodcolor,ipodmini}{ | ||
116 | \note{\index{Firewire}Firewire detection is not supported in Rockbox at | ||
117 | the moment. Please use USB only.} | ||
118 | } | ||
119 | \opt{x5}{ | ||
120 | \note{When instructed to connect/disconnect the USB cable, always use | ||
121 | the USB port through the subpack, not the side 'USB Host' port! The side port | ||
122 | is intended to be used for USB OTG connections only (digital cameras, memory | ||
123 | sticks, etc)!} | ||
124 | } | ||
125 | |||
126 | \opt{sansa}{\warn{The following steps require you to change the setting in | ||
127 | \setting{Settings $\rightarrow$ USB Mode} to \setting{MSC} from within the | ||
128 | original firmware. Never extract files to your \dap{} while it is in | ||
129 | recovery mode.}} | ||
130 | \opt{h10,h10_5gb}{\warn{The following steps require you to use UMS mode and so | ||
131 | may require use of the UMS trick as described in the bootloader installation | ||
132 | section.}} | ||
133 | \opt{gigabeatf}{\warn{During installation, do not connect your \dap{} | ||
134 | using the cradle but plug the USB cable directly to the \dap{}.}} | ||
135 | \end{description} | ||
136 | For manual installation and customization additional software is required. | ||
137 | \begin{description} | ||
138 | \item[ZIP utility.]\index{zip} | ||
139 | Rockbox is distributed as a compressed archive using the | ||
140 | \fname{.zip} format. Your computer will normally already have a means of | ||
141 | handling such archive files. Windows XP has built-in support for | ||
142 | \fname{.zip} files and presents them to you as directories unless you | ||
143 | have installed a third party program that handles compressed files. For | ||
144 | other operating systems this may vary. If the \fname{.zip} file format | ||
145 | is not recognised on your computer you can find a program to handle them | ||
146 | at \url{http://www.info-zip.org/} or \url{http://sevenzip.sf.net/}, both of | ||
147 | which can be downloaded and used free of charge. | ||
148 | \item[Text editor.] As you will see in the following chapters, Rockbox is | ||
149 | highly configurable. In addition to saving configurations, | ||
150 | Rockbox also allows you to create customised configuration files. If you | ||
151 | would like to edit custom configuration files on your computer, you will | ||
152 | need a text editor like Windows' ``Wordpad''. | ||
153 | \end{description} | ||
154 | |||
155 | \opt{ipod}{ | ||
156 | \note{In addition to the requirements described above, Rockbox only works on | ||
157 | Ipods formatted with the FAT32 filesystem (i.e. Ipods initialized by Itunes | ||
158 | for Windows). It does not work with the HFS+ filesystem (i.e. Ipods | ||
159 | initialized by Itunes for the Mac). More information and instructions for | ||
160 | converting an Ipod to FAT32 can be found on the | ||
161 | \wikilink{IpodConversionToFAT32} wiki | ||
162 | page on the Rockbox website. Note that after conversion, you can still use | ||
163 | a FAT32 Ipod on a Mac. | ||
164 | } | ||
165 | } | ||
166 | |||
167 | \section{Installing Rockbox}\label{sec:installing_rockbox}\index{Installation} | ||
168 | |||
169 | \opt{ipodvideo}{\warn{There are separate versions of Rockbox for the 30GB and | ||
170 | 60GB/80GB models. You must ensure you download the correct version for your | ||
171 | \dap{}.}} | ||
172 | |||
173 | \subsection{Automated Installation} | 198 | \subsection{Automated Installation} |
174 | 199 | ||
175 | \opt{mrobe100} | ||
176 | |||
177 | To automatically install Rockbox, download the official installer and | 200 | To automatically install Rockbox, download the official installer and |
178 | housekeeping tool \caps{Rockbox Utility}. It allows you to: | 201 | housekeeping tool \caps{Rockbox Utility}. It allows you to: |
179 | \begin{itemize} | 202 | \begin{itemize} |
180 | \item Automatically install all needed components for using Rockbox | 203 | \item Automatically install all needed components for using Rockbox |
181 | (``Small Installation'') | 204 | (``Minimal Installation''). |
182 | \item Automatically install all suggested components (``Full Installation'') | 205 | \item Automatically install all suggested components (``Complete Installation''). |
183 | \item Selectively install optional components | 206 | \item Selectively install optional components. |
184 | \item Install additional themes | 207 | \nopt{player}{\item Install additional fonts and themes.} |
185 | \item Install voice files and generate talk clips | 208 | \item Install voice files and generate talk clips. |
186 | \item Uninstall all components you installed using Rockbox Utility | 209 | \item Uninstall all components you installed using Rockbox Utility. |
187 | \end{itemize} | 210 | \end{itemize} |
188 | Prebuilt binaries for Windows, Linux and MacOS~X are | 211 | |
189 | available at the \wikilink{RockboxUtility} wiki page. | 212 | Prebuilt binaries for Windows, Linux and Mac OS X are |
190 | \\* | 213 | available at the \wikilink{RockboxUtility} wiki page.\\ |
191 | \warn{When first starting \caps{Rockbox Utility} run ``Autodetect'', | 214 | |
215 | When first starting \caps{Rockbox Utility} run ``Autodetect'', | ||
192 | found in the configuration dialog (File $\rightarrow$ Configure). Autodetection | 216 | found in the configuration dialog (File $\rightarrow$ Configure). Autodetection |
193 | can detect most player types. If autodetection fails or is unable to detect | 217 | can detect most player types. If autodetection fails or is unable to detect |
194 | the mountpoint, make sure to enter the correct values. The mountpoint indicates | 218 | the mountpoint, make sure to enter the correct values. The mountpoint indicates |
195 | the location of the \dap{} in your filesystem. On Windows, this is the drive | 219 | the location of the \dap{} in your filesystem. On Windows, this is the drive |
196 | letter the \dap{} gets assigned, on other systems this is a path in the | 220 | letter the \dap{} gets assigned, on other systems this is a path in the |
197 | filesystem.} | 221 | filesystem.\\* |
198 | 222 | ||
199 | \opt{ipodvideo} | 223 | \opt{ipodvideo} |
200 | {\warn{Autodetection is unable to distinguish between the | 224 | {\note{Autodetection is unable to distinguish between the |
201 | \playerman{} 30~GB and 60~GB / 80~GB models and defaults to the | 225 | \playerman{} 30~GB and 60~GB / 80~GB models and defaults to the |
202 | 30~GB model. This will usually work but you might want to check the | 226 | 30~GB model. This will usually work but you might want to check the |
203 | detected value, especially if you experience problems with Rockbox.} | 227 | detected value, especially if you experience problems with Rockbox.} |
204 | } | 228 | } |
205 | 229 | ||
206 | \note{Rockbox Utility currently lacks some guiding messages. Please have a | 230 | \opt{h100,h300}{ |
207 | look at the manual installation instructions if you are stuck | 231 | Rockbox Utility will ask you for a compatible copy of the original |
208 | during installation.} | 232 | firmware. This is because for legal reasons we cannot distribute |
209 | 233 | the bootloader directly. Instead, we have to patch the Iriver firmware | |
210 | \subsection{Manual Installation} | 234 | with the Rockbox bootloader. |
235 | |||
236 | Download a supported version of the Iriver firmware for your | ||
237 | \playername{} from the Iriver website, links can be found on | ||
238 | \wikilink{IriverBoot}. | ||
239 | |||
240 | Supported Iriver firmware versions currently include | ||
241 | \opt{h100}{1.63US, 1.63EU, 1.63K, 1.65US, 1.65EU, 1.65K, 1.66US, | ||
242 | 1.66EU and 1.66K. Note that the H140 uses the same firmware as the H120; | ||
243 | H120 and H140 owners should use the firmware called \fname{ihp\_120.hex}. | ||
244 | Likewise, the iHP110 and iHP115 use the same firmware, called | ||
245 | \fname{ihp\_100.hex}. Be sure to use the correct firmware file for | ||
246 | your player.} | ||
247 | \opt{h300}{1.28K, 1.28EU, 1.28J, 1.29K, 1.29J and 1.30EU. | ||
248 | \note{The US \playername{} firmware is not supported and cannot be | ||
249 | patched to be used with the bootloader. If you wish to install Rockbox | ||
250 | on a US \playername{}, you must first install a non-US version of the | ||
251 | original firmware and then install one of the supported versions patched | ||
252 | with the Rockbox bootloader. | ||
253 | \warn{Installing non-US firmware on a US \playername{} will | ||
254 | permanently remove DRM support from the player.}}} | ||
255 | |||
256 | If the file that you downloaded is a \fname{.zip} file, use an unzip | ||
257 | utility like mentioned in the prerequisites section to extract | ||
258 | the \fname{.hex} from the \fname{.zip} file | ||
259 | to your desktop. Likewise, if the file that you downloaded is an | ||
260 | \fname{.exe} file, double-click on the \fname{.exe} file to extract | ||
261 | the \fname{.hex} file to your desktop. | ||
262 | When running Linux you should be able to extract \fname{.exe} | ||
263 | files using \fname{unzip}. | ||
264 | } | ||
211 | 265 | ||
212 | \subsubsection{Choosing a Rockbox version}\label{sec:choosing_version} | 266 | \subsubsection{Choosing a Rockbox version}\label{sec:choosing_version} |
213 | 267 | ||
214 | There are three different types of firmware binaries available from the | 268 | There are three different versions of Rockbox available from the |
215 | Rockbox website: | 269 | Rockbox website: |
216 | \label{Version} | 270 | \label{Version} |
217 | Release version, current build and daily build. You need to decide which one | 271 | Release version, current build and archived daily build. You need to decide which one |
218 | you want to install and get the appropriate version for your \dap{}. | 272 | you want to install and get the appropriate version for your \dap{}. If you |
273 | select either ``Minimal Installation'' or ``Complete Installation'' from the | ||
274 | ``Quick Start'' tab, then Rockbox Utility will automatically install the | ||
275 | release version of Rockbox. Using the ``Installation'' tab will allow you | ||
276 | to select which version you wish to install. | ||
219 | 277 | ||
220 | \begin{description} | 278 | \begin{description} |
221 | 279 | ||
222 | \item[Release.] The release version is the latest stable release, free | 280 | \item[Release.] The release version is the latest stable release, free |
223 | of known critical bugs. The current stable release of Rockbox is | 281 | of known critical bugs. For a manual install, the current stable release of Rockbox is |
224 | available at \url{http://www.rockbox.org/download/}. | 282 | available at \url{http://www.rockbox.org/download/}. |
225 | 283 | ||
226 | \item[Current Build.] The current build is built at each source code change to | 284 | \item[Current Build.] The current build is built at each source code change to |
227 | the Rockbox SVN repository and represents the current state of Rockbox | 285 | the Rockbox SVN repository and represents the current state of Rockbox |
228 | development. This means that the build could contain bugs but most of | 286 | development. This means that the build could contain bugs but most of |
229 | the time is safe to use. You can download the current build from | 287 | the time is safe to use. For a manual install, you can download the current build from |
230 | \url{http://build.rockbox.org/}. | 288 | \url{http://build.rockbox.org/}. |
231 | 289 | ||
232 | \item[Archived Build.] In addition to the release version and the current build, | 290 | \item[Archived Build.] In addition to the release version and the current build, |
233 | there is also an archive of daily builds available for download. These are | 291 | there is also an archive of daily builds available for download. These are |
234 | built once a day from the latest source code in the SVN repository. You can | 292 | built once a day from the latest source code in the SVN repository. For a manual install, |
235 | download archived builds from \url{http://www.rockbox.org/daily.shtml}. | 293 | you can download archived builds from \url{http://www.rockbox.org/daily.shtml}. |
236 | 294 | ||
237 | \end{description} | 295 | \end{description} |
238 | 296 | ||
239 | \warn{Because current builds and daily builds are development versions which | 297 | \note{Because current and archived builds are development versions that |
240 | change frequently, they may behave differently than described in this manual, | 298 | change frequently, they may behave differently than described in this manual, |
241 | or they may introduce new (and maybe annoying) bugs. If you do not want to | 299 | or they may introduce new (and potentially annoying) bugs. Unless you wish to |
242 | get undefined behaviour from your \dap{}, you should stick to the current | 300 | try the latest and greatest features at the price of possibly greater instability, |
243 | stable release if there is one for your \dap{}. If you want to help with | 301 | or you wish to help with development, you should stick with the release.\\*} |
244 | project development, you can try development builds and help by reporting bugs. | 302 | |
245 | Just be aware that these are development builds that are highly functional | 303 | Please now go to \reference{ref:finish_install} to complete the installation procedure. |
246 | but not perfect!} | 304 | |
305 | \subsection{Manual Installation} | ||
306 | |||
307 | The manual installation method is still available to you, should you need or desire it | ||
308 | by following the instructions below. If you have used Rockbox Utility | ||
309 | to install Rockbox, then you do not need to follow the next section and can skip | ||
310 | straight to \reference{ref:finish_install} | ||
247 | 311 | ||
248 | \subsubsection{Installing the firmware}\label{sec:installing_firmware} | 312 | \subsubsection{Installing the firmware}\label{sec:installing_firmware} |
249 | 313 | ||
@@ -251,6 +315,9 @@ you want to install and get the appropriate version for your \dap{}. | |||
251 | 315 | ||
252 | \item Download your chosen version of Rockbox from the links in the | 316 | \item Download your chosen version of Rockbox from the links in the |
253 | previous section. | 317 | previous section. |
318 | \opt{ipodvideo}{\note{There are separate versions of Rockbox for the 30GB and | ||
319 | 60GB/80GB models. You must ensure you download the correct version for your | ||
320 | \dap{}.}} | ||
254 | 321 | ||
255 | \item Connect your \dap{} to the computer via USB | 322 | \item Connect your \dap{} to the computer via USB |
256 | \opt{ipod3g,ipod4g,ipodmini,ipodcolor}{ or Firewire} as described in | 323 | \opt{ipod3g,ipod4g,ipodmini,ipodcolor}{ or Firewire} as described in |
@@ -269,50 +336,18 @@ structure that Rockbox needs.} | |||
269 | \end{enumerate} | 336 | \end{enumerate} |
270 | 337 | ||
271 | \opt{archos}{ | 338 | \opt{archos}{ |
272 | \note{ | 339 | If the contents of the \fname{.zip} file are extracted correctly, you will |
273 | If the contents of the \fname{.zip} file are extracted correctly, you will | 340 | have a file called \fname{\firmwarefilename} in the main directory of your |
274 | have a file called \fname{\firmwarefilename} in the main directory of your | 341 | \daps{} drive, and also a directory called \fname{.rockbox}, which contains a |
275 | \daps{} drive, and also a directory called \fname{.rockbox}, which contains a | 342 | number of other directories and system files needed by Rockbox. |
276 | number of other directories and system files needed by Rockbox. If you receive a | ||
277 | ``-1'' error when you start Rockbox, you have not extracted the contents of | ||
278 | the \fname{.zip} file to the proper location. | ||
279 | } | ||
280 | } | 343 | } |
281 | 344 | ||
282 | % This has nothing to do with swcodec, just that these players need our own | 345 | % This has nothing to do with swcodec, just that these players need our own |
283 | % bootloader so we can decide where we want the main binary. | 346 | % bootloader so we can decide where we want the main binary. |
284 | \opt{swcodec}{ | 347 | \opt{swcodec}{ |
285 | \note{ | 348 | If the contents of the \fname{.zip} file are extracted correctly, you will |
286 | If the contents of the \fname{.zip} file are extracted correctly, you will | 349 | have a directory called \fname{.rockbox}, which contains all the files needed |
287 | have a directory called \fname{.rockbox}, which contains all the files needed | 350 | by Rockbox, in the main directory of your \daps{} drive. |
288 | by Rockbox, in the main directory of your \daps{} drive. If you receive a | ||
289 | ``-1'' error when you start Rockbox, you have not extracted the contents of | ||
290 | the \fname{.zip} file to the proper location. | ||
291 | } | ||
292 | } | ||
293 | |||
294 | \nopt{player}{ | ||
295 | \subsubsection{Installing the fonts package}{\index{Installation!Fonts}\label{sec:installing_fonts} | ||
296 | Rockbox has a fonts package that is available at | ||
297 | \url{http://www.rockbox.org/daily.shtml} or from the \emph{extras} link in | ||
298 | the menu on the Rockbox website. The fonts package rarely changes and is | ||
299 | therefore not included in the firmware \fname{.zip} file. When installing | ||
300 | Rockbox for the first time, you should install the fonts package. | ||
301 | |||
302 | \begin{enumerate} | ||
303 | |||
304 | \item Download the fonts package from the link above. | ||
305 | |||
306 | \item Take the file that you downloaded above, and use the ``Extract | ||
307 | all'' command of your unzip program to extract the files in the | ||
308 | \fname{.zip} file onto your \dap{}. As with the firmware installation, the | ||
309 | entire contents of the fonts \fname{.zip} should be extracted directly to the | ||
310 | root of your \daps{} drive. Do not try to create a separate directory | ||
311 | on your \dap{} for the fonts! The \fname{.zip} already contains the | ||
312 | correct internal structure. | ||
313 | |||
314 | \end{enumerate} | ||
315 | } | ||
316 | } | 351 | } |
317 | 352 | ||
318 | \opt{swcodec}{ | 353 | \opt{swcodec}{ |
@@ -327,20 +362,71 @@ structure that Rockbox needs.} | |||
327 | \opt{gigabeats}{\input{getting_started/gigabeats_install.tex}} | 362 | \opt{gigabeats}{\input{getting_started/gigabeats_install.tex}} |
328 | } | 363 | } |
329 | 364 | ||
365 | \subsection{Finishing the install}\label{ref:finish_install} | ||
366 | |||
367 | \opt{gigabeatf}{ | ||
368 | After installing you \emph{need} to power-cycle the | ||
369 | \dap{} by doing the following steps. Failure to do so may result in problems. | ||
370 | \begin{itemize} | ||
371 | \item Safely eject / unmount your \dap{} and unplug the USB cable. | ||
372 | \item Unplug any power adapter. | ||
373 | \item Hold the \ButtonPower{} button to turn off the \dap{}. | ||
374 | \item Slide the battery switch located on the bottom of the \dap{} from | ||
375 | `on' to `off'. | ||
376 | \item Slide the battery switch back from `off' to `on'. | ||
377 | \end{itemize} | ||
378 | } | ||
379 | |||
380 | \opt{m5,x5}{ | ||
381 | After installing you \emph{need} to power-cycle the | ||
382 | \dap{} by doing the following steps. | ||
383 | \begin{itemize} | ||
384 | \item Safely eject / unmount your \dap{} and unplug the USB cable. | ||
385 | \item Hold the \ButtonPower{} button to turn off the \dap{}. | ||
386 | \item Insert the charger. The Rockbox bootloader will automatically be flashed. | ||
387 | \end{itemize} | ||
388 | } | ||
389 | |||
390 | \opt{h10,h10_5gb,ipod,mrobe100,sansa,archos}{ | ||
391 | Safely eject / unmount the USB drive, unplug the cable and restart. | ||
392 | } | ||
393 | |||
394 | \opt{h100,h300}{ | ||
395 | \begin{itemize} | ||
396 | \item Safely eject / unmount your \dap{}. | ||
397 | |||
398 | \item \warn{Before proceeding further, make sure that your player has a full charge | ||
399 | or that it is connected to the power adaptor. Interrupting the next step | ||
400 | due to a power failure most likely will brick your \dap{}.} | ||
401 | Update your \daps{} firmware with the patched bootloader. To do this, turn | ||
402 | the jukebox on. Press and hold the \ButtonSelect{} button to enter the main menu, | ||
403 | and navigate to \setting{General $\rightarrow$ Firmware Upgrade}. Select | ||
404 | \setting{Yes} when asked to confirm if you want to upgrade the | ||
405 | firmware. The \playerman{} will display a message indicating that the | ||
406 | firmware update is in progress. Do \emph{not} interrupt this process. When the | ||
407 | firmware update is complete the player will turn itself off. (The update | ||
408 | firmware process usually takes a minute or so.). You are now ready to go. | ||
409 | \end{itemize} | ||
410 | } | ||
411 | |||
412 | |||
330 | \subsection{Enabling Speech Support (optional)}\label{sec:enabling_speech_support} | 413 | \subsection{Enabling Speech Support (optional)}\label{sec:enabling_speech_support} |
331 | \index{Speech}\index{Installation!Optional Steps} | 414 | \index{Speech}\index{Installation!Optional Steps} |
332 | If you wish to use speech support you will also need a voice file, English ones | 415 | If you wish to use speech support you will also need a voice file. Voice files |
333 | are available from \url{http://www.rockbox.org/daily.shtml}. Download the | 416 | allow Rockbox to speak the user interface to you. Rockbox Utility can install |
334 | ``voice'' package for your player and unzip it directly to the root of your \dap. | 417 | an English voice file, or you can download it from \url{http://www.rockbox.org/daily.shtml} |
335 | You should now find an \fname{english.voice} in the \fname{/.rockbox/langs} | 418 | and unzip it to the root of your \dap{}. |
336 | directory on your \dap{}. Voice menus are enabled by default and will come | 419 | Rockbox Utility can also aid you in the creation of voice files with different voices |
420 | or in other languages if you have a suitable speech engine installed on your computer. | ||
421 | Voice menus are enabled by default and will come | ||
337 | into effect after a reboot. See \reference{ref:Voiceconfiguration} for details | 422 | into effect after a reboot. See \reference{ref:Voiceconfiguration} for details |
338 | on voice settings. | 423 | on voice settings. |
424 | Rockbox Utility can also aid in the production of talk files, which allow Rockbox | ||
425 | to speak file and folder names. | ||
339 | 426 | ||
340 | \section{Running Rockbox} | 427 | \section{Running Rockbox} |
341 | Remove your \dap{} from the computer's USB port. % | ||
342 | \nopt{ipod,e200}{Unplug any connected power supply and turn the unit off. When | 428 | \nopt{ipod,e200}{Unplug any connected power supply and turn the unit off. When |
343 | you next turn the unit on, Rockbox should load. }% | 429 | you next turn the unit on, Rockbox should load.}% |
344 | \opt{ipod}{Hard resetting the Ipod by holding | 430 | \opt{ipod}{Hard resetting the Ipod by holding |
345 | \opt{IPOD_4G_PAD}{\ButtonMenu{}+\ButtonSelect{}}% | 431 | \opt{IPOD_4G_PAD}{\ButtonMenu{}+\ButtonSelect{}}% |
346 | \opt{IPOD_3G_PAD}{\ButtonMenu{}+\ButtonPlay{}} | 432 | \opt{IPOD_3G_PAD}{\ButtonMenu{}+\ButtonPlay{}} |
@@ -354,22 +440,24 @@ use. | |||
354 | \note{ | 440 | \note{ |
355 | If you have loaded music onto your \dap{} using Itunes, | 441 | If you have loaded music onto your \dap{} using Itunes, |
356 | you will not be able to see your music properly in the \setting{File Browser}. | 442 | you will not be able to see your music properly in the \setting{File Browser}. |
357 | This is because Itunes changes your files' names and hides them in | 443 | This is because Itunes changes your files' names and hides them in |
358 | directories in the \fname{Ipod\_Control} directory. Files placed on your | 444 | directories in the \fname{Ipod\_Control} directory. Files placed on your |
359 | \dap{} using Itunes can be viewed by initializing and using Rockbox's database. | 445 | \dap{} using Itunes can be viewed by initialising and using Rockbox's database. |
360 | See \reference{ref:database} for more information. | 446 | See \reference{ref:database} for more information. |
361 | } | 447 | } |
362 | } | 448 | } |
363 | 449 | ||
364 | \section{Updating Rockbox} | 450 | \section{Updating Rockbox} |
365 | Updating Rockbox is easy even if you do not use the Rockbox Utility. | 451 | Rockbox can be easily updated with Rockbox Utility. |
366 | Download a Rockbox build. | 452 | You can also update Rockbox manually - download a Rockbox build |
367 | (The latest release of the Rockbox software will always be available from | 453 | as detailed above, and unzip the build to the root directory |
368 | \url{http://www.rockbox.org/download/}). Unzip the build to the root directory | 454 | of your \dap{} as in the manual installation stage. If your unzip |
369 | of your \dap{} like you did in the installation stage. If your unzip | ||
370 | program asks you whether to overwrite files, choose the ``Yes to all'' option. | 455 | program asks you whether to overwrite files, choose the ``Yes to all'' option. |
371 | The new build will be installed over your current build. | 456 | The new build will be installed over your current build. |
372 | 457 | ||
458 | The bootloader only changes rarely, and should not normally | ||
459 | need to be updated. | ||
460 | |||
373 | \note{If you use Rockbox Utility be aware that it cannot detect manually | 461 | \note{If you use Rockbox Utility be aware that it cannot detect manually |
374 | installed components.} | 462 | installed components.} |
375 | 463 | ||
@@ -438,27 +526,50 @@ completely follow the manual uninstallation instructions below.}} | |||
438 | } | 526 | } |
439 | 527 | ||
440 | \opt{h100,h300}{ | 528 | \opt{h100,h300}{ |
441 | \note{ | ||
442 | If you want to remove the Rockbox bootloader, simply flash an unpatched | 529 | If you want to remove the Rockbox bootloader, simply flash an unpatched |
443 | \playerman{} firmware. Be aware that doing so will also remove the bootloader | 530 | \playerman{} firmware. Be aware that doing so will also remove the bootloader |
444 | USB mode. As that mode can come in quite handy (especially when | 531 | USB mode. As that mode can come in quite handy (especially if you experience |
445 | having disk errors) it is recommended to keep the bootloader. It also | 532 | disk errors) it is recommended to keep the bootloader. It also |
446 | gives you the possibility of trying Rockbox anytime later by simply | 533 | gives you the possibility of trying Rockbox anytime later by simply |
447 | installing the distribution files. | 534 | installing the distribution files. |
448 | \opt{h100}{ | 535 | \opt{h100}{ |
449 | The Rockbox bootloader will automatically start the original firmware if | 536 | The Rockbox bootloader will automatically start the original firmware if |
450 | the \fname{.rockbox} directory has been deleted. | 537 | the \fname{.rockbox} directory has been deleted. |
451 | }% | 538 | } |
452 | \opt{h300}{% | 539 | \opt{h300}{ |
453 | Although if you retain the Rockbox bootloader, you will need to hold the | 540 | Although if you retain the Rockbox bootloader, you will need to hold the |
454 | \ButtonRec{} button each time you want to start the original firmware. | 541 | \ButtonRec{} button each time you want to start the original firmware. |
455 | } | 542 | } |
456 | } | ||
457 | } | 543 | } |
458 | 544 | ||
459 | If you wish to clean up your disk, you may also wish to delete the | 545 | If you wish to clean up your disk, you may also wish to delete the |
460 | \fname{.rockbox} directory and its contents. | 546 | \fname{.rockbox} directory and its contents. |
461 | \nopt{m5,x5}{Turn the \playerman{} off. | 547 | \nopt{m5,x5}{Turn the \playerman{} off. |
462 | Turn the \dap{} back on and the original \playerman{} software will load. | 548 | Turn the \dap{} back on and the original \playerman{} software will load.} |
463 | } | ||
464 | 549 | ||
550 | \section{Troubleshooting} | ||
551 | \begin{description} | ||
552 | \item[``-1 error''] | ||
553 | If you receive a ``-1 error'' from the bootloader, then | ||
554 | the bootloader cannot find the Rockbox firmware. This is usually a result of | ||
555 | not extracting the contents of the \fname{.zip} file to the proper location, | ||
556 | and should not happen when Rockbox has been installed with Rockbox Utility. | ||
557 | |||
558 | To fix this, either install Rockbox with the Rockbox Utility which will take care | ||
559 | of this for you, or recheck the Manual Install section to see where the files | ||
560 | need to be located. | ||
561 | |||
562 | \opt{sansa,ipod}{ | ||
563 | \item[Bootloader install problems] | ||
564 | If you have trouble installing the bootloader, | ||
565 | please ensure that you are either logged in as an administrator (Windows), or | ||
566 | you have root rights (Linux)} | ||
567 | |||
568 | \opt{h100,h300}{ | ||
569 | \item[Immediately loading original firmware.] | ||
570 | If the original firmware is immediately | ||
571 | loaded without the Rockbox bootloader appearing first, then the Rockbox bootloader | ||
572 | has not been correctly installed. The original firmware update will only perform | ||
573 | the update if the filename is correct, including case. Make sure that the patched | ||
574 | Iriver firmware is called \fname{.hex}.} | ||
575 | \end{description} \ No newline at end of file | ||
diff --git a/manual/getting_started/ipod_install.tex b/manual/getting_started/ipod_install.tex index f53263b9ab..2ec5bf8798 100644 --- a/manual/getting_started/ipod_install.tex +++ b/manual/getting_started/ipod_install.tex | |||
@@ -1,31 +1,12 @@ | |||
1 | % $Id$ % | 1 | % $Id$ % |
2 | 2 | ||
3 | \opt{ipodnano}{\warn{If your Nano has a stainless steel back and plastic front, | ||
4 | it is a 1st generation and is compatible with Rockbox. If, on the other hand, | ||
5 | your Nano has a one-piece aluminum body it is a 2nd generation Nano and there | ||
6 | is currently no Rockbox port available. Do not attempt to install the | ||
7 | bootloader on a 2nd generation Nano}} | ||
8 | |||
9 | In order to make your \dap{} load and execute the Rockbox firmware you | ||
10 | have just installed, you will need to install the Rockbox | ||
11 | bootloader. Unless bugs are found in the bootloader code, or | ||
12 | significant new feature are added, you will only have to perform this | ||
13 | step once. | ||
14 | |||
15 | \subsubsection{Bootloader installation from Windows} | 3 | \subsubsection{Bootloader installation from Windows} |
16 | 4 | ||
17 | \begin{enumerate} | 5 | \begin{enumerate} |
18 | 6 | ||
19 | \item Make sure you are logged into your computer as Administrator, or a | ||
20 | user with Administrator privileges and connect your \dap{}. If you have | ||
21 | configured iTunes to open automatically when your \dap{} is attached | ||
22 | (the default behaviour), then wait for it to open and then quit it. You | ||
23 | also need to ensure the ``Enable use as disk'' option is enabled for | ||
24 | your \dap{} in iTunes. | ||
25 | |||
26 | \item Download ipodpatcher.exe from | 7 | \item Download ipodpatcher.exe from |
27 | \download{bootloader/ipod/ipodpatcher/win32/ipodpatcher.exe} | 8 | \download{bootloader/ipod/ipodpatcher/win32/ipodpatcher.exe} |
28 | and run it. | 9 | and run it whilst logged in with an administrator account. |
29 | 10 | ||
30 | \item If all has gone well, you should see some information displayed about | 11 | \item If all has gone well, you should see some information displayed about |
31 | your \dap{} and a message asking you if you wish to install the Rockbox | 12 | your \dap{} and a message asking you if you wish to install the Rockbox |
@@ -35,17 +16,11 @@ install the bootloader. After a short time you should see the message | |||
35 | ipodpatcher. | 16 | ipodpatcher. |
36 | 17 | ||
37 | \item \note{If ipodpatcher fails to install the bootloader for you, please | 18 | \item \note{If ipodpatcher fails to install the bootloader for you, please |
38 | be certain that you do indeed have a supported iPod model. If you do, run | 19 | be certain that you do indeed have a supported iPod model and are logged in |
20 | as an administrator. If you do, run | ||
39 | ipodpatcher once more and try again. If you don't, then do not attempt to | 21 | ipodpatcher once more and try again. If you don't, then do not attempt to |
40 | install again.} | 22 | install again.} |
41 | 23 | ||
42 | \item Make sure that you have correctly extracted a build of Rockbox so that | ||
43 | you have a \fname{/.rockbox}, which contains all the files needed by Rockbox | ||
44 | in the root of your \daps{} drive and that you have also installed the fonts | ||
45 | package -- see \reference{sec:installing_fonts} for more information. | ||
46 | |||
47 | \item Disconnect your \dap{} in the usual way. The bootloader is now installed. | ||
48 | |||
49 | \end{enumerate} | 24 | \end{enumerate} |
50 | 25 | ||
51 | \subsubsection{Bootloader installation from Mac OS X} | 26 | \subsubsection{Bootloader installation from Mac OS X} |
@@ -53,10 +28,7 @@ package -- see \reference{sec:installing_fonts} for more information. | |||
53 | \begin{enumerate} | 28 | \begin{enumerate} |
54 | 29 | ||
55 | \item Attach your \dap{} to your Mac and wait for its icon to appear in | 30 | \item Attach your \dap{} to your Mac and wait for its icon to appear in |
56 | Finder. If you have configured iTunes to open automatically when your | 31 | Finder. |
57 | \dap{} is attached (the default behaviour), then wait for it to open and | ||
58 | then quit it. You also need to ensure the ``Enable use as disk'' option | ||
59 | is enabled for your \dap{} in iTunes. | ||
60 | 32 | ||
61 | \item Download and open ipodpatcher.dmg from | 33 | \item Download and open ipodpatcher.dmg from |
62 | \download{bootloader/ipod/ipodpatcher/macosx/ipodpatcher.dmg} | 34 | \download{bootloader/ipod/ipodpatcher/macosx/ipodpatcher.dmg} |
@@ -76,18 +48,12 @@ be certain that you do indeed have a supported iPod model. If you do, run | |||
76 | ipodpatcher once more and try again. If you don't, then do not attempt to | 48 | ipodpatcher once more and try again. If you don't, then do not attempt to |
77 | install again.} | 49 | install again.} |
78 | 50 | ||
79 | |||
80 | \item Your \dap{} will now automatically reconnect itself to your Mac. | 51 | \item Your \dap{} will now automatically reconnect itself to your Mac. |
81 | Wait for it to connect, and then eject and unplug it in the normal way. | 52 | Wait for it to connect, and then eject and unplug it in the normal way. |
82 | \note{You should unplug your ipod immediately after ejecting it to | 53 | \note{You should unplug your ipod immediately after ejecting it to |
83 | prevent Rockbox immediately rebooting your \dap{} into disk mode when it | 54 | prevent Rockbox immediately rebooting your \dap{} into disk mode when it |
84 | detects that your \dap{} is attached to a computer. } | 55 | detects that your \dap{} is attached to a computer. } |
85 | 56 | ||
86 | \item Make sure that you have correctly extracted a build of Rockbox so that | ||
87 | you have a \fname{/.rockbox}, which contains all the files needed by Rockbox | ||
88 | in the root of your \daps{} drive and that you have also installed the fonts | ||
89 | package -- see \reference{sec:installing_fonts} for more information. | ||
90 | |||
91 | \end{enumerate} | 57 | \end{enumerate} |
92 | 58 | ||
93 | \subsubsection{Bootloader installation from Linux} | 59 | \subsubsection{Bootloader installation from Linux} |
@@ -110,7 +76,7 @@ steps will assume you have saved it in your home directory. | |||
110 | ./ipodpatcher | 76 | ./ipodpatcher |
111 | \end{code} | 77 | \end{code} |
112 | 78 | ||
113 | \warn{You may need to be the root user in order for ipodpatcher to have | 79 | \note{You need to be the root user in order for ipodpatcher to have |
114 | sufficient permission to perform raw disk access to your \dap{}.} | 80 | sufficient permission to perform raw disk access to your \dap{}.} |
115 | 81 | ||
116 | \item If all has gone well, you should see some information displayed about | 82 | \item If all has gone well, you should see some information displayed about |
@@ -119,11 +85,4 @@ bootloader. Press i followed by ENTER, and ipodpatcher will now install the | |||
119 | bootloader. After a short time you should see the message ``[INFO] Bootloader | 85 | bootloader. After a short time you should see the message ``[INFO] Bootloader |
120 | installed successfully.'' Press ENTER again to exit ipodpatcher. | 86 | installed successfully.'' Press ENTER again to exit ipodpatcher. |
121 | 87 | ||
122 | \item Make sure that you have correctly extracted a build of Rockbox so that | ||
123 | you have a \fname{/.rockbox}, which contains all the files needed by Rockbox | ||
124 | in the root of your \daps{} drive and that you have also installed the fonts | ||
125 | package -- see \reference{sec:installing_fonts} for more information. | ||
126 | |||
127 | \item Disconnect your \dap{} in the usual way. The bootloader is now installed. | ||
128 | |||
129 | \end{enumerate} | 88 | \end{enumerate} |
diff --git a/manual/getting_started/iriver_install.tex b/manual/getting_started/iriver_install.tex index 97b43db776..fbc53fec37 100644 --- a/manual/getting_started/iriver_install.tex +++ b/manual/getting_started/iriver_install.tex | |||
@@ -1,102 +1,29 @@ | |||
1 | % $Id$ % | 1 | % $Id$ % |
2 | 2 | ||
3 | Installing the bootloader is the trickiest part of the installation. | 3 | Installing the bootloader is the trickiest part of the installation. |
4 | The Rockbox bootloader allows users to boot into either the Rockbox | 4 | As explained above, we cannot distribute the bootloader directly, and |
5 | firmware or the \playerman{} firmware. For legal reasons, we cannot distribute | 5 | thus need to patch a compatible version of the Iriver firmware, which |
6 | the bootloader. Instead, we have developed a program that will patch the | 6 | can be downloaded as described above. |
7 | Iriver firmware with the Rockbox bootloader. These instructions will explain | ||
8 | how to download and patch the Iriver firmware with the Rockbox bootloader | ||
9 | and install it on your jukebox. | ||
10 | 7 | ||
11 | 8 | ||
12 | \begin{enumerate} | 9 | \begin{enumerate} |
13 | \item Download a supported version of the Iriver firmware for your | ||
14 | \playername{} from the Iriver website, links can be found on | ||
15 | \wikilink{IriverBoot}. | ||
16 | Supported Iriver firmware versions currently include | ||
17 | \opt{IRIVER_H100_PAD}{1.63US, 1.63EU, 1.63K, 1.65US, 1.65EU, 1.65K, 1.66US, | ||
18 | 1.66EU and 1.66K. Note that the H140 uses the same firmware as the H120; | ||
19 | H120 and H140 owners should use the firmware called \fname{ihp\_120.hex}. | ||
20 | Likewise, the iHP110 and iHP115 use the same firmware, called | ||
21 | \fname{ihp\_100.hex}. Be sure to use the correct firmware file for | ||
22 | your player.} | ||
23 | \opt{IRIVER_H300_PAD}{1.28K, 1.28EU, 1.28J, 1.29K, 1.29J and 1.30EU. | ||
24 | \note{The US \playername{} firmware is not supported and cannot be | ||
25 | patched to be used with the bootloader. If you wish to install Rockbox | ||
26 | on a US \playername, you must first install a non-US version of the | ||
27 | original firmware and then install one of the supported versions patched | ||
28 | with the Rockbox bootloader. | ||
29 | \warn{Installing non-US firmware on a US \playername{} will | ||
30 | permanently remove DRM support from the player.}} | ||
31 | }% | ||
32 | If the file that you downloaded is a \fname{.zip} file, use an unzip | ||
33 | utility like mentioned in the prerequisites section to extract | ||
34 | the \fname{.hex} from the \fname{.zip} file | ||
35 | to your desktop. Likewise, if the file that you downloaded is an | ||
36 | \fname{.exe} file, double-click on the \fname{.exe} file to extract | ||
37 | the \fname{.hex} file to your desktop. | ||
38 | When running Linux you should be able extracting \fname{.exe} | ||
39 | files using \fname{unzip}. | ||
40 | % | ||
41 | \item Download the firmware patcher \fname{fwpatcher.exe} from | 10 | \item Download the firmware patcher \fname{fwpatcher.exe} from |
42 | \url{http://download.rockbox.org/bootloader/iriver/} and save it to your desktop. | 11 | \url{http://download.rockbox.org/bootloader/iriver/} and save it to your desktop. |
43 | \warn{The firmware patcher contains Unicode support, which is not supported by | 12 | \note{The firmware patcher contains Unicode support, which is not supported by |
44 | all versions of Windows. If you have difficulty with the firmware patcher, try | 13 | all versions of Windows. If you have difficulty with the firmware patcher, try |
45 | downloading the alternate firmware patcher \fname{fwpatchernu.exe}, which is | 14 | downloading the alternate firmware patcher \fname{fwpatchernu.exe}, which is |
46 | built without Unicode support.} | 15 | built without Unicode support.} |
47 | % | 16 | % |
48 | \item Go to your desktop and double-click on whichever version of the firmware | 17 | \item Go to your desktop and double-click on the firmware patcher. |
49 | patcher you downloaded in the prior step. | ||
50 | % | 18 | % |
51 | \item In the firmware patcher dialog box, click on the \setting{Browse} | 19 | \item In the firmware patcher dialog box, click on the \setting{Browse} |
52 | button and navigate | 20 | button and navigate |
53 | to the \fname{.hex} file that you previously downloaded to your desktop. | 21 | to the \fname{.hex} file that you previously downloaded. |
54 | % | 22 | % |
55 | \item Click \setting{Patch}. The firmware patcher will patch the | 23 | \item Click \setting{Patch}. The firmware patcher will patch the |
56 | original firmware to include the Rockbox bootloader. The \fname{.hex} | 24 | original firmware to include the Rockbox bootloader. The \fname{.hex} |
57 | file on your desktop is now a modified version of the original | 25 | file on your desktop is now a modified version of the original |
58 | \fname{.hex} file. | 26 | \fname{.hex} file. |
59 | % | 27 | % |
60 | \item Turn on your \playerman{} and connect it to your computer via USB. | 28 | \item Copy \fname{.hex} to the root folder (the highest level) of your \dap{} |
61 | % | ||
62 | \item Copy or move the modified \fname{.hex} file directly to the root of | ||
63 | your \daps{} drive. Do not put it inside a directory on your \dap. | ||
64 | % | ||
65 | \item Disconnect the jukebox from USB. (Be sure to use Windows' ``safely remove | ||
66 | hardware'' option.) | ||
67 | \warn{Before proceeding further, make sure that your player has a full charge | ||
68 | or that it is connected to the power adaptor. Interrupting the next step | ||
69 | due to a power failure most likely will brick your \dap{}.} | ||
70 | % | ||
71 | \item Update your \daps{} firmware with the patched bootloader. To do this, turn | ||
72 | the jukebox on. Press and hold the | ||
73 | \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonSelect{} button }% | ||
74 | to enter the main menu, and navigate to \setting{General $\rightarrow$ Firmware | ||
75 | Upgrade}. Select \setting{Yes} when asked to confirm if you want to upgrade the | ||
76 | firmware. The \playerman{} will display a message indicating that the | ||
77 | firmware update | ||
78 | is in progress. Do \emph{not} interrupt this process. When the | ||
79 | firmware update is complete the player will turn itself off. (The update | ||
80 | firmware process usually takes a minute or so.) | ||
81 | |||
82 | You have now installed the Rockbox bootloader. | ||
83 | \end{enumerate} | 29 | \end{enumerate} |
84 | |||
85 | \note{If you install the Rockbox bootloader but do not install the | ||
86 | Rockbox firmware the Rockbox bootloader will load the Iriver firmware when the | ||
87 | jukebox is turned on. | ||
88 | To load the \playerman{} firmware press and hold \ButtonRec{} before | ||
89 | powering up the \dap{} until the \playerman{} logo appears. | ||
90 | } | ||
91 | |||
92 | \note{The bootloader has a built-in ``bootloader USB mode''. This function | ||
93 | switches to USB mode when the \dap{} is connected to a computer upon | ||
94 | power-up. This way you can access the \daps{} hard disk without the need | ||
95 | to boot any firmware (which is also useful when your hard disk is | ||
96 | damaged). The screen will simply display the text ``bootloader USB mode''. | ||
97 | After you disconnect the \dap{} from USB the bootloader will | ||
98 | continue booting Rockbox. As in bootloader USB mode the firmware | ||
99 | itself has not been loaded this is also a simple way of updating Rockbox. | ||
100 | After the disconnect the bootloader will load the updated version of | ||
101 | Rockbox. | ||
102 | } | ||
diff --git a/manual/getting_started/mrobe100_install.tex b/manual/getting_started/mrobe100_install.tex index 3379239924..41fafac073 100644 --- a/manual/getting_started/mrobe100_install.tex +++ b/manual/getting_started/mrobe100_install.tex | |||
@@ -1,10 +1,10 @@ | |||
1 | \subsubsection{Installation} | 1 | \subsubsection{Installation} |
2 | \begin{enumerate} | 2 | \begin{enumerate} |
3 | \item Download | 3 | \item Download |
4 | \opt{mrobe100}{\url{http://download.rockbox.org/bootloader/olympus/mrobe100/pp5020.mi4}} | 4 | {\url{http://download.rockbox.org/bootloader/olympus/mrobe100/pp5020.mi4}} |
5 | \item Connect your \playertype{} to the computer. | 5 | \item Connect your \playertype{} to the computer. |
6 | \item Rename the original \fname{pp5020.mi4} file to \fname{OF.mi4} in the \fname{System} directory on your \playertype{}. | 6 | \item Rename the original \fname{pp5020.mi4} file to \fname{OF.mi4} in the \fname{System} directory on your \playertype{}. |
7 | \note{You should keep a safe backup of this file for use if you ever wish to switch back to the \playerman{} firmware.} | 7 | \warn{You should keep a safe backup of this file for use if you ever wish to switch back to the \playerman{} firmware.} |
8 | \note{If you cannot see the \fname{System} directory, you will need to make sure your operating system is configured to show hidden files and directories.} | 8 | \note{If you cannot see the \fname{System} directory, you will need to make sure your operating system is configured to show hidden files and directories.} |
9 | 9 | ||
10 | \item Copy the \fname{pp5020.mi4} file you downloaded to the System directory on your \dap{}. | 10 | \item Copy the \fname{pp5020.mi4} file you downloaded to the System directory on your \dap{}. |
diff --git a/manual/getting_started/sansa_install.tex b/manual/getting_started/sansa_install.tex index 5fc852096e..7956e94f76 100644 --- a/manual/getting_started/sansa_install.tex +++ b/manual/getting_started/sansa_install.tex | |||
@@ -1,32 +1,11 @@ | |||
1 | % $Id$ % | 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 | \warn{If your \daps{} original firmware starts with a version number of 03.XX.XX, then do \emph{not} proceed with these install instructions. | ||
8 | If your \daps{} original firmware starts with 01.XX.XX, then you can | ||
9 | install Rockbox.} | ||
10 | |||
11 | In order to make your \playertype{} load and execute the Rockbox firmware you | ||
12 | have just installed, you will need to install the Rockbox | ||
13 | bootloader. Unless bugs are found in the bootloader code, or | ||
14 | significant new features are added, you will only have to perform this | ||
15 | step once. | ||
16 | |||
17 | These steps use the sansapatcher tool. Source code is available in the Rockbox | ||
18 | SVN repository (\url{http://svn.rockbox.org/viewvc.cgi/trunk/rbutil/sansapatcher/}). | ||
19 | |||
20 | \subsubsection{Bootloader installation from Windows} | 2 | \subsubsection{Bootloader installation from Windows} |
21 | 3 | ||
22 | \begin{enumerate} | 4 | \begin{enumerate} |
23 | 5 | ||
24 | \item Make sure you are logged into your computer as Administrator, or a | ||
25 | user with Administrator privileges and connect your \dap{}. | ||
26 | |||
27 | \item Download sansapatcher.exe from | 6 | \item Download sansapatcher.exe from |
28 | \download{bootloader/sandisk-sansa/sansapatcher/win32/sansapatcher.exe} | 7 | \download{bootloader/sandisk-sansa/sansapatcher/win32/sansapatcher.exe} |
29 | and run it. | 8 | and run it whilst logged in with an administrator account. |
30 | 9 | ||
31 | \item If all has gone well, you should see some information displayed about | 10 | \item If all has gone well, you should see some information displayed about |
32 | your \playertype{} and a message asking you if you wish to install the Rockbox | 11 | your \playertype{} and a message asking you if you wish to install the Rockbox |
@@ -34,9 +13,6 @@ bootloader. Press i followed by ENTER, and sansapatcher will now | |||
34 | install the bootloader. After a short time you should see the message | 13 | install the bootloader. After a short time you should see the message |
35 | ``[INFO] Bootloader installed successfully.'' Press ENTER again to exit | 14 | ``[INFO] Bootloader installed successfully.'' Press ENTER again to exit |
36 | sansapatcher. | 15 | sansapatcher. |
37 | |||
38 | \item Disconnect your \dap{} in the usual way. The bootloader is now installed. | ||
39 | |||
40 | \end{enumerate} | 16 | \end{enumerate} |
41 | 17 | ||
42 | \subsubsection{Bootloader installation from Mac OS X} | 18 | \subsubsection{Bootloader installation from Mac OS X} |
@@ -54,11 +30,8 @@ and then double-click on the sansapatcher icon inside. | |||
54 | information displayed about your \dap{} and a message asking you if you | 30 | information displayed about your \dap{} and a message asking you if you |
55 | wish to install the Rockbox bootloader. Press i followed by ENTER, and | 31 | wish to install the Rockbox bootloader. Press i followed by ENTER, and |
56 | sansapatcher will now unmount your \dap{} and install the bootloader. | 32 | sansapatcher will now unmount your \dap{} and install the bootloader. |
57 | 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. | 33 | After a short time you should see the message ``[INFO] Bootloader installed successfully.'' |
58 | 34 | Press ENTER again to exit sansapatcher and then quit the Terminal application. | |
59 | \item Your \dap{} will now automatically reconnect itself to your Mac. | ||
60 | Wait for it to connect, and then eject and unplug it in the normal way. | ||
61 | |||
62 | \end{enumerate} | 35 | \end{enumerate} |
63 | 36 | ||
64 | \subsubsection{Bootloader installation from Linux} | 37 | \subsubsection{Bootloader installation from Linux} |
@@ -81,7 +54,7 @@ steps will assume you have saved it in your home directory. | |||
81 | ./sansapatcher | 54 | ./sansapatcher |
82 | \end{code} | 55 | \end{code} |
83 | 56 | ||
84 | \warn{You may need to be the root user in order for sansapatcher to have | 57 | \note{You need to be the root user in order for sansapatcher to have |
85 | sufficient permission to perform raw disk access to your \dap{}.} | 58 | sufficient permission to perform raw disk access to your \dap{}.} |
86 | 59 | ||
87 | \item If all has gone well, you should see some information displayed about | 60 | \item If all has gone well, you should see some information displayed about |
@@ -89,7 +62,4 @@ your \playertype{} and a message asking you if you wish to install the Rockbox | |||
89 | bootloader. Press i followed by ENTER, and sansapatcher will now install the | 62 | bootloader. Press i followed by ENTER, and sansapatcher will now install the |
90 | bootloader. After a short time you should see the message ``[INFO] Bootloader | 63 | bootloader. After a short time you should see the message ``[INFO] Bootloader |
91 | installed successfully.'' Press ENTER again to exit sansapatcher. | 64 | installed successfully.'' Press ENTER again to exit sansapatcher. |
92 | |||
93 | \item Disconnect your \dap{} in the usual way. The bootloader is now installed. | ||
94 | |||
95 | \end{enumerate} | 65 | \end{enumerate} |