collapseos/emul
Virgil Dupras bf289b0a67 z80a: de-variable-ize
Use straight VARIABLE instead of Z80MEM+. Initially, I used this
system to allow z80a to be embedded in a system binary, but now
I don't think it's worth it. Compiled, z80a is 2.5k. Sure, it's a
sizeable amount of RAM, but I think that even with it in RAM, I'll
manage a bootstrap within my most constrained machine, the SMS with
8K.
2020-05-14 15:29:22 -04:00
..
hw ti84: we have a prompt 2020-05-09 14:28:55 -04:00
libz80@8a1f935daa
.gitignore emul: rename stage2 to stage 2020-05-14 10:55:39 -04:00
emul.c Add emul_memdump() and stop automatically on ROM write 2020-04-09 08:26:41 -04:00
emul.h Add emul_memdump() and stop automatically on ROM write 2020-04-09 08:26:41 -04:00
forth.bin z80a: de-variable-ize 2020-05-14 15:29:22 -04:00
forth.c Make INTERPRET break on ASCII EOT 2020-05-13 21:44:46 -04:00
Makefile emul: rename stage2 to stage 2020-05-14 10:55:39 -04:00
README.md Update READMEs 2020-05-03 12:51:21 -04:00
stage.c emul: remove stage1 2020-05-14 10:49:24 -04:00
xcomp.fs emul: remove stage1 2020-05-14 10:49:24 -04:00

emul

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

Not real hardware

In the few emulated apps described below, we don'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.

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.

Run ./forth to get the COllapse OS prompt. Type 0 LIST for help.

Problems?

If the libz80-wrapped zasm executable works badly (hangs, spew garbage, etc.), it's probably because you've broken your bootstrap binaries. They're easy to mistakenly break. To verify if you've done that, look at your git status. If forth.bin is modified, try resetting it and then run make clean all. Things should go better afterwards.

If that doesn't work, there's also the nuclear option of git reset --hard and git clean -fxd.

If that still doesn't work, it might be because the current commit you're on is broken, but that is rather rare: the repo on Github is plugged on Travis and it checks that everything is smooth.