Quartus中如何配置编译设置生成SOF文件？

Question

在使用Quartus Prime进行FPGA开发时，如何正确配置编译设置以生成SOF（Serial Object File）编程文件是关键步骤。常见问题为：尽管设计已成功综合与布局布线，但未生成SOF文件，导致无法进行器件编程。该问题通常源于编译设置中未启用“Programming File”生成选项。用户需在“Assignments” → “Device” → “Device and Pin Options”中确认配置模式（如AS、JTAG等），并在“File” → “Convert Programming Files”中选择.SOF格式并配置正确的输出路径。此外，确保顶层设计实体正确指定，并在“Project Settings”中将目标器件与实际硬件匹配。若忽略这些设置，Quartus可能默认不生成SOF文件，从而影响后续下载与调试流程。

Answer 1

一、Quartus Prime中SOF文件生成机制概述

在使用Quartus Prime进行FPGA开发时，Serial Object File（SOF）是用于通过JTAG或AS模式对Altera/Intel FPGA器件进行编程的关键输出文件。尽管设计能够成功完成综合（Synthesis）、适配（Fitting）与时序分析，但若未正确配置编译流程，系统可能不会自动生成SOF文件。

该现象常出现在项目迁移、模板复用或新用户配置过程中，根本原因多为未显式启用编程文件生成功能或忽略了配置模式设置。

以下是SOF生成的核心依赖要素：

1. 顶层设计实体（Top-level Entity）正确指定
2. 目标器件型号与硬件一致
3. 配置模式（Configuration Mode）已设定（如JTAG、Active Serial等）
4. “Convert Programming Files”任务已执行并选择.SOF格式
5. 输出路径配置正确且可写

二、常见问题诊断流程

当发现编译完成后工程目录下缺失.sof文件时，应按以下顺序排查：

检查项	位置路径	预期设置
顶层设计名称	Assignments → Settings → General	与实际HDL顶层模块名完全一致
目标器件型号	Assignments → Device	与开发板FPGA型号匹配（如5CSEMA4U23C6）
配置模式	Device and Pin Options → Configuration	根据下载方式选择JTAG或AS模式
SOF生成开关	Project Navigator右键点击“Generate Functional/Timing Netlist”之外需手动触发	无自动勾选，必须手动操作

三、SOF文件生成的完整操作步骤

为确保SOF文件被正确生成，请遵循以下标准流程：

步骤 1: 完成全编译（Full Compilation）
    → Processing → Start → Start Analysis & Synthesis
    → 后续自动进入Fitter、Assembler阶段

步骤 2: 配置设备选项
    → Assignments → Device → Device and Pin Options
        → Configuration页签：
            • Configuration mode: JTAG 或 AS
            • Configuration device: EPCSxx 或无需设置
            • Enable Bitstream Compression: 可选开启

步骤 3: 转换编程文件
    → File → Convert Programming Files
        → Programming file type:选择 "Serial Flash .sof (.sof)"
        → Add Device: 添加当前工程器件
        → Specify programming file name: 设置输出路径及文件名
        → 点击“Generate”按钮
    

四、自动化集成建议与高级配置

对于具备5年以上经验的工程师，在CI/CD流水线或批量部署场景中，推荐结合QSF脚本化配置提升可重复性：

# 在.qsf项目文件中添加如下语句以预设配置
set_global_assignment -name USE_CONFIGURATION_DEVICE ON
set_global_assignment -name CONFIGURATION_MODE "JTAG"
set_instance_assignment -name RESERVE_NCEO_AFTER_CONFIGURATION "USE AS REGULAR IO"
    

此外，可通过Tcl脚本实现一键生成SOF：

execute_module -tool cpf -args "-c sof_output.cof"
    

五、典型错误案例与调试策略

以下是实践中高频出现的问题实例：

• 错误1： 编译日志显示“Assembler completed successfully”，但output_directory无.sof
• 原因： 用户误以为Assembler阶段会自动生成SOF，实则需单独调用CPF工具
• 错误2： CPF提示“Invalid top-level entity”
• 原因： QSF中get_global_assignment -name TOP_LEVEL_ENTITY 与实际不符
• 错误3： SOF生成后无法下载
• 原因： 配置模式设为AS但硬件跳线处于JTAG模式

六、可视化流程图：SOF生成决策路径

graph TD
            A[启动Quartus Prime工程] --> B{顶层设计正确?}
            B -->|是| C[运行全编译流程]
            B -->|否| D[修正Top Entity并更新QSF]
            C --> E{Device和Pin Options已配置?}
            E -->|是| F[打开Convert Programming Files]
            E -->|否| G[设置Configuration Mode]
            F --> H[选择SOF格式并生成]
            H --> I[SOF文件输出至指定路径]
            I --> J[可用于Programmer工具烧录]