Skip to main content

Mips Interpreter

Project description

Dashmips

Dashmips is a Mips Interpreter CLI Program.

Install

The recommended way to install dashmips is with pip:

pip install dashmips

Usage

If you installed via pip you should now have a binary in your path that you can launch by typing:

dashmips

"Compiling"

To compile or run a mips program you run:

dashmips compile --run FILE.mips

What "compilation" means in dashmips is a conversion of the source file to a json format that is better understood by the program. You can use this json format to inspect the internals of how your mips program is interpretted by dashmips.

Debugging

In order to leave a flexible environment for debugging dashmips doesn't provide an interface for human debugging of a mips program. Instead the debugger included is a server that accepts the json format of a mips program over the network and will do the requested operations returning an updated MipsProgram json object.

There is a vscode extension that can speak dashmips specific json language here.

Debugging protocol

Small notes about the protocol if you want to proceed with a manual debugging. The JSON you send to the debug server is expected to take the following format:

interface DebugMessage {
    command: 'start' | 'step' | 'continue' | 'stop';
    program: MipsProgram;  // MipsProgram can be found in `dashmips/models.py`
    // properties below are optional
    breakpoints?: number[];
    message?: string;
    error?: boolean;
}

The commands listed are start, step, continue, and stop. In short each operation does the following:

  • Start: sets the pc to the main label
  • Step: runs exactly one instruction from current pc
  • Continue: runs as many instructions as there are between current pc and a breakpoint
  • Stop: Does nothing

The server is designed to be stateless so it can handle many clients at once.

Contributing

Adding Syscalls / Adding Instructions

You can add to the existing files in the dashmips/instructions and dashmips/syscalls directories using the relevant decorator (@). If you add instructions or syscalls to a new file in these subdirectories ensure that the new file is named with the pattern: *_instructions.py or *_syscalls.py where * is whatever identifier you choose.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
dashmips-0.0.7-py3-none-any.whl (30.2 kB) Copy SHA256 hash SHA256 Wheel py3
dashmips-0.0.7.tar.gz (20.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page