merge

[dcpu16] / README

A DCPU16 implementation, in late-model C.
  Not the fastest,
  nor the fanciest,
  just another tree in the forest.

This is an emulator system for an imaginary computing unit from 0x10c.com, based on initial specifications and speculations.

Developed on Lion and targeting command-line operation, this ought work on most similar platforms, but portability has not been tested to any great degree.

The processor-core emulator is complete and embeddable.  The sparse API allows stepping the cpu, and a rudimentary callback system allows for watching system memory access, for doing all sorts of extra things, such as driving the included display driver, which can manage to splat some text glyphs into a tiny screen buffer, and render out an image file of the current state.  With a little more work, it could support such things as completely pluggable modules, or something fancy like that.

For support utilities, there's a simple shell for running and manipulating a complete emulated system, as well as a woefully inelegant brute-force assembler, which needs a few additional features to be really useful beyond proof-of-concept.

Enjoy.

Justin Wind <justin.wind@gmail.com>