···195 \item[Screen Scrolls Out of View.]
196 Screens can be manually scrolled horizontally by pressing
197 \opt{IRIVER_H10_PAD}{Long \ButtonRew/\ButtonFF}%
198- \nopt{IRIVER_H10_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD%
0199 ,touchscreen}{%
200 Long \ButtonRight/\ButtonLeft}.
201 Setting this option to \setting{Yes}
···195 \item[Screen Scrolls Out of View.]
196 Screens can be manually scrolled horizontally by pressing
197 \opt{IRIVER_H10_PAD}{Long \ButtonRew/\ButtonFF}%
198+ \opt{IRIVER_H10_PAD,XDUOO_X3_PAD}{Long \ButtonPrev/\ButtonNext}%
199+ \nopt{IRIVER_H10_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD,XDUOO_X3_PAD%
200 ,touchscreen}{%
201 Long \ButtonRight/\ButtonLeft}.
202 Setting this option to \setting{Yes}
···56\section{Before Starting}
78-\opt{e200}{\fixme{NOTE: These instructions will not work on the
9-``Rhapsody'' version of the E200 series (also known as E200R). Please
10-follow the instructions at
11\url{http://www.rockbox.org/wiki/SansaE200RInstallation}.}}
1213\opt{ipodnano,ipodnano2g,ipodvideo,ipod6g,e200,c200,c200v2,e200v2,clipv1,clipv2,cowond2,fuze,fuzev2}{
14-\begin{description}
15-\item[Supported hardware versions.]
16 \opt{ipodnano,ipodnano2g}{
17 The \playertype{} is available in multiple versions, not
18- all of which run Rockbox. Rockbox presently runs only on
19 the first and second generation Ipod Nano. Rockbox does
20 \emph{not} run on the third, fourth or fifth generation Ipod Nano.
21 For information on identifying which Ipod you own, see this page on
···23 }
24 \opt{ipodvideo}{
25 The \playertype{} is the 5th/5.5th generation \playerman{} only.
26- For information on identifying which Ipod you own, see this page on Apple's
27 website: \url{http://www.info.apple.com/kbnum/n61688}.
28 }
29 \opt{ipod6g}{
···33 }
34 \opt{c200,c200v2,e200,e200v2}{
35 The \playertype{} is available in multiple versions, and you need to make
36- sure which you have by checking the Sandisk firmware version number under
37 Settings $\rightarrow$ Info. The v1 firmware is named 01.xx.xx, while the
38 v2 firmware begins with 03. Make sure that you are following the
39 instructions from the correct manual.
···97\end{description}
98}
99\opt{iriverh300}{
100-\begin{description}
101 \item[DRM capability.] If your \dap{} has a US firmware, then by installing Rockbox you will
102 \emph{permanently} lose the ability to playback files with DRM.
103\end{description}
104}
105106\opt{sansaAMS,fuzeplus}{
107-\begin{description}
108 \item[DRM capability.] It is possible that installation of the bootloader
109 may lead to you \emph{permanently} losing the ability to playback files
110 with DRM.
···112}
113114\nopt{gigabeats}{
115-\begin{description}
116117\nopt{ipod1g2g}{
118 \item[USB connection.]
···121 \item[Firewire connection.]
122}
123 To transfer Rockbox to your \dap{} you need to
124- connect it to your computer. For manual installation/uninstallation, or
125- should autodetection fail during automatic installation, you need to know
126- where to access the \dap{}. On Windows this means you need to know
127 the drive letter associated with the \dap{}. On Linux you need to know
128 the mount point of your \dap{}. On Mac OS X you need to know the volume
129 name of your \dap{}.
···189 }
190 \opt{gigabeatf}{The installation requires you to change a setting in the
191 original firmware. Make sure the option under \setting{Setup
192- $\rightarrow$ Connections $\rightarrow$ PC Connections} is set to
193 \setting{gigabeat room}. Also, during installation, do not connect your
194 \dap{} using the cradle but plug the USB cable directly to the \dap{}.
195 }
···209}
210211\opt{ipod,sansa}{
212-\begin{description}
213 \item[Administrator/Root rights.] Installing the bootloader portion of Rockbox
214 requires you to have administrative (Windows) or root (Linux) rights.
215 Consequently when doing either the automatic or manual bootloader install,
···279 most of the Rockbox code is contained in a
280 ``build'' that resides on your \daps{} drive. This makes it easy to
281 update Rockbox. The build consists of a directory called
282- \fname{.rockbox} which contains all of the Rockbox files, and is
283 located in the root of your \daps{} drive.
284\end{description}
285}
···320321When first starting \caps{Rockbox Utility} run ``Autodetect'',
322found in the configuration dialog (File $\rightarrow$ Configure). Autodetection
323-can detect most player types. If autodetection fails or is unable to detect
324the mountpoint, make sure to enter the correct values. The mountpoint indicates
325the location of the \dap{} in your filesystem. On Windows, this is the drive
326letter the \dap{} gets assigned, on other systems this is a path in the
···333 the bootloader directly. Instead, we have to patch the Iriver firmware
334 with the Rockbox bootloader.
335336- Download a supported version of the Iriver firmware for your
337- \playername{} from the Iriver website, links can be found on
338 \wikilink{IriverBoot}.
339-340- Supported Iriver firmware versions currently include
341- \opt{iriverh100}{1.63US, 1.63EU, 1.63K, 1.65US, 1.65EU, 1.65K, 1.66US,
342 1.66EU and 1.66K. Note that the H140 uses the same firmware as the H120;
343 H120 and H140 owners should use the firmware called \fname{ihp\_120.hex}.
344- Likewise, the iHP110 and iHP115 use the same firmware, called
345- \fname{ihp\_100.hex}. Be sure to use the correct firmware file for
346 your player.}
347 \opt{iriverh300}{1.28K, 1.28EU, 1.28J, 1.29K, 1.29J, 1.30EU and 1.31K.
348 \note{The US \playername{} firmware is not supported and cannot be
···353 \warn{Installing a non-US firmware on a US \playername{} will
354 \emph{permanently} remove DRM support from the player.}}
355356- If the file that you downloaded is a \fname{.zip} file, use an unzip
357 utility like mentioned in the prerequisites section to extract
358 the \fname{.hex} from the \fname{.zip} file
359- to your desktop. Likewise, if the file that you downloaded is an
360- \fname{.exe} file, double-click on the \fname{.exe} file to extract
361 the \fname{.hex} file to your desktop.
362 When running Linux you should be able to extract \fname{.exe}
363 files using \fname{unzip}.
···369 the bootloader directly. Instead, we have to patch the MPIO firmware
370 with the Rockbox bootloader.
371372- Download a supported version of the MPIO firmware for your
373- \playername{} from the MPIO website, links can be found on
374 \opt{mpiohd200}{\wikilink{MPIOHD200Port}}%
375 \opt{mpiohd300}{\wikilink{MPIOHD300Port}}.
376···420\item[Release.] The release version is the latest stable release, free
421 of known critical bugs. For a manual install, the current stable release of Rockbox is
422 available at \url{http://www.rockbox.org/download/}.
423-424\item[Development Build.] The development build is built at each change to
425 the Rockbox source code repository and represents the current state of Rockbox
426 development. This means that the build could contain bugs but most of
427- the time is safe to use. For a manual install, you can download the current build from
428 \url{http://build.rockbox.org/}.
429430\item[Archived Build.] In addition to the release version and the current build,
···434435\end{description}
436437-\note{Because current and archived builds are development versions that
438- change frequently, they may behave differently than described in this manual,
439 or they may introduce new (and potentially annoying) bugs. Unless you wish to
440 try the latest and greatest features at the price of possibly greater instability,
441 or you wish to help with development, you should stick with the release.\\*}
···461the main data partition. Rockbox \emph{must} be installed onto the main
462data partition.}}
463464-\begin{enumerate}
465\item Download your chosen version of Rockbox from the links in the
466 previous section.
467468-\item Connect your \dap{} to the computer via USB
469 \opt{sansa,sansaAMS,iriverh10,iriverh10_5gb,vibe500,fuzeplus,samsungyh}
470 { in MSC mode }
471 \opt{ipod3g,ipod4g,ipodmini,ipodcolor}{ or Firewire }as described in
472 the manual that came with your \dap{}.
473474\item Take the \fname{.zip} file that you downloaded and use
475- the ``Extract all'' command of your unzip program to extract
476 the files onto
477 \opt{gigabeats,fuzeplus}{the main data partition of }
478 \opt{cowond2}{either an SD card or the internal memory of }
···482 will not be possible to save settings.}}
483\end{enumerate}
484485-\note{The entire contents of the \fname{.zip} file should be extracted
486directly to the root of your \daps{} drive. Do not try to
487create a separate directory on your \dap{} for the Rockbox
488files! The \fname{.zip} file already contains the internal
···490491% This has nothing to do with swcodec, just that these players need our own
492% bootloader so we can decide where we want the main binary.
493-\opt{swcodec}{
494- If the contents of the \fname{.zip} file are extracted correctly, you will
495- have a directory called \fname{.rockbox}, which contains all the files needed
496- by Rockbox, in the main directory of your \daps{} drive.
497-}
498499\opt{swcodec}{%
500 \nopt{gigabeats}{%
···517 \opt{ondavx777}{\input{getting_started/ondavx777_install.tex}}
518 \opt{IMX233}{\input{getting_started/IMX233_install.tex}}
519 \opt{samsungyh}{\input{getting_started/samsungyh_install.tex}}
0520 }
521}
522523\subsection{Finishing the install}\label{ref:finish_install}
524525\opt{gigabeatf}{
526- After installing you \emph{need} to power-cycle the
527 \dap{} by doing the following steps. Failure to do so may result in problems.
528 \begin{itemize}
529 \item Safely eject / unmount your \dap{} and unplug the USB cable.
530 \item Unplug any power adapter.
531 \item Hold the \ButtonPower{} button to turn off the \dap{}.
532- \item Slide the battery switch located on the bottom of the \dap{} from
533 `on' to `off'.
534 \item Slide the battery switch back from `off' to `on'.
535 \end{itemize}
536}
537538\opt{iaudiom3,iaudiom5,iaudiox5}{
539- After installing you \emph{need} to power-cycle the
540 \dap{} by doing the following steps.
541 \begin{itemize}
542 \item Safely eject / unmount your \dap{} and unplug the USB cable.
543 \item Hold the
544 \opt{IAUDIO_X5_PAD}{\ButtonPower}
545 \opt{IAUDIO_M3_PAD}{\ButtonPlay}
546- button to turn off the \dap{}.
547 \item Insert the charger. The Rockbox bootloader will automatically be flashed.
548 \end{itemize}
549}
···564\opt{iriverh100,iriverh300}{
565 \begin{itemize}
566 \item Safely eject / unmount your \dap{}.
567-568 \item \warn{Before proceeding further, make sure that your player has a full charge
569 or that it is connected to the power adapter. Interrupting the next step
570 due to a power failure most likely will brick your \dap{}.}
571 Update your \daps{} firmware with the patched bootloader. To do this, turn
572 the jukebox on. Press and hold the \ButtonSelect{} button to enter the main menu,
573 and navigate to \setting{General $\rightarrow$ Firmware Upgrade}. Select
574- \setting{Yes} when asked to confirm if you want to upgrade the
575 firmware. The \playerman{} will display a message indicating that the
576 firmware update is in progress. Do \emph{not} interrupt this process. When the
577 firmware update is complete the player will turn itself off. (The update
···618\index{Speech}\index{Installation!Optional Steps}
619If you wish to use speech support you will also need a voice file. Voice files
620allow Rockbox to speak the user interface to you. Rockbox Utility can install
621-an English voice file, or you can download it from \url{http://www.rockbox.org/daily.shtml}
622and unzip it to the root of your \dap{}.
623Rockbox Utility can also aid you in the creation of voice files with different voices
624or in other languages if you have a suitable speech engine installed on your computer.
···642 \note{
643 If you have loaded music onto your \dap{} using the \playerman{}
644 firmware, you will not be able to see your music properly in the
645- \setting{File Browser} as MTP mode changes the location and file names.
646 Files placed on your \dap{} using the \playerman{} firmware can be
647 viewed by initialising and using Rockbox's database.
648 See \reference{ref:database} for more information.}
···659660\opt{ipod}{
661 \note{
662- If you have loaded music onto your \dap{} using Itunes,
663- you will not be able to see your music properly in the \setting{File Browser}.
664- This is because Itunes changes your files' names and hides them in
665- directories in the \fname{Ipod\_Control} directory. Files placed on your
666 \dap{} using Itunes can be viewed by initialising and using Rockbox's database.
667 See \reference{ref:database} for more information.
668 }
···697\section{Uninstalling Rockbox}\index{Installation!uninstall}
698699\nopt{gigabeatf,iaudiom3,iaudiom5,iaudiox5,mrobe100,gigabeats,fuzeplus}{
700- \note{The Rockbox bootloader allows you to choose between Rockbox and
701 the original firmware. (See \reference{ref:Dualboot} for more information.)}
702}
703···735736\optv{ipod}{
737 To uninstall Rockbox and go back to using just the original Ipod software, connect
738- the \dap{} to your computer and follow the instructions to install
739- the bootloader but, when prompted by ipodpatcher, enter \texttt{u} for uninstall
740 instead of \texttt{i} for install.
741}
742···766}
767768 \opt{sansaAMS,fuzeplus}{
769- Copy an unmodified original firmware to your player, and then reboot into
770 the Sandisk firmware. See \reference{ref:Dualboot} for more information.
771}
772···803 \end{itemize}
804805 \note{From Windows, you can also run \fname{gbs\_update\_1\_2\_us.exe}
806- directly to restore your \dap{}. This will format your \dap{},
807 removing all files.}
808}
809810\section{Troubleshooting}
811-\begin{description}
812\opt{sansa,ipod}{
813 \item[Bootloader install problems]
814 If you have trouble installing the bootloader,
···836\opt{iriverh100,iriverh300,mpiohd200}{\item[``-1 error'']}
837 If you receive a
838 \nopt{iriverh100,iriverh300,mpiohd200}{``File Not Found''}
839- \opt{iriverh100,iriverh300,mpiohd200}{``-1 error''}
840- from the bootloader, then the bootloader cannot find the Rockbox firmware.
841- This is usually a result of not extracting the contents of the \fname{.zip}
842 file to the proper location, and should not happen when Rockbox has been
843 installed with Rockbox Utility.
844···859 mkdosfs -f 2 -F 32 -S 512 -s 64 -v -n TFAT /path/to/partition/device
860\end{code}
861\warn{This will remove all your files.}
862-863\item Copying a \fname{tar}. If you have a Rockbox build environment
864then you can try generating \fname{rockbox.tar} instead of
865\fname{rockbox.zip} as follows:
···56\section{Before Starting}
78+\opt{e200}{\fixme{NOTE: These instructions will not work on the
9+``Rhapsody'' version of the E200 series (also known as E200R). Please
10+follow the instructions at
11\url{http://www.rockbox.org/wiki/SansaE200RInstallation}.}}
1213\opt{ipodnano,ipodnano2g,ipodvideo,ipod6g,e200,c200,c200v2,e200v2,clipv1,clipv2,cowond2,fuze,fuzev2}{
14+\begin{description}
15+\item[Supported hardware versions.]
16 \opt{ipodnano,ipodnano2g}{
17 The \playertype{} is available in multiple versions, not
18+ all of which run Rockbox. Rockbox presently runs only on
19 the first and second generation Ipod Nano. Rockbox does
20 \emph{not} run on the third, fourth or fifth generation Ipod Nano.
21 For information on identifying which Ipod you own, see this page on
···23 }
24 \opt{ipodvideo}{
25 The \playertype{} is the 5th/5.5th generation \playerman{} only.
26+ For information on identifying which Ipod you own, see this page on Apple's
27 website: \url{http://www.info.apple.com/kbnum/n61688}.
28 }
29 \opt{ipod6g}{
···33 }
34 \opt{c200,c200v2,e200,e200v2}{
35 The \playertype{} is available in multiple versions, and you need to make
36+ sure which you have by checking the Sandisk firmware version number under
37 Settings $\rightarrow$ Info. The v1 firmware is named 01.xx.xx, while the
38 v2 firmware begins with 03. Make sure that you are following the
39 instructions from the correct manual.
···97\end{description}
98}
99\opt{iriverh300}{
100+\begin{description}
101 \item[DRM capability.] If your \dap{} has a US firmware, then by installing Rockbox you will
102 \emph{permanently} lose the ability to playback files with DRM.
103\end{description}
104}
105106\opt{sansaAMS,fuzeplus}{
107+\begin{description}
108 \item[DRM capability.] It is possible that installation of the bootloader
109 may lead to you \emph{permanently} losing the ability to playback files
110 with DRM.
···112}
113114\nopt{gigabeats}{
115+\begin{description}
116117\nopt{ipod1g2g}{
118 \item[USB connection.]
···121 \item[Firewire connection.]
122}
123 To transfer Rockbox to your \dap{} you need to
124+ connect it to your computer. For manual installation/uninstallation, or
125+ should autodetection fail during automatic installation, you need to know
126+ where to access the \dap{}. On Windows this means you need to know
127 the drive letter associated with the \dap{}. On Linux you need to know
128 the mount point of your \dap{}. On Mac OS X you need to know the volume
129 name of your \dap{}.
···189 }
190 \opt{gigabeatf}{The installation requires you to change a setting in the
191 original firmware. Make sure the option under \setting{Setup
192+ $\rightarrow$ Connections $\rightarrow$ PC Connections} is set to
193 \setting{gigabeat room}. Also, during installation, do not connect your
194 \dap{} using the cradle but plug the USB cable directly to the \dap{}.
195 }
···209}
210211\opt{ipod,sansa}{
212+\begin{description}
213 \item[Administrator/Root rights.] Installing the bootloader portion of Rockbox
214 requires you to have administrative (Windows) or root (Linux) rights.
215 Consequently when doing either the automatic or manual bootloader install,
···279 most of the Rockbox code is contained in a
280 ``build'' that resides on your \daps{} drive. This makes it easy to
281 update Rockbox. The build consists of a directory called
282+ \fname{.rockbox} which contains all of the Rockbox files, and is
283 located in the root of your \daps{} drive.
284\end{description}
285}
···320321When first starting \caps{Rockbox Utility} run ``Autodetect'',
322found in the configuration dialog (File $\rightarrow$ Configure). Autodetection
323+can detect most player types. If autodetection fails or is unable to detect
324the mountpoint, make sure to enter the correct values. The mountpoint indicates
325the location of the \dap{} in your filesystem. On Windows, this is the drive
326letter the \dap{} gets assigned, on other systems this is a path in the
···333 the bootloader directly. Instead, we have to patch the Iriver firmware
334 with the Rockbox bootloader.
335336+ Download a supported version of the Iriver firmware for your
337+ \playername{} from the Iriver website, links can be found on
338 \wikilink{IriverBoot}.
339+340+ Supported Iriver firmware versions currently include
341+ \opt{iriverh100}{1.63US, 1.63EU, 1.63K, 1.65US, 1.65EU, 1.65K, 1.66US,
342 1.66EU and 1.66K. Note that the H140 uses the same firmware as the H120;
343 H120 and H140 owners should use the firmware called \fname{ihp\_120.hex}.
344+ Likewise, the iHP110 and iHP115 use the same firmware, called
345+ \fname{ihp\_100.hex}. Be sure to use the correct firmware file for
346 your player.}
347 \opt{iriverh300}{1.28K, 1.28EU, 1.28J, 1.29K, 1.29J, 1.30EU and 1.31K.
348 \note{The US \playername{} firmware is not supported and cannot be
···353 \warn{Installing a non-US firmware on a US \playername{} will
354 \emph{permanently} remove DRM support from the player.}}
355356+ If the file that you downloaded is a \fname{.zip} file, use an unzip
357 utility like mentioned in the prerequisites section to extract
358 the \fname{.hex} from the \fname{.zip} file
359+ to your desktop. Likewise, if the file that you downloaded is an
360+ \fname{.exe} file, double-click on the \fname{.exe} file to extract
361 the \fname{.hex} file to your desktop.
362 When running Linux you should be able to extract \fname{.exe}
363 files using \fname{unzip}.
···369 the bootloader directly. Instead, we have to patch the MPIO firmware
370 with the Rockbox bootloader.
371372+ Download a supported version of the MPIO firmware for your
373+ \playername{} from the MPIO website, links can be found on
374 \opt{mpiohd200}{\wikilink{MPIOHD200Port}}%
375 \opt{mpiohd300}{\wikilink{MPIOHD300Port}}.
376···420\item[Release.] The release version is the latest stable release, free
421 of known critical bugs. For a manual install, the current stable release of Rockbox is
422 available at \url{http://www.rockbox.org/download/}.
423+424\item[Development Build.] The development build is built at each change to
425 the Rockbox source code repository and represents the current state of Rockbox
426 development. This means that the build could contain bugs but most of
427+ the time is safe to use. For a manual install, you can download the current build from
428 \url{http://build.rockbox.org/}.
429430\item[Archived Build.] In addition to the release version and the current build,
···434435\end{description}
436437+\note{Because current and archived builds are development versions that
438+ change frequently, they may behave differently than described in this manual,
439 or they may introduce new (and potentially annoying) bugs. Unless you wish to
440 try the latest and greatest features at the price of possibly greater instability,
441 or you wish to help with development, you should stick with the release.\\*}
···461the main data partition. Rockbox \emph{must} be installed onto the main
462data partition.}}
463464+\begin{enumerate}
465\item Download your chosen version of Rockbox from the links in the
466 previous section.
467468+\item Connect your \dap{} to the computer via USB
469 \opt{sansa,sansaAMS,iriverh10,iriverh10_5gb,vibe500,fuzeplus,samsungyh}
470 { in MSC mode }
471 \opt{ipod3g,ipod4g,ipodmini,ipodcolor}{ or Firewire }as described in
472 the manual that came with your \dap{}.
473474\item Take the \fname{.zip} file that you downloaded and use
475+ the ``Extract all'' command of your unzip program to extract
476 the files onto
477 \opt{gigabeats,fuzeplus}{the main data partition of }
478 \opt{cowond2}{either an SD card or the internal memory of }
···482 will not be possible to save settings.}}
483\end{enumerate}
484485+\note{The entire contents of the \fname{.zip} file should be extracted
486directly to the root of your \daps{} drive. Do not try to
487create a separate directory on your \dap{} for the Rockbox
488files! The \fname{.zip} file already contains the internal
···490491% This has nothing to do with swcodec, just that these players need our own
492% bootloader so we can decide where we want the main binary.
493+If the contents of the \fname{.zip} file are extracted correctly, you will
494+have a directory called \fname{.rockbox}, which contains all the files needed
495+by Rockbox, in the main directory of your \daps{} drive.
00496497\opt{swcodec}{%
498 \nopt{gigabeats}{%
···515 \opt{ondavx777}{\input{getting_started/ondavx777_install.tex}}
516 \opt{IMX233}{\input{getting_started/IMX233_install.tex}}
517 \opt{samsungyh}{\input{getting_started/samsungyh_install.tex}}
518+ \opt{xduoox3}{\input{getting_started/xduoox3_install.tex}}
519 }
520}
521522\subsection{Finishing the install}\label{ref:finish_install}
523524\opt{gigabeatf}{
525+ After installing you \emph{need} to power-cycle the
526 \dap{} by doing the following steps. Failure to do so may result in problems.
527 \begin{itemize}
528 \item Safely eject / unmount your \dap{} and unplug the USB cable.
529 \item Unplug any power adapter.
530 \item Hold the \ButtonPower{} button to turn off the \dap{}.
531+ \item Slide the battery switch located on the bottom of the \dap{} from
532 `on' to `off'.
533 \item Slide the battery switch back from `off' to `on'.
534 \end{itemize}
535}
536537\opt{iaudiom3,iaudiom5,iaudiox5}{
538+ After installing you \emph{need} to power-cycle the
539 \dap{} by doing the following steps.
540 \begin{itemize}
541 \item Safely eject / unmount your \dap{} and unplug the USB cable.
542 \item Hold the
543 \opt{IAUDIO_X5_PAD}{\ButtonPower}
544 \opt{IAUDIO_M3_PAD}{\ButtonPlay}
545+ button to turn off the \dap{}.
546 \item Insert the charger. The Rockbox bootloader will automatically be flashed.
547 \end{itemize}
548}
···563\opt{iriverh100,iriverh300}{
564 \begin{itemize}
565 \item Safely eject / unmount your \dap{}.
566+567 \item \warn{Before proceeding further, make sure that your player has a full charge
568 or that it is connected to the power adapter. Interrupting the next step
569 due to a power failure most likely will brick your \dap{}.}
570 Update your \daps{} firmware with the patched bootloader. To do this, turn
571 the jukebox on. Press and hold the \ButtonSelect{} button to enter the main menu,
572 and navigate to \setting{General $\rightarrow$ Firmware Upgrade}. Select
573+ \setting{Yes} when asked to confirm if you want to upgrade the
574 firmware. The \playerman{} will display a message indicating that the
575 firmware update is in progress. Do \emph{not} interrupt this process. When the
576 firmware update is complete the player will turn itself off. (The update
···617\index{Speech}\index{Installation!Optional Steps}
618If you wish to use speech support you will also need a voice file. Voice files
619allow Rockbox to speak the user interface to you. Rockbox Utility can install
620+an English voice file, or you can download it from \url{http://www.rockbox.org/daily.shtml}
621and unzip it to the root of your \dap{}.
622Rockbox Utility can also aid you in the creation of voice files with different voices
623or in other languages if you have a suitable speech engine installed on your computer.
···641 \note{
642 If you have loaded music onto your \dap{} using the \playerman{}
643 firmware, you will not be able to see your music properly in the
644+ \setting{File Browser} as MTP mode changes the location and file names.
645 Files placed on your \dap{} using the \playerman{} firmware can be
646 viewed by initialising and using Rockbox's database.
647 See \reference{ref:database} for more information.}
···658659\opt{ipod}{
660 \note{
661+ If you have loaded music onto your \dap{} using Itunes,
662+ you will not be able to see your music properly in the \setting{File Browser}.
663+ This is because Itunes changes your files' names and hides them in
664+ directories in the \fname{Ipod\_Control} directory. Files placed on your
665 \dap{} using Itunes can be viewed by initialising and using Rockbox's database.
666 See \reference{ref:database} for more information.
667 }
···696\section{Uninstalling Rockbox}\index{Installation!uninstall}
697698\nopt{gigabeatf,iaudiom3,iaudiom5,iaudiox5,mrobe100,gigabeats,fuzeplus}{
699+ \note{The Rockbox bootloader allows you to choose between Rockbox and
700 the original firmware. (See \reference{ref:Dualboot} for more information.)}
701}
702···734735\optv{ipod}{
736 To uninstall Rockbox and go back to using just the original Ipod software, connect
737+ the \dap{} to your computer and follow the instructions to install
738+ the bootloader but, when prompted by ipodpatcher, enter \texttt{u} for uninstall
739 instead of \texttt{i} for install.
740}
741···765}
766767 \opt{sansaAMS,fuzeplus}{
768+ Copy an unmodified original firmware to your player, and then reboot into
769 the Sandisk firmware. See \reference{ref:Dualboot} for more information.
770}
771···802 \end{itemize}
803804 \note{From Windows, you can also run \fname{gbs\_update\_1\_2\_us.exe}
805+ directly to restore your \dap{}. This will format your \dap{},
806 removing all files.}
807}
808809\section{Troubleshooting}
810+\begin{description}
811\opt{sansa,ipod}{
812 \item[Bootloader install problems]
813 If you have trouble installing the bootloader,
···835\opt{iriverh100,iriverh300,mpiohd200}{\item[``-1 error'']}
836 If you receive a
837 \nopt{iriverh100,iriverh300,mpiohd200}{``File Not Found''}
838+ \opt{iriverh100,iriverh300,mpiohd200}{``-1 error''}
839+ from the bootloader, then the bootloader cannot find the Rockbox firmware.
840+ This is usually a result of not extracting the contents of the \fname{.zip}
841 file to the proper location, and should not happen when Rockbox has been
842 installed with Rockbox Utility.
843···858 mkdosfs -f 2 -F 32 -S 512 -s 64 -v -n TFAT /path/to/partition/device
859\end{code}
860\warn{This will remove all your files.}
861+862\item Copying a \fname{tar}. If you have a Rockbox build environment
863then you can try generating \fname{rockbox.tar} instead of
864\fname{rockbox.zip} as follows:
+28
manual/getting_started/xduoox3_install.tex
···0000000000000000000000000000
···1+ Installing the bootloader is the trickiest part of the installation.
2+ We cannot distribute the bootloader directly, and thus need to patch a compatible
3+ version of the xDuoo firmware.
4+5+\begin{enumerate}
6+7+\item Download the Rockbox bootloader from
8+ \url{http://download.rockbox.org/bootloader/xduoo/X3-v11.bsdiff}
9+10+\item Get a copy of the original \playertype{} v1.1 firmware from
11+ \url{https://www.xduoo.net/firmware-download/} and extract the .rar file to obtain the
12+ update image (called \fname{update.zip}).
13+14+\item Compile bspatch in rbutil/bspatch/ (run make in the dir).
15+16+\item Run
17+\begin{code}
18+ ../rbutil/bspatch/bspatch update.zip output.zip X3-v11.bsdiff
19+\end{code}
20+21+\item Put \fname{output.zip} in the root of the SD card and rename it to \fname{update.zip}.
22+23+\item Disconnect the player from USB and let the original firmware boot.
24+25+\item Go into the 'Setting' menu, and select 'Upgrade'. The player will reboot into Rockbox
26+ upon completion.
27+28+\end{enumerate}
···1+% Id: %
2+\def\UseOption{xduoox3}
3+\edef\UseOption{\UseOption,XDUOO_X3_PAD}
4+\edef\UseOption{\UseOption,HAVE_BACKLIGHT}
5+\edef\UseOption{\UseOption,HAVE_RB_BL_IN_FLASH}
6+7+\newcommand{\playerman}{xDuoo}
8+\newcommand{\playertype}{X3}
9+\newcommand{\playerlongtype}{\playertype}
10+\newcommand{\dapdisplaywidth}{128}
11+\newcommand{\dapdisplayheight}{64}
12+\newcommand{\dapdisplaydepth}{1}
13+\newcommand{\specimg}{xduoox3}
14+%used for specifying screenshot names common to a target "family"
15+\newcommand{\seriesimg}{xduoox3}
16+%Used to name the player, e.g. ...to the \dap
17+\newcommand{\dap}{player}
18+%For use when referring to the player. E.g. the \daps\ capacity...
19+\newcommand{\daps}{player's}
20+\newcommand{\firmwarefilename}{\fname{update.zip}}
21+\newcommand{\firmwareextension}{\fname{zip}}
22+\newcommand{\screenshotsize}{3cm}
23+\newcommand{\disk}{SD card}
24+25+% link external keymap file
26+\input{platform/keymap-xduoox3.tex}