80 lines
		
	
	
	
		
			2.8 KiB
		
	
	
	
		
			Text
		
	
	
	
	
	
			
		
		
	
	
			80 lines
		
	
	
	
		
			2.8 KiB
		
	
	
	
		
			Text
		
	
	
	
	
	
| . \" $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.
 |