Z88DK
Text copied from the official Z88dk website.
Contents
What is Z88dk?
z88dk is a Z80 C cross compiler supplied with an assembler/linker and a set of libraries implementing the C standard library for a number of different Z80 based machines. The name z88dk originates from the time when the project was founded and targetted only the Cambridge z88 portable.
The compiler featured in z88dk is much enhanced Small C compiler, the compiler accepts many features of ANSI C and is only deficient in a few areas where implementation on a Z80 processor might prove inefficient. The compiler performs simple optimizations, but the bulk of the optimization is done by a set of peep-hole rules, which will typically reduce the size of a large project by up to a third.
The libraries supplied with z88dk are designed to be as generic as possible, indeed it is possible to port to a new machine simply by supplying two library routines and some startup code. It is hoped that one day z88dk will support as many z80 based machines as there is information available and sufficient interest in.
Warning : you would really install a recent version like the nightly build to enjoy of the last improvement for CPC.
Supported Targets
z88dk produces code and programs that will run on the following machines:
- Cambridge Computers z88
- Sinclair ZX Spectrum
- Sinclair ZX81
- CP/M based machines
- Amstrad NC100
- VZ200/300
- Sharp MZ series
- TI calculators (TI82, TI83, TI83+, TI85, TI86)
- ABC80, Jupiter Ace
- Xircom REX 6000
- Sam Coupe
- MSX1
- Spectravideo
- Mattel Aquarius
- Peters Sprinter
- C128 (in Z80 mode)
Supported Platforms
z88dk is known to run on the following platforms:
- Amiga
- BeOS
- HP-UX 9
- Linux
- MacOS X
- Solaris
- Win32
- Win16
- MSDOS
Binary releases are available for Amiga, Solaris and Win32. Win16/MSDOS needs to be rolled by the user. On BSD machines, GNU make should be used instead of the native make program.
Usage
Here is world.c from the z88dk console examples:
/*
* Hello World
*/
#include <stdio.h>
main()
{
printf("Hello world!\n");
}
Compile this example with:
zcc +cpc -create-app -make-app -O3 -unsigned -o out.bin world.c -lndos -zorg=16384
If you get an error message during compilation ("File open/read error"), make sure the Z80_OZFILES environment variable is set correctly, see [1].
The resulting binary can be run from BASIC with:
memory &3fff load "out.cpc",&4000 call &4000
Another more specific example:
#include <stdio.h>
#include <cpc.h>
int main(void) {
int model;
char * model_name;
model = cpc_model() ;
switch (model) {
case 0:
model_name = "464";
break;
case 1:
model_name = "664";
break;
case 2:
model_name = "6128";
break;
default:
model_name = "unknown";
}
printf("model=%s\n",model_name);
return 0 ;
}
graphics library examples :
#include <graphics.h>
main()
{
int i,x1,y1,x2,y2;
clg();
for ( i=0;i<11;i++)
{
y1 = 200 - 20 * i ;
x2 = 50 + 20 * i ;
draw(50,y1,x2,0);
}
}
must-read topic on z88dk wiki :
Libraries for the CPC
- CPCRSlib
- Crocolib by Arnaudstorq (link dead)
Released Software
CPC programs which are using Z88dk:
- Mariano the dragon (game)
- Magical drop (game)
- PHAT (demo)
- Nanako in Classic Japanese Monster Castle v.2 (game)
- Phantomas Tales #1: Marsport (game)
- Nanako Descends To Hell (game)
- Platformer Medley Block #1 (game)
- Phantomas Saga #1: Infinity (game)
