3. Vitis开发环境：创建应用工程、BSP配置、编译与下载流程
好，咱们进入实战环节。前面两章把硬件工程和FSBL讲清楚了，现在该聊聊怎么在Vitis里把软件跑起来。说实话，我见过不少工程师在硬件设计上花了大功夫，结果卡在Vitis的工程配置上，一卡就是半天。其实摸清套路后，这步反而是最省心的。
3.1 从硬件导出到Vitis工作空间
在Vivado里完成综合、实现、生成比特流之后，第一步是导出硬件描述文件。这个文件包含了PS端的配置信息、DDR地址映射、外设中断号等关键数据。Vitis全靠它来生成BSP。
关键操作路径：
Vivado → File → Export → Export Hardware → 勾选 "Include bitstream"
导出后会生成一个 .xsa 文件（Xilinx Support Archive），这就是硬件描述。
我个人习惯把 .xsa 文件放在一个单独的目录下，比如 hw_design/，方便后续多个软件工程复用同一份硬件配置。你想想看，如果每次改个软件配置都要重新导一遍硬件，那效率就太低了。
3.2 创建应用工程
打开Vitis，指定工作空间目录。然后按以下步骤创建工程：
- 创建平台工程（Platform Project）：选择 .xsa 文件，Vitis会自动解析硬件配置。
- 创建应用工程（Application Project）：基于刚才的平台工程，选择模板。
- 选择模板：Vitis提供了不少模板，比如 "Hello World"、"Empty Application"、"DDR Memory Test" 等。
我记得第一次用Vitis时，直接选了"Hello World"模板，结果发现它默认跑在DDR里，而我的板子DDR还没初始化好。嗯，这里要注意：模板只是起点，千万别指望它开箱即用。
| 模板名称 | 适用场景 | 注意事项 |
|---|---|---|
| Hello World | 验证串口输出、基础环境 | 需要确保MIO/UART配置正确 |
| Empty Application | 从零开始、自定义逻辑 | 需要手动添加所有驱动和初始化 |
| DDR Memory Test | 验证DDR稳定性、硬件调试 | 测试时间较长，建议先跑小范围 |
| Peripheral Test | 验证单个外设功能 | 需要根据实际外设修改参数 |
3.3 BSP配置——避坑重灾区
BSP（Board Support Package）是连接硬件和应用的桥梁。说白了，它就是一堆驱动库和配置文件。Vitis会根据 .xsa 自动生成BSP，但自动生成的不一定对。
我曾经踩过的坑：
有一次我用的板子DDR型号比较特殊，Vitis自动生成的BSP里DDR参数是默认值，结果程序一跑就挂。后来手动在BSP设置里改了DDR时序参数才解决。所以，BSP配置一定要和硬件原理图、DDR手册对照检查。
BSP配置的核心项包括：
- 驱动库选择：勾选需要用到的外设驱动，比如
xilffs（文件系统）、lwip（网络协议栈）。别一股脑全勾上，会增加编译时间和代码体积。 - 中断配置：设置中断优先级、中断类型（边沿/电平）。我习惯把时间敏感的中断设高优先级，比如定时器中断。
- 时钟与DDR：核对CPU频率、DDR频率、DDR时序参数。这里错了，系统根本起不来。
- 串口参数：波特率、数据位、停止位。调试信息全靠它输出，错了就成哑巴了。
小技巧：
修改BSP配置后，记得点击 "Regenerate BSP Sources"。不然你改了半天，编译时用的还是旧版本。我吃过这个亏，改完配置发现没生效，排查了半天才发现是忘了重新生成。
3.4 编译与链接
Vitis的编译流程分为两步：先编译BSP，再编译应用工程。你可以单独编译，也可以一键编译整个工程。
编译时，Vitis会生成以下关键文件：
- .elf：可执行文件，最终下载到PS端运行。
- .bit：比特流文件，如果硬件有PL端逻辑，需要一起下载。
- .bif：启动镜像描述文件，用于生成BOOT.BIN。
我个人习惯在编译前先做一次 "Clean"，清除之前的编译产物。尤其是当你修改了BSP配置或者换了硬件版本时，不清除的话容易出一些莫名其妙的链接错误。
3.5 下载与调试
下载方式有两种：
- 直接下载到DDR运行：适合调试阶段，掉电就没了。
- 生成BOOT.BIN烧写到QSPI Flash：适合量产或脱机运行。
调试阶段我推荐第一种方式，改代码、编译、下载、验证，循环快。等代码稳定了再生成BOOT.BIN。
下载时，Vitis会自动检测JTAG链。如果检测不到设备，先检查JTAG线缆连接，再检查电源。我遇到过好几次，板子没上电，Vitis在那干等半天。
3.6 本章知识体系
下面这张图把整个流程串起来了，你可以对照着看：
整个流程环环相扣。硬件导出不对，后面全白搭。BSP配置错了，程序跑起来也是错的。编译通过了，下载时又可能出问题。所以我的建议是：每完成一步，先验证一步。导出 .xsa 后，先看看里面的地址映射对不对；创建完工程，先编译一下看看有没有语法错误；下载后，先看串口有没有输出。
别急着一次把所有功能都加上。我见过有人一口气把UART、I2C、SPI、Ethernet全写进去，结果出问题了，根本不知道是哪个外设的配置有问题。一点点来，稳扎稳打，反而更快。