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,这样下载后不需要时钟就能观察结果。
module top (
input wire sw,
output wire led
);
// 最小组合逻辑用于验证从 RTL 到真实 I/O 的完整链路。
assign led = sw;
endmodule预期结果:综合后只有一条从 sw 到 led 的组合逻辑通路;下载到板卡后,LED 的逻辑电平应随开关同步变化。若开发板 LED 为低电平点亮,视觉上的亮灭状态会与逻辑电平相反,需要以原理图为准。
用脚本完成综合与实现
Vivado 的典型硬件链路是:RTL 先经过综合得到网表,再经过优化、布局和布线形成可映射到器件资源上的实现结果,随后生成位流,最后经 JTAG 写入 FPGA。几个阶段前后依赖,流程图能更直观地说明每一步的产物和验收点。

创建 build.tcl。脚本从命令行接收开发板参数,在工程目录生成最小 XDC 约束,然后依次执行综合、优化、布局、布线和位流生成。这里必须使用 Tcl 的有效子命令 file normalize 规范化路径,不能写成不存在的 file nze。
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 当作重定向符号。
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"预期输出
...
BITSTREAM_OK同时应生成 <PATH>/build/top.bit 和 <PATH>/build/timing.rpt。Vivado 版本不同,前面的日志内容会变化;本节只把 BITSTREAM_OK、位流文件存在以及实现阶段无关键错误作为构建成功的稳定判据。
下载位流并验收硬件
连接开发板的供电和 JTAG/USB 线缆,确认系统能识别下载器。创建 program.tcl。脚本默认选择 JTAG 链上的第一个 FPGA 设备;如果链上有多个器件,应改成按器件属性筛选,不能盲目使用第一个设备。
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执行下载:
vivado -mode batch -source program.tcl预期输出
...
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,先确认构建目录和当前工作目录;如果下载成功但板上现象错误,则回到端口映射和有效电平检查。按阶段定位,比反复修改代码更快找到根因。