summaryrefslogtreecommitdiff
path: root/README.md
blob: fe091bd675fa91f43ac37cd4babd379abcdb4b8a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
# z80emu

This repository contains a bare bones implementation of a `Z80` emulator (written in Typescript), supporting up to `150+` basic opcodes. It is intended to be an educational project to show how one would approach simulating the behaviour of an `8-bit` microprocessor.

The simulator interface steps through a compiled binary and dumps the contents of each `Z80` register after each fetch, decode, execute instruction cycle to the console.

> `Z80` assembly programs are intended to be compiled with [`z80asm`](https://www.nongnu.org/z80asm/)

Files:
<br/>
* `z80.ts` - `core implementation`.
* `main.ts` - `simulator interface`.