Intergalactic Space Rescue Source Code
Copyright (C) Damian Walker 2013

This source isn't quite ready to assemble out of the box.  Here are instructions about what you need to do to create your own personalised version of Intergalactic Space Rescue, should you so wish.

REQUIREMENTS

This project uses a number of other development packages, most of which you will need to get from elsewhere.  You can use alternative tools, but this would involve editing the Makefile, or building your own equivalent project file.

1. The z80asm assembler from the z88dk cross-development system.  This may be available as a standalone package; I used the version bundled with z88dk.  Beware of other assemblers similarly named that use an incompatible syntax.

2. GNU make or a compatible make program (a standard Unix make compatible will probably do the job).

3. A C compiler, to compile the bintotap utility that is used to create headerless tape files.

BINTOTAP

First you need to compile bintotap.c.  The existing bin2tap utility available elsewhere doesn't seem to have a way of generating tape files without a header block, so be sure to use this one instead.  It's in ANSI C so it should compile on anything.

LOADER

I have not yet found a way to automate creation of the tape loader.  To create the loader:

1. enter the 'loader.bas' program into a Spectrum emulator; the REM statement has 385 full-stop characters in it;

2. assemble the 'loader.asm' program individually, creating a straight binary file 'loader.bin';

3. load 'loader.bin' into the Spectrum emulator at address 23760;

4. save the loader program to a tape file 'loader.tap' using the BASIC command: SAVE "Rescue" LINE 1

THE REST

Assuming that 'bintotap' is executable and is somewhere in your path, you should now be able to build the rest of the system using the command 'make'.

Date: 13 January 2013
