~jleightcap/jemu

jeighty Z80 minicomputer emulator

clone

read-only
https://git.sr.ht/~jleightcap/jemu
read/write
git@git.sr.ht:~jleightcap/jemu

You can also use your local clone with git send-email.

#jalemu

a Z80 instruction set simulator targeting the jeighty minicomputer. see DESIGN.md.

#usage

assemble some source file to machine code; rasm is used here for testing. see input/ for some assembly examples.

Z80 ISA Emulator 0.1
Jack Leightcap <jack@leightcap.com>
Emulate Z80 processor

USAGE:
    jemu [FLAGS] <ROM>

FLAGS:
    -h, --help       prints this text
    -v               set verbosity (0-3)
    -V, --version    version

ARGS:
    <ROM>    Z80 machine code

#building

build with cargo

cargo build --release

for testing and development dependencies, use nix with nix-shell. see shell.nix.

#testing

cargo test

additional test files can be placed in input/ with an (optional) *.out file for the expected output. tests in do_pass are expected to pass, tests in do_err are expected to not pass.

to run a single test, for example input/do_pass/while.asm,

cargo test do_pass_input_do_pass_while_asm