README.md

Mash16 -- Reference Chip16 Emulator

Summary

Mash16 is an emulator for the Chip16 platform, which aims to make writing emulators easier for beginners.

It is one of the reference emulators, and hence supports the full instruction set. The user is encouraged to read the source code.

Download here!

Screenshots

_
_

Features

• Full support of the latest (1.3) Chip16 specification
• Debugging functionality (breakpoints, stepping, state viewing)
• Multiple video scalers
• Unrestricted emulation speed possible

Usage

mash16 filename [OPTIONS]

Options

--no-audio              : disable audio output
--audio-sample-rate=n   : set audio sample rate (8000,11025,22050,44100 recommended)
--audio-buffer=n        : set audio buffer size (512-8192 recommended)
--verbose               : log emulation
--video-scaler=n        : screen scaler size (1,2,3,4)
--fullscreen            : use fullscreen mode
--no-cpu-limit          : do not restrict the speed of the emulation

--cpu-rec               : use (experimental) recompiler core

--break@n               : add a breakpoint at address n
--break-all             : break at every instruction
--help                  : print the help text
--version               : print version information

Supported platforms

Mash16 is officially supported on Linux and Windows. OS X testing is welcome.

• On Linux, it has been tested with GCC and Clang. Build with the Makefile.
  • Cross-compiling for Windows is possible from Linux; build the windows target (make windows). Do not forget to specify your MinGW prefix (use make windows WIN_PREFIX=...); the default is i486-mingw32.
• On Windows, it has been tested with Visual Studio 2010. Build with the provided solution files.

More Screenshots

_ _