From 675b22e76b798bc0e36cdd1edb97b17546c03cf2 Mon Sep 17 00:00:00 2001
From: Solomon Peachy <pizza@shaftnet.org>
Date: Mon, 24 Aug 2020 11:04:02 -0400
Subject: xduoox3:  Initial manual

TODO:

 * Screenshots
 * Plugin keymaps

Change-Id: Iaecaa2f585693eb5c2c301bd07aeaa27cdf2588f
---
 manual/getting_started/xduoox3_install.tex | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 manual/getting_started/xduoox3_install.tex

(limited to 'manual/getting_started/xduoox3_install.tex')

diff --git a/manual/getting_started/xduoox3_install.tex b/manual/getting_started/xduoox3_install.tex
new file mode 100644
index 0000000000..e4d49898f2
--- /dev/null
+++ b/manual/getting_started/xduoox3_install.tex
@@ -0,0 +1,28 @@
+  Installing the bootloader is the trickiest part of the installation.
+  We cannot distribute the bootloader directly, and thus need to patch a compatible
+  version of the xDuoo firmware.
+
+\begin{enumerate}
+
+\item Download the Rockbox bootloader from
+  \url{http://download.rockbox.org/bootloader/xduoo/X3-v11.bsdiff}
+
+\item Get a copy of the original \playertype{} v1.1 firmware from
+  \url{https://www.xduoo.net/firmware-download/} and extract the .rar file to obtain the
+  update image (called \fname{update.zip}).
+
+\item Compile bspatch in rbutil/bspatch/ (run make in the dir).
+
+\item Run
+\begin{code}
+    ../rbutil/bspatch/bspatch update.zip output.zip X3-v11.bsdiff
+\end{code}
+
+\item Put \fname{output.zip} in the root of the SD card and rename it to \fname{update.zip}.
+
+\item Disconnect the player from USB and let the original firmware boot.
+
+\item Go into the 'Setting' menu, and select 'Upgrade'. The player will reboot into Rockbox
+  upon completion.
+
+\end{enumerate}
-- 
cgit v1.2.3

