EduMIPS64 技术文档

1. 安装指南

1.1 系统要求

EduMIPS64 是一个跨平台的 MIPS64 CPU 模拟器，支持 Windows、Linux 和 macOS 系统。安装前请确保您的系统满足以下要求：

• Java 运行环境（JRE）已安装，版本建议为 Java 8 或更高。
• 浏览器支持 JavaScript（用于 Web 版本）。

1.2 下载与安装

1.2.1 通过 GitHub 下载

1. 访问 GitHub 页面 下载最新版本的 JAR 文件或源代码压缩包。
2. 解压下载的文件到您选择的目录。
3. 运行 JAR 文件：

   java -jar edumips64-<version>.jar
   

1.2.2 通过包管理器安装

• Ubuntu Snap: 使用命令行安装：

  snap install edumips64
  

• Windows Package Manager: 使用命令行安装：

  winget install edumips64
  

• FreeBSD FreshPorts: 通过 FreeBSD 包管理器安装。
• Gentoo: 通过 Gentoo 包管理器安装。
• ArchLinux: 通过 AUR 安装。

1.3 验证安装

运行 EduMIPS64 后，您应该能够看到主界面，并可以开始使用模拟器。

2. 项目使用说明

2.1 启动模拟器

双击 JAR 文件或通过命令行启动模拟器后，您将看到 EduMIPS64 的主界面。

2.2 加载程序

1. 点击菜单栏中的“文件”选项，选择“打开”。
2. 选择您要加载的 MIPS64 汇编程序文件（通常为 .s 文件）。
3. 程序加载后，您可以在界面中查看程序的汇编代码和 CPU 状态。

2.3 运行程序

1. 点击“运行”按钮，模拟器将开始执行程序。
2. 您可以在执行过程中查看 CPU 的寄存器状态、内存状态以及流水线执行情况。

2.4 调试程序

1. 使用“单步执行”按钮逐条执行指令。
2. 查看每条指令执行后的寄存器和内存变化。
3. 使用“断点”功能在特定指令处暂停程序执行。

3. 项目 API 使用文档

EduMIPS64 提供了一些 API 接口，允许用户通过编程方式与模拟器进行交互。以下是一些常用的 API 接口：

3.1 加载程序

public void loadProgram(String filePath);

• 功能: 加载指定的 MIPS64 汇编程序文件。
• 参数: filePath - 程序文件的路径。

3.2 运行程序

public void runProgram();

• 功能: 开始执行加载的程序。

3.3 单步执行

public void step();

• 功能: 单步执行一条指令。

3.4 设置断点

public void setBreakpoint(int lineNumber);

• 功能: 在指定行设置断点。
• 参数: lineNumber - 断点所在的行号。

4. 项目安装方式

4.1 通过 JAR 文件安装

1. 下载最新版本的 JAR 文件。
2. 使用命令行运行：

   java -jar edumips64-<version>.jar
   

4.2 通过包管理器安装

• Ubuntu Snap:

  snap install edumips64
  

• Windows Package Manager:

  winget install edumips64
  

• FreeBSD FreshPorts: 通过 FreeBSD 包管理器安装。
• Gentoo: 通过 Gentoo 包管理器安装。
• ArchLinux: 通过 AUR 安装。

通过以上步骤，您可以顺利安装并使用 EduMIPS64 模拟器，进行 MIPS64 汇编程序的模拟与调试。