len0rd/rockbox
1
0
Fork 1
mirror of https://github.com/Rockbox/rockbox.git synced 2026-04-12 00:47:49 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

rgnano: rbutil support and manual updates

Browse source 
Needs some testing in windows but except for uninstalling everything should work.

Change-Id: I55691d4cae9b37921f08177edaadc88854fef948
This commit is contained in:
Hairo R. Carela 2026-01-03 11:34:34 -04:00 • committed by Solomon Peachy
parent e3bb80384d
commit d695c3b95b
2 changed files with 55 additions and 50 deletions
Download patch file Download diff file Expand all files Collapse all files

84
manual/getting_started/installation.tex
View file

@ -422,10 +422,10 @@ in installing.
\subsection{Automated Installation} \subsection{Automated Installation}
\opt{gigabeats,ondavx777,fiiom3k,shanlingq1,erosqnative,rgnano}{ \opt{gigabeats,ondavx777,fiiom3k,shanlingq1,erosqnative}{
\note{Rockbox Utility does not currently support the \playertype{} and you will \note{Rockbox Utility does not currently support the \playertype{} and you will
therefore need to follow the manual install instructions.}} therefore need to follow the manual install instructions.}}
\nopt{erosqnative,rgnano}{ \nopt{erosqnative}{
To automatically install Rockbox, download the official installer and To automatically install Rockbox, download the official installer and
housekeeping tool \caps{Rockbox Utility}. It allows you to: housekeeping tool \caps{Rockbox Utility}. It allows you to:
\begin{itemize} \begin{itemize}
@ -538,11 +538,11 @@ There are three different versions of Rockbox available from the
Rockbox website: Rockbox website:
\label{Version} \label{Version}
Release version, current build and archived daily build. You need to decide which one Release version, current build and archived daily build. You need to decide which one
you want to install and get the appropriate version for your \dap{}. \nopt{rgnano}{If you you want to install and get the appropriate version for your \dap{}. If you
select either ``Minimal Installation'' or ``Complete Installation'' from the select either ``Minimal Installation'' or ``Complete Installation'' from the
``Quick Start'' tab, then Rockbox Utility will automatically install the ``Quick Start'' tab, then Rockbox Utility will automatically install the
release version of Rockbox. Using the ``Installation'' tab will allow you release version of Rockbox. Using the ``Installation'' tab will allow you
to select which version you wish to install.} to select which version you wish to install.
\opt{erosqnative}{ \opt{erosqnative}{
\note{\textbf{There are two different versions of Rockbox for the \playertype{}. This manual only \note{\textbf{There are two different versions of Rockbox for the \playertype{}. This manual only
@ -581,9 +581,9 @@ Please now go to \reference{ref:finish_install} to complete the installation pro
\nopt{erosqnative}{ \nopt{erosqnative}{
The manual installation method is still available to you, should you need or desire it The manual installation method is still available to you, should you need or desire it
by following the instructions below. \nopt{rgnano}{If you have used Rockbox Utility by following the instructions below. If you have used Rockbox Utility
to install Rockbox, then you do not need to follow the next section and can skip to install Rockbox, then you do not need to follow the next section and can skip
straight to \reference{ref:finish_install}.} straight to \reference{ref:finish_install}.
} }
\opt{gigabeats,erosqnative}{\subsubsection{Installing the bootloader} \opt{gigabeats,erosqnative}{\subsubsection{Installing the bootloader}
@ -648,22 +648,22 @@ data partition.}}
\opt{gigabeats,fuzeplus}{the main data partition of }% \opt{gigabeats,fuzeplus}{the main data partition of }%
\opt{cowond2}{either an SD card or the internal memory of }% \opt{cowond2}{either an SD card or the internal memory of }%
\opt{ondavx777}{the MicroSD of }% \opt{ondavx777}{the MicroSD of }%
\opt{rgnano}{the \fname{Applications} folder of the microSD card of }% \opt{rgnano}{the root of the microSD card of }%
your \dap{}. your \dap{}.
\opt{cowond2}{\note{If you have chosen to extract to the internal memory, it \opt{cowond2}{\note{If you have chosen to extract to the internal memory, it
will not be possible to save settings.}} will not be possible to save settings.}}
\end{enumerate} \end{enumerate}
\nopt{rgnano}{
\note{The entire contents of the \fname{.zip} file should be extracted \note{The entire contents of the \fname{.zip} file should be extracted
directly to the root of your \daps{} drive. Do not try to directly to the root of your \daps{} drive. Do not try to
create a separate directory on your \dap{} for the Rockbox create a separate directory on your \dap{} for the Rockbox
files! The \fname{.zip} file already contains the internal files! The \fname{.zip} file already contains the internal
structure that Rockbox needs.\\} structure that Rockbox needs.}
\nopt{rgnano}{
% This has nothing to do with swcodec, just that these players need our own % This has nothing to do with swcodec, just that these players need our own
% bootloader so we can decide where we want the main binary. % bootloader so we can decide where we want the main binary.
If the contents of the \fname{.zip} file are extracted correctly, you will \\If the contents of the \fname{.zip} file are extracted correctly, you will
have a directory called \fname{.rockbox}, which contains all the files needed have a directory called \fname{.rockbox}, which contains all the files needed
by Rockbox, in the main directory of your \daps{} drive. by Rockbox, in the main directory of your \daps{} drive.
} }
@ -856,20 +856,18 @@ you turn the unit on, Rockbox should load.}
\section{Updating Rockbox} \section{Updating Rockbox}
\nopt{rgnano}{ \nopt{erosqnative}{
\nopt{erosqnative}{ Rockbox can be easily updated with Rockbox Utility. You can also update Rockbox
Rockbox can be easily updated with Rockbox Utility. You can also update Rockbox
}
\opt{erosqnative}{
The Native Port to \playername{} is not supported by Rockbox Utility yet, so Rockbox Utility cannot update it.
Rockbox is easily updated
}
manually -- download a Rockbox build
as detailed above, and unzip the build to the root directory
of your \dap{} as in the manual installation stage. If your unzip
program asks you whether to overwrite files, choose the ``Yes to all'' option.
The new build will be installed over your current build.\\
} }
\opt{erosqnative}{
The Native Port to \playername{} is not supported by Rockbox Utility yet, so Rockbox Utility cannot update it.
Rockbox is easily updated
}
manually -- download a Rockbox build
as detailed above, and unzip the build to the root directory
of your \dap{} as in the manual installation stage. If your unzip
program asks you whether to overwrite files, choose the ``Yes to all'' option.
The new build will be installed over your current build.\\
\opt{gigabeats}{ \opt{gigabeats}{
\note{When your \dap{} is in the Rockbox USB or bootloader \note{When your \dap{} is in the Rockbox USB or bootloader
@ -884,38 +882,36 @@ The bootloader only changes rarely, and should not normally
need to be updated.\\ need to be updated.\\
} }
\nopt{erosqnative,rgnano}{ \nopt{erosqnative}{
\note{If you use Rockbox Utility be aware that it cannot detect manually \note{If you use Rockbox Utility be aware that it cannot detect manually
installed components.} installed components.\\}
} }
\opt{rgnano}{ \opt{rgnano}{
Rockbox can be easily updated by replacing the \fname{rockbox-funkey-s.opk} Rockbox also can be updated manually by replacing the \fname{rockbox-funkey-s.opk}
file in the \fname{Applications} folder of the microSD card with a newer version. file in the \fname{Applications} folder of the microSD card with a newer version.
} }
\section{Uninstalling Rockbox}\index{Installation!uninstall} \section{Uninstalling Rockbox}\index{Installation!uninstall}
\nopt{rgnano}{ \nopt{gigabeatf,iaudiom3,iaudiom5,iaudiox5,mrobe100,gigabeats,fuzeplus,erosqnative,rgnano}{
\nopt{gigabeatf,iaudiom3,iaudiom5,iaudiox5,mrobe100,gigabeats,fuzeplus,erosqnative}{ \note{The Rockbox bootloader allows you to choose between Rockbox and
\note{The Rockbox bootloader allows you to choose between Rockbox and the original firmware. (See \reference{ref:Dualboot} for more information.)}
the original firmware. (See \reference{ref:Dualboot} for more information.)}
}
\subsection{Automatic Uninstallation}
\opt{gigabeats,erosqnative}{\note{Rockbox can only be uninstalled manually from the \playername{} for now.}}
\nopt{erosqnative}{
You can uninstall Rockbox automatically by using Rockbox Utility. If you
installed Rockbox manually you can still use Rockbox Utility for uninstallation
but will not be able to do this selectively.
}
\opt{iriverh100,iriverh300,fuzeplus}{\note{Rockbox Utility cannot uninstall the bootloader due to
the fact that it requires a flashing procedure. To uninstall the bootloader
completely follow the manual uninstallation instructions below.}}
} }
\subsection{Automatic Uninstallation}
\opt{gigabeats,erosqnative,rgnano}{\note{Rockbox can only be uninstalled manually from the \playername{} for now.}}
\nopt{erosqnative,rgnano}{
You can uninstall Rockbox automatically by using Rockbox Utility. If you
installed Rockbox manually you can still use Rockbox Utility for uninstallation
but will not be able to do this selectively.
}
\opt{iriverh100,iriverh300,fuzeplus}{\note{Rockbox Utility cannot uninstall the bootloader due to
the fact that it requires a flashing procedure. To uninstall the bootloader
completely follow the manual uninstallation instructions below.}}
\subsection{Manual Uninstallation} \subsection{Manual Uninstallation}
\opt{iriverh10,iriverh10_5gb,mrobe100,vibe500,samsungyh}{ \opt{iriverh10,iriverh10_5gb,mrobe100,vibe500,samsungyh}{

21
packaging/rgnano/rgnano.make
View file

@ -2,14 +2,14 @@ RG_NANO_DIR=$(ROOTDIR)/packaging/rgnano
MKSQUASHFS=$(FUNKEY_SDK_PATH)/bin/mksquashfs MKSQUASHFS=$(FUNKEY_SDK_PATH)/bin/mksquashfs
INSTALL_DIR=$(OPK_BUILD_DIR)/install INSTALL_DIR=$(OPK_BUILD_DIR)/install
OPK_BUILD_DIR=opkdir OPK_BUILD_DIR=opkdir
OPK_NAME=rockbox_funkey-s.opk
opkdir:
mkdir $(OPK_BUILD_DIR)
opkclean: opkclean:
rm -rf $(OPK_BUILD_DIR) rm -rf $(OPK_BUILD_DIR)
opk: opkclean opkdir $(MKSQUASHFS) build opk: opkclean $(MKSQUASHFS) build
mkdir $(OPK_BUILD_DIR)
make PREFIX=$(OPK_BUILD_DIR)/rockbox install make PREFIX=$(OPK_BUILD_DIR)/rockbox install
# Install opk files # Install opk files
@ -37,7 +37,16 @@ opk: opkclean opkdir $(MKSQUASHFS) build
chmod +x $(OPK_BUILD_DIR)/run.sh chmod +x $(OPK_BUILD_DIR)/run.sh
# Make opk # Make opk
$(MKSQUASHFS) $(OPK_BUILD_DIR) rockbox_funkey-s.opk -all-root -noappend -no-exports -no-xattrs $(MKSQUASHFS) $(OPK_BUILD_DIR) $(OPK_NAME) -all-root -noappend -no-exports -no-xattrs
opk-zip: opk opk-zip: opk
zip -9 -q rockbox-opk.zip rockbox_funkey-s.opk rockbox-info.txt mkdir Applications
mkdir -p FunKey/.rockbox
mv $(OPK_NAME) Applications/$(OPK_NAME)
zip -9 -q rockbox-opk.zip Applications/$(OPK_NAME) FunKey/.rockbox rockbox-info.txt
mv Applications/$(OPK_NAME) $(OPK_NAME)
rmdir Applications
rmdir FunKey/.rockbox