rockbox/www/sh-win/index.t
Björn Stenberg f2feb0a5d0 A bunch of web updates
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@3061 a1c6a512-1295-4272-9138-f99709370657
2003-01-10 12:13:21 +00:00

78 lines
3.4 KiB
Perl

#define _PAGE_ Setting up the GNUSH compiler for Windows
#include "head.t"
<P>by <A href="mailto:edx@codeforce.d2g.com">Felix Arends</A>, 1/8/2002
<BR>
</P>
<P>I have spent a long time figuring out how to compile SH1 code in windows (using
the sh-elf-gcc compiler) and when I finally compiled the first OS for my
Jukebox I decided to write a little tutorial explaining the setup process.
</P>
<H2>The GNU-SH Tool Chain for Windows</H2>
This is actually all you need to download. It includes the binutils, gcc and
newlib. Download the GNUSH Tool Chain for ELF format (35 MB).
<P>
The GNUSH website can be found at <A href="http://www.kpit.com/download/downloadgnushv0203.htm">
http://www.kpit.com/download/downloadgnushv0203.htm</A> (source code is
also available there). Get the "GNUSH v0203 Tool Chain for ELF format". <b>Note: </b>
The GNUSH v0204 Tool Chain has a bug which causes problems when compiling
Rockbox!
</P>
<H2>Perl</H2>
<p>
Download Perl for Windows from <a href="http://www.activestate.com/Products/ActivePerl/">
http://www.activestate.com/Products/ActivePerl/</a>.
</p>
<H2>Setting up&nbsp;the Compiler</H2>
<P>Install the GNUSH Tool Chain (nothing you really have to care about during the
installation process).</P>
<P>
<H2>Compiling the latest Rockbox Source
</H2>
<P>Use CVS to download the latest source code of Rockbox (the firmware and apps
modules). In addition, you need to copy a win32 compilation of scramble.exe and
convbdf.exe into the tools dir. The pre-compiled scramble.exe can be downloaded <A href="http://rockbox.haxx.se/sh-win/scramble.exe">
here</A>. The pre-compiled convbdf.exe can be downloaded <A href="http://rockbox.haxx.se/fonts/convbdf.exe">
here</A>. From your start menu, open the "SH-ELF tool chain" batch file
inside the GNU-SH v0203 program folder. You should end up seeing a command
prompt. Go to the apps directory and type:</P>
<P>
<TABLE id="Table1" cellSpacing="1" cellPadding="1" width="100%" border="1">
<TBODY>
<TR>
<TD>Command</TD>
<TD>Description</TD>
</TR>
<TR>
<TD>make -f win32.mak<BR>
make -f win32.mak RECORDER = 1</TD>
<TD vAlign="top">build for recorder target</TD>
</TR>
<TR>
<TD>make -f win32.mak PLAYER</TD>
<TD>build for player target</TD>
</TR>
<TR>
<TD>make -f win32.mak PLAYER_OLD</TD>
<TD>build for old player target</TD>
</TR>
<TR>
<TD>make -f win32.mak RECORDER=1 DISABLE_GAMES=1</TD>
<TD>build for recorder target, disable games</TD>
</TR>
<TR>
<TD vAlign="top">make -f win32.mak RECORDER=1 PROPFONTS=1</TD>
<TD>build for recorder target, enable propfonts</TD>
</TR>
<TR>
<TD vAlign="top">make -f win32.mak RECORDER=1 PROPFONTS=1&nbsp;DISABLE_GAMES =
1&nbsp;</TD>
<TD>build for recorder target, disable games, use propfonts</TD>
</TR>
</TBODY></TABLE>
</P>
<P>I hope this tutorial helped you to compile an Archos firmware with Windows. If
you have any questions, comments or corrections, please mail to <A href="mailto:felix.arends@gmx.de">
felix.arends@gmx.de</A>
#include "foot.t"