summaryrefslogtreecommitdiff
path: root/manual
diff options
context:
space:
mode:
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
83 \end{itemize} 83 \end{itemize}
84\end{description} 84\end{description}
85} 85}
86\opt{ondavx777}{
87\begin{description}
88 \item[Current limitations.] Most Rockbox functions are usable on the
89 \playertype{}, including music playback and most plugins, but
90 there are a number of shortcomings that prevent it from being a fully
91 supported target:
92 \begin{itemize}
93 \item A MicroSD card is required to run Rockbox, since the internal
94 flash memory hasn't been figured out yet.
95 \item There is only basic touchscreen support. Further work is
96 required to make the UI more usable with a touchscreen in general.
97 \note{The touchscreen can be used in two modes, either a 3$\times$3 grid mode
98 which divides the screen into areas to emulate a set of physical
99 buttons (the default setting), or ``absolute point'' mode where the
100 touchscreen is used to point to items on the screen.\\}
101 \end{itemize}
102\end{description}
103}
86\opt{h300}{ 104\opt{h300}{
87\begin{description} 105\begin{description}
88 \item[DRM capability.] If your \dap{} has a US firmware, then by installing Rockbox you will 106 \item[DRM capability.] If your \dap{} has a US firmware, then by installing Rockbox you will
@@ -261,7 +279,6 @@ still available to you.\\
261 update Rockbox. The build consists of a directory called 279 update Rockbox. The build consists of a directory called
262 \fname{.rockbox} which contains all of the Rockbox files, and is 280 \fname{.rockbox} which contains all of the Rockbox files, and is
263 located in the root of your \daps{} drive. 281 located in the root of your \daps{} drive.
264
265\end{description} 282\end{description}
266} 283}
267 284
@@ -297,7 +314,7 @@ housekeeping tool \caps{Rockbox Utility}. It allows you to:
297Prebuilt binaries for Windows, Linux and Mac OS X are 314Prebuilt binaries for Windows, Linux and Mac OS X are
298available at the \wikilink{RockboxUtility} wiki page.\\ 315available at the \wikilink{RockboxUtility} wiki page.\\
299 316
300\opt{gigabeats}{\note{Rockbox Utility does not currently support the 317\opt{gigabeats,ondavx777}{\note{Rockbox Utility does not currently support the
301\playertype{} and you will therefore need to follow the manual install 318\playertype{} and you will therefore need to follow the manual install
302instructions below.\\}} 319instructions below.\\}}
303 320
@@ -427,6 +444,7 @@ correct version for your \dap{}.}}
427 the files onto% 444 the files onto%
428 \opt{gigabeats}{the main data partition of } 445 \opt{gigabeats}{the main data partition of }
429 \opt{cowond2}{either an SD card or the internal memory of } 446 \opt{cowond2}{either an SD card or the internal memory of }
447 \opt{ondavx777}{the MicroSD of }
430 your \dap{}. 448 your \dap{}.
431 \opt{cowond2}{\note{If you have chosen to extract to the internal memory, it 449 \opt{cowond2}{\note{If you have chosen to extract to the internal memory, it
432 will not be possible to save settings.}} 450 will not be possible to save settings.}}
@@ -453,19 +471,22 @@ structure that Rockbox needs.\\}
453 by Rockbox, in the main directory of your \daps{} drive. 471 by Rockbox, in the main directory of your \daps{} drive.
454} 472}
455 473
456\opt{swcodec}{\nopt{gigabeats}{ 474\opt{swcodec}{%
457 \subsubsection{Installing the bootloader} 475 \nopt{gigabeats}{%
458 \opt{h100,h300}{\input{getting_started/iriver_install.tex}} 476 \subsubsection{Installing the bootloader}
459 \opt{ipod}{\input{getting_started/ipod_install.tex}} 477 \opt{h100,h300}{\input{getting_started/iriver_install.tex}}
460 \opt{m3,m5,x5}{\input{getting_started/iaudio_install.tex}} 478 \opt{ipod}{\input{getting_started/ipod_install.tex}}
461 \opt{h10,h10_5gb}{\input{getting_started/h10_install.tex}} 479 \opt{m3,m5,x5}{\input{getting_started/iaudio_install.tex}}
462 \opt{gigabeatf}{\input{getting_started/gigabeat_install.tex}} 480 \opt{h10,h10_5gb}{\input{getting_started/h10_install.tex}}
463 \opt{sansa}{\input{getting_started/sansa_install.tex}} 481 \opt{gigabeatf}{\input{getting_started/gigabeat_install.tex}}
464 \opt{sansaAMS}{\input{getting_started/sansaAMS_install.tex}} 482 \opt{sansa}{\input{getting_started/sansa_install.tex}}
465 \opt{mrobe100}{\input{getting_started/mrobe100_install.tex}} 483 \opt{sansaAMS}{\input{getting_started/sansaAMS_install.tex}}
466 \opt{cowond2}{\input{getting_started/cowond2_install.tex}} 484 \opt{mrobe100}{\input{getting_started/mrobe100_install.tex}}
467 \opt{vibe500}{\input{getting_started/vibe500_install.tex}} 485 \opt{cowond2}{\input{getting_started/cowond2_install.tex}}
468}} 486 \opt{vibe500}{\input{getting_started/vibe500_install.tex}}
487 \opt{ondavx777}{\input{getting_started/ondavx777_install.tex}}
488 }
489}
469 490
470\subsection{Finishing the install}\label{ref:finish_install} 491\subsection{Finishing the install}\label{ref:finish_install}
471 492
@@ -495,7 +516,7 @@ structure that Rockbox needs.\\}
495 \end{itemize} 516 \end{itemize}
496} 517}
497 518
498\opt{h10,h10_5gb,ipod,mrobe100,sansa,archos,sansaAMS,cowond2,vibe500}{ 519\opt{h10,h10_5gb,ipod,mrobe100,sansa,archos,sansaAMS,cowond2,vibe500,ondavx777}{
499 Safely eject / unmount the USB drive, unplug the cable and restart. 520 Safely eject / unmount the USB drive, unplug the cable and restart.
500} 521}
501 522
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 @@
1\begin{enumerate}
2\item Compile the bootloader (this will generate a \fname{ccpmp.bin} file).
3
4\item Get a copy of the original \playerman{} firmware (called \fname{vx777.HXF}) from
5 \url{http://www.onda.cn/pro/download/biosexp.jsp?ITEM_ID=12628}.
6
7\item Compile ChinaChipPatcher in rbutil/chinachippatcher/ (run make in the dir).
8
9\item Run
10\begin{code}
11 ../rbutil/chinachippatcher/chinachip VX747.HXF ccpmp.bin output.HXF ccpmp.old
12\end{code}
13 in the dir where you compiled your bootloader
14
15\item Put \fname{output.HXF} in the root of the NAND drive (boot into the OF as
16 Rockbox currently can't access the NAND storage) and name it \fname{VX777.HXF}
17
18\item Reset your player.
19
20\end{enumerate}
21
22\note{If you want to have dual-boot capabilities, copy \fname{ccpmp.old}, name it
23 \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 @@
1% $Id$
2\newcommand{\ButtonPower}{\btnfnt{Power}}
3
4%Button actions, standard context
5\newcommand{\ActionStdPrev}{\TouchActionStdPrev}
6\newcommand{\ActionStdPrevRepeat}{\TouchActionStdPrevRepeat}
7\newcommand{\ActionStdNext}{\TouchActionStdNext}
8\newcommand{\ActionStdNextRepeat}{\TouchActionStdNextRepeat}
9\newcommand{\ActionStdCancel}{\ButtonPower{} or \TouchActionStdCancel}
10\newcommand{\ActionStdContext}{\TouchActionStdContext}
11\newcommand{\ActionStdQuickScreen}{\TouchActionStdQuickScreen}
12\newcommand{\ActionQuickScreenExit}{\ButtonPower{} or \TouchActionQuickScreenExit}
13\newcommand{\ActionStdMenu}{\TouchActionStdMenu}
14\newcommand{\ActionStdOk}{\TouchActionStdOk}
15%\newcommand{\ActionStdRec}{\TouchActionStdRec}
16%\newcommand{\ActionStdUsbCharge}{\ButtonMenu}
17
18%Button actions, wps context
19\newcommand{\ActionWpsPlay}{\TouchActionWpsPlay}
20\newcommand{\ActionWpsSkipNext}{\TouchActionWpsSkipNext}
21\newcommand{\ActionWpsSeekFwd}{\TouchActionWpsSeekFwd}
22\newcommand{\ActionWpsSkipPrev}{\TouchActionWpsSkipPrev}
23\newcommand{\ActionWpsSeekBack}{\TouchActionWpsSeekBack}
24
25\newcommand{\ActionWpsStop}{\TouchActionWpsStop}
26\newcommand{\ActionWpsVolDown}{\TouchActionWpsVolDown}
27\newcommand{\ActionWpsVolUp}{\TouchActionWpsVolUp}
28
29\newcommand{\ActionWpsQuickScreen}{\TouchActionWpsQuickScreen}
30\newcommand{\ActionWpsMenu}{\TouchActionWpsMenu}
31\newcommand{\ActionWpsContext}{\TouchActionWpsContext}
32\newcommand{\ActionWpsBrowse}{\TouchActionWpsBrowse}
33\newcommand{\ActionWpsPitchScreen}{\TouchActionWpsPitchScreen}
34\newcommand{\ActionWpsIdThreeScreen}{\TouchActionWpsIdThreeScreen}
35
36\newcommand{\ActionWpsAbSetBNextDir}{\TouchActionWpsAbSetBNextDir}
37\newcommand{\ActionWpsAbSetAPrevDir}{\TouchActionWpsAbSetAPrevDir}
38\newcommand{\ActionWpsAbReset}{\TouchActionWpsAbReset}
39
40\newcommand{\ActionWpsHotkey}{\TouchBottomRight}
41
42%Button actions, tree context
43\newcommand{\ActionTreeWps}{\TouchActionTreeWps}
44\newcommand{\ActionTreeStop}{\TouchActionTreeStop}
45\newcommand{\ActionTreeEnter}{\TouchActionTreeEnter}
46\newcommand{\ActionTreeParentDirectory}{\TouchActionTreeParentDirectory}
47
48%Button actions, YesNo context
49\newcommand{\ActionYesNoAccept}{\TouchActionYesNoAccept}
50
51%Button actions, Setting context
52\newcommand{\ActionSettingInc}{\TouchActionSettingInc}
53\newcommand{\ActionSettingDec}{\TouchActionSettingDec}
54
55%Button actions, Virtual Keyboard Context
56\newcommand{\ActionKbdLeft}{\TouchActionKbdLeft}
57\newcommand{\ActionKbdRight}{\TouchActionKbdRight}
58\newcommand{\ActionKbdSelect}{\TouchActionKbdSelect}
59\newcommand{\ActionKbdDone}{\TouchActionKbdDone}
60\newcommand{\ActionKbdAbort}{\TouchActionKbdAbort}
61\newcommand{\ActionKbdUp}{\TouchActionKbdUp}
62\newcommand{\ActionKbdDown}{\TouchActionKbdDown}
63\newcommand{\ActionKbdCursorLeft}{\TouchActionKbdCursorLeft}
64\newcommand{\ActionKbdCursorRight}{\TouchActionKbdCursorRight}
65\newcommand{\ActionKbdBackSpace}{\TouchActionKbdBackSpace}
66\newcommand{\ActionKbdPageFlip}{\TouchActionKbdPageFlip}
67
68%Button actions, Pitch Screen context
69\newcommand{\ActionPsToggleMode}{\TouchActionPsToggleMode}
70\newcommand{\ActionPsIncSmall}{\TouchActionPsIncSmall}
71\newcommand{\ActionPsIncBig}{\TouchActionPsIncBig}
72\newcommand{\ActionPsDecSmall}{\TouchActionPsDecSmall}
73\newcommand{\ActionPsDecBig}{\TouchActionPsDecBig}
74\newcommand{\ActionPsNudgeLeft}{\TouchActionPsNudgeLeft}
75\newcommand{\ActionPsNudgeRight}{\TouchActionPsNudgeRight}
76\newcommand{\ActionPsReset}{\TouchActionPsReset}
77\newcommand{\ActionPsExit}{\ButtonPower{} or \TouchActionPsExit}
78\newcommand{\ActionPsSlower}{\TouchActionPsSlower}
79\newcommand{\ActionPsFaster}{\TouchActionPsFaster}
80
81%Button actions, FM radio context
82\newcommand{\ActionFMPreset}{\TouchActionFMPreset}
83\newcommand{\ActionFMMenu}{\TouchActionFMMenu}
84\newcommand{\ActionFMMode}{\TouchActionFMMode}
85\newcommand{\ActionFMStop}{\TouchActionFMStop{} or \ButtonPower}
86\newcommand{\ActionFMExit}{\TouchActionFMExit}
87\newcommand{\ActionFMPlay}{\TouchActionFMPlay}
88\newcommand{\ActionFMSettingsInc}{\ActionSettingInc}
89\newcommand{\ActionFMSettingsDec}{\ActionSettingDec}
90\newcommand{\ActionFMPrev}{\TouchActionFMPrev}
91\newcommand{\ActionFMNext}{\TouchActionFMNext}
92
93%Button actions, Bookmark screen context
94\newcommand{\ActionBmDelete}{\TouchActionBmDelete}
95
96%Plugin lib actions
97\newcommand{\PluginUp}{\TouchTopMiddle}
98\newcommand{\PluginDown}{\TouchBottomMiddle}
99\newcommand{\PluginLeft}{\TouchMidLeft}
100\newcommand{\PluginRight}{\TouchMidRight}
101\newcommand{\PluginUpRepeat}{Long \TouchTopMiddle}
102\newcommand{\PluginDownRepeat}{Long \TouchBottomMiddle}
103\newcommand{\PluginLeftRepeat}{Long \TouchMidLeft}
104\newcommand{\PluginRightRepeat}{Long \TouchMidRight}
105\newcommand{\PluginCancel}{\ButtonPower{} or \TouchBottomRight}
106\newcommand{\PluginExit}{Long \ButtonPower}
107\newcommand{\PluginSelect}{\TouchCenter}
108\newcommand{\PluginSelectRepeat}{Long \TouchCenter}
109
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 @@
1% $Id$ %
2\def\UseOption{ondavx777}
3\edef\UseOption{\UseOption,ONDA_VX777_PAD}
4\edef\UseOption{\UseOption,HAVE_BACKLIGHT}
5\edef\UseOption{\UseOption,HAVE_RB_BL_IN_FLASH}
6%\edef\UseOption{\UseOption,HAVE_CAR_ADAPTER_MODE}
7\edef\UseOption{\UseOption,ondavx777}
8
9\newcommand{\playerman}{Onda}
10\newcommand{\playertype}{VX777}
11\newcommand{\playerlongtype}{\playertype}
12\newcommand{\dapdisplaywidth}{240}
13\newcommand{\dapdisplayheight}{400}
14\newcommand{\dapdisplaydepth}{16}
15\newcommand{\specimg}{ondavx777}
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{rockbox.vx777}}
21\newcommand{\firmwareextension}{\fname{vx777}}
22\newcommand{\screenshotsize}{6cm}
23\newcommand{\disk}{flash storage}
24
25% link external keymap file
26\input{platform/keymap-ondavx777.tex}
27\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.
22\opt{touchscreen}{ 22\opt{touchscreen}{
23The areas of the touchscreen in the 3$\times$3 grid mode are in turn referred as follows: 23The areas of the touchscreen in the 3$\times$3 grid mode are in turn referred as follows:
24\begin{table} 24\begin{table}
25 \begin{center} 25 \centering
26 %\begin{tabularx}{.82\textwidth}{l|c|r} 26 \begin{tabular}{|c|c|c|}
27 \begin{tabularx}{.9\textwidth}{X|X|X} 27 \hline
28 \toprule 28 \TouchTopLeft & \TouchTopMiddle & \TouchTopRight \\ [5ex]
29 \TouchTopLeft & \TouchTopMiddle & \TouchTopRight \\ 29 \hline
30 \midrule 30 \TouchMidLeft & \TouchCenter & \TouchMidRight \\ [5ex]
31 \TouchMidLeft & \TouchCenter & \TouchMidRight \\ 31 \hline
32 \midrule 32 \TouchBottomLeft & \TouchBottomMiddle & \TouchBottomRight \\ [5ex]
33 \TouchBottomLeft & \TouchBottomMiddle & \TouchBottomRight \\ 33 \hline
34 \bottomrule 34 \end{tabular}
35 \end{tabularx}
36 \end{center}
37\end{table} 35\end{table}
38}% 36}%
39Whenever a button name is prefixed by ``Long'', a long press of approximately 37Whenever 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:
503 \opt{IPOD_3G_PAD}{\ButtonMenu{} / \ButtonPlay}% 501 \opt{IPOD_3G_PAD}{\ButtonMenu{} / \ButtonPlay}%
504 \opt{ONDIO_PAD}{\ButtonOff}\opt{RECORDER_PAD,PLAYER_PAD}% 502 \opt{ONDIO_PAD}{\ButtonOff}\opt{RECORDER_PAD,PLAYER_PAD}%
505 {Long \ButtonOn}% 503 {Long \ButtonOn}%
506 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD% 504 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,ONDA_VX777_PAD%
507 ,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,PBELL_VIBE500_PAD% 505 ,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,PBELL_VIBE500_PAD%
508 }{\ButtonPower}% 506 }{\ButtonPower}%
509 \opt{COWON_D2_PAD} {\ButtonPower{}, then \ButtonHold}% 507 \opt{COWON_D2_PAD} {\ButtonPower{}, then \ButtonHold}%
@@ -522,7 +520,7 @@ To turn on and off your Rockbox enabled \dap{} use the following keys:
522 \opt{PLAYER_PAD}{From the Main Menu, select \textbf{Shutdown}}% 520 \opt{PLAYER_PAD}{From the Main Menu, select \textbf{Shutdown}}%
523 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD% 521 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD%
524 ,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,COWON_D2_PAD% 522 ,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,COWON_D2_PAD%
525 ,PBELL_VIBE500_PAD}{Long \ButtonPower}% 523 ,PBELL_VIBE500_PAD,ONDA_VX777_PAD}{Long \ButtonPower}%
526 & 524 &
527 \opt{HAVEREMOTEKEYMAP}{ 525 \opt{HAVEREMOTEKEYMAP}{
528 \opt{IRIVER_RC_H100_PAD}{Long \ButtonRCStop}% 526 \opt{IRIVER_RC_H100_PAD}{Long \ButtonRCStop}%
@@ -657,6 +655,13 @@ To turn on and off your Rockbox enabled \dap{} use the following keys:
657 button and keep it pressed until the original firmware starts. 655 button and keep it pressed until the original firmware starts.
658 } 656 }
659 657
658 \opt{ondavx777}
659 {
660 Rockbox has a dual-boot feature where it is possible to load the original firmware from
661 the file \fname{/SD/ccpmp.bin}. To boot into the original firmware press and release
662 \ButtonPower{} immediately after the Rockbox Logo appear on the screen.
663 }
664
660 } 665 }
661\subsection{Putting music on your \dap{}} 666\subsection{Putting music on your \dap{}}
662 667