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自动生成工程框架
生成后会在工程目录看到这些关键文件：
.qpf：Quartus工程文件.qsf：Quartus设置文件.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的支持确实做得非常到位。