collapseos/doc/emulate.md

Running Collapse OS on an emulated RC2014

To give Collapse OS a whirl or to use emulation as a development tool, I recommend using Alan Cox's RC2014 emulator. It runs Collapse OS fine. One caveat, however, is that it requires a ROM image bigger than 8K, so you have to pad the binary.

A working Makefile for a project with a glue code being called main.asm could look like:

TARGET = os.bin
PARTS = ~/collapseos/parts
ROM = os.rom

.PHONY: all
all: $(ROM)
$(TARGET): main.asm
        scas -o $@ -L map -I $(PARTS) $<

$(ROM): $(TARGET)
        cp $< $@
        dd if=/dev/null of=$@ bs=1 count=1 seek=8192

.PHONY: run
run: $(ROM)
        ~/RC2014/rc2014 -r $(ROM)

CTRL+\ stops the emulation.