forked from jtauber/dcpu16py
-
Notifications
You must be signed in to change notification settings - Fork 5
/
Copy pathREADME
33 lines (20 loc) · 1.08 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
A Python implementation of Notch's DCPU-16.
See http://0x10c.com/doc/dcpu-16.txt for specification.
Notch apparently started doing a 6502 emulator first. Given I did one in
Python <https://github.com/jtauber/applepy> it only seems fitting I now
do a DCPU-16 implementation in Python too :-)
STATUS
Runs the example program successfully. Cycle times are not yet taken
into account but it otherwise should be feature-complete.
A dissassembler and assembler are also included.
./asm.py example.asm example.obj will assemble Notch's example to object code
./dcpu16.py example.obj will execute it (currently hard-coded to debug mode)
./disasm.py example.obj will disassemble the given object code
Note that the disassembler doesn't quite output in a format that can be
round-tripped back into the assembler as it annotates each line with a
memory offset.
I plan to work on a Forth implementation soon.
I'm also keen to find out how Notch plans I/O to work.
EXAMPLES
Now see https://github.com/jtauber/DCPU-16-Examples (almost my assembler and
emulator don't necessarily support everything there yet)