USB HID Host FPGA Core 项目教程

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

本项目usb_hid_host是一个开源的FPGA核心，用于支持USB键盘、鼠标和游戏手柄。项目的目录结构如下：

• boards: 包含针对不同FPGA开发板的示例项目文件。
• doc: 存放项目文档，包括设计介绍和使用说明。
• src: 源代码目录，包含FPGA核心的Verilog实现。
• LICENSE: 项目使用的Apache-2.0协议许可文件。
• README.md: 项目描述文件，介绍了项目的目的、使用方法和贡献者信息。

每个目录下的文件都是为了项目的开发和使用提供必要的资源和支持。

2. 项目的启动文件介绍

项目的启动主要涉及到src目录下的以下文件：

• usb_hid_host.v: 这是FPGA核心的主要Verilog文件，定义了USB HID主机的核心功能。
• usb_hid_host_rom.v: 包含了用于存储固件的ROM模块的Verilog实现。
• usb_hid_host_rom.hex: 包含了固件的十六进制文件，用于编程FPGA。

对于不同开发板的启动，你需要将上述文件添加到对应的板级项目中。例如，对于 Gowin GW2A FPGA，你只需打开boards/TangNano_20K/usb_hid_proj.gprj文件，并在Gowin IDE中编译项目。

3. 项目的配置文件介绍

项目的配置文件主要涉及到Makefile，用于构建项目。在boards目录下，不同开发板有其对应的Makefile，例如：

• Makefile: 对于使用开源工具链Yosys/nextpnr的开发板（如IceSugar-Pro和Machdyne Schoko），会有一个Makefile来配置和编译项目。

Makefile通常会包含以下配置：

• BOARD: 指定使用的开发板型号。
• TOOLCHAIN: 指定使用的工具链。
• PRJ: 指定项目文件。
• SRC: 指定源文件目录。
• INC: 指定头文件目录。
• LIB: 指定库文件。

Makefile会使用这些变量来运行相应的命令，编译源代码，并将结果编程到FPGA上。

使用Makefile编译项目通常需要以下命令：

make

该命令会根据Makefile中的规则进行项目的构建。

通过以上介绍，开发者可以快速了解如何使用本项目，并根据自身需求进行相应的配置和启动。