1
0
mirror of https://github.com/hsoft/collapseos.git synced 2024-12-25 04:58:05 +11:00

doc: add emulate section

This commit is contained in:
Virgil Dupras 2019-04-16 11:35:15 -04:00
parent 056de2b19d
commit 6597e8a75a
2 changed files with 31 additions and 0 deletions

View File

@ -3,6 +3,7 @@
## Assembly guide
* [Writing the glue code](glue-code.md)
* [Running Collapse OS on an emulated RC2014](emulate.md)
## User guide

30
doc/emulate.md Normal file
View File

@ -0,0 +1,30 @@
# 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][rc2014-emul]. 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.
[rc2014-emul]: https://github.com/EtchedPixels/RC2014