welcome to www.hangar-eleven.de - your premier resource for console development





Development Env

Installing Cygwin

Building SH4 toolchain
Making Binutils
Making crossGCC
Making Newlib
Making final crossGCC

Building ARM toolchain
Making Binutils
Making crossGCC

Compiling KallistiOS

Testing KOS and the Compilers
Writing the first program
Compiling the first program
Uploading to the Dreamcast
DC-Tool
Serial Slave

Making a CD

Back to News

 

  Compiling KallistiOS for Dreamcast Platform
  Written: September 17th, 2001 @ 15:52 GMT By: Thorsten Titze
 
 

Now comes the easier part, compiling the KallistiOS Operating System which Dan Potter wrote for the Dreamcast. (libdream is no longer supported and KOS now offers half-way compatible API's)

  • Visit Dan Potters DCDEV or the KOS Sourceforge page and download the latest KOS sources

  • Copy the tarball into your Cygwin tree and unpack it

    tar zxf kos-1.1.5.tar.gz

  • Make a small change to the kos-1.1.5/utils/genromfs/genromfs.c sourcecode.
    (this is not needed anymore from 1.1.7 on and if you use CVS-KOS)
    Just add the following line at the top of the source:

    #define _WIN32

  • Now copy the file kos-1.1.x/doc/environ-dc.sh.sample to kos-1.1.x/ and change the file to reflect your install patch for the KOS sources

  • Run this shell-script with

    . ./environ-dc.sh

    (the single dot in front is extremely important since otherwise the environment variables will be cleared after the script finishes)

  • Now type

    make

    and everything should compile, including the examples.

GETTING CVS-KOS:
In order to get the KallistiOS sources from the CVS repository just open up a Bash-Shell, browse to where you want your KOS to reside and execute the following two commands:

cvs -d:pserver:anonymous@cvs.cadcdev.sourceforge.net:/cvsroot/cadcdev login
cvs -z3 -d:pserver:anonymous@cvs.cadcdev.sourceforge.net:/cvsroot/cadcdev co kos

(NOTE: You have to have CVS installed from the Cygwin Installer in order to use it. If the Bash does not find CVS install the corresponding Cygwin package)

All the notes for the release versions of KOS also apply to CVS ! But you have to make one additional change to the Makefile in the KOS root directory.

Just comment out the following line (by adding a # in front of it):

cp lib-release/libm.a lib/

(This is needed because the binary KOS released come with a precomiled libm. If you followed my tutorials you already compiled your own when compiling newlib !!!)

HINT:
Now would be a good time to add the following line to your .BASHRC (which can be found in your cygwin home directory, normally /home/username .If this file does not exist yet just create it or alternatively put the line in /etc/profile) to be able to use KOS whenever you start your Cygwin shell.

. ./kos-1.1.3/environ-dc.sh

(The single dot in front of the command is essential since otherwise the EXPORTS will only be valid within the shellscript)

You are now ready to write your own programs/demos/games for the Dreamcast.

 

  Go to the sourceforge homepage of KallistiOS [offsite link]

Back to Dreamcast Development Main


DISCLAIMERS:
Website Design © 2002 by Thorsten Titze / hangar-eleven.de
(the pictures used for the design were taken from a WindowsXP Skin and WindowsXP)
All brand names used on this site are registered trademarks of their respective owners
No copyright infringement is intended
Last updated @ 22-Feb-2002 2:19 PM Contact me via eMail