ack/doc/z80.doc

. \" $Header$
.ND April 1985
.TL
THE Z80 BACK END TABLE
.AU
Frans van Haarlem
.NH 1
INTRODUCTION
.PP
This table was written to make it run, not to make it clever!
The effect is, that the table written for the intel 8080, 
which was made very clever runs faster and requiers less space!!
So, for anyone to run programs on a z80 machine:
You could try to make the table as clever as the one for the i80,
or you could run the i80 table, for that can run on every z80 too.
.NH
IMPLEMENTATION
.PP
It will not be possible to run the entire Amsterdam Compiler Kit on a
Z80-based computer system.
One has to write a program on another 
system, a system where the compiler kit runs on.
This program may be a mixture of high-level languages, such as 
C or Pascal, EM and z80 assembly code.
The program should be compiled using the compiler kit,
producing z80 machine code.
This code should come available to the z80 machine
for example by downloading or
by storing it in ROM (Read Only Memory).
Depending on the characteristics of the particular z80 based system, some
adaptions have to be made:
.IP 1)
In \fIhead_em\fP: the base address, which is the address where the first
z80 instruction will be stored, and the initial value of the
stackpointer are set to 0x1000 and 0x7ffe respectivally.
The latter because it could run on a 32K machine as well.
Other systems require other values.
.IP 2)
In \fIhead_em\fP: before calling "_m_a_i_n", the environment
pointer, argument vector and argument count will have to be pushed
onto the stack.
Since this back-end is tested on a system without any knowledge
of these things, dummies are pushed now.
.IP 3)
In \fItail_em\fP: proper routines "putchar" and "getchar" should
be provided.
They should write resp. read a character on/from the monitor.
Maybe some conversions will have to be made.
The ones for the Nascom and Hermac z80 micro's are to be found
in the EM-library.
.IP 4)
In \fIhead_em\fP: an application program returns control to the monitor by 
jumping to address 0x20.
If this is not the right way on your system, change it.
For an CPM-machine for example this should be 0x5, to provide a warm boot.
.IP 5)
In \fItail_em\fP: the current version of the z80 back-end has very limited I/O
capabilities, because it was tested on a system that
had no knowlegde of files.
So the implementation of the EM-instruction \fImon\fP is very simple;
it can only do the following things:
.DS
   Monitor call 1:
		Exit
   Monitor call 3:
   		read, always reads from the monitor.
		echos the read character.
		ignores file descriptor.
   Monitor call 4:
		write, always writes on the monitor.
		ignores file descriptor.
   Monitor call 5:
		open file, returns file descriptor -1.
   Monitor call 6:
		close file, returns error code = 0.
   Monitor call 54:
		io-control, returns error code = 0.
.DE
If the system should do file-handling the routine ".mon"
should be extended thoroughly.