[linuxdc-cvs] CVS: docs/howto Makefile,NONE,1.1 install-kernel.ht,NONE,1.1 install-tools.ht,NONE,1.1

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/linuxdc/docs/howto
In directory usw-pr-cvs1:/tmp/cvs-serv4634/howto

Added Files:
	Makefile install-kernel.ht install-tools.ht 
Log Message:
Added beginnings of the new HOWTOs

--- NEW FILE ---

--- NEW FILE ---
<HTML>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
<!-- Mon Mar  5 03:28:12 2001 -->
<!-- USING HT2HTML 1.1 -->
<!-- SEE http://www.python.org/~bwarsaw/software/pyware.html -->
<!-- User-specified headers:
Title: install-kernel.ht

-->

<HEAD>
<TITLE>install-kernel.ht</TITLE>

</HEAD>
<BODY BGCOLOR="#ffffff" TEXT="#000000"
      TOPMARGIN="0" LEFTMARGIN="0" MARGINWIDTH="0" MARGINHEIGHT="0"
      LINK="#0000bb"  VLINK="#551a8b"
      ALINK="#ff0000">
<!-- start of page table -->
<TABLE WIDTH="100%" BORDER=0 CELLSPACING=0 CELLPADDING=0>
<TR><!-- start of sidebar/body row -->
<!-- start of sidebar cells -->
<TD WIDTH=150 VALIGN=TOP BGCOLOR="#cdba96">
<!-- start of sidebar table -->
<TABLE WIDTH="100%" BORDER=0 CELLSPACING=0 CELLPADDING=3
       BGCOLOR="#ffffff">
<TR><TD BGCOLOR="#b78900"><B><FONT COLOR="#ffffff">
Email Us
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#cdba96">
<A HREF="mailto:webmaster@local">webmaster@local</A>
</TD></TR>
</TABLE><!-- end of sidebar table -->

</TD>
<TD WIDTH=15>&nbsp;&nbsp;</TD><!--spacer-->
<!-- end of sidebar cell -->
<!-- start of body cell -->
<TD VALIGN=TOP WIDTH="90%"><BR>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
  <head>
    <title>Compiling and installing the Dreamcast Linux kernel</title>
  </head>
  <body bgcolor=white>

</body>
</html>

</TD><!-- end of body cell -->
</TR><!-- end of sidebar/body row -->
</TABLE><!-- end of page table -->
</BODY></HTML>

--- NEW FILE ---
<html>
<h3 align=center>Compiling and installing the toolchain</h3>

<h4>binutils</h4>

Get a recent snapshot of the GNU binutils from
<a href="ftp://sources.redhat.com/pub/binutils/snapshots/">sources.redhat.com</a>.
binutils-010220.tar.bz2 is know to work, so should the later versions.

<p>Unpack the tarball, make a directory alongside the unpacked snapshot and run configure from
there:</p>
<pre>sh-binutils>../binutils-010220/configure --target=sh-linux-gnu

sh-binutils>make all install
</pre>

You may want to use the --prefix option so that you don't clutter
up /usr/local more than necessary. If you do, remember to add the bin
directory to your path.

<h4>gcc</h4>

Again, <a href="ftp://sources.redhat.com/pub/gcc/snapshots/">sources.redhat.com</a> is the
place to look for a recent snapshot. gcc-20010205 is known to work
with a minor patch added. So should more recent snapshots.

Unpack the tarball and make a directory alongside the unpacked
snapshot to compile in.

<p>Before you start compiling, however, you will need to apply a minor
<a href="mno-fpu-patch.diff">fpu-disabling patch</a>, thus:
<pre>sh-gcc>patch -p1 < mno-fpu-patch.diff</pre>

<p>Once that has been taken care of, you're ready to compile:
<pre>
sh-gcc>../gcc-20010205/configure --target=sh-linux-gnu --without-headers --with-newlib --enable-languages=c

sh-gcc>make all-gcc install-gcc
</pre>

If you run into a problem about missing sh-linux-gnu-as, you should
fix your path to include the bin directory from wherever you installed
binutils.

<h4>dcload</h4>

To upload the kernel later on, you'll need a serial slave for you
DC. The one we recommend is <a href="http://www.cerc.utexas.edu/~andrewk/dc/">dcload</a>.

To compile dcload, you'll have to apply a patch to it, since the
'sh-linux-gnu' target we compiled our tools with breaks the SH
ABI. We've put together an <a href="dcload-unabi.diff">ABI-uncorrecting patch</a>.
for this. Apply it:
<pre>
dcload>patch -p1 < dcload-unabi.diff
</pre>

<p>Then edit Makefile.cfg to suit your paths.</p>

<p>After that, you should be set to do a
<pre>
dcload>make all install
</pre>

<p>To burn the dcload to a CD-R, you'll need a few more tools:
<ul>
      <li><a href="http://mc.pp.se/dc/files/scramble.c">scramble.c</a></li>
      <li><a href="http://mc.pp.se/dc/files/makeip.tar.gz">makeip.tar.gz</a></li>
      <li>cdrecord and mkisofs, probably already installed if you have
          a CD burner</li>
    </ul>
Install these tools, modify make-cd/Makefile in the
dcload-distribution, then do make inside the make-cd directory to burn
the serial loader to CD.
</p>

<h4>Conclusion</h4>
If you get this far and everything is working, you can pat yourself
on the back. The worst part is over. Scuttle over to the <a href="install-kernel.html">
kernel installing howto</a> to finish up.
</body>
</html>