ed2b91411a
I'm planning on going back to 8-bit branching. 16-bit br cells incur a non-negligible penalty and, while at first 64 words (128 bytes forward or backward) seemed a bit limiting, I now don't see why one would ever construct such a big branch. It would be un-forthy. Also, I looked at using BC instead of IY to hold IP and the transition would be a lot easier with 8-bit branching. In this commit, all I do is add overflow checks in IF. The mechanic below doesn't change. I'll give myself some time to think it over so that I avoid yet another back and forth. |
||
---|---|---|
.. | ||
hw | ||
libz80@8a1f935daa | ||
.gitignore | ||
avra.sh | ||
emul.c | ||
emul.h | ||
forth.bin | ||
forth.c | ||
Makefile | ||
README.md | ||
stage.c | ||
xcomp.fs | ||
zasm.sh |
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
.
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.
Usage
Run ./forth
to get the Collapse OS prompt. Type 0 LIST
for help.
The program is a curses interface with a limited, fixed size so that it can provide a AT-XY interface (which is yet to implement).
Problems?
If the forth
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.
A modified blkfs
can also break things (although even with a completely broken
blkfs, you should still get to prompt), you might want to run make pack
to
ensure that the blkfs
file is in sync with the contents of the blk/
folder.
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.