iceGDROM 项目使用教程

iceGDROM 项目使用教程

iceGDROM An FPGA based GDROM emulator for the Sega Dreamcast 项目地址: https://gitcode.com/gh_mirrors/ic/iceGDROM

1. 项目的目录结构及介绍

iceGDROM 项目的目录结构如下：

iceGDROM/
├── fpga/
│   ├── ...
├── pcb/
│   ├── riser/
│   │   ├── ...
├── rv32/
│   ├── ...
├── test/
│   ├── ...
├── tools/
│   ├── ...
├── .gitignore
├── COPYING
├── GNUmakefile
├── README.md

目录介绍

• fpga/: 包含 FPGA 相关的代码和配置文件。
• pcb/riser/: 包含用于连接 FPGA 板和 Dreamcast 主板的定制“riser 板”的设计文件。
• rv32/: 包含 RISC-V 软核的代码和配置文件。
• test/: 包含测试相关的文件。
• tools/: 包含用于生成图像文件的工具。
• .gitignore: Git 忽略文件。
• COPYING: 项目的许可证文件，使用 GPL-3.0 许可证。
• GNUmakefile: 项目的 Makefile，用于构建项目。
• README.md: 项目的介绍和使用说明。

2. 项目的启动文件介绍

项目的启动文件主要是 GNUmakefile，它负责项目的构建和编译。通过运行 make 命令，可以构建整个项目或特定部分。

启动步骤

1. 构建 FPGA 比特流:

   make -C fpga
   

2. 构建 RISC-V 软件:

   make -C rv32
   

3. 构建工具:

   make -C tools
   

4. 整体构建:

   make
   

3. 项目的配置文件介绍

项目的配置文件主要位于 rv32/source/config.h，该文件用于配置 RISC-V 软核的行为，例如 CD 信号的极性或启用调试跟踪。

配置文件内容

// rv32/source/config.h

#ifndef CONFIG_H
#define CONFIG_H

// 配置 CD 信号的极性
#define CD_SIGNAL_POLARITY 1

// 启用调试跟踪
#define ENABLE_DEBUG_TRACES 0

#endif // CONFIG_H

配置说明

• CD_SIGNAL_POLARITY: 配置 CD 信号的极性，根据所选的 SD 卡模块进行调整。
• ENABLE_DEBUG_TRACES: 启用或禁用调试跟踪，通过串口输出调试信息。

通过修改 config.h 文件，可以根据具体需求调整项目的配置。

iceGDROM An FPGA based GDROM emulator for the Sega Dreamcast 项目地址: https://gitcode.com/gh_mirrors/ic/iceGDROM