iCEstation-32 开源项目教程

iCEstation-32 开源项目教程

icestation-32Compact FPGA game console项目地址:https://gitcode.com/gh_mirrors/ic/icestation-32

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

iCEstation-32 项目的目录结构如下：

icestation-32/
├── doc/
│   ├── platform.md
│   └── ...
├── firmware/
│   ├── ics32.v
│   └── ...
├── hardware/
│   ├── ics32_top.v
│   └── ...
├── photos/
│   └── ...
├── scripts/
│   └── ...
├── simulator/
│   └── ...
├── software/
│   ├── sprites/
│   │   ├── Makefile
│   │   └── ...
│   └── ...
├── utilities/
│   └── ...
├── .gitattributes
├── .gitignore
├── LICENSE
├── README.md
└── ...

目录介绍

• doc/: 包含项目的文档，如 platform.md，提供了详细的硬件文档。
• firmware/: 包含项目的固件文件，如 ics32.v，是项目的核心代码。
• hardware/: 包含硬件相关的文件，如 ics32_top.v，是硬件顶层模块的代码。
• photos/: 包含项目的图片文件。
• scripts/: 包含项目的脚本文件。
• simulator/: 包含模拟器相关的文件。
• software/: 包含软件相关的文件，如 sprites/ 目录下的 Makefile，用于编译和编程。
• utilities/: 包含项目的实用工具文件。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略配置文件。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的介绍和使用说明。

2. 项目的启动文件介绍

项目的启动文件主要位于 software/sprites/ 目录下，其中 Makefile 是关键的启动文件。

Makefile

Makefile 文件用于编译和编程 iCEstation-32 项目。以下是 Makefile 的主要内容和功能：

# 编译目标
icebreaker_prog:
    make -C ../.. icebreaker_prog

ulx3s_prog:
    make -C ../.. ulx3s_prog

# 其他编译目标
...

启动步骤

1. 进入软件目录:

   cd software/sprites/
   

2. 编译和编程:

   • 对于 iCEBreaker 用户:

     make icebreaker_prog
     

   • 对于 ULX3S 用户:

     make ulx3s_prog
     

3. 项目的配置文件介绍

项目的配置文件主要位于 firmware/ 目录下，其中 ics32.v 是核心配置文件。

ics32.v

ics32.v 文件是 iCEstation-32 项目的核心配置文件，包含了 RISC-V CPU 的选择和其他关键配置。

// 选择 RISC-V CPU 实现
parameter USE_VEXRISCV = 1; // 1 表示使用 VexRiscV, 0 表示使用 PicoRV32

// 其他配置参数
...

配置步骤

1. 编辑配置文件:

   nano firmware/ics32.v
   

2. 修改配置参数:

   • 根据需求修改 USE_VEXRISCV 参数。

3. 保存并退出:

   Ctrl + X
   

通过以上步骤，您可以成功配置和启动 iCEstation-32 项目。

icestation-32Compact FPGA game console项目地址:https://gitcode.com/gh_mirrors/ic/icestation-32