AGM Supra软件从零到一：国产CPLD工程创建全流程拆解

1. 认识AGM Supra与CPLD开发环境第一次接触AGM Supra软件的朋友可能会觉得陌生其实它就像我们熟悉的Quartus一样是专门用于CPLD/FPGA开发的工具链。我刚开始用Supra时也走过弯路后来发现只要掌握几个关键点就能快速上手。这里以AG1280Q48器件为例带大家走通整个开发流程。Supra最大的特点是对国产CPLD的深度支持。与Quartus相比它的工程转换功能特别实用——既可以直接创建新项目也能将现有Quartus工程无缝转换。实测下来软件运行非常稳定但有个致命细节安装路径绝对不能包含中文。我有次偷懒把软件放在桌面/测试目录下结果转换工程时各种报错排查半天才发现是这个原因。开发环境准备其实很简单官方提供的Supra软件包2022.6.21版本实测稳定Quartus Prime基础版建议18.1以上版本一台Windows系统的电脑暂不支持Mac和Linux软件下载要注意区分32位和64位版本。解压后直接运行bin目录下的Supra.exe即可不需要安装过程。这里有个小技巧建议把软件放在C盘根目录如C:\AGM_Tools这样的纯英文路径能避免90%的路径相关问题。2. 创建第一个CPLD工程打开Supra后界面非常简洁主要分为上方的操作区和下方的信息输出区。点击File→Project→New Project会弹出工程创建窗口。这里要特别注意工程路径建议新建专用目录如D:\CPLD_Projects\demo1工程名称最好用英文数字组合比如led_blink创建成功后信息区会显示工程路径和名称。此时工程目录下会生成.proj后缀的工程文件相当于Quartus的.qpf文件。之后要打开工程只需双击这个文件或在Supra中选择Open Project。我建议在工程目录下建立清晰的子目录结构project_root/ ├── src/ # 存放Verilog/VHDL代码 ├── tcl/ # 存放脚本文件 └── output/ # 生成文件输出目录3. Quartus项目转换的关键步骤在Tool菜单选择Migrate会进入核心功能——Quartus项目转换。这里有两种情况需要区分3.1 新建Quartus项目适合从零开始的开发者操作流程选择Create New Quartus Project填写项目名称如led_controller选择器件型号AG1280Q48点击Next自动生成工程框架生成后会在工程目录看到这些关键文件.qpfQuartus工程文件.qsfQuartus设置文件.v空的Verilog模板文件3.2 导入现有Quartus项目已有成熟项目时更高效的做法选择Import Existing Quartus Project指定原工程路径必须全英文选择目标器件型号关键点源路径和目标路径不能相同我遇到过的一个典型错误是直接导入桌面上的Quartus工程。由于Windows桌面路径包含中文用户名导致转换失败。正确做法是先把工程复制到英文路径再导入。4. TCL脚本执行与工程编译完成项目转换后最关键的步骤是运行TCL脚本打开Tool→Tcl Scripts界面选择project/af_quartus.tcl脚本点击Run等待自动执行这个阶段常见问题脚本窗口闪退通常是路径包含中文或特殊字符综合失败检查器件型号是否选择正确时序违例可能需要调整时钟约束成功运行后会弹出完成提示此时点击Next进入最终编译。编译过程可能会花费几分钟取决于工程复杂度。看到绿色的Compile Success就大功告成了。5. 烧写与调试技巧虽然本文不深入讲解烧写细节但有几点实用建议通过Tool→Program打开烧写界面生成的.pof文件在output目录下如果修改代码后需要重新编译直接使用Tool→Compile快捷方式调试时我发现一个很有用的技巧在Supra的信息输出窗口右键可以保存日志。当遇到诡异问题时这些日志能帮助快速定位原因。比如有次综合失败查看日志发现是某个信号名与保留字冲突。6. 避坑指南与经验分享根据我的实战经验新手最容易踩的坑有中文路径问题不仅软件本身所有相关工程文件路径都要全英文器件型号选择AG1280Q48有多个封装版本要选对具体型号脚本执行顺序必须先运行af_quartus.tcl再编译代码风格避免使用Quartus特有的语法糖有个特别隐蔽的问题如果电脑用户名是中文即使安装路径全英文也可能报错。这时可以尝试在系统新建英文用户账户。另外建议关闭杀毒软件实时监控有时会影响编译过程。最后分享一个效率技巧把常用的TCL命令写成脚本批量执行。比如我常用的初始化脚本包含project_new my_project -overwrite set_global_assignment -name DEVICE AG1280Q48 source ./src/constraints.sdc刚开始可能会觉得步骤繁琐但熟悉流程后从创建工程到烧写器件整个过程不超过10分钟。AGM Supra虽然不如Quartus功能丰富但对国产CPLD的支持确实做得非常到位。