izaya/collapseos
1
0
Fork 0
mirror of https://github.com/hsoft/collapseos.git synced 2024-11-17 06:58:05 +11:00
Code Issues Releases Wiki Activity
69bb34ce7b
collapseos/cvm
History
Virgil Dupras de7cb4a80f Add word A, 
This would be useful, for example, to allow the assembler to write
straight to an AT28 EEPROM without going to RAM. This would be a
life saver in machines with tight RAM such as the SMS.
2020-10-28 20:45:50 -04:00
..
.gitignore cvm: bootstraps itself! 2020-06-26 18:58:02 -04:00
avra.sh Add alias and switch word types 2020-10-28 15:02:06 -04:00
forth.bin Add word A, 2020-10-28 20:45:50 -04:00
forth.c recipes/sms: move recipe blocks into local overlay 2020-09-20 10:21:21 -04:00
Makefile recipes/sms: move recipe blocks into local overlay 2020-09-20 10:21:21 -04:00
README.md emul: build from "cvm" instead of from itself 2020-06-26 22:08:45 -04:00
stage.c recipes/sms: move recipe blocks into local overlay 2020-09-20 10:21:21 -04:00
vm.c Add alias and switch word types 2020-10-28 15:02:06 -04:00
vm.h recipes/rc2014: move recipe blocks into local overlay 2020-09-20 10:50:13 -04:00
xcomp.fs Move most of the high layer of comp core into the low one 2020-10-28 18:18:00 -04:00
zasm.sh Add alias and switch word types 2020-10-28 15:02:06 -04:00

README.md

C VM

This is a C implementation of Collapse OS' native words. It allows Collapse OS to run natively on any POSIX environment.

Requirements

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

Build

Running make will yield forth and stage executables.

Usage

To play around Collapse OS, you'll want to run ./forth. 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.

You can get a REPL by launching the program with rlwrap(1) like this:

rlwrap -e '' -m -S '> ' ./forth /dev/stdin

Problems?

If the forth executable works badly (hangs, spew garbage, etc.), it's probably because you've broken your bootstrap binary. It's 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.