History

Virgil Dupras 490c57834f emul: update README		2020-06-27 07:53:58 -04:00
..
hw	sms: WIP !	2020-05-14 22:15:31 -04:00
libz80@8a1f935daa	Move "emul" folder to root	2019-12-31 13:34:24 -05:00
.gitignore	emul: build from "cvm" instead of from itself	2020-06-26 22:08:45 -04:00
Makefile	emul: build from "cvm" instead of from itself	2020-06-26 22:08:45 -04:00
README.md	emul: update README	2020-06-27 07:53:58 -04:00
emul.c	emul: make blk operations much faster	2020-06-22 06:29:00 -04:00
emul.h	emul: add live register stats in the corner	2020-05-23 14:42:36 -04:00
forth.c	emul: make blk operations much faster	2020-06-22 06:29:00 -04:00
xcomp.fs	z80: make boot binary a 2-part process	2020-06-26 21:41:17 -04:00

README.md

emul

This folder contains a couple of tools running under the libz80 emulator.

Requirements

You need ncurses to build the forth executable. In debian-based distros, it's libncurses5-dev.

Build

First, make sure that the libz80 git submodule is checked out. If not, run git submodule init && git submodule update.

After that, you can run make and it builds the forth interpreter.

Usage

The ./forth executable here works like the one in /cvm, except that it runs under an emulated z80 machine instead of running natively. Refer to /cvm/README.md for details.

Not real hardware

./forth doesn't try to emulate real hardware because the goal here is to facilitate "high level" development.

These apps run on imaginary hardware and use many cheats to simplify I/Os.

For real hardware emulation (which helps developing drivers), see the hw folder.