DCPU-16 GUI

DCPU-16 emulator GUI written in Rust and Piston.

Installation

Make sure you have Rust/Cargo and SDL2. One of these lines might help with the latter:

$ brew install sdl2                 # macOS
$ apt-get install libsdl2-dev       # Ubuntu

Now install DCPU-16 and DCPU-16-GUI through Cargo:

$ cargo install dcpu16
$ cargo install dcpu16-gui

This will install a variety of binaries that all start with dcpu16, so try typing that in and hit tab.

Devices

Implemented devices:

Monitor (LEM1802)
Generic keyboard
Floppy drive (M35FD)

They are attached with device indices 0 (monitor), 1 (keyboard), and 2 (floppy). The floppy drive is empty at start, but you have an all-zero floppy disk that can be inserted/ejected by hitting F1.

Example

Prints "Hello world!" in green to the screen:

$ dcpu16-gui examples/hello.bin

To automatically attach a monitor to address 0x8000 (as in older programs), run with -m 0x8000.

Example 2

The next example is not assembled yet, so let's do that first:

$ dcpu16-assembler examples/rainbow.dasm16 -o examples/rainbow.bin

Now we can run it:

$ dcpu16-gui examples/rainbow.bin

Tools