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

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{}}