From 018c54ad1c1fdd15759141da11120e00763986cd Mon Sep 17 00:00:00 2001 From: Dana Conrad Date: Fri, 13 Sep 2024 12:18:01 -0500 Subject: Manual: Update erosqnative Update installation instructions, and add a couple things that were missing. Change-Id: I7313285338fe5c4bc05a944e3ba2ff941a796d5b --- manual/configure_rockbox/sound_settings.tex | 17 ++++--- manual/getting_started/hibyos_nativeinstall.tex | 66 +++++++++++++++++++++++++ manual/getting_started/installation.tex | 29 ++++++++++- 3 files changed, 104 insertions(+), 8 deletions(-) create mode 100644 manual/getting_started/hibyos_nativeinstall.tex (limited to 'manual') 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. -- cgit v1.2.3