https://github.com/stianeklund/z80-rs
A Zilog Z80 CPU emulator intended for emulating the Pacman arcade cabinet
https://github.com/stianeklund/z80-rs
cpu cpu-emulator emu emulation emulator rust rustlang z80 zilog
Last synced: about 1 month ago
JSON representation
A Zilog Z80 CPU emulator intended for emulating the Pacman arcade cabinet
- Host: GitHub
- URL: https://github.com/stianeklund/z80-rs
- Owner: stianeklund
- License: gpl-3.0
- Created: 2020-06-18T08:33:34.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-08-10T21:24:56.000Z (almost 6 years ago)
- Last Synced: 2026-01-02T00:57:25.665Z (6 months ago)
- Topics: cpu, cpu-emulator, emu, emulation, emulator, rust, rustlang, z80, zilog
- Language: Rust
- Homepage:
- Size: 260 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# z80-rs
[](https://travis-ci.com/stianeklund/z80-rs)
A WIP Zilog Z80 CPU Emulator
Compatible with Windows, Linux, & Mac OS
## Emulator compatibility
* This is a work in progress project ported from [eighty-eighty](https://github.com/stianeklund/eighty-eighty) and does not run any games, yet.
* Interrupts not implemented.
* Passes the preliminary z80 tests & CPUTEST by SuperSoft Associates.
### CPU Tests
#### Diagnostics II v1.2 by by Supersoft Associates (1981):
```
Test loaded: "CPUTEST.COM" Bytes: 19200
DIAGNOSTICS II V1.2 - CPU TEST
COPYRIGHT (C) 1981 - SUPERSOFT ASSOCIATES
ABCDEFGHIJKLMNOPQRSTUVWXYZ
CPU IS Z80
BEGIN TIMING TEST
END TIMING TEST
CPU TESTS OK
```
#### Preliminary z80 Exerciser (by Frank D. Cringle):
```
Test loaded: "tests/prelim.com" Bytes: 1280
Preliminary tests complete Jump to 0 from 0447
```
#### Preliminary 8080 / z80 Exerciser (by Frank D. Cringle, modified by Ian Bartholemew for the 8080*):
```
Test loaded: "8080PRE.COM" Bytes: 1024
8080 Preliminary tests complete
Jump to 0 from 032F
```
#### Zexall
```
*Does not pass.
* See Zexdoc
```
#### Zexdoc
```
Test loaded: "tests/zexdoc.com" Bytes: 8588
Z80doc instruction exerciser
hl,.... OK
add hl,.......... OK
add ix,.......... OK
add iy,.......... OK
aluop a,nn.................... OK
aluop a,.. ERROR **** crc expected:fe43b016 found:80744231
aluop a,..... ERROR **** crc expected:a4026d5a found:18e22f28
aluop a,(+1)........... ERROR **** crc expected:e849676e found:b2b3f5cf
bit n,(+1)............. ERROR **** crc expected:a8ee0867 found:efb20fe7
bit n,.... OK
cpd........................ ERROR **** crc expected:a87e6cfa found:8a2154a8
cpi........................ ERROR **** crc expected:06deb356 found:06b932a1
............. ERROR **** crc expected:9b4ba675 found:89ad31f7
a................... OK
b................... OK
bc.................. OK
c................... OK
d................... OK
de.................. OK
e................... OK
h................... OK
hl.................. OK
ix.................. OK
iy.................. OK
l................... OK
(hl)................ OK
sp.................. OK
(+1)......... OK
ixh................. OK
ixl................. OK
iyh................. OK
iyl................. OK
ld ,(nnnn)............. OK
ld hl,(nnnn).................. OK
ld sp,(nnnn).................. OK
ld ,(nnnn)............. OK
ld (nnnn),............. OK
ld (nnnn),hl.................. OK
ld (nnnn),sp.................. OK
ld (nnnn),............. OK
ld ,nnnn......... OK
ld ,nnnn............... OK
ld a,<(bc),(de)>.............. OK
ld ,nn.... OK
ld (+1),nn............. OK
ld ,(+1)...... OK
ld ,(+1).......... OK
ld a,(+1).............. OK
ld ,nn....... OK
ld ,........ OK
ld ,........ OK
ld a,(nnnn) / ld (nnnn),a..... OK
ldd (1).................... ERROR **** crc expected:94f42769 found:b94a393d
ldd (2).................... ERROR **** crc expected:5a907ed4 found:772e6080
ldi (1).................... ERROR **** crc expected:9abdf6b5 found:b703e8e1
ldi (2).................... ERROR **** crc expected:eb59891b found:1c991b87
neg........................... ERROR **** crc expected:6a3c3bbd found:dfbcf11d
..................... ERROR **** crc expected:955ba326 found:2c05f8a4
........... ERROR **** crc expected:251330ae found:34b41bec
shf/rot (+1)........... ERROR **** crc expected:713acd81 found:c5ed15c5
shf/rot .. ERROR **** crc expected:eb604d58 found:772bdc9b
n,..... ERROR **** crc expected:8b57f008 found:36d25f63
n,(+1)....... ERROR **** crc expected:cc63f98a found:fe27dcf9
ld (+1),...... OK
ld (+1),.......... OK
ld (+1),a.............. OK
ld (),a................ OK
Tests complete
```
---
### Arcade game support
Please see [pacman-rs](https://github.com/stianeklund/pacman-rs)
---
#### Running CPU tests:
With Rust & cargo installed:
Run tests from the terminal you can use `cargo test` or, for `stdout` output:
Run all tests: `cargo test -- --nocapture`
---
### References used:
* https://z80.info
* http://www.z80.info/#BASICS_INST
* http://z80.info/zip/z80-documented.pdf
* [Z80 test roms](http://mdfs.net/Software/Z80/Exerciser/)
* https://old.reddit.com/r/emudev & the emudev community on Discord.