Groovy_MiSTer 项目使用教程

1. 项目目录结构及介绍

Groovy_MiSTer 项目的目录结构如下：

Groovy_MiSTer/
├── api/
├── groovymame_uifont/
├── hps_linux/
├── old-builds/
├── retroarch/
├── rtl/
├── sys/
├── test-builds/
├── .gitattributes
├── .gitignore
├── Groovy.qpf
├── Groovy.qsf
├── Groovy.rbf
├── Groovy.sdc
├── Groovy.srf
├── Groovy.sv
├── LICENSE
├── README.md
├── clean.bat
├── files.qip
└── history.txt

目录介绍

• api/: 包含项目API相关的文件。
• groovymame_uifont/: 包含GroovyMAME用户界面字体相关的文件。
• hps_linux/: 包含与Linux系统相关的文件。
• old-builds/: 包含旧版本的构建文件。
• retroarch/: 包含RetroArch相关的文件。
• rtl/: 包含RTL（Register Transfer Level）设计文件。
• sys/: 包含系统相关的文件。
• test-builds/: 包含测试构建的文件。
• .gitattributes: Git属性配置文件。
• .gitignore: Git忽略文件配置。
• Groovy.qpf: Quartus项目文件。
• Groovy.qsf: Quartus设置文件。
• Groovy.rbf: 可执行的FPGA二进制文件。
• Groovy.sdc: Synopsys设计约束文件。
• Groovy.srf: 系统参考文件。
• Groovy.sv: SystemVerilog源代码文件。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• clean.bat: Windows批处理文件，用于清理项目。
• files.qip: Quartus IP文件。
• history.txt: 项目历史记录文件。

2. 项目启动文件介绍

项目的启动文件主要是 Groovy.rbf，这是一个可执行的FPGA二进制文件。启动项目时，需要将此文件复制到MiSTer的适当目录下，并在MiSTer的配置文件中进行相应的设置。

启动步骤

1. 将 Groovy.rbf 复制到 /media/fat/_Utility 目录下。
2. 编辑 MiSTer.ini 文件，添加以下配置：

   [Groovy]
   main=MiSTer_groovy
   

3. 保存并退出 MiSTer.ini 文件。
4. 重启MiSTer设备，项目将自动加载并启动。

3. 项目配置文件介绍

项目的主要配置文件包括 MiSTer.ini 和 Groovy.qsf。

MiSTer.ini

MiSTer.ini 是MiSTer设备的配置文件，用于指定项目的启动文件和其他相关设置。在 MiSTer.ini 中添加以下内容以启动Groovy_MiSTer项目：

[Groovy]
main=MiSTer_groovy

Groovy.qsf

Groovy.qsf 是Quartus设置文件，用于配置FPGA的硬件设置。该文件包含了项目的各种硬件资源分配和时序约束。

其他配置文件

• .gitattributes: 用于指定Git的属性，如文件的换行符处理等。
• .gitignore: 用于指定Git忽略的文件和目录。
• LICENSE: 项目的许可证文件，通常为GPL-2.0许可证。
• README.md: 项目的介绍和使用说明，通常包含项目的功能、安装步骤和使用方法。

通过以上配置文件的设置，可以确保Groovy_MiSTer项目在MiSTer设备上正确运行。