quartus新建工程文件说明以及如何修改工程文件名

ps：以下例子使用Quartus Prime Edition 18.0版本，其他版本不排除有一些例外情况；

一、工程文件说明

1、当我们新建一个工程时，跟工程目录以及工程顶层模块的选项卡如下

说明：这里需要区分两个概念，文件名称，以及模块名称；一般而言，我们新建设计文件（如.v或者.sv文件），文件的命名以及文件内部书写的模块名是一致的，例如

为文件名称；

为模块名称；

文件名称和模块名称可以是不同的，一个.v或者.sv文件内部也可以有好几个module；

上图中定义的顶层模块的名字实际上定义的是模块名称；

2、新建工程完毕，如下

此时对应的文件夹生成文件如下

说明：

.qpf文件：全称：Quartus Project File，是 Quartus 工程的主项目文件，里面记录了Quartus使用的版本以及工程的建立时间，还有使用的project_revision，如下

.qsf文件：全称：Quartus Settings File，是存储工程的所有设置和约束信息的文件，包括有目标器件型号、引脚分配、时序约束、综合与布局布线选项、添加的源文件列表、第三方工具路径等；是文本文件，采用Tcl脚本语法；可手动编辑（如引脚分配等；

qdb文件夹：是Quartus 在编译（Compilation）过程中生成的中间数据库文件存放目录；

3、更改顶层模块名称

建立工程选项卡的时候设置了工程顶层模块名称，此名称需要和set as top的模块名称一致（注意不是文件名称，而是模块名称，一般情况下两者相同，比如，我添加了文件

并且文件内的模块名称和文件名称一致，也是

把该文件（实际为该文件内的模块）设置为顶层模块，如下

可以看到顶层模块名称变为设置的文件名

此时编译才能成功；如果文件名称和文件内的模块名称不一致，比如上面的例子，如果改为

编译工程的时候会显示

就是匹配不上顶层模块名导致的；

二、如何修改工程文件名

1、点击project中的revisions，如下

2、打开如下

可以看到选项和我们前面设置的一样，点击new revision

3、点击new revision如下

4、新生成的文件如下

可以看到新生成了3个文件，我们逐一看下

register.qsf：和前面的intel_pro_prj.qsf一样，记录了约束文件；

register_description.txt：为刚才的描述文件，如下

此时打开刚才的revision，可以看到如下信息

intel_pro_prj.qws：全称：Quartus Workspace File，作用是保存 当前工程窗口的 UI 状态和工作区布局，与 Revision 密切相关，本质上是一个 XML 格式的配置文件，记录你当前打开的是哪个 Revision、哪些窗口（如 RTL Viewer、Messages、Project Navigator）是展开的、窗口大小、位置等。

如果此时你切换回intel_pro_prj，如下

或者直接这里进行切换

可以看到生成的文件变成了

我们看回原先的旧文件intel_pro_prj.qpf

可以看到文件内产生了变化

有了两个PROJECT_REVISION；

到这里，相信对文件结构也比较清晰了，我们可以选择保留这两个PROJECT_REVISION，也可以选择把名字改掉；如下

5、把revision删除

可以看到原先的intel_pro_prj.qpf变成下面这样

换句话说直接修改intel_pro_prj.qpf文件也一样，也就是GUI修改方式以及“文件/脚本修改方式“都能达到同样的目的；

并且intel_pro_prj.qsf文件也删除了（对应revision的setting文件删除）

6、把文件名修改，如下

笔者修改如下

可以看到，这样我们对工程名字的修改就完成了

如果涉及到rtl代码中文件名称的修改，就需要手动修改文件名称以及文件内部模块的名称，并且在文件管理那里把旧的文件删除再添加新的修改完毕的文件了；

总结

以上方法为笔者在查找网上相关方法以及借助AI工具问询得到的，如果有错误或者更好的方法，欢迎交流。