【ZYNQ Ultrascale+ MPSOC FPGA教程】第十九章Hello World(下)

原创声明：

本原创教程由芯驿电子科技（上海）有限公司（ALINX）创做，版权归本公司全部，如需转载，需受权并注明出处。

适用于板卡型号：

AXU2CGA/AXU2CGB/AXU3EG/AXU4EV-E/AXU4EV-P/AXU5EV-E/AXU5EV-P /AXU9EG/AXU15EG

 

此文基于第十八章内容进行软件开发

【ZYNQ Ultrascale+ MPSOC FPGA教程】第十八章Hello World(上)

ALINX：【ZYNQ Ultrascale+ MPSOC FPGA教程】第十八章Hello World(上)​zhuanlan.zhihu.com

 

软件工程师工做内容

Vitis工程目录为“ps_hello/vitis”

如下为软件工程师负责内容。

1.Vitis调试；

2.建立Application工程；

1）新建一个文件夹，将vivado导出的xx.xsa文件拷贝进来；

2）Vitis是独立的软件，能够双击Vitis软件打开；

也能够经过在Vivado软件中选择ToolsLaunch Vitis打开Vitis软件

选择以前新建的文件夹，点击”Launch”

3）启动Vitis以后界面以下，点击“Create Application Project”，这个选项会生成APP工程以及Platfrom工程，Platform工程相似于之前版本的hardware platform，包含了硬件支持的相关文件以及BSP。

4）第一页为介绍页，直接跳过，点击Next

 

5）选择“Create a new platform from hardware(XSA)”，选择“Browse”

选择以前生成的xsa，点击打开

6）最下面的Generate boot components选项，若是勾选上，软件会自动生成fsbl工程，咱们通常选择默认勾选上。

7）填入APP工程名称，在方框处点击能够选择对应的处理器，咱们这里保持默认

8）在这个界面能够修改Domain名称，选择操做系统，ARM架构等，这里保持默认，操做系统选择standalone，也就是裸机。

9）选择”Hellow World”模板，点击“Finish”完成

10）完成以后能够看到生成了两个工程，一个是硬件平台工程，即以前所说的Platfrom工程，一个是APP工程

11）展开Platform工程后能够看到里面包含有BSP工程，以及zynq_fsbl工程（此工程即选择Generate boot components以后的结果）,双击platform.spr便可看到Platform对应生成的BSP工程，能够在这里对BSP进行配置。软件开发人员比较清楚，BSP也就是Board Support Package板级支持包的意思，里面包含了开发所须要的驱动文件，用于应用程序开发。能够看到Platform下有多个BSP，这是跟以往的SDK软件不同的，其中zynqmp_fsbl便是fsbl的BSP，domain_psu_cortexa53_0便是APP工程的BSP。也能够在Platform里添加BSP，在之后的例程中再讲。

12）点开BSP，便可看到工程带有的外设驱动，其中Documentation是xilinx提供的驱动的说明文档，Import Examples是xilinx提供的example工程，加快学习。

13）选中APP工程，右键Build Project，或者点击菜单栏的“锤子”按键，进行工程编译

14）能够在Console看到编译过程

编译结束，生成elf文件

15）链接JTAG线到开发板、UART的USB线到PC

16）使用PuTTY软件作为串口终端调试工具，PuTTY是一个免安装的小软件

17）选择Serial，Serial line填写COM3，Speed填写115200，COM3串口号根据设备管理器里显示的填写，点击“Open”

18）在上电以前最好将开发板的启动模式设置到JTAG模式，拔到”ON”的位置

19）给开发板上电，准备运行程序，开发板出厂时带有程序，这里能够把运行模式选择JTAG模式，而后从新上电。选择“hello”，右键，能够看到不少选项，本实验要用到这里的“Run as”，就是把程序运行起来，“Run as”里又有很对选项，选择第一个“Launch on Hardware(Single Application Debug)”，使用系统调试，直接运行程序。

20）这个时候观察串口软件，便可以看到输出”Hello World”

21）为了保证系统的可靠调试，最好是右键“Run As -> Run Configuration...”

22）咱们能够看一下里面的配置，其中Reset entire system是默认选中的，这是跟之前的SDK软件不一样的。若是系统中还有PL设计，还必须选择“Program FPGA”。

23）除了“Run As”，还能够“Debug As”，这样能够设置断点，单步运行

24）进入Debug模式

25）和其余C语言开发IDE同样，能够逐步运行、设置断点等

26）右上角能够切换IDE模式

3. 固化程序

普通的FPGA通常是能够从flash启动，或者被动加载，ZYNQ的启动是由ARM主导的，包括FPGA程序的加载，ZYNQ MPSoC启动通常为三个步骤，在UG1085中也有介绍：

Pre-configuration satge :预加载阶段由PMU控制，执行PMU ROM中的代码设置系统。PMU处理全部的复位和唤醒过程。

Configuration stage : 接下来进入最重要的一步，当BootRom（CSU ROM代码的一部分）搬运FSBL到OCM后，处理器开始执行FSBL代码，FSBL主要有如下几个做用：

• 初始化PS端配置，MIO，PLL，DDR，QSPI，SD等
• 若是有PL端程序，加载PL端bitstream
• 搬运用户程序到DDR，并跳转执行

Post-configuration stage : FSBL开始执行后，CSU ROM代码进入post-configuration阶段，负责起系统干预响应，CSU为验证文件正确性、经过PCAP加载PL、存储管理安全密钥、解密等提供持续的硬件支持。

3.1 生成FSBL

FSBL是一个二级引导程序，完成MIO的分配、时钟、PLL、DDR控制器初始化、SD、QSPI控制器初始化，经过启动模式查找bitstream配置FPGA，而后搜索用户程序加载到DDR，最后交接给应用程序执行。

1) 因为在新建时选择了Generate boot components选项，因此Platform已经导入了fsbl的工程，并生成了相应的elf文件。

2) 修改调试宏定义FSBL_DEBUG_INFO_VAL，能够在启动输出FSBL的一些状态信息，有利于调试，可是会致使启动时间变长。保存文件。能够看一下fsbl里包含了不少外设的文件，包括psu_init.c，qspi，sd等，你们能够再仔细读读代码。固然这个fsbl模板也是能够修改的，至于怎么修改根据本身的需求来作。

3) 从新Build Project

4) 接下来咱们能够点击APP工程的system，右键选择Build project

5) 这个时候就会多出一个Debug文件夹，生成了对应的BOOT.BIN

6) 还有一种方法就是，点击APP工程的system右键选择Creat Boot Image，弹出的窗口中能够看到生成的BIF文件路径，BIF文件是生成BOOT文件的配置文件，还有生成的BOOT.bin文件路径，BOOT.bin文件是咱们须要的启动文件，能够放到SD卡启动，也能够烧写到QSPI Flash。

7) 在Boot image partitions列表中有要合成的文件，第一个文件必定是bootloader文件，就是上面生成的fsbl.elf文件，第二个文件是FPGA配置文件bitstream，在本实验中因为没有FPGA的bitstream，不须要添加，第三个是应用程序，在本实验中为hello.elf，因为没有bitstream，在本实验中只添加bootloader和应用程序。点击Create Image生成。

8) 在生成的目录下能够找到BOOT.bin文件

3.2 SD卡启动测试

1) 格式化SD卡，只能格式化为FAT32格式，其余格式没法启动

2) 放入BOOT.bin文件，放在根目录

3) SD卡插入开发板的SD卡插槽

4) 启动模式调整为SD卡启动

5) 打开串口软件，上电启动，便可看到打印信息，红色框为FSBL启动信息，黄色箭头部分为执行的应用程序helloworld

3.3 QSPI启动测试

1) 在Vitis菜单Xilinx -> Program Flash

2) Hardware Platform选择最新的，Image FIle文件选择要烧写的BOOT.bin，FSBL file选择fsbl.elf。选择Verify after flash，在烧写完成后校验flash。

3) 点击Program等待烧写完成

4) 设置启动模式为QSPI，再次启动，能够在串口软件里看到与SD一样的启动效果。

3.4 Vivado下烧写QSPI

1) 在HARDWARE MANGER下选择器件，右键Add Configuration Memory Device

2) 选择尝试Micron，类型选择qspi，宽度选择x4-single，Density选择256，这时候出现wt25qu256，选择红框型号。

3) 右键选择编程文件

4) 选择要烧写的文件和fsbl文件，就能够烧写了，若是烧写时不是JTAG启动模式，软件会给出一个警告，因此建议烧写QSPI的时候设置到JTAG启动模式

3.5 使用批处理文件快速烧写QSPI

1) 新建一个program_qspi.txt文本文件，扩展名改成bat,内容填写以下，

E:\XilinxVitis\Vitis\2020.1\bin\program_flash 为咱们工具路径，按照安装路径适当修改，-f 为要烧写的文件，-fsbl为要烧写使用的fsbl文件，-verify为校验选项。

callE:\XilinxVitis\Vitis\2020.1\bin\program_flash -f BOOT.bin -offset 0 -flash_type qspi-x4-single -fsbl fsbl.elf -verifypause

2) 把要烧录的BOOT.bin、fsbl、bat文件放在一块儿

3) 插上JTAG线后上电，双击bat文件便可烧写flash。

4. 常见问题

4.1 仅有PL端逻辑的固化

有不少人会问，若是只有PL端的逻辑，不须要PS端该怎么固化程序呢？不带ARM的FPGA固化是没问题的，可是对于ZYNQ来讲，必需要有PS端的配合才能固化程序。那么对于前面的”PL的“Hello World”LED实验”该怎么固化程序呢？

1) 根据本章的PS端添加ZYNQ核并配置，最简单的方法就是在本章工程的基础上添加LED实验的verilog源文件，并进行例化，组成一个系统，并须要生成bitstream。

2) 生成bitstream以后，导出硬件，选择include bitstream

3) 在生成BOOT.BIN时，仍是须要一个app工程hello，仅仅是为了生成BOOT.BIN，默认状况下在system右键Build Project，便可生成包含bitstream的BOOT.BIN。

打开Create Boot Image界面能够看到，Boot Image Partitions的文件顺序是fsbl、bitstream、app，注意顺序不要颠倒，利用这样生成的BOOT.BIN就能够按照前面的启动方式测试启动了

在course_s2文件夹，咱们提供了一个名为led_qspi_sd的工程，你们能够参考。

5. 使用技巧分享

在频繁的修改源文件，并进行编译的时候，最好选择APP工程进行Build Project，这种状况下只会生成elf文件。

若是想生成BOOT.BIN文件，能够选择system进行编译，这种状况既会生成elf也会生成BOOT.BIN，笔者最开始用的时候就吃过亏，每次编译都是选择system，结果每次都要等待生成BOOT.BIN，浪费时间，你们能够注意一下。

6. 本章小结

本章从FPGA工程师和软件工程师二者角度出发，介绍了ZYNQ开发的经典流程，FPGA工程师的主要工做是搭建好硬件平台，提供硬件描述文件hdf给软件工程师，软件工程师在此基础上开发应用程序。本章是一个简单的例子介绍了FPGA和软件工程师协同工做，后续还会牵涉到PS与PL之间的联合调试，较为复杂，也是ZYNQ开发的核心部分。

同时也介绍了FSBL，启动文件的制做，SD卡启动方式，QSPI下载及启动方式，Vivado下载BOOT.BIN方式，本章没有FPGA加载文件，后面的应用中会再介绍添加FPGA加载文件制做BOOT.BIN。

后续的工程都会以本章节的配置为准，后面再也不介绍ZYNQ的基本配置。

千里之行，始于足下，相信通过本章的学习，你们对ZYNQ开发有了基本概念，高楼稳不稳，要看地基打的牢不牢，虽然本章较为简单，但也有不少知识点待诸位慢慢消化。加油！！！