summaryrefslogtreecommitdiffstats
path: root/manual
diff options
context:
space:
mode:
authorMarianne Arnold <pixelma@rockbox.org>2010-07-04 13:28:20 +0000
committerMarianne Arnold <pixelma@rockbox.org>2010-07-04 13:28:20 +0000
commitbf83ac624083af0c53fdc358df8270798831d8cb (patch)
tree7b30d9bbd82a8353d4ee7e53382df45b8bdd4aa4 /manual
parent4acfdbc12acedac6a06ab1c0986d1935e97f2ac5 (diff)
downloadrockbox-bf83ac624083af0c53fdc358df8270798831d8cb.tar.gz
rockbox-bf83ac624083af0c53fdc358df8270798831d8cb.tar.bz2
rockbox-bf83ac624083af0c53fdc358df8270798831d8cb.zip
Add platform and keymap files and basic descriptions about installing Rockbox etc. for an Onda VX777 manual. Author: Giovanni Zilli. Flyspray: FS#11437.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27279 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'manual')
-rw-r--r--manual/getting_started/installation.tex53
-rw-r--r--manual/getting_started/ondavx777_install.tex23
-rw-r--r--manual/platform/keymap-ondavx777.tex109
-rw-r--r--manual/platform/ondavx777.tex27
-rw-r--r--manual/rockbox_interface/main.tex33
5 files changed, 215 insertions, 30 deletions
diff --git a/manual/getting_started/installation.tex b/manual/getting_started/installation.tex
index fefa847c02..2ee4f84c29 100644
--- a/manual/getting_started/installation.tex
+++ b/manual/getting_started/installation.tex
@@ -83,6 +83,24 @@ follow the instructions at
\end{itemize}
\end{description}
}
+\opt{ondavx777}{
+\begin{description}
+ \item[Current limitations.] Most Rockbox functions are usable on the
+ \playertype{}, including music playback and most plugins, but
+ there are a number of shortcomings that prevent it from being a fully
+ supported target:
+ \begin{itemize}
+ \item A MicroSD card is required to run Rockbox, since the internal
+ flash memory hasn't been figured out yet.
+ \item There is only basic touchscreen support. Further work is
+ required to make the UI more usable with a touchscreen in general.
+ \note{The touchscreen can be used in two modes, either a 3$\times$3 grid mode
+ which divides the screen into areas to emulate a set of physical
+ buttons (the default setting), or ``absolute point'' mode where the
+ touchscreen is used to point to items on the screen.\\}
+ \end{itemize}
+\end{description}
+}
\opt{h300}{
\begin{description}
\item[DRM capability.] If your \dap{} has a US firmware, then by installing Rockbox you will
@@ -261,7 +279,6 @@ still available to you.\\
update Rockbox. The build consists of a directory called
\fname{.rockbox} which contains all of the Rockbox files, and is
located in the root of your \daps{} drive.
-
\end{description}
}
@@ -297,7 +314,7 @@ housekeeping tool \caps{Rockbox Utility}. It allows you to:
Prebuilt binaries for Windows, Linux and Mac OS X are
available at the \wikilink{RockboxUtility} wiki page.\\
-\opt{gigabeats}{\note{Rockbox Utility does not currently support the
+\opt{gigabeats,ondavx777}{\note{Rockbox Utility does not currently support the
\playertype{} and you will therefore need to follow the manual install
instructions below.\\}}
@@ -427,6 +444,7 @@ correct version for your \dap{}.}}
the files onto%
\opt{gigabeats}{the main data partition of }
\opt{cowond2}{either an SD card or the internal memory of }
+ \opt{ondavx777}{the MicroSD of }
your \dap{}.
\opt{cowond2}{\note{If you have chosen to extract to the internal memory, it
will not be possible to save settings.}}
@@ -453,19 +471,22 @@ structure that Rockbox needs.\\}
by Rockbox, in the main directory of your \daps{} drive.
}
-\opt{swcodec}{\nopt{gigabeats}{
- \subsubsection{Installing the bootloader}
- \opt{h100,h300}{\input{getting_started/iriver_install.tex}}
- \opt{ipod}{\input{getting_started/ipod_install.tex}}
- \opt{m3,m5,x5}{\input{getting_started/iaudio_install.tex}}
- \opt{h10,h10_5gb}{\input{getting_started/h10_install.tex}}
- \opt{gigabeatf}{\input{getting_started/gigabeat_install.tex}}
- \opt{sansa}{\input{getting_started/sansa_install.tex}}
- \opt{sansaAMS}{\input{getting_started/sansaAMS_install.tex}}
- \opt{mrobe100}{\input{getting_started/mrobe100_install.tex}}
- \opt{cowond2}{\input{getting_started/cowond2_install.tex}}
- \opt{vibe500}{\input{getting_started/vibe500_install.tex}}
-}}
+\opt{swcodec}{%
+ \nopt{gigabeats}{%
+ \subsubsection{Installing the bootloader}
+ \opt{h100,h300}{\input{getting_started/iriver_install.tex}}
+ \opt{ipod}{\input{getting_started/ipod_install.tex}}
+ \opt{m3,m5,x5}{\input{getting_started/iaudio_install.tex}}
+ \opt{h10,h10_5gb}{\input{getting_started/h10_install.tex}}
+ \opt{gigabeatf}{\input{getting_started/gigabeat_install.tex}}
+ \opt{sansa}{\input{getting_started/sansa_install.tex}}
+ \opt{sansaAMS}{\input{getting_started/sansaAMS_install.tex}}
+ \opt{mrobe100}{\input{getting_started/mrobe100_install.tex}}
+ \opt{cowond2}{\input{getting_started/cowond2_install.tex}}
+ \opt{vibe500}{\input{getting_started/vibe500_install.tex}}
+ \opt{ondavx777}{\input{getting_started/ondavx777_install.tex}}
+ }
+}
\subsection{Finishing the install}\label{ref:finish_install}
@@ -495,7 +516,7 @@ structure that Rockbox needs.\\}
\end{itemize}
}
-\opt{h10,h10_5gb,ipod,mrobe100,sansa,archos,sansaAMS,cowond2,vibe500}{
+\opt{h10,h10_5gb,ipod,mrobe100,sansa,archos,sansaAMS,cowond2,vibe500,ondavx777}{
Safely eject / unmount the USB drive, unplug the cable and restart.
}
diff --git a/manual/getting_started/ondavx777_install.tex b/manual/getting_started/ondavx777_install.tex
new file mode 100644
index 0000000000..b5c7b5eaed
--- /dev/null
+++ b/manual/getting_started/ondavx777_install.tex
@@ -0,0 +1,23 @@
+\begin{enumerate}
+\item Compile the bootloader (this will generate a \fname{ccpmp.bin} file).
+
+\item Get a copy of the original \playerman{} firmware (called \fname{vx777.HXF}) from
+ \url{http://www.onda.cn/pro/download/biosexp.jsp?ITEM_ID=12628}.
+
+\item Compile ChinaChipPatcher in rbutil/chinachippatcher/ (run make in the dir).
+
+\item Run
+\begin{code}
+ ../rbutil/chinachippatcher/chinachip VX747.HXF ccpmp.bin output.HXF ccpmp.old
+\end{code}
+ in the dir where you compiled your bootloader
+
+\item Put \fname{output.HXF} in the root of the NAND drive (boot into the OF as
+ Rockbox currently can't access the NAND storage) and name it \fname{VX777.HXF}
+
+\item Reset your player.
+
+\end{enumerate}
+
+\note{If you want to have dual-boot capabilities, copy \fname{ccpmp.old}, name it
+ \fname{ccpmp.bin} to the root of your MicroSD card.}
diff --git a/manual/platform/keymap-ondavx777.tex b/manual/platform/keymap-ondavx777.tex
new file mode 100644
index 0000000000..bdf85a5370
--- /dev/null
+++ b/manual/platform/keymap-ondavx777.tex
@@ -0,0 +1,109 @@
+% $Id$
+\newcommand{\ButtonPower}{\btnfnt{Power}}
+
+%Button actions, standard context
+\newcommand{\ActionStdPrev}{\TouchActionStdPrev}
+\newcommand{\ActionStdPrevRepeat}{\TouchActionStdPrevRepeat}
+\newcommand{\ActionStdNext}{\TouchActionStdNext}
+\newcommand{\ActionStdNextRepeat}{\TouchActionStdNextRepeat}
+\newcommand{\ActionStdCancel}{\ButtonPower{} or \TouchActionStdCancel}
+\newcommand{\ActionStdContext}{\TouchActionStdContext}
+\newcommand{\ActionStdQuickScreen}{\TouchActionStdQuickScreen}
+\newcommand{\ActionQuickScreenExit}{\ButtonPower{} or \TouchActionQuickScreenExit}
+\newcommand{\ActionStdMenu}{\TouchActionStdMenu}
+\newcommand{\ActionStdOk}{\TouchActionStdOk}
+%\newcommand{\ActionStdRec}{\TouchActionStdRec}
+%\newcommand{\ActionStdUsbCharge}{\ButtonMenu}
+
+%Button actions, wps context
+\newcommand{\ActionWpsPlay}{\TouchActionWpsPlay}
+\newcommand{\ActionWpsSkipNext}{\TouchActionWpsSkipNext}
+\newcommand{\ActionWpsSeekFwd}{\TouchActionWpsSeekFwd}
+\newcommand{\ActionWpsSkipPrev}{\TouchActionWpsSkipPrev}
+\newcommand{\ActionWpsSeekBack}{\TouchActionWpsSeekBack}
+
+\newcommand{\ActionWpsStop}{\TouchActionWpsStop}
+\newcommand{\ActionWpsVolDown}{\TouchActionWpsVolDown}
+\newcommand{\ActionWpsVolUp}{\TouchActionWpsVolUp}
+
+\newcommand{\ActionWpsQuickScreen}{\TouchActionWpsQuickScreen}
+\newcommand{\ActionWpsMenu}{\TouchActionWpsMenu}
+\newcommand{\ActionWpsContext}{\TouchActionWpsContext}
+\newcommand{\ActionWpsBrowse}{\TouchActionWpsBrowse}
+\newcommand{\ActionWpsPitchScreen}{\TouchActionWpsPitchScreen}
+\newcommand{\ActionWpsIdThreeScreen}{\TouchActionWpsIdThreeScreen}
+
+\newcommand{\ActionWpsAbSetBNextDir}{\TouchActionWpsAbSetBNextDir}
+\newcommand{\ActionWpsAbSetAPrevDir}{\TouchActionWpsAbSetAPrevDir}
+\newcommand{\ActionWpsAbReset}{\TouchActionWpsAbReset}
+
+\newcommand{\ActionWpsHotkey}{\TouchBottomRight}
+
+%Button actions, tree context
+\newcommand{\ActionTreeWps}{\TouchActionTreeWps}
+\newcommand{\ActionTreeStop}{\TouchActionTreeStop}
+\newcommand{\ActionTreeEnter}{\TouchActionTreeEnter}
+\newcommand{\ActionTreeParentDirectory}{\TouchActionTreeParentDirectory}
+
+%Button actions, YesNo context
+\newcommand{\ActionYesNoAccept}{\TouchActionYesNoAccept}
+
+%Button actions, Setting context
+\newcommand{\ActionSettingInc}{\TouchActionSettingInc}
+\newcommand{\ActionSettingDec}{\TouchActionSettingDec}
+
+%Button actions, Virtual Keyboard Context
+\newcommand{\ActionKbdLeft}{\TouchActionKbdLeft}
+\newcommand{\ActionKbdRight}{\TouchActionKbdRight}
+\newcommand{\ActionKbdSelect}{\TouchActionKbdSelect}
+\newcommand{\ActionKbdDone}{\TouchActionKbdDone}
+\newcommand{\ActionKbdAbort}{\TouchActionKbdAbort}
+\newcommand{\ActionKbdUp}{\TouchActionKbdUp}
+\newcommand{\ActionKbdDown}{\TouchActionKbdDown}
+\newcommand{\ActionKbdCursorLeft}{\TouchActionKbdCursorLeft}
+\newcommand{\ActionKbdCursorRight}{\TouchActionKbdCursorRight}
+\newcommand{\ActionKbdBackSpace}{\TouchActionKbdBackSpace}
+\newcommand{\ActionKbdPageFlip}{\TouchActionKbdPageFlip}
+
+%Button actions, Pitch Screen context
+\newcommand{\ActionPsToggleMode}{\TouchActionPsToggleMode}
+\newcommand{\ActionPsIncSmall}{\TouchActionPsIncSmall}
+\newcommand{\ActionPsIncBig}{\TouchActionPsIncBig}
+\newcommand{\ActionPsDecSmall}{\TouchActionPsDecSmall}
+\newcommand{\ActionPsDecBig}{\TouchActionPsDecBig}
+\newcommand{\ActionPsNudgeLeft}{\TouchActionPsNudgeLeft}
+\newcommand{\ActionPsNudgeRight}{\TouchActionPsNudgeRight}
+\newcommand{\ActionPsReset}{\TouchActionPsReset}
+\newcommand{\ActionPsExit}{\ButtonPower{} or \TouchActionPsExit}
+\newcommand{\ActionPsSlower}{\TouchActionPsSlower}
+\newcommand{\ActionPsFaster}{\TouchActionPsFaster}
+
+%Button actions, FM radio context
+\newcommand{\ActionFMPreset}{\TouchActionFMPreset}
+\newcommand{\ActionFMMenu}{\TouchActionFMMenu}
+\newcommand{\ActionFMMode}{\TouchActionFMMode}
+\newcommand{\ActionFMStop}{\TouchActionFMStop{} or \ButtonPower}
+\newcommand{\ActionFMExit}{\TouchActionFMExit}
+\newcommand{\ActionFMPlay}{\TouchActionFMPlay}
+\newcommand{\ActionFMSettingsInc}{\ActionSettingInc}
+\newcommand{\ActionFMSettingsDec}{\ActionSettingDec}
+\newcommand{\ActionFMPrev}{\TouchActionFMPrev}
+\newcommand{\ActionFMNext}{\TouchActionFMNext}
+
+%Button actions, Bookmark screen context
+\newcommand{\ActionBmDelete}{\TouchActionBmDelete}
+
+%Plugin lib actions
+\newcommand{\PluginUp}{\TouchTopMiddle}
+\newcommand{\PluginDown}{\TouchBottomMiddle}
+\newcommand{\PluginLeft}{\TouchMidLeft}
+\newcommand{\PluginRight}{\TouchMidRight}
+\newcommand{\PluginUpRepeat}{Long \TouchTopMiddle}
+\newcommand{\PluginDownRepeat}{Long \TouchBottomMiddle}
+\newcommand{\PluginLeftRepeat}{Long \TouchMidLeft}
+\newcommand{\PluginRightRepeat}{Long \TouchMidRight}
+\newcommand{\PluginCancel}{\ButtonPower{} or \TouchBottomRight}
+\newcommand{\PluginExit}{Long \ButtonPower}
+\newcommand{\PluginSelect}{\TouchCenter}
+\newcommand{\PluginSelectRepeat}{Long \TouchCenter}
+
diff --git a/manual/platform/ondavx777.tex b/manual/platform/ondavx777.tex
new file mode 100644
index 0000000000..4865f069fc
--- /dev/null
+++ b/manual/platform/ondavx777.tex
@@ -0,0 +1,27 @@
+% $Id$ %
+\def\UseOption{ondavx777}
+\edef\UseOption{\UseOption,ONDA_VX777_PAD}
+\edef\UseOption{\UseOption,HAVE_BACKLIGHT}
+\edef\UseOption{\UseOption,HAVE_RB_BL_IN_FLASH}
+%\edef\UseOption{\UseOption,HAVE_CAR_ADAPTER_MODE}
+\edef\UseOption{\UseOption,ondavx777}
+
+\newcommand{\playerman}{Onda}
+\newcommand{\playertype}{VX777}
+\newcommand{\playerlongtype}{\playertype}
+\newcommand{\dapdisplaywidth}{240}
+\newcommand{\dapdisplayheight}{400}
+\newcommand{\dapdisplaydepth}{16}
+\newcommand{\specimg}{ondavx777}
+%Used to name the player, e.g. ...to the \dap
+\newcommand{\dap}{player}
+%For use when referring to the player. E.g. the \daps\ capacity ...
+\newcommand{\daps}{player's}
+\newcommand{\firmwarefilename}{\fname{rockbox.vx777}}
+\newcommand{\firmwareextension}{\fname{vx777}}
+\newcommand{\screenshotsize}{6cm}
+\newcommand{\disk}{flash storage}
+
+% link external keymap file
+\input{platform/keymap-ondavx777.tex}
+\input{platform/keymap-touchscreen.tex}
diff --git a/manual/rockbox_interface/main.tex b/manual/rockbox_interface/main.tex
index 507255bcf3..8a69744f17 100644
--- a/manual/rockbox_interface/main.tex
+++ b/manual/rockbox_interface/main.tex
@@ -22,18 +22,16 @@ picture above.
\opt{touchscreen}{
The areas of the touchscreen in the 3$\times$3 grid mode are in turn referred as follows:
\begin{table}
- \begin{center}
- %\begin{tabularx}{.82\textwidth}{l|c|r}
- \begin{tabularx}{.9\textwidth}{X|X|X}
- \toprule
- \TouchTopLeft & \TouchTopMiddle & \TouchTopRight \\
- \midrule
- \TouchMidLeft & \TouchCenter & \TouchMidRight \\
- \midrule
- \TouchBottomLeft & \TouchBottomMiddle & \TouchBottomRight \\
- \bottomrule
- \end{tabularx}
- \end{center}
+ \centering
+ \begin{tabular}{|c|c|c|}
+ \hline
+ \TouchTopLeft & \TouchTopMiddle & \TouchTopRight \\ [5ex]
+ \hline
+ \TouchMidLeft & \TouchCenter & \TouchMidRight \\ [5ex]
+ \hline
+ \TouchBottomLeft & \TouchBottomMiddle & \TouchBottomRight \\ [5ex]
+ \hline
+ \end{tabular}
\end{table}
}%
Whenever a button name is prefixed by ``Long'', a long press of approximately
@@ -503,7 +501,7 @@ To turn on and off your Rockbox enabled \dap{} use the following keys:
\opt{IPOD_3G_PAD}{\ButtonMenu{} / \ButtonPlay}%
\opt{ONDIO_PAD}{\ButtonOff}\opt{RECORDER_PAD,PLAYER_PAD}%
{Long \ButtonOn}%
- \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD%
+ \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,ONDA_VX777_PAD%
,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,PBELL_VIBE500_PAD%
}{\ButtonPower}%
\opt{COWON_D2_PAD} {\ButtonPower{}, then \ButtonHold}%
@@ -522,7 +520,7 @@ To turn on and off your Rockbox enabled \dap{} use the following keys:
\opt{PLAYER_PAD}{From the Main Menu, select \textbf{Shutdown}}%
\opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD%
,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,COWON_D2_PAD%
- ,PBELL_VIBE500_PAD}{Long \ButtonPower}%
+ ,PBELL_VIBE500_PAD,ONDA_VX777_PAD}{Long \ButtonPower}%
&
\opt{HAVEREMOTEKEYMAP}{
\opt{IRIVER_RC_H100_PAD}{Long \ButtonRCStop}%
@@ -657,6 +655,13 @@ To turn on and off your Rockbox enabled \dap{} use the following keys:
button and keep it pressed until the original firmware starts.
}
+ \opt{ondavx777}
+ {
+ Rockbox has a dual-boot feature where it is possible to load the original firmware from
+ the file \fname{/SD/ccpmp.bin}. To boot into the original firmware press and release
+ \ButtonPower{} immediately after the Rockbox Logo appear on the screen.
+ }
+
}
\subsection{Putting music on your \dap{}}