5 releases

0.1.4 Sep 18, 2023
0.1.3 Sep 18, 2023
0.1.2 Sep 17, 2023
0.1.1 Sep 17, 2023
0.1.0 Sep 17, 2023

#210 in Emulators

MIT license

85KB
1.5K SLoC

SSEM Emulator

crates.io MIT licensed

This is a CLI tool for running emulations of the Manchester Small-Scale Experimental Machine "Baby", the worlds first stored program computer, providing a familiar albeit primitive programming environment.

Installation

Ensure you have cargo installed.

cargo install ssemu

Useage

Usage: ssemu <COMMAND>

Commands:
  assemble  Assemble an asm source file to a binary file
  run       Load and run a source file
  help      Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

Assemble

Usage: ssemu assemble [OPTIONS] --input <INPUT>

Options:
  -i, --input <INPUT>    The input asm file
  -o, --output <OUTPUT>  The output binary dump (defaults to input + .bin)
      --og-notation      Use original notation for asm instructions
  -h, --help             Print help

Run

Usage: ssemu run [OPTIONS] <SRC>

Arguments:
  <SRC>  The source file to execute from

Options:
      --exe-from <EXE_FROM>        The format of the file to execute from [default: bin] [possible values: asm, bin]
      --og-notation                Use original notation for asm instructions if running from asm
      --output-model               Output whole `model` including registers & memory when execution stops or breakpoint encountered
      --output-addr <OUTPUT_ADDR>  Memory addresses to output when execution stops or breakpoint encountered
      --output-regs <OUTPUT_REGS>  Registers to output when execution stops or breakpoint encountered [possible values: accumulator, instruction, instruction-address]
      --break-addr <BREAK_ADDR>    Addresses where to break & output the state of the core
  -h, --help                       Print help (see more with '--help')

Dependencies

~1–12MB
~78K SLoC