ProjectPSX 开源项目使用教程

ProjectPSX 开源项目使用教程

ProjectPSX Experimental C# Playstation Emulator 项目地址: https://gitcode.com/gh_mirrors/pr/ProjectPSX

1. 项目介绍

ProjectPSX 是一个用 C# 编写的实验性 PlayStation 模拟器，旨在模拟原始的 Sony PlayStation（PlayStation 1/PS1/PSX）。该项目是一个个人项目，旨在学习和了解硬件以及模拟器的开发。ProjectPSX 不使用任何外部依赖，采用相对简单的 C# 代码实现。

主要功能

• CPU (MIPS R3000A)：包括协处理器 0 和几何变换引擎 (GTE) 协处理器。
• BUS：用于连接各个组件的总线。
• GPU：实现了所有命令的软件多边形光栅化器。
• CDROM：实现了常见的命令。
• DMA 传输：支持 DMA 传输。
• 计时器：支持计时器功能。
• 数字控制器支持：目前硬编码为键盘。
• BIOS 和 MIPS 反汇编器：提供基本的 BIOS 和 MIPS 反汇编功能。
• MDEC：支持 16/24 bpp 视频解码。
• 显示屏幕：支持 24 bpp 显示。
• 内存卡支持：支持内存卡功能。
• SPU：支持 SPU，但不支持混响。

未实现功能

• DMA 可恢复传输
• CDROM：正确的计时
• 其他硬件功能的实现

2. 项目快速启动

环境准备

• 安装 .NET SDK
• 克隆项目代码

git clone https://github.com/BluestormDNA/ProjectPSX.git
cd ProjectPSX

编译项目

dotnet build

运行项目

项目包含两个额外的项目：ProjectPSX.Winforms 和 ProjectPSX.OpenTK。

使用 Winforms 项目

dotnet run --project ProjectPSX.Winforms

运行后，会弹出一个文件对话框，选择一个 Bin 文件（使用 track1）或 Cue 文件来生成 CD 轨道以供 CDROM 使用。

使用 OpenTK 项目

dotnet run --project ProjectPSX.OpenTK

运行后，可以直接拖放 bin/cue 文件到窗口中。

输入映射

• D-Pad UP: 上
• D-Pad Left: 左
• D-Pad Down: 下
• D-Pad Right: 右
• Triangle: W
• Square: A
• X: S
• Circle: D
• Start: Enter
• Select: Space
• L1: Q
• R1: E
• L2: 1
• R2: 2

3. 应用案例和最佳实践

应用案例

• 游戏开发：开发者可以使用 ProjectPSX 来测试和调试 PlayStation 游戏，了解硬件的工作原理。
• 教育：用于教学和学习硬件模拟器的开发，特别是对于 C# 开发者。

最佳实践

• 调试：使用 VRAM 查看器（按 TAB 键切换）来调试图形问题。
• 日志输出：在 CPU 主循环中取消注释 bios_verbose() 或 TTY() 函数以获取控制台 TTY 或 BIOS 输出。

4. 典型生态项目

相关项目

• XamaiNES：另一个用 C# 编写的 NES 模拟器，适合学习更简单的硬件模拟。
• OpenTK：一个用于高性能图形和计算的库，ProjectPSX 使用 OpenTK 进行图形渲染。

社区资源

• PSX-SPX 文档：Martin Korth 的 PlayStation 硬件文档，地址：https://problemkaputt.de/psx-spx.htm
• emudev Discord：PlayStation 模拟器开发者的社区，地址：https://discord.gg/dkmJAes

ProjectPSX Experimental C# Playstation Emulator 项目地址: https://gitcode.com/gh_mirrors/pr/ProjectPSX