Subversion Repositories a-z80

                               A-Z80
             A conceptual implementation of the Z80 CPU
             ------------------------------------------
                for Altera, Xilinx and Lattice FPGAs

This project is described in more details at www.baltazarstudios.com

For additional information, read 'Quick Start' and 'Users Guide' documents
in the 'docs' folder. Also read a 'readme.txt' file in each of the folders.

Prerequisites
=============
* Altera Quartus and Modelsim (free web editions) OR
* Xilinx ISE (free Webpack edition) OR
* Lattice ICECube toolchain from Synopsis (Lattice tested by JuanS)
* Python 3.5.x

Description of Folders
======================
"cpu" folder contains A-Z80 CPU functional blocks and top-level modules:
  alu         contains ALU block, ALU control and flags logic
  bus         contains data bus switches, pin logic, address latch and the
              address incrementer
  control     contains PLA decoder, the sequencer and other control blocks
  registers   contains CPU register file and the register control logic
  toplevel    A-Z80 top level core, interfaces and test code

IMPORTANT:
If you want to use A-Z80 in your own project, run "export.py" script which
will copy only files that are needed (so, don't copy everything yourself).

"host" folder integrates the A-Z80 CPU into several fully functional designs:
  "basic_de1" contains a simplified board consisting of A-Z80 CPU, memory
          and UART modules that can run small Z80 programs on Altera DE1
  "basic_nexys3" contains the same example project but for Xilinx Nexys3 board
  "zxspectrum_de1" contains an implementation of the Sinclair ZX Spectrum
          for Altera DE1 board

"tools", "resources" contain various tools related to the project; reverse
  engineering Z80, design verification and testing.

Email me if you have any questions, issues or you want to use A-Z80 or any of
the files herein; I'd like to hear from you,

Goran Devic
gdevic@yahoo.com

----------------------------------------------------------------------------------
This project and each file therein is covered under the GNU GPL2.0 license.
It basically states that anyone is free to use it and distribute it, but the full
source needs to be available under the same terms.