DrZ80.txt 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144
  1. ___________________________________________________________________________
  2. DrZ80 (c) Copyright 2004 Reesy. Free for non-commercial use
  3. Reesy's e-mail: drsms_reesy(atsymbol)yahoo.co.uk
  4. Replace (atsymbol) with @
  5. ___________________________________________________________________________
  6. What is it?
  7. -----------
  8. DrZ80 is an emulator for the Z80 microprocessor, written in ARM 32-bit assembly.
  9. It is aimed at chips such as ARM7 and ARM9 cores, StrongARM and XScale, to interpret Z80
  10. code as fast as possible.
  11. Flags are mapped onto ARM flags whenever possible, which speeds up the processing of an opcode.
  12. ARM Register Usage
  13. ------------------
  14. See source code for up to date of register usage, however a summary is here:
  15. r0-3: Temporary registers
  16. r3 : Pointer to Opcode Jump table
  17. r4 : T-States remaining
  18. r5 : Pointer to Cpu Context
  19. r6 : Current PC + Memory Base (i.e. pointer to next opcode)
  20. r7 : Z80 A Register in top 8 bits (i.e. 0xAA000000)
  21. r8 : Z80 F Register (Flags) (NZCV) in lowest four bits
  22. r9 : Z80 BC Register pair in top 16 bits (i.e. 0xBBCC0000)
  23. r10 : Z80 DE Register pair in top 16 bits (i.e. 0xDDEE0000)
  24. r11 : Z80 HL Register pair in top 16 bits (i.e. 0xHHLL0000)
  25. r12 : Z80 Stack + Memory Base (i.e. pointer to current stack in host system memory)
  26. ( note: r3,r12 are always preserved when calling external memory functions )
  27. How to Compile
  28. --------------
  29. The core is targeted for the GNU compiler, so to compile just add the "DrZ80.o" object
  30. to your makefile and that should be it.
  31. If you want to compile it seperately, use: as -o DrZ80.o DrZ80.s
  32. ( note: If you want to use DrZ80 with a different compiler you will need to run
  33. some sort of parser through the source to make the syntax of the source
  34. compatible with your target compiler )
  35. Adding to your project
  36. ----------------------
  37. To add DrZ80 to your project, add DrZ80.o, and include DrZ80.h
  38. There is one structure: 'struct DrZ80', and three functions: DrZ80Run,DrZ80RaiseInt
  39. and DrZ80_irq_callback.
  40. Don't worry if this seem very minimal - its all you need to run as many Z80s as you want.
  41. It works with both C and C++.
  42. ( Note: DrZ80_irq_callback is just a pointer to an irq call back function that needs
  43. to be written by you )
  44. Declaring a Memory handlers
  45. ---------------------------
  46. Before you can reset or execute Z80 opcodes you must first set up a set of memory handlers.
  47. There are 8 functions you have to set up per CPU, like this:
  48. unsigned int z80_rebaseSP(unsigned short new_sp);
  49. unsigned int z80_rebasePC(unsigned short new_pc);
  50. unsigned char z80_read8(unsigned short a);
  51. unsigned short z80_read16(unsigned short a);
  52. void z80_write8(unsigned char d,unsigned short a);
  53. void z80_write16(unsigned short d,unsigned short a);
  54. unsigned char z80_in(unsigned char p);
  55. void z80_out(unsigned char p,unsigned char d);
  56. You can think of these functions representing the Z80's memory bus.
  57. The Read and Write functions are called whenever the Z80 reads or writes memory.
  58. The In and Out functions are called whenever the Z80 uses the I/O ports.
  59. The z80_rebasePC and z80_rebaseSP functions are to do with creating direct memory
  60. pointers in the host machines memory, I will explain more about this later.
  61. Declaring a CPU Context
  62. -----------------------
  63. To declare a CPU simple declare a struct Cyclone in your code. For example to declare
  64. two Z80s:
  65. struct DrZ80 MyCpu;
  66. struct DrZ80 MyCpu2;
  67. It's probably a good idea to initialise the memory to zero:
  68. memset(&MyCpu, 0,sizeof(MyCpu));
  69. memset(&MyCpu2,0,sizeof(MyCpu2));
  70. Next point to your memory handlers:
  71. MyCpu.z80_rebasePC=z80_rebasePC;
  72. MyCpu.z80_rebaseSP=z80_rebaseSP;
  73. MyCpu.z80_read8 =z80_read8;
  74. MyCpu.z80_read16 =z80_read16;
  75. MyCpu.z80_write8 =z80_write8;
  76. MyCpu.z80_write16 =z80_write16;
  77. MyCpu.z80_in =z80_in;
  78. MyCpu.z80_out =z80_out;
  79. Now you are nearly ready to reset the Z80, except you need one more function: checkpc().
  80. The z80_rebasePC() function
  81. ---------------------------
  82. When DrZ80 reads opcodes, it doesn't use a memory handler every time, this would be
  83. far too slow, instead it uses a direct pointer to ARM memory.
  84. For example if your Rom image was at 0x3000000 and the program counter was $206,
  85. Cyclone's program counter would be 0x3000206.
  86. The difference between an ARM address and a Z80 address is also stored in a variable called
  87. 'pc_membase'. In the above example it's 0x3000000. To retrieve the real PC, DrZ80 just
  88. subtracts 'pc_membase'.
  89. Everytime the Z80 PC is modified, i.e. by a jump,branch intructions or by an interupt, DrZ80
  90. calls the z80_rebasePC function. If the PC is in a different bank, for example Ram instead
  91. of Rom, change 'pc_membase', recalculate the new PC and return it.
  92. The z80_rebaseSP() function
  93. ---------------------------
  94. When DrZ80 pushs/pops to the Z80 stack pointer, it doesn't use a memory handler every time. In
  95. order to gain more speed a direct pointer to ARM memory is used. For example if your Ram was at
  96. 0x3000000 and the z80 stack pointer counter was 0xD000, DrZ80's stack pointer would be 0x300D000.
  97. The difference between an ARM address and a Z80 address is also stored in a variable called
  98. 'sp_membase'. In the above example it's 0x3000000. To retrieve the real SP, DrZ80 just
  99. subtracts 'sp_membase'.
  100. Everytime the Z80 SP is modified ( i.e. set with a new value LD SP,NN etc ) DrZ80
  101. calls the z80_rebaseSP function. If the SP is in a different bank, for example Rom instead
  102. of Ram, change 'sp_membase', recalculate the new SP and return it.