Cowon D2 manual: Platform specific information and installation instructions

FS#10735 - Platform files for Cowon D2 manual
Author: Aleksei Kaveshnikov (4nykey)

I've modified the original patch to comply with current state of both the
player and manual.


git-svn-id: svn://svn.rockbox.org/rockbox/trunk@24008 a1c6a512-1295-4272-9138-f99709370657

2 files changed, 76 insertions, 4 deletions

diff --git a/manual/getting_started/cowond2_install.tex b/manual/getting_started/cowond2_install.tex
new file mode 100644
index 0000000000..f264ee96d8
--- /dev/null
+++ b/manual/getting_started/cowond2_install.tex
@@ -0,0 +1,28 @@
+\begin{enumerate}
+\item Get a copy of the original \playerman{} \playertype{} firmware from
+  \url{http://www.cowonglobal.com/zeroboard/zboard.php?id=C08&bmenu=support}.
+  It has to be of the same version that is currently installed on your \dap{}.
+
+\item Build the mktccboot tool or download a binary for your operating system.
+
+\item Build the bootloader (\fname{bootloader-cowond2.bin}). Pre-built binary
+  is available at \download{bootloader/cowon/d2/bootloader-cowond2.bin}.
+
+\item Patch the bootloader into the \playerman{} firmware using mktccboot:
+  \begin{code}
+    mktccboot D2N.bin bootloader-cowond2.bin D2N-patched.bin
+  \end{code}
+  \note{The filename depends on the firmware version and hardware revision as
+    shown in the table below (for the \playertype{} use the file found in folder
+    ``\fname{1}'', not ``\fname{0}'')
+    \begin{table}
+      \begin{rbtabular}{0.6\textwidth}{XXX}%
+        { \textbf{FW / HW} & \textbf{\playertype{}} & \textbf{\playertype{}+}}{}{}
+        \textbf{1.xx, 3.xx} & \fname{D2.bin} & \fname{D2\_P.bin} \\
+        \textbf{2.xx, 4.xx} & \fname{D2N.bin} & \fname{D2N\_P.bin} \\
+      \end{rbtabular}
+    \end{table}}
+
+\item Copy the output file (``\fname{D2N-patched.bin}'' in our example) to the
+  root of the \daps{} internal memory and rename it according to the above table.
+\end{enumerate}
diff --git a/manual/getting_started/installation.tex b/manual/getting_started/installation.tex
index a32027d5f2..5943e4ecde 100644
--- a/manual/getting_started/installation.tex
+++ b/manual/getting_started/installation.tex
@@ -11,7 +11,7 @@ before beginning there are a few things it is important to know.
 follow the instructions at 
 \url{http://www.rockbox.org/twiki/bin/view/Main/SansaE200RInstallation}.}}
 
-\opt{ipodnano,ipodnano2g,ipodvideo,e200,c200,e200v2,clip}{
+\opt{ipodnano,ipodnano2g,ipodvideo,e200,c200,e200v2,clip,cowond2}{
 \begin{description}  
 \item[Supported hardware versions.] 
     \opt{ipodnano,ipodnano2g}{
@@ -51,9 +51,38 @@ follow the instructions at
     while the v2 firmware begins with 02.  In addition, Rockbox does not
     run on the Clip+.
 }
+  \opt{cowond2}{
+    Rockbox runs on all \playerman{} \playertype{} and \playertype{}+ variants
+    (2 / 4 / 8 / 16GB, with or without DAB/DMB).
+    \note{Newer \playertype{}+ hardware revisions use an updated power
+    management chip, and some functionality is not yet implemented on these
+    players (e.g. touchscreen support).}
+}
 \end{description}
 }
 
+\opt{cowond2}{
+\begin{description}
+  \item[Current limitations.] Most Rockbox functions are usable on the
+    \playertype{}/\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 An SD card is required to use many features, since the internal
+        flash memory is read-only in Rockbox.
+        \warn{The SD driver is still in development and may contain bugs.
+          There have been reports of SD cards becoming unusable after being used
+          with Rockbox on \playerman{} \playertype{}. Only use old, low-capacity
+          cards until we are satisfied the driver is safe to use.\\}
+      \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 3x3 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
@@ -373,7 +402,12 @@ data partiton.}}
 
 \item Take the \fname{.zip} file that you downloaded and use
  the ``Extract all'' command of your unzip program to extract 
- the files onto \opt{gigabeats}{the main data partition of }your \dap{}.
+ the files onto%
+ \opt{gigabeats}{the main data partition of }
+ \opt{cowond2}{either an SD card or the internal memory of }
+ your \dap{}.
+ \opt{cowond2}{\note{If you have chosen to extract to the internal memory, it
+     will not be possible to save settings.}}
 \end{enumerate}
 
 \note{The entire contents of the \fname{.zip} file should be extracted 
@@ -407,6 +441,7 @@ structure that Rockbox needs.\\}
   \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}}
 }}
 
 \subsection{Finishing the install}\label{ref:finish_install}
@@ -437,7 +472,7 @@ structure that Rockbox needs.\\}
   \end{itemize}
 }
 
-\opt{h10,h10_5gb,ipod,mrobe100,sansa,archos,sansaAMS}{
+\opt{h10,h10_5gb,ipod,mrobe100,sansa,archos,sansaAMS,cowond2}{
   Safely eject / unmount the USB drive, unplug the cable and restart.
 }
 
@@ -482,7 +517,7 @@ Rockbox Utility can also aid in the production of talk files, which allow Rockbo
 to speak file and folder names.
 
 \section{Running Rockbox}
-\nopt{ipod,gigabeats}{When
+\nopt{ipod,gigabeats,cowond2}{When
 you turn the unit on, Rockbox should load.}
 \opt{ipod}{Hard reset the Ipod by holding
   \opt{IPOD_4G_PAD}{\ButtonMenu{}+\ButtonSelect{}}%
@@ -501,6 +536,15 @@ you turn the unit on, Rockbox should load.}
     See \reference{ref:database} for more information.}
 }
 
+\opt{cowond2}{
+  To boot the Rockbox firmware set the \ButtonHold{} switch immediately after
+  power on.\\
+  \note{If you have chosen to install to an SD card and it is inserted at power
+    on, Rockbox will boot from that card and use it as the primary drive for
+    storing settings, etc. If there is no SD card inserted, Rockbox will boot
+    from the internal memory, and it will not be possible to save settings.}
+}
+
 \opt{ipod}{
   \note{
     If you have loaded music onto your \dap{} using Itunes,