ZX Spectrum emulator written in Rust
- Watch this video showcase (
v0.9.x
) - Read CHANGELOG.md for info on the latest version changes
- Written in pure rust
- Cross-platform
- Full ZX Spectrum 48K and 128K emulation
- Perfect emulation of Z80 core
- Highly precise AY chip emulation
- Beeper sound emulation
- Supported formats: TAP, SNA (both 48K and 128K version)
- Fast loading of tap files with standard loader
- Precise timings
- Full border emulation
- Joystick emulation: Kempston, Sinclair
- Kempston mouse emulation
- Extended 128K keys emulation (arrows, backspace, caps lock)
- Quick save/load
- Separate
no_std
core library which can be used to port emulator almost anywhere.- Global allocator is still needed, but all dynamic allocations were minimized
- All resource-heavy features are configurable via cargo
features
- Sure that you have C compiller and CMake to
build bundled
sdl2
- Install it with cargo
cargo install --path ./rustzx
rustzx --help # Show help
rustzx test.tap # Autodetect file type and run in 48K mode
rustzx --ay test.tap # Run in 48K mode with AY sound chip
rustzx -m128 --tape test128.tap # Run in 128K mode with tape
rustzx --rom tester.rom -s3 # Run with custom rom and 3x screen scaling
rustzx --nofastload test.tap # Run without fast tape loading
rustzx --mouse test.tap # Run with Kempston mouse support
For loading tape in 48K mode, press j
then Ctrl+p
twice, as on real Spectrum.
You should see LOAD ""
on emulator's screen, then press Enter
(in 128K mode just press enter).
In --nofastload
mode, press Insert
to play the tape and Delete
to stop
If you have choppy audio, try --sound-latency
option with bigger values.
F1
- quick saveF2
- quick loadF3
- set normal emulation speedF4
- set 2x emulation speedF5
- max possible emulation speedF6
- enable frame trace infoF9
- enable kempston/sinclair joy keyboard layerInsert
- start tapeDelete
- stop tapeEnd
- break commandCaps Lock
- caps lock commandBackspace
- delete<Arrows>
- 128K arrow keysEsc
- unlock mouse (if--mouse
is used)
<Arrows>
- Kempston joy arrowsAlt
- Kempston fireWASD
- Siclair Joy 1 arrowsCaps Lock
- Sinclair Joy 1 fireIJKL
- Siclair Joy 2 arrowsEnter
- Sinclair Joy 2 fire
Many resources were used to find out, how to buildthis emulator. Huge thanks to the following resources which helped to figure out a lot of defails about ZX Spectrum.
- Of course z80.info
- Instruction table from ClrHome
- "Floating bus explained!" by Ramsoft
- 16K / 48K ZX Spectrum Reference
- 128K ZX Spectrum Reference
- Z80 hardware organization
- disassembler.io online disassembler
- Cool z80 assembler zasm
- Diagnostic ROM by Phill
- zx-modules.de - great resource, check it out!
- speccy.info
- Harlequin
- And many other great material, which helped me to make rustzx!
- FUSE emulator source for finding out correct timings
Emulator contains ROMs, created by by Sinclair Research Ltd (now owned by Amstrad plc),
Amstrad has given
permission to distribute their ROM's in conjunction with emulators.
In RustZX these ROMs included in source of the core emulator library mod rustzx_core::zx::roms
. Embedded roms
can be opted-out from the core library by disabling feature embedded-roms
.