Update Beast installation instructions to use beastpatcher and remove instructions for fixing partition table as this will shortly be done on-the-fly by the bootloader. Download locations for beastpatcher still required.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@20084 a1c6a512-1295-4272-9138-f99709370657
This commit is contained in:
Alex Parker 2009-02-22 14:18:18 +00:00
parent c06071e2e7
commit 8dc70840d3
2 changed files with 96 additions and 65 deletions

View file

@ -22,57 +22,84 @@ bootloader) and executed when your \dap{} is powered on.
\subsubsection{Bootloader installation from Windows}
\begin{enumerate}
\item Download \fname{sendfirm.exe} from \fixme{add download location}.
\item Download the bootloader (\fname{nk.bin}) from \fixme{add download location}.
\item From the command prompt, enter the directory into which you downloaded
\fname{sendfirm.exe} and \fname{nk.bin} and run:
\begin{code}
sendfirm.exe nk.bin
\end{code}
\item After a successful installation, your \dap{} will immediately reboot
and (because it is still connected to your PC) enter the Rockbox bootloader's
\item Attach your \dap{} to your computer.
\item Download \fname{beastpatcher.exe} from
\fixme{add download location}
and run it.
\item You should see some information displayed about
your \dap{} and a message asking you if you wish to install the Rockbox
bootloader. Press i followed by ENTER, and beastpatcher will
install the bootloader. After a short time you should see the message
``[INFO] Bootloader installed successfully'' followed by some error
messages that you can safely ignore. Press ENTER again to exit
beastpatcher.
\item After a successful installation, your \dap{} will immediately turn off.
Turn it on again, and (because it is still connected to your PC)
it will enter the Rockbox bootloader's
``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
as a standard USB Mass Storage device.
\end{enumerate}
\subsubsection{Bootloader installation from Unix (Linux / Mac OS X)}
\subsubsection{Bootloader installation from Mac OS X}
\begin{enumerate}
\item Attach your \dap{} to your computer.
\item Download and open beastpatcher.dmg from
\fixme{add download location}
and then double-click on the beastpatcher icon inside. You can also
drag the beastpatcher icon to a location on your hard drive and launch
it from the Terminal.
\item If all has gone well, you should see some
information displayed about your \dap{} and a message asking you if you
wish to install the Rockbox bootloader. Press i followed by ENTER, and
beastpatcher will now install the bootloader. After a short time you
should see the message ``[INFO] Bootloader installed successfully''
followed by some error messages that you can safely ignore. Press
ENTER again to exit beastpatcher and then quit the Terminal application.
\item After a successful installation, your \dap{} will immediately turn off.
Turn it on again, and (because it is still connected to your Mac)
it will enter the Rockbox bootloader's
``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
as a standard USB Mass Storage device.
\end{enumerate}
\subsubsection{Bootloader installation from Linux}
\begin{enumerate}
\item Download \fname{sendfirm} from \fixme{add download location}.
\item Download the bootloader (\fname{nk.bin}) from \fixme{add download location}.
\item From the terminal, enter the directory into which you downloaded
\fname{sendfirm} and \fname{nk.bin} and run:
\item Download beastpatcher from
\fixme{add download location} (32-bit x86
binary) or \fixme{add download location}
(64-bit amd64 binary). You can save this anywhere you wish, but the next
steps will assume you have saved it in your home directory.
\item Attach your \dap{} to your computer.
\item Open up a terminal window and type the following commands:
\begin{code}
chmod +x sendfirm
./sendfirm nk.bin
cd $HOME
chmod +x beastpatcher
./beastpatcher
\end{code}
\item After a successful installation, your \dap{} will immediately reboot
and (because it is still connected to your PC) enter the Rockbox bootloader's
\item If all has gone well, you should see some information displayed about
your \dap{} and a message asking you if you wish to install the Rockbox
bootloader. Press i followed by ENTER, and beastpatcher will now install the
bootloader. After a short time you should see the message ``[INFO] Bootloader
installed successfully'' followed by some error
messages that you can safely ignore. Press ENTER again to exit beastpatcher.
\item After a successful installation, your \dap{} will immediately turn off.
Turn it on again, and (because it is still connected to your PC)
it will enter the Rockbox bootloader's
``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
as a standard USB Mass Storage device.
\end{enumerate}
\subsubsection{Fixing the partition table}
The factory-standard partition table on your \daps{} disk is technically
invalid, and the Linux kernel (and maybe other operating systems) rejects it.
To fix this, you need to use the fdisk utility to correctly set the ``bootable
flag'' field to a valid value (it doesn't matter if this is true or false).\\
\note{Windows does not seem to mind this, so if you only use your \dap{} with
Windows the following steps are not necessary.\\}
Assuming your \dap{} is appearing as /dev/sdz (the output of the dmesg
command will show the log messages including the device node assigned to
your \dap{}), type the following:
\begin{code}
fdisk /dev/sdz
a
1
a
2
w
\end{code}
After exiting fdisk, you may need to unplug and then reattach your \dap{}
in order for it to be recognised by your computer.
\end{enumerate}

View file

@ -341,14 +341,14 @@ 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 your \dap{}.
the files onto \opt{gigabeats}{the main data partition of }your \dap{}.
\end{enumerate}
\note{The entire contents of the \fname{.zip} file should be extracted
directly to the root of your \daps{} drive. Do not try to
create a separate directory on your \dap{} for the Rockbox
files! The \fname{.zip} file already contains the internal
structure that Rockbox needs.}
structure that Rockbox needs.\\}
\opt{archos}{
If the contents of the \fname{.zip} file are extracted correctly, you will
@ -427,6 +427,9 @@ structure that Rockbox needs.}
\end{itemize}
}
\opt{e200}{Your e200 will automatically reboot and Rockbox should load.}
\subsection{Enabling Speech Support (optional)}\label{sec:enabling_speech_support}
\index{Speech}\index{Installation!Optional Steps}
@ -443,24 +446,22 @@ 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,e200,gigabeats}{Unplug any connected power supply and turn the unit off. When
you next turn the unit on, Rockbox should load.}%
\opt{ipod}{Hard resetting the Ipod by holding
\nopt{ipod,gigabeats}{When
you turn the unit on, Rockbox should load.}
\opt{ipod}{Hard reset the Ipod by holding
\opt{IPOD_4G_PAD}{\ButtonMenu{}+\ButtonSelect{}}%
\opt{IPOD_3G_PAD}{\ButtonMenu{}+\ButtonPlay{}}
for a couple of seconds until the \dap{} resets. Now Rockbox should load.
} %
\opt{e200}{Your e200 will automatically reboot and Rockbox should load. }%
When you see the Rockbox splash screen, Rockbox is loaded and ready for
use.
}
\opt{gigabeats}{Rockbox should automatically load when you turn on your player.\\
\opt{gigabeats}{Rockbox should automatically load when you unplug the USB
cable.
\note{
If you have loaded music onto your \dap{} using the \playerman{} firmaware,
you will not be able to see your music properly in the \setting{File Browser}.
Files placed on your \dap{} using the \playerman{} can be viewed by
initialising and using Rockbox's database.
If you have loaded music onto your \dap{} using the \playerman{}
firmware, you will not be able to see your music properly in the
\setting{File Browser} as MTP mode changes the location and file names.
Files placed on your \dap{} using the \playerman{} firmware can be
viewed by initialising and using Rockbox's database.
See \reference{ref:database} for more information.}
}
@ -588,6 +589,10 @@ completely follow the manual uninstallation instructions below.}}
}
\opt{gigabeats}{
If you wish to clean up your disk by deleting the
\fname{.rockbox} directory and its contents, this must be done
before uninstalling the bootloader in the next step.
Before installation you should have downloaded a copy of the \playerman{}
firmware from
\url{http://www.tacp.toshiba.com/tacpassets-images/firmware/MESV12US.zip}.
@ -597,16 +602,15 @@ completely follow the manual uninstallation instructions below.}}
\fname{Autorun.inf} and \fname{gbs\_update\_1\_2\_us.exe}. Extract them with
your favourite unzipping utility e.g. 7zip.
\item Connect your \dap{} to your computer.
\item From Windows, you can run \fname{gbs\_update\_1\_2\_us.exe} to restore
your \dap{}
\warn{This will format your \dap{}, removing all files}
\item From Linux, extract \fname{nk.bin} from within
\item Extract \fname{nk.bin} from within
\fname{gbs\_update\_1\_2\_us.exe} using e.g. 7zip and copy it to the 150 MB
firmware partition of your \dap{}. If you wish to clean up your disk,
you may also wish to delete the \fname{.rockbox} directory and its contents
from the main partition.
firmware partition of your \dap{}.
\item Safely eject / unmount the USB drive, unplug the cable and restart.
\end{itemize}
\note{From Windows, you can also run \fname{gbs\_update\_1\_2\_us.exe}
directly to restore your \dap{}. This will format your \dap{},
removing all files.}
}
\section{Troubleshooting}