3. 开发环境搭建与工程准备：Quartus Prime Pro安装与许可配置、Agilex器件库安装、创建第一个空白工程
在开始Agilex嵌入式逻辑分析仪的实战之前，必须首先搭建一套完整、稳定的开发环境。本章将引导你完成从工具链安装、许可配置到创建第一个空白工程的完整流程。环境搭建的规范性直接影响后续调试效率，请务必按步骤操作。
3.1 Quartus Prime Pro 安装与许可配置
Agilex系列器件仅支持Quartus Prime Pro Edition（标准版与精简版不支持）。请从Intel官网下载最新版本的安装包（当前推荐版本为23.4或更高）。
3.1.1 系统要求与安装步骤
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10 64-bit / RHEL 8.x | Windows 11 64-bit / RHEL 9.x |
| 内存 | 16 GB | 32 GB 或更高 |
| 磁盘空间 | 80 GB（仅工具） | 200 GB（含器件库与工程） |
| CPU核心数 | 4核 | 8核或以上 |
- 下载安装包：访问
https://www.intel.com/content/www/us/en/software/programmable/quartus-prime/download.html，选择 Quartus Prime Pro Edition 版本。 - 运行安装程序：以管理员身份运行
setup.exe（Windows）或setup.sh（Linux）。 - 选择组件：在组件选择界面，至少勾选以下项：
- Quartus Prime Pro Edition
- Device Libraries（后续可单独添加）
- Signal Tap Logic Analyzer（默认包含）
- 完成安装：等待安装完成，默认安装路径为
C:\intelFPGA_pro\23.4（Windows）或/opt/intelFPGA_pro/23.4（Linux）。
提示：安装路径中不要包含中文字符或空格，否则可能导致部分Tcl脚本执行异常。
3.1.2 许可配置
Quartus Prime Pro需要有效的License文件才能启用完整功能。Agilex器件属于高端系列，通常需要Subscription Edition License。
- 获取License文件：从Intel FPGA Licensing Center申请或购买。将License文件保存到本地，例如
C:\licenses\license.dat。 - 配置环境变量：
- Windows：系统环境变量 → 新建
LM_LICENSE_FILE，值设为License文件路径。 - Linux：在
.bashrc中添加export LM_LICENSE_FILE=/opt/licenses/license.dat。
- Windows：系统环境变量 → 新建
- 验证许可：打开Quartus Prime Pro，点击 Tools → License Setup，确认License类型与到期日期正确显示。
常见问题：如果提示“No license for this feature”，请检查环境变量是否生效，以及License文件是否包含Agilex器件支持（Feature: quartus_pro）。
3.2 Agilex器件库安装
Agilex器件库需要单独安装或通过Quartus Prime的组件管理工具添加。器件库包含综合、布局布线所需的工艺信息与时序模型。
3.2.1 安装方式对比
| 安装方式 | 适用场景 | 操作复杂度 | 磁盘占用 |
|---|---|---|---|
| 在线安装（通过Quartus Prime） | 网络良好，首次安装 | 低 | 约15 GB |
| 离线安装包 | 无网络环境或批量部署 | 中 | 约15 GB |
| 自定义组件选择 | 仅需特定Agilex子系列 | 低 | 按需（5~10 GB） |
3.2.2 在线安装步骤
- 打开Quartus Prime Pro，点击 Tools → Install Devices。
- 在器件列表中找到 Agilex 7 系列（包含F-Tile、R-Tile、E-Tile等变体）。
- 勾选所需子系列（建议全选以覆盖所有实验场景）。
- 点击 Install，等待下载与安装完成。
提示：安装完成后，可在 Assignments → Device 中确认器件列表是否出现
AGFB014R24C2E2V 等Agilex 7型号。
3.3 创建第一个空白工程
空白工程是后续所有实验的基础。我们将创建一个针对Agilex 7器件的空工程，并配置基本的工程属性。
3.3.1 工程创建流程
- 启动New Project Wizard：File → New Project Wizard。
- 设置工程目录与名称：
- 工程目录：
C:\Agilex_Lab\Lab01_Blank - 工程名称：
Lab01_Blank - 顶层实体：
top
- 工程目录：
- 添加设计文件：暂时不添加，直接点击 Next。
- 选择器件：
- Family：Agilex 7
- Device：AGFB014R24C2E2V（或根据实际板卡选择）
- 选择EDA工具：保持默认（ModelSim/Questa），点击 Next。
- 完成创建：点击 Finish。
关键检查点：创建完成后，在工程导航栏中应看到
top 作为顶层实体，且器件型号正确显示。如果器件型号显示为“None”，请返回检查器件库是否安装成功。
3.3.2 工程结构验证
创建完成后，工程目录下会自动生成以下文件结构：
Lab01_Blank/
├── Lab01_Blank.qpf # Quartus Prime工程文件
├── Lab01_Blank.qsf # 工程设置文件（器件、约束等）
├── Lab01_Blank.sdc # 时序约束文件（初始为空）
├── output_files/ # 编译输出目录
├── db/ # 数据库目录
└── incremental_db/ # 增量编译数据库
提示：
.qsf 文件是工程的核心配置文件，后续添加引脚分配、时序约束等操作都会写入此文件。建议定期备份。
3.4 开发环境架构总览
下图展示了从Quartus Prime安装到Agilex器件调试的完整工具链架构，帮助你理解各组件之间的关系。
3.5 环境验证清单
完成上述步骤后，请对照以下清单逐项确认，确保环境准备无误：
| 检查项 | 验证方法 | 预期结果 |
|---|---|---|
| Quartus Prime Pro 启动 | 双击桌面图标或运行 quartus |
正常显示主界面，无报错 |
| License 状态 | Tools → License Setup | 显示“Licensed”且到期日期有效 |
| Agilex 器件库 | Assignments → Device → Family 下拉 | 可看到“Agilex 7”系列 |
| 空白工程编译 | Processing → Start Compilation | 编译通过，无错误 |
| Signal Tap 可用性 | Tools → Signal Tap Logic Analyzer | 正常打开调试窗口 |
注意：如果空白工程编译失败，请检查工程设置中的器件型号是否与实际安装的器件库匹配。例如，
AGFB014R24C2E2V 属于 Agilex 7 F-Series，需要确保已安装对应的 F-Tile 支持。
3.6 常见问题与解决
- 问题1：安装过程中提示“无法找到器件库”
- 原因：安装时未勾选Agilex器件库。
- 解决：重新运行安装程序，选择 Modify 并添加器件库。
- 问题2：License报错“Feature: quartus_pro”
- 原因：License文件不包含Pro Edition支持。
- 解决：联系Intel FAE或代理商获取正确的License。
- 问题3：Signal Tap无法识别JTAG链
- 原因：未安装USB Blaster驱动或驱动版本过旧。
- 解决：从Intel官网下载并安装 Quartus Prime Programmer and Tools 驱动包。