z80-python-emulator/README.md

42 lines
1.2 KiB
Markdown
Raw Normal View History

2014-08-29 23:48:33 +02:00
## Z80 CPU Emulator
This is a Zilog Z80 CPU emulator, written in Python.
It runs a 1978 Microsoft Basic 4.7 ROM taken from [Grant Searle's Z80 SBC project][http://searle.hostei.com/grant/z80/SimpleZ80.html]
### Why?
Just for fun. I like the Z80 CPU - it was in many devices I played with as a
kid.
### Is it useful?
No. It runs really slowly, and is a completely non-optimal software design for
an emulator, but (in my opinion) the code is readable. If you want a CPU emulator,
probably don't use Python. That said, an optimised python coded emulator could run
a lot faster than this :-)
### Running
```
cd src
python z80sbc.py
```
Unit tests:
```
cd src
PYTHONPATH=`pwd`:$PYTHONPATH python ../tests/test_z80.py
PYTHONPATH=`pwd`:$PYTHONPATH python ../tests/test_registers.py
```
Fuse tests:
```
cd src
PYTHONPATH=`pwd`:$PYTHONPATH python ../fuse_tests/tests.py
```
### Missing and todo
Most undocumented opcodes, undocumented flags for `CPI` and `CPIR`.
### Credits
[Grant Searle's Z80 SBC project][http://searle.hostei.com/grant/z80/SimpleZ80.html]
[FUSE - Free Unix Spectrum Emulator][http://fuse-emulator.sourceforge.net/] for the instruction set tests
### License
Public domain; do what the like. (Except fuse tests and BASIC rom)