新手避坑指南：用Vitis给Ultra96-V2开发板跑通第一个裸机程序-开发者社区

Ultra96-V2开发板裸机程序开发避坑指南

第一次拿到Ultra96-V2开发板时，那种既兴奋又忐忑的心情我至今记忆犹新。作为一款功能强大的FPGA SoC开发平台，它能为嵌入式开发者打开一扇全新的大门，但同时也意味着要面对比传统MCU更复杂的环境配置。记得我第一次尝试在Vitis中运行裸机程序时，整整两天时间都卡在串口输出这一步，那种挫败感让我差点放弃。本文将分享我从无数次失败中总结出的实战经验，帮助新手避开那些最容易踩的坑，快速看到串口输出的"Hello World"。

1. 开发环境准备：别在起点就跌倒

很多教程会直接跳到工程创建步骤，却忽略了环境配置这个最容易出问题的环节。根据我的经验，超过60%的初学者的失败都源于环境配置不当。

1.1 工具链版本选择

Xilinx工具链的版本兼容性是个大坑。对于Ultra96-V2开发板，我强烈推荐使用Vivado/Vitis 2020.1版本。这个版本不仅稳定，而且有最完善的板级支持包(BSP)。我曾尝试使用2021.1版本，结果在生成FSBL时遇到了莫名其妙的错误。

安装时需要注意：

确保安装路径不含中文或空格
安装时勾选"Vitis"和"Device-only"选项
安装完成后运行xilinx_vitis_2020_1_win64.bat设置环境变量

1.2 板级支持包安装

Ultra96-V2需要额外的板级支持文件，这是很多新手忽略的关键步骤：

# 下载板级支持包 git clone https://github.com/Avnet/bdf.git # 将文件复制到Vivado安装目录 cp -r bdf/* ${XILINX_VIVADO}/data/boards/board_files/

验证是否安装成功：

打开Vivado
创建新工程
在"Boards"选项卡中应该能看到"Avnet Ultra96-V2"

2. Vivado工程配置：细节决定成败

2.1 创建基础硬件平台

在Vivado中创建工程时，选择正确的板型至关重要。常见错误包括：

误选"Ultra96 Rev1"（应该是Rev2）
未勾选"Create Block Design"选项

正确的创建流程：

启动Vivado → Create Project
选择"RTL Project"，勾选"Do not specify sources at this time"
在Boards列表中选择"Avnet Ultra96-V2 Rev2"
点击"Create Block Design"创建硬件设计

2.2 配置Zynq UltraScale+ MPSoC

在Block Design中添加Zynq UltraScale+ MPSoC IP后，需要特别注意以下配置：

配置项	推荐值	常见错误值
UART0	启用	禁用(导致无输出)
UART1	启用	未配置正确引脚
SD0	启用	禁用(无法从SD卡启动)
时钟	100MHz	保留默认33.33MHz

关键步骤：

双击Zynq IP进入配置界面
在"PS-PL Configuration" → "PS UART"中启用psu_uart_1
在"Clock Configuration"中设置CPU时钟为100MHz
在"PS DDR Configuration"中确认DDR4参数正确

注意：务必在"Address Editor"中为所有外设分配正确的地址空间，否则后续Vitis工程会报错。

3. Vitis工程配置：避开串口输出的陷阱

3.1 导出硬件平台

从Vivado导出到Vitis时，有两个致命细节经常被忽略：

导出前必须生成Bitstream
导出时要包含.xsa文件和hw_handoff文件夹

正确的导出命令：

# 在Vivado Tcl控制台执行 write_hw_platform -fixed -include_bit -force -file {ultra96v2.xsa}

3.2 创建裸机应用工程

在Vitis中创建应用工程时，新手常犯的错误包括：

选择错误的处理器(应该是psu_cortexa53_0)
未正确设置板级支持包

创建步骤：

File → New → Application Project
选择之前导出的.xsa文件
处理器选择psu_cortexa53_0
模板选择"Hello World"
在"Board Support Package"设置中：
- 启用psu_uart_1
- 设置stdin/stdout为psu_uart_1

3.3 串口配置调试

这是最容易卡住的地方。要确保串口终端正确显示输出，需要检查三个关键点：

板载串口配置：
- Ultra96-V2使用USB转串口芯片FT4232H
- 实际使用的UART是psu_uart_1(不是默认的psu_uart_0)

代码修改：打开src/helloworld.c，修改串口初始化代码：

#include "xparameters.h" int main() { // 确保使用UART1 XUartPs_Config *Config = XUartPs_LookupConfig(XPAR_PSU_UART_1_DEVICE_ID); XUartPs Uart_PS; XUartPs_CfgInitialize(&Uart_PS, Config, Config->BaseAddress); // 设置波特率 XUartPs_SetBaudRate(&Uart_PS, 115200); // 输出测试信息 xil_printf("Hello Ultra96-V2!\r\n"); return 0; }

终端软件设置：
- 波特率：115200
- 数据位：8
- 停止位：1
- 无校验
- 无流控

4. 程序加载与调试：启动模式的选择

4.1 JTAG模式调试

对于初次开发，建议使用JTAG模式，可以实时查看调试信息。常见问题包括：

未安装USB驱动
开发板未正确进入JTAG模式

操作步骤：

将开发板上的启动模式开关设置为JTAG(SW1全部置OFF)
连接USB-JTAG接口(板载的J2接口)
在Vitis中：
- 右键工程 → Debug As → Launch Hardware
- 确保在Debug Configuration中选择了正确的目标

4.2 生成SD卡启动镜像

当程序调试完成后，可以生成SD卡镜像独立运行：

# 在Vitis Tcl控制台执行 exec bootgen -image output.bif -arch zynqmp -o BOOT.bin -w

关键文件结构：

BOOT/ ├── BOOT.bin ├── boot.scr └── image.ub

提示：SD卡必须格式化为FAT32格式，且容量建议不超过32GB。我曾遇到过128GB SD卡无法识别的问题。

5. 常见问题排查手册

5.1 串口无输出

排查步骤：

确认启动模式开关设置正确
检查USB线是否连接到正确的接口(J4)
验证终端软件配置(波特率115200)
在代码中添加LED闪烁测试，确认程序是否运行

5.2 程序卡在"Starting application..."

这通常是DDR初始化失败的表现，解决方法：

检查Vivado中的DDR配置
尝试降低CPU时钟频率
确认电源供应充足(建议使用官方电源适配器)

5.3 Vitis工程无法识别开发板

可能原因：

未安装USB驱动
开发板供电不足
USB线质量问题

解决方法：

安装最新的Digilent Adept驱动
尝试更换USB线
确保开发板单独供电(不要仅依赖USB供电)

6. 进阶技巧与优化建议

6.1 提高开发效率的技巧

使用预编译的板级支持包：
```
git clone https://github.com/Avnet/u96v2_sbc_platform.git
```
这个仓库包含了完整的硬件平台定义，可以节省大量配置时间。

自动化构建脚本：创建一个build.tcl脚本来自动化构建过程：

# 创建硬件平台 create_project -force ultra96v2 ./ultra96v2 -part xczu3eg-sbva484-1-e set_property board_part avnet.com:ultra96v2:part0:1.1 [current_project] # 添加源文件 add_files -norecurse {sources/*.v} # ...其他构建命令

调试技巧：
- 在代码中添加xil_printf调试输出
- 使用Vitis的"Memory View"监控关键变量
- 利用Xilinx SDK的"Register View"检查外设状态

6.2 性能优化方向

当熟悉基础开发后，可以考虑以下优化：

优化方向	实施方法	预期效果
内存访问	使用Cache	提升2-3倍性能
算法加速	使用NEON指令集	特定算法提升5-10倍
电源管理	动态调频调压	降低30%功耗

// NEON指令集示例代码 #include <arm_neon.h> void neon_add(float *a, float *b, float *c, int n) { for(int i=0; i<n; i+=4) { float32x4_t va = vld1q_f32(a+i); float32x4_t vb = vld1q_f32(b+i); float32x4_t vc = vaddq_f32(va, vb); vst1q_f32(c+i, vc); } }

开发Ultra96-V2的过程就像解谜游戏，每个问题的解决都带来新的认知。记得第一次看到串口输出"Hello World"时的激动，所有的挫折都变得值得。建议新手在遇到问题时，先休息片刻再回来看，往往会有新的思路。