Welcome to the EduMIPS64 documentation!

EduMIPS64 is a MIPS64 Instruction Set Architecture (ISA) simulator. It is designed to be used to execute small programs that use the subset of the MIPS64 ISA implemented by the simulator, allowing the user to see how instructions behave in the pipeline, how stalls are handled by the CPU, the status of registers and memory and much more. It is both a simulator and a visual debugger.

The website for the project is http://www.edumips.org, and the code is hosted at http://github.com/EduMIPS64/edumips64. If you find any bugs, or have any suggestion for improving the simulator, please open an issue on github or send an email at bugs@edumips.org.

EduMIPS64 is developed by a group of students of the University of Catania (Italy), and started as a clone of WinMIPS64, even if now there are lots of differences between the two simulators.

This manual will introduce you to EduMIPS64, and will cover some details on how to use it.

This manual describes EduMIPS64 version 1.4.0.

This manual is split into two parts. The first part is independent from the user interface in use and covers the source file format, the supported instruction set, the Floating Point Unit and a set of example programs. The second part documents the user interfaces: a chapter for the desktop (Swing) application, which also includes the command line options of the JAR, a chapter for the interactive command line shell that the JAR exposes in headless mode, and a chapter for the web frontend.

When this manual is opened from inside the running application, only the chapter that is relevant for the active user interface is shown. The full manual (with both UI chapters) is available on Read the Docs and as a PDF.

• Source files format
  • Memory limits
  • The .data section
  • The .code section
  • The #include command
• The instruction set
  • ALU Instructions
  • Load/Store instructions
  • Flow control instructions
  • The SYSCALL instruction
  • Other instructions
• Floating Point Unit
  • Special values
  • Exception configuration
  • The .double directive
  • The FCSR register
  • Instruction set
• Code Examples
  • SYSCALL

• The desktop user interface
  • The menu bar
  • Frames
  • Dialogs
  • Command line options
• The interactive command line interface
  • The prompt
  • Browsing the user manual from the shell
  • Available commands
  • A typical session
  • Scripting tips

• The web user interface
  • Layout overview
  • The top toolbar
  • The code editor
  • The Issues panel
  • Runtime panels
  • Running EduMIPS64 as a desktop or CLI application