From 8dc70840d362ae0d3a2fe3086df60d6726896e47 Mon Sep 17 00:00:00 2001 From: Alex Parker Date: Sun, 22 Feb 2009 14:18:18 +0000 Subject: 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 --- manual/getting_started/gigabeats_install.tex | 113 +++++++++++++++++---------- manual/getting_started/installation.tex | 48 ++++++------ 2 files changed, 96 insertions(+), 65 deletions(-) diff --git a/manual/getting_started/gigabeats_install.tex b/manual/getting_started/gigabeats_install.tex index 2bc8e094c8..317e190fe0 100644 --- a/manual/getting_started/gigabeats_install.tex +++ b/manual/getting_started/gigabeats_install.tex @@ -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 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: -\begin{code} - chmod +x sendfirm - ./sendfirm 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 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{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 +\subsubsection{Bootloader installation from Linux} + +\begin{enumerate} + +\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} + cd $HOME + chmod +x beastpatcher + ./beastpatcher \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. \ No newline at end of file +\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} \ No newline at end of file diff --git a/manual/getting_started/installation.tex b/manual/getting_started/installation.tex index 9299aefb8a..acffcaf590 100644 --- a/manual/getting_started/installation.tex +++ b/manual/getting_started/installation.tex @@ -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} -- cgit v1.2.3