collapseos/emul
2020-05-23 14:42:36 -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: rename stage2 to stage 2020-05-14 10:55:39 -04:00
avra.sh sms/kbd: begin rewriting ps2ctl to Forth 2020-05-17 14:24:27 -04:00
emul.c emul: add live register stats in the corner 2020-05-23 14:42:36 -04:00
emul.h emul: add live register stats in the corner 2020-05-23 14:42:36 -04:00
forth.bin Optimize chkPS 2020-05-22 23:12:03 -04:00
forth.c emul: add live register stats in the corner 2020-05-23 14:42:36 -04:00
Makefile emul: deduplicate some code 2020-05-23 10:08:40 -04:00
README.md emul: run Collapse OS inside a limited, fixed window 2020-05-23 14:23:03 -04:00
stage.c emul: deduplicate some code 2020-05-23 10:08:40 -04:00
xcomp.fs Move Cross-compiled core from B390 to B350 2020-05-15 22:44:49 -04:00
zasm.sh avra: first steps 2020-05-16 09:51:02 -04:00

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.