4. 开发环境搭建:Quartus Prime Pro Edition安装、Agilex器件库配置、License设置、ModelSim/QuestaSim仿真器集成

本章将系统讲解基于 Intel Agilex FPGA 的完整开发环境搭建流程。一个正确配置的开发环境是高效进行 Agilex 项目开发的基础,涉及 Quartus Prime Pro Edition 软件安装、Agilex 专属器件库配置、License 授权管理以及仿真器集成四个核心环节。以下步骤均以 Windows 10/11 64 位系统为例,Linux 环境(Red Hat Enterprise Linux 7/8)操作逻辑类似,仅路径与包管理器不同。

环境要求速览: 建议主机至少配备 16 GB 内存、50 GB 可用磁盘空间(SSD 优先)、支持 OpenGL 3.0 的独立显卡。Quartus Prime Pro Edition 21.3 及以上版本原生支持 Agilex 7 系列。

4.1 Quartus Prime Pro Edition 安装流程

Quartus Prime Pro Edition 是 Intel 针对高端 FPGA(包括 Agilex、Stratix 10、Arria 10)提供的旗舰级开发套件。安装过程需严格遵循以下步骤:

  1. 获取安装包: 登录 Intel FPGA 下载中心,选择 Quartus Prime Pro Edition 版本。推荐下载 Combined Files(包含所有器件支持)或 Separate Files(按需选择 Agilex 器件包)。
  2. 运行安装程序: 以管理员身份运行 setup.exe。在安装类型界面选择 “Quartus Prime Pro Edition”,并勾选 “Device” 下的 Agilex 7 系列(如 AGFB、AGIB、AGMB 等)。
  3. 选择附加工具: 在组件选择界面,务必勾选以下核心工具:
    • ModelSim Intel FPGA Edition(免费版,支持 VHDL/Verilog 仿真)
    • QuestaSim Intel FPGA Edition(高级版,性能更优,需额外 License)
    • Quartus Prime Help(离线文档)
  4. 配置安装路径: 建议使用默认路径(如 C:\intelFPGA_pro\23.3),避免包含中文字符或空格。路径总长度建议不超过 80 个字符。
  5. 完成安装: 安装过程约需 30-60 分钟,取决于磁盘性能。安装完成后,重启系统以确保环境变量生效。
安装验证: 打开命令提示符,输入 quartus --version,若返回版本号(如 “Quartus Prime Pro Edition Version 23.3.0 Build 123 12/12/2023 SJ Pro Edition”),则安装成功。

4.2 Agilex 器件库配置

Agilex 器件库并非随 Quartus 主程序自动完整安装,需要单独下载并配置。器件库包含逻辑单元、DSP、存储器、I/O 以及 Hard Processor System (HPS) 的时序与物理模型。

器件系列 器件库名称 安装包大小(约) 关键特性
Agilex 7 (F-Series) agilex7_f 2.8 GB 通用逻辑、AI 推理、网络加速
Agilex 7 (I-Series) agilex7_i 3.1 GB 高带宽存储器 (HBM2e)、数据密集型
Agilex 7 (M-Series) agilex7_m 3.5 GB 最大逻辑密度、最高 DSP 性能
Agilex 5 (D-Series) agilex5_d 2.2 GB 中端、低功耗、AI 优化

配置步骤:

  1. 从 Intel 官网下载对应器件库的 .qdz 文件(如 agilex7_f.qdz)。
  2. 将 .qdz 文件放置于 Quartus 安装目录下的 devices 文件夹(如 C:\intelFPGA_pro\23.3\devices)。
  3. 启动 Quartus Prime Pro Edition,点击 Tools → Install Devices。
  4. 在弹出的对话框中,选择 “Install from local directory”,浏览至 devices 文件夹,选中对应的 .qdz 文件。
  5. 点击 “Install”,等待解压与索引完成。安装完成后,在新建项目时即可在 Device 列表中找到 Agilex 7 或 Agilex 5 系列。
常见错误: 若新建项目时 Device 列表为空,请检查 devices 目录下是否存在 agilex7_f 等子文件夹,并确认环境变量 QUARTUS_ROOTDIR 指向正确的安装路径。
Agilex 器件库配置流程 下载 .qdz 文件 Intel 官网获取 放置到 devices 目录 C:\intelFPGA_pro\23.3\devices Install Devices Tools 菜单启动 选择 .qdz 本地浏览 安装完成 重启 Quartus 提示 确保磁盘空间 > 5 GB

4.3 License 设置

Intel Quartus Prime Pro Edition 采用浮动 License 机制。Agilex 器件开发通常需要 Quartus Prime Pro Edition Subscription License 或 Node-Locked License。License 设置正确与否直接决定软件能否正常编译与综合。

License 类型对比:

License 类型 适用场景 配置方式 优点 缺点
Node-Locked (单机) 个人开发、固定工作站 环境变量 LM_LICENSE_FILE 指向 .dat 文件 无需网络、稳定 无法迁移
Floating (浮动) 团队协作、多用户共享 环境变量指向 port@server(如 27000@lic-server) 灵活、集中管理 依赖网络与 License Server
Subscription (订阅) 企业级、长期项目 Intel 官网生成,绑定 MAC 地址 包含所有 IP 核 年费较高

配置步骤(以 Node-Locked 为例):

  1. 从 Intel FPGA Licensing Center 获取 license.dat 文件,确保文件中的 HOSTID 与本地网卡 MAC 地址一致。
  2. 将 license.dat 放置于非中文路径(如 C:\flexlm\license.dat)。
  3. 设置系统环境变量:
    • 变量名:LM_LICENSE_FILE
    • 变量值:C:\flexlm\license.dat
  4. 启动 Quartus Prime Pro Edition,点击 Tools → License Setup,确认 “Licensed Features” 列表中包含 “Quartus Prime Pro Edition” 且状态为 “Available”。
验证 License: 在 Quartus 中打开任意 Agilex 项目,尝试运行 Analysis & Synthesis。若编译正常启动且无 License 报错,则配置成功。常见错误 “License for feature QUARTUS_PRO is not available” 通常由环境变量路径错误或 MAC 地址不匹配引起。

4.4 ModelSim / QuestaSim 仿真器集成

仿真验证是 FPGA 开发的核心环节。Quartus Prime Pro Edition 支持两种仿真器:ModelSim Intel FPGA Edition(免费,功能基础)和 QuestaSim Intel FPGA Edition(付费,支持 SystemVerilog UVM、覆盖率驱动验证)。两者均可在 Quartus 内部自动调用,也可独立运行。

集成步骤:

  1. 安装仿真器: 在 Quartus 安装过程中勾选 “ModelSim Intel FPGA Edition” 或 “QuestaSim Intel FPGA Edition”。安装完成后,仿真器位于 C:\intelFPGA_pro\23.3\modelsim_ase(ModelSim)或 C:\intelFPGA_pro\23.3\questa(QuestaSim)。
  2. 配置仿真库: 首次使用前,需编译 Agilex 器件仿真库。在 Quartus 中点击 Tools → Launch Simulation Library Compiler,选择仿真器类型(ModelSim/QuestaSim),指定输出目录(如 C:\sim_lib\agilex7),点击 “Start Compilation”。编译约需 10-20 分钟。
  3. 设置仿真器路径: 在 Quartus 中点击 Assignments → Settings → EDA Tool Settings → Simulation,选择 “ModelSim Intel FPGA” 或 “QuestaSim Intel FPGA”,并指定安装路径。
  4. 生成仿真脚本: 在项目编译完成后,点击 Processing → Start → Start Test Bench Template Writer,Quartus 会自动生成 .do(ModelSim)或 .tcl(QuestaSim)仿真脚本。
仿真启动命令: 在 ModelSim 命令窗口执行 do run_simulation.do 即可启动仿真。若需手动启动,使用 vsim -L agilex7_f -t 1ps work.testbench 加载 Agilex 器件库。
仿真器集成架构 Quartus Prime Pro Edition 仿真库编译器 编译 Agilex 器件库 Test Bench 模板 生成 .do / .tcl 脚本 EDA 工具设置 指定仿真器路径 ModelSim / QuestaSim 仿真波形输出 仿真库预编译 必须步骤

4.5 环境验证与常见问题

完成上述所有配置后,建议执行一次完整的 “创建项目 → 综合 → 仿真” 流程来验证环境。以下为常见问题及解决方案:

问题现象 可能原因 解决方案
Quartus 启动报错 “Cannot find license file” 环境变量 LM_LICENSE_FILE 未设置或路径错误 检查系统环境变量,确保指向正确的 .dat 文件或 port@server
新建项目时 Device 列表为空 Agilex 器件库未安装或索引未更新 重新运行 Install Devices,或手动删除 devices 下的 .qdz 缓存文件后重试
仿真报错 “Failed to find library agilex7_f” 仿真库未编译或路径未指定 运行 Simulation Library Compiler,并在仿真脚本中使用 -L agilex7_f
ModelSim 无法启动 安装路径包含空格或中文,或缺少 VC++ 运行库 重新安装 ModelSim 到纯英文路径,并安装 Microsoft Visual C++ Redistributable
重要提醒: 所有环境变量设置后,必须 重新启动 Quartus Prime Pro Edition 才能生效。对于浮动 License,请确保客户端与 License Server 之间的 27000-27009 端口未被防火墙阻断。