Difference between revisions of "Building NitrOS9"

Revision as of 10:29, 13 July 2013

The LWTOOLS and ToolShed utilities are used to build the NitrOS-9 operating system on Mac, Windows, or Linux based systems. If you would like to set up your system to build the project, please follow the instructions below.

Notes for Linux platforms

For Debian/Ubuntu you can get prebuilt LWTOOLS and Toolshed from https://launchpad.net/~tormodvolden/+archive/m6809

Notes for Windows platforms

For Windows you can get prebuilt LWTOOLS from http://lwtools.projects.l-w.ca/contrib/tormod/ and prebuilt Toolshed from http://toolshed.sourceforge.net/snapshots/

Mercurial (hg) can be installed from http://mercurial.selenic.com/wiki/Download for instance by downloading the Mercurial MSI installer (ca 6 MB).

The build process must be done in a Cygwin or MingW environment.

On MingW you will have to append "CC=gcc" to the "make" lines below. See also Building NitrOS9 in Windows using Cygwin for more Windows specific issues.

Obtain and build LWTOOLS

hg clone http://lwtools.projects.l-w.ca/hg/ lwtools
cd lwtools
make
make install
cd ..

This will build and install lwasm, lwlink, lwar and lwobjdump into your /usr/local/bin directory.

Obtain and build the Toolshed tools

hg clone http://hg.code.sf.net/p/toolshed/code toolshed
cd toolshed
make -C build/unix install
cd ..

This will build and install the toolshed tools into your /usr/local/bin directory.

Obtain and build NitrOS-9

Make sure lwasm is in your path, either by editing your shell startup scripts or by entering PATH=$PATH:/usr/local/bin in your active command shell.

hg clone http://hg.code.sf.net/p/nitros9/code nitros9
cd nitros9
hg update lwtools-port # this step is temporarily needed
export NITROS9DIR=$PWD
make dsk

You should now find disk images have been created in the various directories. For instance, the boot disks for level 2, 6309 can be found in the level2/coco3_6309 subdirectory.