FPGA 与数字 IC 设计 / 系统课时

跑通 FPGA 综合、实现与下载

跑通 FPGA 综合、实现与下载

这一节用“拨动开关直接驱动 LED”的最小工程,把 Verilog 源码真正送到 FPGA 上运行。你将完成综合、实现、位流生成和 JTAG 下载,并用板上现象确认工具链、器件选择与引脚约束形成完整闭环。

学习目标

  • 能区分综合、实现、位流生成和下载各阶段的职责
  • 能用 Vivado Tcl 脚本构建最小板级工程并生成 .bit 文件
  • 能通过 JTAG 下载位流,并用开关与 LED 联动完成硬件验收

先确认板卡参数

下面以 AMD/Xilinx Vivado 命令行流程为例,避免依赖具体版本的图形界面。开始前需要从开发板原理图或官方约束文件确认四个值:FPGA 器件型号、开关对应的封装引脚、LED 对应的封装引脚,以及所在 I/O Bank 允许使用的 I/O 电平标准。

本节只验证通过 JTAG 把易失性位流写入 FPGA。断电后配置通常会丢失;如果需要上电自动加载,还要另外配置板载 Flash,这不属于本节范围。

建立最小硬件逻辑

创建 top.v。逻辑只做一件事:把输入开关 sw 的电平直接送到输出 led,这样下载后不需要时钟就能观察结果。

verilog
module top (
    input  wire sw,
    output wire led
);
    // 最小组合逻辑用于验证从 RTL 到真实 I/O 的完整链路。
    assign led = sw;
endmodule

预期结果:综合后只有一条从 sw 到 led 的组合逻辑通路;下载到板卡后,LED 的逻辑电平应随开关同步变化。若开发板 LED 为低电平点亮,视觉上的亮灭状态会与逻辑电平相反,需要以原理图为准。

用脚本完成综合与实现

Vivado 的典型硬件链路是:RTL 先经过综合得到网表,再经过优化、布局和布线形成可映射到器件资源上的实现结果,随后生成位流,最后经 JTAG 写入 FPGA。几个阶段前后依赖,流程图能更直观地说明每一步的产物和验收点。

FPGA 从 RTL 到板级验证的构建与下载流程

创建 build.tcl。脚本从命令行接收开发板参数,在工程目录生成最小 XDC 约束,然后依次执行综合、优化、布局、布线和位流生成。这里必须使用 Tcl 的有效子命令 file normalize 规范化路径,不能写成不存在的 file nze。

tcl
if {$argc != 4} {
    puts "usage: vivado -mode batch -source build.tcl -tclargs <FPGA_PART> <SW_PIN> <LED_PIN> <IOSTANDARD>"
    exit 2
}

set part        [lindex $argv 0]
set sw_pin      [lindex $argv 1]
set led_pin     [lindex $argv 2]
set io_standard [lindex $argv 3]

create_project -force min_fpga build -part $part
add_files [file normalize "top.v"]
set_property top top [current_fileset]

# 根据板卡参数生成约束,避免把示例中的假想管脚误用到真实硬件。
set xdc_path [file normalize "build/board.xdc"]
set fd [open $xdc_path "w"]
puts $fd "set_property PACKAGE_PIN $sw_pin \[get_ports sw\]"
puts $fd "set_property PACKAGE_PIN $led_pin \[get_ports led\]"
puts $fd "set_property IOSTANDARD $io_standard \[get_ports {sw led}\]"
close $fd

add_files -fileset constrs_1 $xdc_path
update_compile_order -fileset sources_1

synth_design -top top -part $part
opt_design
place_design
route_design

# 位流生成成功才算实现链路真正跑通。
report_timing_summary -file [file normalize "build/timing.rpt"]
write_bitstream -force [file normalize "build/top.bit"]
puts "BITSTREAM_OK"

把占位值替换为开发板官方资料中的真实参数后,在已配置 Vivado 环境变量的终端执行。占位值放在引号内,避免 <、> 被 Shell 当作重定向符号。

bash
FPGA_PART="<FPGA_PART>"
SW_PIN="<SW_PIN>"
LED_PIN="<LED_PIN>"
IOSTANDARD="<IOSTANDARD>"

vivado -mode batch -source build.tcl   -tclargs "$FPGA_PART" "$SW_PIN" "$LED_PIN" "$IOSTANDARD"

预期输出

text
...
BITSTREAM_OK

同时应生成 <PATH>/build/top.bit 和 <PATH>/build/timing.rpt。Vivado 版本不同,前面的日志内容会变化;本节只把 BITSTREAM_OK、位流文件存在以及实现阶段无关键错误作为构建成功的稳定判据。

下载位流并验收硬件

连接开发板的供电和 JTAG/USB 线缆,确认系统能识别下载器。创建 program.tcl。脚本默认选择 JTAG 链上的第一个 FPGA 设备;如果链上有多个器件,应改成按器件属性筛选,不能盲目使用第一个设备。

tcl
open_hw_manager
connect_hw_server
open_hw_target

set devices [get_hw_devices]
if {[llength $devices] < 1} {
    puts "NO_HW_DEVICE"
    close_hw_manager
    exit 3
}

set bitstream [file normalize "build/top.bit"]
if {![file exists $bitstream]} {
    puts "BITSTREAM_NOT_FOUND"
    close_hw_manager
    exit 4
}

set dev [lindex $devices 0]
current_hw_device $dev
refresh_hw_device $dev

# PROGRAM.FILE 必须指向刚刚生成的位流。
set_property PROGRAM.FILE $bitstream $dev
program_hw_devices $dev

puts "PROGRAM_OK"
close_hw_manager

执行下载:

bash
vivado -mode batch -source program.tcl

预期输出

text
...
PROGRAM_OK

程序成功返回后,拨动被约束到 sw 的实体开关。预期结果是对应 led 的逻辑电平随输入同步改变;如果终端显示 PROGRAM_OK 但 LED 没反应,说明“下载链路已通”不等于“板级功能正确”,此时应依次核对 XDC 管脚、I/O 标准、LED 有效电平以及是否选中了正确器件。

如何判断工具链真的跑通

一次完整验收至少要同时满足三个条件:实现阶段无关键错误并生成 top.bit,JTAG 编程命令成功结束,真实板卡上的 LED 能随开关变化。只看到位流文件不能证明下载成功,只看到下载成功日志也不能证明约束和 RTL 与板级硬件对应正确。

如果综合报端口或语法错误,问题还在 RTL;如果布局布线阶段报无法放置或 I/O 约束冲突,重点检查器件与 XDC;如果出现 NO_HW_DEVICE,优先检查供电、线缆、驱动和 JTAG;如果出现 BITSTREAM_NOT_FOUND,先确认构建目录和当前工作目录;如果下载成功但板上现象错误,则回到端口映射和有效电平检查。按阶段定位,比反复修改代码更快找到根因。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

跑通 FPGA 综合、实现与下载

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通