···195195 \item[Screen Scrolls Out of View.]
196196 Screens can be manually scrolled horizontally by pressing
197197 \opt{IRIVER_H10_PAD}{Long \ButtonRew/\ButtonFF}%
198198- \nopt{IRIVER_H10_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD%
198198+ \opt{IRIVER_H10_PAD,XDUOO_X3_PAD}{Long \ButtonPrev/\ButtonNext}%
199199+ \nopt{IRIVER_H10_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD,XDUOO_X3_PAD%
199200 ,touchscreen}{%
200201 Long \ButtonRight/\ButtonLeft}.
201202 Setting this option to \setting{Yes}
···5566\section{Before Starting}
7788-\opt{e200}{\fixme{NOTE: These instructions will not work on the
99-``Rhapsody'' version of the E200 series (also known as E200R). Please
1010-follow the instructions at
88+\opt{e200}{\fixme{NOTE: These instructions will not work on the
99+``Rhapsody'' version of the E200 series (also known as E200R). Please
1010+follow the instructions at
1111\url{http://www.rockbox.org/wiki/SansaE200RInstallation}.}}
12121313\opt{ipodnano,ipodnano2g,ipodvideo,ipod6g,e200,c200,c200v2,e200v2,clipv1,clipv2,cowond2,fuze,fuzev2}{
1414-\begin{description}
1515-\item[Supported hardware versions.]
1414+\begin{description}
1515+\item[Supported hardware versions.]
1616 \opt{ipodnano,ipodnano2g}{
1717 The \playertype{} is available in multiple versions, not
1818- all of which run Rockbox. Rockbox presently runs only on
1818+ all of which run Rockbox. Rockbox presently runs only on
1919 the first and second generation Ipod Nano. Rockbox does
2020 \emph{not} run on the third, fourth or fifth generation Ipod Nano.
2121 For information on identifying which Ipod you own, see this page on
···2323 }
2424 \opt{ipodvideo}{
2525 The \playertype{} is the 5th/5.5th generation \playerman{} only.
2626- For information on identifying which Ipod you own, see this page on Apple's
2626+ For information on identifying which Ipod you own, see this page on Apple's
2727 website: \url{http://www.info.apple.com/kbnum/n61688}.
2828 }
2929 \opt{ipod6g}{
···3333 }
3434 \opt{c200,c200v2,e200,e200v2}{
3535 The \playertype{} is available in multiple versions, and you need to make
3636- sure which you have by checking the Sandisk firmware version number under
3636+ sure which you have by checking the Sandisk firmware version number under
3737 Settings $\rightarrow$ Info. The v1 firmware is named 01.xx.xx, while the
3838 v2 firmware begins with 03. Make sure that you are following the
3939 instructions from the correct manual.
···9797\end{description}
9898}
9999\opt{iriverh300}{
100100-\begin{description}
100100+\begin{description}
101101 \item[DRM capability.] If your \dap{} has a US firmware, then by installing Rockbox you will
102102 \emph{permanently} lose the ability to playback files with DRM.
103103\end{description}
104104}
105105106106\opt{sansaAMS,fuzeplus}{
107107-\begin{description}
107107+\begin{description}
108108 \item[DRM capability.] It is possible that installation of the bootloader
109109 may lead to you \emph{permanently} losing the ability to playback files
110110 with DRM.
···112112}
113113114114\nopt{gigabeats}{
115115-\begin{description}
115115+\begin{description}
116116117117\nopt{ipod1g2g}{
118118 \item[USB connection.]
···121121 \item[Firewire connection.]
122122}
123123 To transfer Rockbox to your \dap{} you need to
124124- connect it to your computer. For manual installation/uninstallation, or
125125- should autodetection fail during automatic installation, you need to know
126126- where to access the \dap{}. On Windows this means you need to know
124124+ connect it to your computer. For manual installation/uninstallation, or
125125+ should autodetection fail during automatic installation, you need to know
126126+ where to access the \dap{}. On Windows this means you need to know
127127 the drive letter associated with the \dap{}. On Linux you need to know
128128 the mount point of your \dap{}. On Mac OS X you need to know the volume
129129 name of your \dap{}.
···189189 }
190190 \opt{gigabeatf}{The installation requires you to change a setting in the
191191 original firmware. Make sure the option under \setting{Setup
192192- $\rightarrow$ Connections $\rightarrow$ PC Connections} is set to
192192+ $\rightarrow$ Connections $\rightarrow$ PC Connections} is set to
193193 \setting{gigabeat room}. Also, during installation, do not connect your
194194 \dap{} using the cradle but plug the USB cable directly to the \dap{}.
195195 }
···209209}
210210211211\opt{ipod,sansa}{
212212-\begin{description}
212212+\begin{description}
213213 \item[Administrator/Root rights.] Installing the bootloader portion of Rockbox
214214 requires you to have administrative (Windows) or root (Linux) rights.
215215 Consequently when doing either the automatic or manual bootloader install,
···279279 most of the Rockbox code is contained in a
280280 ``build'' that resides on your \daps{} drive. This makes it easy to
281281 update Rockbox. The build consists of a directory called
282282- \fname{.rockbox} which contains all of the Rockbox files, and is
282282+ \fname{.rockbox} which contains all of the Rockbox files, and is
283283 located in the root of your \daps{} drive.
284284\end{description}
285285}
···320320321321When first starting \caps{Rockbox Utility} run ``Autodetect'',
322322found in the configuration dialog (File $\rightarrow$ Configure). Autodetection
323323-can detect most player types. If autodetection fails or is unable to detect
323323+can detect most player types. If autodetection fails or is unable to detect
324324the mountpoint, make sure to enter the correct values. The mountpoint indicates
325325the location of the \dap{} in your filesystem. On Windows, this is the drive
326326letter the \dap{} gets assigned, on other systems this is a path in the
···333333 the bootloader directly. Instead, we have to patch the Iriver firmware
334334 with the Rockbox bootloader.
335335336336- Download a supported version of the Iriver firmware for your
337337- \playername{} from the Iriver website, links can be found on
336336+ Download a supported version of the Iriver firmware for your
337337+ \playername{} from the Iriver website, links can be found on
338338 \wikilink{IriverBoot}.
339339-340340- Supported Iriver firmware versions currently include
341341- \opt{iriverh100}{1.63US, 1.63EU, 1.63K, 1.65US, 1.65EU, 1.65K, 1.66US,
339339+340340+ Supported Iriver firmware versions currently include
341341+ \opt{iriverh100}{1.63US, 1.63EU, 1.63K, 1.65US, 1.65EU, 1.65K, 1.66US,
342342 1.66EU and 1.66K. Note that the H140 uses the same firmware as the H120;
343343 H120 and H140 owners should use the firmware called \fname{ihp\_120.hex}.
344344- Likewise, the iHP110 and iHP115 use the same firmware, called
345345- \fname{ihp\_100.hex}. Be sure to use the correct firmware file for
344344+ Likewise, the iHP110 and iHP115 use the same firmware, called
345345+ \fname{ihp\_100.hex}. Be sure to use the correct firmware file for
346346 your player.}
347347 \opt{iriverh300}{1.28K, 1.28EU, 1.28J, 1.29K, 1.29J, 1.30EU and 1.31K.
348348 \note{The US \playername{} firmware is not supported and cannot be
···353353 \warn{Installing a non-US firmware on a US \playername{} will
354354 \emph{permanently} remove DRM support from the player.}}
355355356356- If the file that you downloaded is a \fname{.zip} file, use an unzip
356356+ If the file that you downloaded is a \fname{.zip} file, use an unzip
357357 utility like mentioned in the prerequisites section to extract
358358 the \fname{.hex} from the \fname{.zip} file
359359- to your desktop. Likewise, if the file that you downloaded is an
360360- \fname{.exe} file, double-click on the \fname{.exe} file to extract
359359+ to your desktop. Likewise, if the file that you downloaded is an
360360+ \fname{.exe} file, double-click on the \fname{.exe} file to extract
361361 the \fname{.hex} file to your desktop.
362362 When running Linux you should be able to extract \fname{.exe}
363363 files using \fname{unzip}.
···369369 the bootloader directly. Instead, we have to patch the MPIO firmware
370370 with the Rockbox bootloader.
371371372372- Download a supported version of the MPIO firmware for your
373373- \playername{} from the MPIO website, links can be found on
372372+ Download a supported version of the MPIO firmware for your
373373+ \playername{} from the MPIO website, links can be found on
374374 \opt{mpiohd200}{\wikilink{MPIOHD200Port}}%
375375 \opt{mpiohd300}{\wikilink{MPIOHD300Port}}.
376376···420420\item[Release.] The release version is the latest stable release, free
421421 of known critical bugs. For a manual install, the current stable release of Rockbox is
422422 available at \url{http://www.rockbox.org/download/}.
423423-423423+424424\item[Development Build.] The development build is built at each change to
425425 the Rockbox source code repository and represents the current state of Rockbox
426426 development. This means that the build could contain bugs but most of
427427- the time is safe to use. For a manual install, you can download the current build from
427427+ the time is safe to use. For a manual install, you can download the current build from
428428 \url{http://build.rockbox.org/}.
429429430430\item[Archived Build.] In addition to the release version and the current build,
···434434435435\end{description}
436436437437-\note{Because current and archived builds are development versions that
438438- change frequently, they may behave differently than described in this manual,
437437+\note{Because current and archived builds are development versions that
438438+ change frequently, they may behave differently than described in this manual,
439439 or they may introduce new (and potentially annoying) bugs. Unless you wish to
440440 try the latest and greatest features at the price of possibly greater instability,
441441 or you wish to help with development, you should stick with the release.\\*}
···461461the main data partition. Rockbox \emph{must} be installed onto the main
462462data partition.}}
463463464464-\begin{enumerate}
464464+\begin{enumerate}
465465\item Download your chosen version of Rockbox from the links in the
466466 previous section.
467467468468-\item Connect your \dap{} to the computer via USB
468468+\item Connect your \dap{} to the computer via USB
469469 \opt{sansa,sansaAMS,iriverh10,iriverh10_5gb,vibe500,fuzeplus,samsungyh}
470470 { in MSC mode }
471471 \opt{ipod3g,ipod4g,ipodmini,ipodcolor}{ or Firewire }as described in
472472 the manual that came with your \dap{}.
473473474474\item Take the \fname{.zip} file that you downloaded and use
475475- the ``Extract all'' command of your unzip program to extract
475475+ the ``Extract all'' command of your unzip program to extract
476476 the files onto
477477 \opt{gigabeats,fuzeplus}{the main data partition of }
478478 \opt{cowond2}{either an SD card or the internal memory of }
···482482 will not be possible to save settings.}}
483483\end{enumerate}
484484485485-\note{The entire contents of the \fname{.zip} file should be extracted
485485+\note{The entire contents of the \fname{.zip} file should be extracted
486486directly to the root of your \daps{} drive. Do not try to
487487create a separate directory on your \dap{} for the Rockbox
488488files! The \fname{.zip} file already contains the internal
···490490491491% This has nothing to do with swcodec, just that these players need our own
492492% bootloader so we can decide where we want the main binary.
493493-\opt{swcodec}{
494494- If the contents of the \fname{.zip} file are extracted correctly, you will
495495- have a directory called \fname{.rockbox}, which contains all the files needed
496496- by Rockbox, in the main directory of your \daps{} drive.
497497-}
493493+If the contents of the \fname{.zip} file are extracted correctly, you will
494494+have a directory called \fname{.rockbox}, which contains all the files needed
495495+by Rockbox, in the main directory of your \daps{} drive.
498496499497\opt{swcodec}{%
500498 \nopt{gigabeats}{%
···517515 \opt{ondavx777}{\input{getting_started/ondavx777_install.tex}}
518516 \opt{IMX233}{\input{getting_started/IMX233_install.tex}}
519517 \opt{samsungyh}{\input{getting_started/samsungyh_install.tex}}
518518+ \opt{xduoox3}{\input{getting_started/xduoox3_install.tex}}
520519 }
521520}
522521523522\subsection{Finishing the install}\label{ref:finish_install}
524523525524\opt{gigabeatf}{
526526- After installing you \emph{need} to power-cycle the
525525+ After installing you \emph{need} to power-cycle the
527526 \dap{} by doing the following steps. Failure to do so may result in problems.
528527 \begin{itemize}
529528 \item Safely eject / unmount your \dap{} and unplug the USB cable.
530529 \item Unplug any power adapter.
531530 \item Hold the \ButtonPower{} button to turn off the \dap{}.
532532- \item Slide the battery switch located on the bottom of the \dap{} from
531531+ \item Slide the battery switch located on the bottom of the \dap{} from
533532 `on' to `off'.
534533 \item Slide the battery switch back from `off' to `on'.
535534 \end{itemize}
536535}
537536538537\opt{iaudiom3,iaudiom5,iaudiox5}{
539539- After installing you \emph{need} to power-cycle the
538538+ After installing you \emph{need} to power-cycle the
540539 \dap{} by doing the following steps.
541540 \begin{itemize}
542541 \item Safely eject / unmount your \dap{} and unplug the USB cable.
543542 \item Hold the
544543 \opt{IAUDIO_X5_PAD}{\ButtonPower}
545544 \opt{IAUDIO_M3_PAD}{\ButtonPlay}
546546- button to turn off the \dap{}.
545545+ button to turn off the \dap{}.
547546 \item Insert the charger. The Rockbox bootloader will automatically be flashed.
548547 \end{itemize}
549548}
···564563\opt{iriverh100,iriverh300}{
565564 \begin{itemize}
566565 \item Safely eject / unmount your \dap{}.
567567-566566+568567 \item \warn{Before proceeding further, make sure that your player has a full charge
569568 or that it is connected to the power adapter. Interrupting the next step
570569 due to a power failure most likely will brick your \dap{}.}
571570 Update your \daps{} firmware with the patched bootloader. To do this, turn
572571 the jukebox on. Press and hold the \ButtonSelect{} button to enter the main menu,
573572 and navigate to \setting{General $\rightarrow$ Firmware Upgrade}. Select
574574- \setting{Yes} when asked to confirm if you want to upgrade the
573573+ \setting{Yes} when asked to confirm if you want to upgrade the
575574 firmware. The \playerman{} will display a message indicating that the
576575 firmware update is in progress. Do \emph{not} interrupt this process. When the
577576 firmware update is complete the player will turn itself off. (The update
···618617\index{Speech}\index{Installation!Optional Steps}
619618If you wish to use speech support you will also need a voice file. Voice files
620619allow Rockbox to speak the user interface to you. Rockbox Utility can install
621621-an English voice file, or you can download it from \url{http://www.rockbox.org/daily.shtml}
620620+an English voice file, or you can download it from \url{http://www.rockbox.org/daily.shtml}
622621and unzip it to the root of your \dap{}.
623622Rockbox Utility can also aid you in the creation of voice files with different voices
624623or in other languages if you have a suitable speech engine installed on your computer.
···642641 \note{
643642 If you have loaded music onto your \dap{} using the \playerman{}
644643 firmware, you will not be able to see your music properly in the
645645- \setting{File Browser} as MTP mode changes the location and file names.
644644+ \setting{File Browser} as MTP mode changes the location and file names.
646645 Files placed on your \dap{} using the \playerman{} firmware can be
647646 viewed by initialising and using Rockbox's database.
648647 See \reference{ref:database} for more information.}
···659658660659\opt{ipod}{
661660 \note{
662662- If you have loaded music onto your \dap{} using Itunes,
663663- you will not be able to see your music properly in the \setting{File Browser}.
664664- This is because Itunes changes your files' names and hides them in
665665- directories in the \fname{Ipod\_Control} directory. Files placed on your
661661+ If you have loaded music onto your \dap{} using Itunes,
662662+ you will not be able to see your music properly in the \setting{File Browser}.
663663+ This is because Itunes changes your files' names and hides them in
664664+ directories in the \fname{Ipod\_Control} directory. Files placed on your
666665 \dap{} using Itunes can be viewed by initialising and using Rockbox's database.
667666 See \reference{ref:database} for more information.
668667 }
···697696\section{Uninstalling Rockbox}\index{Installation!uninstall}
698697699698\nopt{gigabeatf,iaudiom3,iaudiom5,iaudiox5,mrobe100,gigabeats,fuzeplus}{
700700- \note{The Rockbox bootloader allows you to choose between Rockbox and
699699+ \note{The Rockbox bootloader allows you to choose between Rockbox and
701700 the original firmware. (See \reference{ref:Dualboot} for more information.)}
702701}
703702···735734736735\optv{ipod}{
737736 To uninstall Rockbox and go back to using just the original Ipod software, connect
738738- the \dap{} to your computer and follow the instructions to install
739739- the bootloader but, when prompted by ipodpatcher, enter \texttt{u} for uninstall
737737+ the \dap{} to your computer and follow the instructions to install
738738+ the bootloader but, when prompted by ipodpatcher, enter \texttt{u} for uninstall
740739 instead of \texttt{i} for install.
741740}
742741···766765}
767766768767 \opt{sansaAMS,fuzeplus}{
769769- Copy an unmodified original firmware to your player, and then reboot into
768768+ Copy an unmodified original firmware to your player, and then reboot into
770769 the Sandisk firmware. See \reference{ref:Dualboot} for more information.
771770}
772771···803802 \end{itemize}
804803805804 \note{From Windows, you can also run \fname{gbs\_update\_1\_2\_us.exe}
806806- directly to restore your \dap{}. This will format your \dap{},
805805+ directly to restore your \dap{}. This will format your \dap{},
807806 removing all files.}
808807}
809808810809\section{Troubleshooting}
811811-\begin{description}
810810+\begin{description}
812811\opt{sansa,ipod}{
813812 \item[Bootloader install problems]
814813 If you have trouble installing the bootloader,
···836835\opt{iriverh100,iriverh300,mpiohd200}{\item[``-1 error'']}
837836 If you receive a
838837 \nopt{iriverh100,iriverh300,mpiohd200}{``File Not Found''}
839839- \opt{iriverh100,iriverh300,mpiohd200}{``-1 error''}
840840- from the bootloader, then the bootloader cannot find the Rockbox firmware.
841841- This is usually a result of not extracting the contents of the \fname{.zip}
838838+ \opt{iriverh100,iriverh300,mpiohd200}{``-1 error''}
839839+ from the bootloader, then the bootloader cannot find the Rockbox firmware.
840840+ This is usually a result of not extracting the contents of the \fname{.zip}
842841 file to the proper location, and should not happen when Rockbox has been
843842 installed with Rockbox Utility.
844843···859858 mkdosfs -f 2 -F 32 -S 512 -s 64 -v -n TFAT /path/to/partition/device
860859\end{code}
861860\warn{This will remove all your files.}
862862-861861+863862\item Copying a \fname{tar}. If you have a Rockbox build environment
864863then you can try generating \fname{rockbox.tar} instead of
865864\fname{rockbox.zip} as follows:
+28
manual/getting_started/xduoox3_install.tex
···11+ Installing the bootloader is the trickiest part of the installation.
22+ We cannot distribute the bootloader directly, and thus need to patch a compatible
33+ version of the xDuoo firmware.
44+55+\begin{enumerate}
66+77+\item Download the Rockbox bootloader from
88+ \url{http://download.rockbox.org/bootloader/xduoo/X3-v11.bsdiff}
99+1010+\item Get a copy of the original \playertype{} v1.1 firmware from
1111+ \url{https://www.xduoo.net/firmware-download/} and extract the .rar file to obtain the
1212+ update image (called \fname{update.zip}).
1313+1414+\item Compile bspatch in rbutil/bspatch/ (run make in the dir).
1515+1616+\item Run
1717+\begin{code}
1818+ ../rbutil/bspatch/bspatch update.zip output.zip X3-v11.bsdiff
1919+\end{code}
2020+2121+\item Put \fname{output.zip} in the root of the SD card and rename it to \fname{update.zip}.
2222+2323+\item Disconnect the player from USB and let the original firmware boot.
2424+2525+\item Go into the 'Setting' menu, and select 'Upgrade'. The player will reboot into Rockbox
2626+ upon completion.
2727+2828+\end{enumerate}
···11+% Id: %
22+\def\UseOption{xduoox3}
33+\edef\UseOption{\UseOption,XDUOO_X3_PAD}
44+\edef\UseOption{\UseOption,HAVE_BACKLIGHT}
55+\edef\UseOption{\UseOption,HAVE_RB_BL_IN_FLASH}
66+77+\newcommand{\playerman}{xDuoo}
88+\newcommand{\playertype}{X3}
99+\newcommand{\playerlongtype}{\playertype}
1010+\newcommand{\dapdisplaywidth}{128}
1111+\newcommand{\dapdisplayheight}{64}
1212+\newcommand{\dapdisplaydepth}{1}
1313+\newcommand{\specimg}{xduoox3}
1414+%used for specifying screenshot names common to a target "family"
1515+\newcommand{\seriesimg}{xduoox3}
1616+%Used to name the player, e.g. ...to the \dap
1717+\newcommand{\dap}{player}
1818+%For use when referring to the player. E.g. the \daps\ capacity...
1919+\newcommand{\daps}{player's}
2020+\newcommand{\firmwarefilename}{\fname{update.zip}}
2121+\newcommand{\firmwareextension}{\fname{zip}}
2222+\newcommand{\screenshotsize}{3cm}
2323+\newcommand{\disk}{SD card}
2424+2525+% link external keymap file
2626+\input{platform/keymap-xduoox3.tex}