Manual: Update erosqnative

Update installation instructions, and add a couple things that
were missing.

Change-Id: I7313285338fe5c4bc05a944e3ba2ff941a796d5b

3 files changed, 104 insertions, 8 deletions

diff --git a/manual/configure_rockbox/sound_settings.tex b/manual/configure_rockbox/sound_settings.tex
index fd69d63317..0aeada59b2 100644
--- a/manual/configure_rockbox/sound_settings.tex
+++ b/manual/configure_rockbox/sound_settings.tex
@@ -44,10 +44,6 @@ change to customise your listening experience.
   limit, select a volume from the list and the maximum volume will be limited to
   the selected value all over the system.
   \opt{xduoox3}{This setting also applies to the Line Out of the \dap{}, as at full scale the \dap{} overdrives the signal.}
-  \opt{erosqnative}{On the \playertype{}, when using the Line Out without anything connected to the Headphone port,
-      the volume is fixed to the \setting{Volume Limit} value.
-      \note{On the \playertype{}, the Line Out level at -2~dB is approximately +7~dBV, -4~dB is approximately +4~dBu,
-      and -18~dB is approximately -10~dBV.}}
 
 \section{Bass}
   This setting emphasises
@@ -196,8 +192,7 @@ change to customise your listening experience.
 \opt{erosqnative}{
   \section{Stereo Switch Mode}
   The Eros Q and related devices contain a stereo switch in the audio path.
-  This may be connected differently depending on the hardware revision. This
-  setting allows the behavior of the stereo switch to be changed if one of
+  This setting allows the behavior of the stereo switch to be changed if one of
   the two outputs (Headphones or Line Out) is not working. There are four modes:
   \begin{description}
     \item[Normal.]
@@ -209,6 +204,16 @@ change to customise your listening experience.
     \item[Always 1.]
       Both outputs use a value of 1.
   \end{description}
+
+  \section{DAC filter roll-off}
+  Later versions of the Eros Q and related devices contain a DAC with user-selectable
+  filter roll-off modes. This allows switching between the following modes:
+  \begin{itemize}
+    \item "Sharp"
+    \item "Slow"
+    \item "Short"
+    \item "Bypass"
+  \end{itemize}
 }
 
 \opt{dac_power_mode}{
diff --git a/manual/getting_started/hibyos_nativeinstall.tex b/manual/getting_started/hibyos_nativeinstall.tex
new file mode 100644
index 0000000000..9312a8ec71
--- /dev/null
+++ b/manual/getting_started/hibyos_nativeinstall.tex
@@ -0,0 +1,66 @@
+We will install the bootloader with the original firmware's recovery
+mode. The process is summed up as the following:
+
+\begin{itemize}
+  \item Determine what hardware version your player is and download
+    the correct bootloader update file
+  \item Place the bootloader \fname{update.upt} file on the SD card
+  \item In the original firmware, run the Firmware Update
+    \code{System Settings --> Firmware Update}
+\end{itemize}
+
+\subsubsection{Determine hardware version}\label{ref:determine_hardware_version}
+Determine what hardware version your player is. Go to
+\code{System Settings --> About The Player --> Version} and reference
+the list below. hw1, hw1.5, and hw2 players all use the same update
+file (with one exception), while hw3 players use a different one.
+
+\note{Important: If your player's version is not contained in this list,
+for example if the firmware version is newer than what is listed here,
+we cannot be sure that the hardware is the same. The best thing to do is
+contact the manufacturer and ask them two things: (1) for an update file
+of your version, and (2) if a player with the most recent version listed
+here can be upgraded to the firmware version on your player. If they say
+yes, we can be more certain that the hardware has not changed. These lists
+may not be the most up to date, please see the wiki page at
+\url{https://www.rockbox.org/wiki/AIGOErosQK} for the most up-to-date list.}
+
+\begin{description}
+\item[hw1/hw1.5/hw2 players]
+  \begin{itemize}
+    \item Aigo Eros Q V1.8 - V2.0
+    \item Hifiwalker H2 V1.1 - V1.6
+    \item Surfans F20 V2.2 - V2.7
+  \end{itemize}
+
+  These players use \fname{erosqnative-hw1hw2-erosq.upt} as the update file.
+  The lone exception is the Hifiwalker H2 V1.3, which uses the update file
+  \fname{erosqnative-hw1hw2-eros_h2.upt}.
+\item[hw3 players]
+  \begin{itemize}
+    \item Aigo Eros Q V2.1
+    \item Hifiwalker H2 V1.7 - V1.8
+    \item Surfans F20 V3.0 - V3.3
+  \end{itemize}
+
+  These players use \fname{erosqnative-hw3-erosq.upt} as the update file.
+\end{description}
+
+Download the \fname{.upt} file for these players from \download{bootloader/aigo/native/}.
+
+\note{All players use the same Rockbox build, only the bootloader is different.}
+
+\subsubsection{Place update file on SD card}\label{ref:place_on_sd_card}
+Place the appropriate bootloader file on the root of the SD card and name it
+\emph{exactly} \fname{update.upt}.
+
+\note{This is a good time to ensure that your Rockbox installation \fname{.rockbox}
+is present on your SD card.}
+
+Don't forget to safely eject/unmount your player.
+
+\subsubsection{Run Firmware Update}\label{ref:run_firmware_update}
+In the original firmware, run the firmware updater by going to
+\code{System Settings --> Firmware Update}. At this point, you can delete
+\fname{update.upt} from the SD card if you wish. \emph{Do not delete .rockbox,
+this is your Rockbox installation and needs to stay there!}
\ No newline at end of file
diff --git a/manual/getting_started/installation.tex b/manual/getting_started/installation.tex
index 661964dd8a..04118680b1 100644
--- a/manual/getting_started/installation.tex
+++ b/manual/getting_started/installation.tex
@@ -118,6 +118,15 @@ of before installing.
 \begin{description}
   \item[Filesystem support.] Rockbox only supports the FAT32 filesystem. Other
     filesystems such as exFAT or NTFS are not supported.
+
+    \opt{erosqnative}{\note{Many SD cards come with exFAT on them from the
+    factory. The original firmware can be used to reformat them to FAT
+    by going to \code{System Settings --> Reset --> Format TF Card}.}
+    
+    \note{The SD card that sometimes come bundled with these players are usually
+    of substandard quality and are not to be trusted. It is recommended to source
+    a card of a reputable brand, from a reputable source, such as direct from
+    the manufacturer.}}
   \item[USB DAC.] This feature is not supported by Rockbox, but you can
     dual-boot the original firmware if you want to use it.
   \opt{shanlingq1,agptekrocker,xduoox3ii,xduoox20,aigoerosq,erosqnative}{\item[Wireless.] There is no support for Bluetooth\opt{shanlingq1}{ or WiFi}.
@@ -545,7 +554,8 @@ by Rockbox, in the main directory of your \daps{} drive.
         \opt{samsungyh}{\input{getting_started/samsungyh_install.tex}}
         \opt{xduoox3}{\input{getting_started/xduoox3_install.tex}}
         \opt{xduoox3ii,xduoox20,agptekrocker,aigoerosq}{\input{getting_started/hibyos_install.tex}}
-        \opt{fiiom3k,shanlingq1,erosqnative}{\input{getting_started/jztool_install.tex}}
+        \opt{fiiom3k,shanlingq1}{\input{getting_started/jztool_install.tex}}
+        \opt{erosqnative}{\input{getting_started/hibyos_nativeinstall.tex}}
     }
 }
 
@@ -807,7 +817,7 @@ completely follow the manual uninstallation instructions below.}}
     \playerman{} firmware.
 }
 
-\opt{fiiom3k,shanlingq1,erosqnative}{
+\opt{fiiom3k,shanlingq1}{
     If you want to remove the Rockbox bootloader, copy an original firmware
     update to your microSD card and run the \playerman{} update by 
     \opt{erosqnative}{running it from the Original Firmware's System Settings menu.}
@@ -821,6 +831,21 @@ completely follow the manual uninstallation instructions below.}}
     and enter the recovery menu -- see \reference{ref:jztool_load_bootloader}.
 }
 
+\opt{erosqnative}{
+    If you want to remove the Rockbox bootloader, you will need to acquire the correct
+    update file for your brand player and original firmware version number. The
+    uninstallation procedure can then be done as follows:
+
+    \begin{itemize}
+      \item If the update file is unmodified, use \fname{tools/hibyos_nativepatcher/hibyos_nativepatcher.sh}
+      to mark the original bootloader for updating
+      \item Place the update file on the SD card and ensure it is named \emph{exactly}
+      \fname{update.upt}
+      \item Boot into the Rockbox bootloader menu: With the player off, hold \ButtonVolUp + \ButtonPower
+      \item Select "Aigo Recovery"
+    \end{itemize}
+}
+
 \nopt{gigabeats}{
   If you wish to clean up your disk, you may also wish to delete the
   \fname{.rockbox} directory and its contents.