mirror of
https://github.com/hsoft/collapseos.git
synced 2024-12-26 05:48:06 +11:00
1.0 KiB
1.0 KiB
Running Collapse OS on an emulator
The quickest way to give Collapse OS a whirl is to use tools/emul
which is
built around libz80. Everything is set up, you just have to run
make
, then shell/shell
.
To emulate something at a lower level, I recommend using Alan Cox's RC2014 emulator. It runs Collapse OS fine but you have to write the glue code yourself. One caveat, also, 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
ZASM = ~/collapseos/tools/emul/zasm/zasm
ROM = os.rom
.PHONY: all
all: $(ROM)
$(TARGET): main.asm
$(ZASM) < $< > $@
$(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.