Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
An emulator for the DCPU16 (found in Notch's new game). Forum thread at: http://0x10cforum.com/forum/m/4932880/viewthread/2718118-dcpu16emulator
C Other
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
hardware
include
programs
LICENSE
Makefile
README
dcpu-16_specifications.txt
dcpu16.c
test.c

README

This is an emulator for the DCPU16 CPU of Notch's new game 0x10c (link: 0x10.com).
Supports DCPU16 according to specification version 1.7 released by Notch.
Project source code can be found at: https://github.com/tobbebia/dcpu16-emulator
Collaborators: tobbebia, skyfell
----------------------------------------------------------------------------------

BUILDING:
Use 'make all'. Output file will be found in /bin.

RUNNING:
Terminal 'dcpu16 parameters ram_file'.

	PARAMETERS:
		-d	debug mode (let's you step through the instructions)
		-bl	ram file is in binary format with little endian words
		-bb	ram file is in binary format with big endian words
		-p	enable profiling
		<file>	file which gets loaded to ram

	EXAMPLES:
		dcpu16 -d -bl notch_program.bin
		dcpu16 my_program.dat
		dcpu16 -bb my_big_endian_program.bin

NOTE:
When running in normal mode (not debug mode), the emulator will run forever and it is hard to see the results of your program.

EXTRA OPCODES:

0x18 - Breakpoint. Let's you explore the CPU state and then continue. Interrupts will be ignored when
	the DCPU is on a breakpoint.

USING THIS EMULATOR AS A CORE IN YOUR OWN PROJECTS (I.E. GUI EMULATORS):
1. Change MAIN variable in Makefile and provide your own C file with a main function.
2. Optionally set the ADDITIONAL_CFILES and ADDITIONAL_CFLAGS in Makefile.
2. Set the desired configuration in config.h.
3. Run 'make all' to build a binary.
Something went wrong with that request. Please try again.