mirror of
https://github.com/hsoft/collapseos.git
synced 2024-11-05 08:50:56 +11:00
doc: add emulate section
This commit is contained in:
parent
056de2b19d
commit
6597e8a75a
@ -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
30
doc/emulate.md
Normal 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
|
Loading…
Reference in New Issue
Block a user