Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Python implementation of Notch's DCPU-16
Python Assembly
branch: master

This branch is 158 commits behind jtauber:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
examples @ d9e5546
.gitignore
.gitmodules
LICENSE
README.md
asm.py
asm_pyparsing.py
dcpu16.py
disasm.py
example.asm

README.md

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 (two) assemblers 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

There is also an experimental pyparsing-based assembler ./asm_pyparsing.py contributed by Peter Waller with support for case-insensitive instructions and identifers as well as dat. You'll need to pip install pyparsing to run it.

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 (although my assembler and emulator don't necessarily support everything there yet)

Something went wrong with that request. Please try again.