From bf83ac624083af0c53fdc358df8270798831d8cb Mon Sep 17 00:00:00 2001 From: Marianne Arnold Date: Sun, 4 Jul 2010 13:28:20 +0000 Subject: 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 --- manual/getting_started/installation.tex | 53 +++++++++---- manual/getting_started/ondavx777_install.tex | 23 ++++++ manual/platform/keymap-ondavx777.tex | 109 +++++++++++++++++++++++++++ manual/platform/ondavx777.tex | 27 +++++++ manual/rockbox_interface/main.tex | 33 ++++---- 5 files changed, 215 insertions(+), 30 deletions(-) create mode 100644 manual/getting_started/ondavx777_install.tex create mode 100644 manual/platform/keymap-ondavx777.tex create mode 100644 manual/platform/ondavx777.tex 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{}} -- cgit v1.2.3