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 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
<adc,sbc> hl,<bc,de,hl,sp>....  OK
add hl,<bc,de,hl,sp>..........  OK
add ix,<bc,de,ix,sp>..........  OK
add iy,<bc,de,iy,sp>..........  OK
aluop a,nn....................  OK
aluop a,<b,c,d,e,h,l,(hl),a>..  ERROR **** crc expected:fe43b016 found:80744231
aluop a,<ixh,ixl,iyh,iyl>.....  ERROR **** crc expected:a4026d5a found:18e22f28
aluop a,(<ix,iy>+1)...........  ERROR **** crc expected:e849676e found:b2b3f5cf
bit n,(<ix,iy>+1).............  ERROR **** crc expected:a8ee0867 found:efb20fe7
bit n,<b,c,d,e,h,l,(hl),a>....  OK
cpd<r>........................  ERROR **** crc expected:a87e6cfa found:8a2154a8
cpi<r>........................  ERROR **** crc expected:06deb356 found:06b932a1
<daa,cpl,scf,ccf>.............  ERROR **** crc expected:9b4ba675 found:89ad31f7
<inc,dec> a...................  OK
<inc,dec> b...................  OK
<inc,dec> bc..................  OK
<inc,dec> c...................  OK
<inc,dec> d...................  OK
<inc,dec> de..................  OK
<inc,dec> e...................  OK
<inc,dec> h...................  OK
<inc,dec> hl..................  OK
<inc,dec> ix..................  OK
<inc,dec> iy..................  OK
<inc,dec> l...................  OK
<inc,dec> (hl)................  OK
<inc,dec> sp..................  OK
<inc,dec> (<ix,iy>+1).........  OK
<inc,dec> ixh.................  OK
<inc,dec> ixl.................  OK
<inc,dec> iyh.................  OK
<inc,dec> iyl.................  OK
ld <bc,de>,(nnnn).............  OK
ld hl,(nnnn)..................  OK
ld sp,(nnnn)..................  OK
ld <ix,iy>,(nnnn).............  OK
ld (nnnn),<bc,de>.............  OK
ld (nnnn),hl..................  OK
ld (nnnn),sp..................  OK
ld (nnnn),<ix,iy>.............  OK
ld <bc,de,hl,sp>,nnnn.........  OK
ld <ix,iy>,nnnn...............  OK
ld a,<(bc),(de)>..............  OK
ld <b,c,d,e,h,l,(hl),a>,nn....  OK
ld (<ix,iy>+1),nn.............  OK
ld <b,c,d,e>,(<ix,iy>+1)......  OK
ld <h,l>,(<ix,iy>+1)..........  OK
ld a,(<ix,iy>+1)..............  OK
ld <ixh,ixl,iyh,iyl>,nn.......  OK
ld <bcdehla>,<bcdehla>........  OK
ld <bcdexya>,<bcdexya>........  OK
ld a,(nnnn) / ld (nnnn),a.....  OK
ldd<r> (1)....................  ERROR **** crc expected:94f42769 found:b94a393d
ldd<r> (2)....................  ERROR **** crc expected:5a907ed4 found:772e6080
ldi<r> (1)....................  ERROR **** crc expected:9abdf6b5 found:b703e8e1
ldi<r> (2)....................  ERROR **** crc expected:eb59891b found:1c991b87
neg...........................  ERROR **** crc expected:6a3c3bbd found:dfbcf11d
<rrd,rld>.....................  ERROR **** crc expected:955ba326 found:2c05f8a4
<rlca,rrca,rla,rra>...........  ERROR **** crc expected:251330ae found:34b41bec
shf/rot (<ix,iy>+1)...........  ERROR **** crc expected:713acd81 found:c5ed15c5
shf/rot <b,c,d,e,h,l,(hl),a>..  ERROR **** crc expected:eb604d58 found:772bdc9b
<set,res> n,<bcdehl(hl)a>.....  ERROR **** crc expected:8b57f008 found:36d25f63
<set,res> n,(<ix,iy>+1).......  ERROR **** crc expected:cc63f98a found:fe27dcf9
ld (<ix,iy>+1),<b,c,d,e>......  OK
ld (<ix,iy>+1),<h,l>..........  OK
ld (<ix,iy>+1),a..............  OK
ld (<bc,de>),a................  OK
Tests complete

---

Arcade game support

Please see 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
• https://old.reddit.com/r/emudev & the emudev community on Discord.