History

Virgil Dupras d97012ecae Fix makefile build-from-clean-repo glitches		2020-06-30 10:24:12 -04:00
..
hw	Fix makefile build-from-clean-repo glitches	2020-06-30 10:24:12 -04:00
libz80@8a1f935daa
.gitignore	emul: build from "cvm" instead of from itself	2020-06-26 22:08:45 -04:00
emul.c	emul: make blk operations much faster	2020-06-22 06:29:00 -04:00
emul.h
forth.c	emul: make blk operations much faster	2020-06-22 06:29:00 -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
xcomp.fs	Add HERESTART xcomp config	2020-06-28 19:45:28 -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.