diff options
Diffstat (limited to 'manual')
-rw-r--r-- | manual/getting_started/installation.tex | 8 | ||||
-rw-r--r-- | manual/getting_started/ipod_install.tex | 109 | ||||
-rw-r--r-- | manual/platform/ipod6g.tex | 27 |
3 files changed, 123 insertions, 21 deletions
diff --git a/manual/getting_started/installation.tex b/manual/getting_started/installation.tex index 473fca2bb9..9812c13606 100644 --- a/manual/getting_started/installation.tex +++ b/manual/getting_started/installation.tex | |||
@@ -10,7 +10,7 @@ before beginning there are a few important things to know. | |||
10 | follow the instructions at | 10 | follow the instructions at |
11 | \url{http://www.rockbox.org/twiki/bin/view/Main/SansaE200RInstallation}.}} | 11 | \url{http://www.rockbox.org/twiki/bin/view/Main/SansaE200RInstallation}.}} |
12 | 12 | ||
13 | \opt{ipodnano,ipodnano2g,ipodvideo,e200,c200,c200v2,e200v2,clipv1,clipv2,cowond2,fuze,fuzev2}{ | 13 | \opt{ipodnano,ipodnano2g,ipodvideo,ipod6g,e200,c200,c200v2,e200v2,clipv1,clipv2,cowond2,fuze,fuzev2}{ |
14 | \begin{description} | 14 | \begin{description} |
15 | \item[Supported hardware versions.] | 15 | \item[Supported hardware versions.] |
16 | \opt{ipodnano,ipodnano2g}{ | 16 | \opt{ipodnano,ipodnano2g}{ |
@@ -23,10 +23,14 @@ follow the instructions at | |||
23 | } | 23 | } |
24 | \opt{ipodvideo}{ | 24 | \opt{ipodvideo}{ |
25 | The \playertype{} is the 5th/5.5th generation \playerman{} only. | 25 | The \playertype{} is the 5th/5.5th generation \playerman{} only. |
26 | Rockbox does \emph{not} run on the newer, 6th/Classic generation Ipod. | ||
27 | For information on identifying which Ipod you own, see this page on Apple's | 26 | For information on identifying which Ipod you own, see this page on Apple's |
28 | website: \url{http://www.info.apple.com/kbnum/n61688}. | 27 | website: \url{http://www.info.apple.com/kbnum/n61688}. |
29 | } | 28 | } |
29 | \opt{ipod6g}{ | ||
30 | The \playertype{} refers to the 6th generation model of the | ||
31 | \playerman{}. It comes with disk sizes of 80GB, 120GB, and 160GB | ||
32 | in ``thick'' and ``slim'' versions. | ||
33 | } | ||
30 | \opt{c200,c200v2,e200,e200v2}{ | 34 | \opt{c200,c200v2,e200,e200v2}{ |
31 | The \playertype{} is available in multiple versions, and you need to make | 35 | The \playertype{} is available in multiple versions, and you need to make |
32 | sure which you have by checking the Sandisk firmware version number under | 36 | sure which you have by checking the Sandisk firmware version number under |
diff --git a/manual/getting_started/ipod_install.tex b/manual/getting_started/ipod_install.tex index 2ec5bf8798..bbb5d1421c 100644 --- a/manual/getting_started/ipod_install.tex +++ b/manual/getting_started/ipod_install.tex | |||
@@ -1,11 +1,13 @@ | |||
1 | % $Id$ % | 1 | % $Id$ % |
2 | 2 | ||
3 | \nopt{ipod6g}{ | ||
4 | |||
3 | \subsubsection{Bootloader installation from Windows} | 5 | \subsubsection{Bootloader installation from Windows} |
4 | 6 | ||
5 | \begin{enumerate} | 7 | \begin{enumerate} |
6 | 8 | ||
7 | \item Download ipodpatcher.exe from | 9 | \item Download ipodpatcher.exe from |
8 | \download{bootloader/ipod/ipodpatcher/win32/ipodpatcher.exe} | 10 | \download{bootloader/ipod/ipodpatcher/win32/ipodpatcher.exe} |
9 | and run it whilst logged in with an administrator account. | 11 | and run it whilst logged in with an administrator account. |
10 | 12 | ||
11 | \item If all has gone well, you should see some information displayed about | 13 | \item If all has gone well, you should see some information displayed about |
@@ -27,20 +29,20 @@ install again.} | |||
27 | 29 | ||
28 | \begin{enumerate} | 30 | \begin{enumerate} |
29 | 31 | ||
30 | \item Attach your \dap{} to your Mac and wait for its icon to appear in | 32 | \item Attach your \dap{} to your Mac and wait for its icon to appear in |
31 | Finder. | 33 | Finder. |
32 | 34 | ||
33 | \item Download and open ipodpatcher.dmg from | 35 | \item Download and open ipodpatcher.dmg from |
34 | \download{bootloader/ipod/ipodpatcher/macosx/ipodpatcher.dmg} | 36 | \download{bootloader/ipod/ipodpatcher/macosx/ipodpatcher.dmg} |
35 | and then double-click on the ipodpatcher icon inside. You can also | 37 | and then double-click on the ipodpatcher icon inside. You can also |
36 | drag the ipodpatcher icon to a location on your hard drive and launch | 38 | drag the ipodpatcher icon to a location on your hard drive and launch |
37 | it from the Terminal. | 39 | it from the Terminal. |
38 | 40 | ||
39 | \item If all has gone well, you should see some | 41 | \item If all has gone well, you should see some |
40 | information displayed about your \dap{} and a message asking you if you | 42 | information displayed about your \dap{} and a message asking you if you |
41 | wish to install the Rockbox bootloader. Press i followed by ENTER, and | 43 | wish to install the Rockbox bootloader. Press i followed by ENTER, and |
42 | ipodpatcher will now install the bootloader. After a short time you | 44 | ipodpatcher will now install the bootloader. After a short time you |
43 | should see the message ``[INFO] Bootloader installed successfully.'' Press | 45 | should see the message ``[INFO] Bootloader installed successfully.'' Press |
44 | ENTER again to exit ipodpatcher and then quit the Terminal application. | 46 | ENTER again to exit ipodpatcher and then quit the Terminal application. |
45 | 47 | ||
46 | \item \note{If ipodpatcher fails to install the bootloader for you, please | 48 | \item \note{If ipodpatcher fails to install the bootloader for you, please |
@@ -48,10 +50,10 @@ be certain that you do indeed have a supported iPod model. If you do, run | |||
48 | ipodpatcher once more and try again. If you don't, then do not attempt to | 50 | ipodpatcher once more and try again. If you don't, then do not attempt to |
49 | install again.} | 51 | install again.} |
50 | 52 | ||
51 | \item Your \dap{} will now automatically reconnect itself to your Mac. | 53 | \item Your \dap{} will now automatically reconnect itself to your Mac. |
52 | Wait for it to connect, and then eject and unplug it in the normal way. | 54 | Wait for it to connect, and then eject and unplug it in the normal way. |
53 | \note{You should unplug your ipod immediately after ejecting it to | 55 | \note{You should unplug your ipod immediately after ejecting it to |
54 | prevent Rockbox immediately rebooting your \dap{} into disk mode when it | 56 | prevent Rockbox immediately rebooting your \dap{} into disk mode when it |
55 | detects that your \dap{} is attached to a computer. } | 57 | detects that your \dap{} is attached to a computer. } |
56 | 58 | ||
57 | \end{enumerate} | 59 | \end{enumerate} |
@@ -61,16 +63,16 @@ detects that your \dap{} is attached to a computer. } | |||
61 | \begin{enumerate} | 63 | \begin{enumerate} |
62 | 64 | ||
63 | \item Download ipodpatcher from | 65 | \item Download ipodpatcher from |
64 | \download{bootloader/ipod/ipodpatcher/linux32x86/ipodpatcher} (32-bit x86 | 66 | \download{bootloader/ipod/ipodpatcher/linux32x86/ipodpatcher} (32-bit x86 |
65 | binary) or \download{bootloader/ipod/ipodpatcher/linux64amd64/ipodpatcher} | 67 | binary) or \download{bootloader/ipod/ipodpatcher/linux64amd64/ipodpatcher} |
66 | (64-bit amd64 binary). You can save this anywhere you wish, but the next | 68 | (64-bit amd64 binary). You can save this anywhere you wish, but the next |
67 | steps will assume you have saved it in your home directory. | 69 | steps will assume you have saved it in your home directory. |
68 | 70 | ||
69 | \item Attach your \dap{} to your computer. | 71 | \item Attach your \dap{} to your computer. |
70 | 72 | ||
71 | \item Open up a terminal window and type the following commands: | 73 | \item Open up a terminal window and type the following commands: |
72 | 74 | ||
73 | \begin{code} | 75 | \begin{code} |
74 | cd $HOME | 76 | cd $HOME |
75 | chmod +x ipodpatcher | 77 | chmod +x ipodpatcher |
76 | ./ipodpatcher | 78 | ./ipodpatcher |
@@ -85,4 +87,73 @@ bootloader. Press i followed by ENTER, and ipodpatcher will now install the | |||
85 | bootloader. After a short time you should see the message ``[INFO] Bootloader | 87 | bootloader. After a short time you should see the message ``[INFO] Bootloader |
86 | installed successfully.'' Press ENTER again to exit ipodpatcher. | 88 | installed successfully.'' Press ENTER again to exit ipodpatcher. |
87 | 89 | ||
90 | \end{enumerate}} | ||
91 | |||
92 | \opt{ipod6g}{ | ||
93 | |||
94 | \subsubsection{Bootloader installation from Windows} | ||
95 | |||
96 | Manual installation under Windows is not supported. Please use \caps{Rockbox | ||
97 | Utility} for bootloader and Rockbox installation. | ||
98 | |||
99 | \subsubsection{Bootloader installation from Mac OS X} | ||
100 | |||
101 | \warn{Please make sure that your iPod is formatted using FAT32 | ||
102 | (a.k.a. WinPod) before attempting to install the bootloader! | ||
103 | Installation will not work on HFS/HFS+ iPods (a.k.a. MacPods).} | ||
104 | |||
105 | \begin{enumerate} | ||
106 | |||
107 | \item Download the bootloader in .ipod format from | ||
108 | \url{https://files.freemyipod.org/~user890104/bootloader-ipodclassic-v1_0/bootloader-ipod6g.ipod} | ||
109 | |||
110 | \item Download mks5lboot for your operating system from | ||
111 | \url{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html\#download_stable} | ||
112 | |||
113 | \item You need to have package libusb installed using Homebrew (brew install | ||
114 | libusb) or MacPorts (port install libusb) in order to run mks5lboot. | ||
115 | |||
116 | \item Start mks5lboot from a terminal with the following command-line: | ||
117 | mks5lboot --dfuscan -l It should scan for DFU devices every second. | ||
118 | |||
119 | \item It is important to stop iTunes (dock icon -> Quit) and iTunesHelper | ||
120 | (using Activity monitor, find the process and select Quit or Force | ||
121 | quit if it keeps restarting) BEFORE continuing to the next | ||
122 | step. Otherwise iTunes will put your iPod in wrong mode, and you will | ||
123 | not be able to proceed with the installation. | ||
124 | |||
125 | \item Put your iPod in DFU mode. | ||
126 | |||
127 | \item When the device is detected, press CTRL+C to terminate the scan | ||
128 | process, and proceed to the next step. | ||
129 | |||
130 | \item Start mks5lboot from a terminal with the following command-line: | ||
131 | mks5lboot --bl-inst path/to/bootloader-ipod6g.ipod, providing the | ||
132 | correct path to bootloader-ipod6g.ipod that you downloaded earlier. | ||
133 | |||
134 | \item When the installation is complete, you should have Rockbox up and | ||
135 | running! | ||
136 | |||
137 | \end{enumerate} | ||
138 | |||
139 | \subsubsection{Bootloader installation from Linux} | ||
140 | |||
141 | \begin{enumerate} | ||
142 | |||
143 | \item Connect your iPod in normal mode (iTunes/file transfer). | ||
144 | \item Download \wikilink{RockboxUtility} for your operating system. | ||
145 | \item When \caps{Rockbox Utility} opens, select the checkbox named Show disabled targets, and point the installer to your iPod's mount point. | ||
146 | \item On the installation screen make sure that Rockbox is selected and Bootloader is not selected. You can install themes or the game files if you want. | ||
147 | \item Start the Rockbox installation. | ||
148 | \item Download the \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic-v1_0/bootloader-ipod6g.ipod}{bootloader in .ipod format}. | ||
149 | \item Download \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html#download_stable}{mks5lboot} for your operating system. Alternatively, you can \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html#build_mks5lboot}{build it} from the source code. | ||
150 | \item You need to have package libusb-1.0.0 installed in order to run mks5lboot. | ||
151 | \item To make sure the installer is marked as executable, start the following command in the terminal: chmod +x mks5lboot. | ||
152 | \item Start mks5lboot from a terminal with the following command-line: ./mks5lboot --dfuscan -l. It should scan for DFU devices every second. | ||
153 | \item Put your iPod in \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html#dfu}{DFU mode}. | ||
154 | \item When the device is detected, press CTRL+C to terminate the scan process, and proceed to the next step. | ||
155 | \item Start mks5lboot from a terminal with the following command-line: ./mks5lboot --bl-inst path/to/bootloader-ipod6g.ipod, providing the correct path to bootloader-ipod6g.ipod that you downloaded earlier. | ||
156 | \item When the installation is complete, you should have Rockbox up and running! | ||
157 | |||
88 | \end{enumerate} | 158 | \end{enumerate} |
159 | } | ||
diff --git a/manual/platform/ipod6g.tex b/manual/platform/ipod6g.tex new file mode 100644 index 0000000000..ecab5b96c8 --- /dev/null +++ b/manual/platform/ipod6g.tex | |||
@@ -0,0 +1,27 @@ | |||
1 | % $Id$ % | ||
2 | \def\UseOption{ipod6g} | ||
3 | \edef\UseOption{\UseOption,HAVE_RB_BL_ON_DISK} | ||
4 | \edef\UseOption{\UseOption,IPOD_4G_PAD} | ||
5 | \edef\UseOption{\UseOption,HAVE_BACKLIGHT} | ||
6 | \edef\UseOption{\UseOption,HAVE_DISK_STORAGE} | ||
7 | \edef\UseOption{\UseOption,HAVE_CAR_ADAPTER_MODE} | ||
8 | \edef\UseOption{\UseOption,ipod} | ||
9 | |||
10 | \newcommand{\playerman}{Ipod} | ||
11 | \newcommand{\playertype}{Classic} | ||
12 | \newcommand{\playerlongtype}{\playertype} | ||
13 | \newcommand{\dapdisplaywidth}{320} | ||
14 | \newcommand{\dapdisplayheight}{240} | ||
15 | \newcommand{\dapdisplaydepth}{16} | ||
16 | \newcommand{\specimg}{ipod6g} | ||
17 | %Used to name the player, e.g. ...to the \dap | ||
18 | \newcommand{\dap}{player} | ||
19 | %For use when referring to the player. E.g. the \daps\ capacity ... | ||
20 | \newcommand{\daps}{player's} | ||
21 | \newcommand{\firmwarefilename}{\fname{rockbox.ipod}} | ||
22 | \newcommand{\firmwareextension}{\fname{ipod}} | ||
23 | \newcommand{\screenshotsize}{8cm} | ||
24 | \newcommand{\disk}{hard disk} | ||
25 | |||
26 | % link external keymap file | ||
27 | \input{platform/keymap-ipod4g.tex} | ||