Vitis 统一软件平台文档

【实例简介】Vitis 统一软件平台文档

Vitis™ 统一软件平台是一种新增工具，用于将赛灵思软件开发的方方面面全部组合到统一的环境内。Vitis 软件平台支
持Vitis 嵌入式软件开发流程以满足希望迁移至下一代技术的赛灵思软件开发套件(SDK) 用户的使用需求，也支持Vitis
应用加速开发流程，以满足希望使用基于赛灵思FPGA 的最新软件加速功能的软件开发者的需求。本文档旨在探讨
Vitis 核开发套件的嵌入式软件开发流程和使用。

【实例截图】

【核心代码】

目录
第一部分：Vitis 入门 ..............................................................................................................................................9
第 1 章：按设计进程浏览内容 .................................................................................................................10
第 2 章：Vitis 软件平台版本说明 ..........................................................................................................11
新增功能..................................................................................................................................................................11
受支持的平台...........................................................................................................................................................11
嵌入式 GNU 工具链详细信息................................................................................................................................. 11
行为更改..................................................................................................................................................................12
已知问题..................................................................................................................................................................12
第 3 章：安装 ...................................................................................................................................................... 13
安装要求..................................................................................................................................................................13
Vitis 软件平台安装.................................................................................................................................................. 13
第 4 章：Vitis 软件平台入门 .....................................................................................................................16
Vitis 统一软件平台概述...........................................................................................................................................16
从赛灵思 SDK 移植到 Vitis 软件平台......................................................................................................................19
第二部分：使用 Vitis IDE ..................................................................................................................................21
第 5 章：启动 Vitis IDE ................................................................................................................................ 22
第 6 章：开发 ...................................................................................................................................................... 23
管理平台和平台存储库............................................................................................................................................23
目标平台..................................................................................................................................................................24
应用......................................................................................................................................................................... 34
在应用工程中使用自定义库....................................................................................................................................52
使用 Git 进行版本控制............................................................................................................................................52
第 7 章：运行、调试和最优化 .................................................................................................................64
运行应用工程...........................................................................................................................................................64
调试应用工程...........................................................................................................................................................74
交叉触发................................................................................................................................................................106
剖析/分析.............................................................................................................................................................. 116
最优化：性能分析.................................................................................................................................................123
创建启动镜像.........................................................................................................................................................146
UG1400 (v2022.2) 2023 年 1 月 2 日 china.xilinx.com
Vitis 嵌入式软件开发 2
Send Feedback
Program Flash..................................................................................................................................................... 147
多线缆和多器件支持............................................................................................................................................. 151
第 8 章：Vitis 实用工具 ..............................................................................................................................157
赛灵思软件命令行工具..........................................................................................................................................157
器件编程................................................................................................................................................................157
转储/复原数据文件............................................................................................................................................... 159
Vitis Shell.............................................................................................................................................................. 159
工程导出和导入.....................................................................................................................................................160
生成设备树............................................................................................................................................................ 161
第 9 章：Vitis 软件平台中的嵌入式软件开发用例 .................................................................. 163
使用用户修改/定制 FSBL 来调试应用.................................................................................................................. 163
第三部分：Bootgen 工具 ...............................................................................................................................165
第 10 章：简介 ................................................................................................................................................. 166
安装 Bootgen....................................................................................................................................................... 166
启动时间安全.........................................................................................................................................................166
第 11 章：启动镜像布局 ............................................................................................................................168
Zynq-7000 SoC 启动和配置..................................................................................................................................168
Zynq UltraScale MPSoC 启动和配置.................................................................................................................176
Versal ACAP 启动镜像格式...................................................................................................................................187
第 12 章：创建启动镜像 ............................................................................................................................199
启动镜像格式 (BIF)............................................................................................................................................... 199
BIF 语法和受支持的文件类型............................................................................................................................... 200
属性....................................................................................................................................................................... 203
第 13 章：使用 Bootgen GUI ............................................................................................................... 214
启动 Bootgen GUI................................................................................................................................................214
适用于 Zynq-7000 和 Zynq UltraScale 器件的 Bootgen GUI..........................................................................214
为 Versal ACAP 使用 Bootgen GUI 选项.............................................................................................................216
在命令行上使用 Bootgen.....................................................................................................................................218
命令和描述............................................................................................................................................................ 218
第 14 章：启动时间安全 ............................................................................................................................222
使用加密................................................................................................................................................................223
使用身份验证.........................................................................................................................................................232
Versal 身份验证支持.............................................................................................................................................241
Versal 散列方案.................................................................................................................................................... 243
使用 HSM 模式......................................................................................................................................................243
第 15 章：SSIT 支持 ..................................................................................................................................... 271
UG1400 (v2022.2) 2023 年 1 月 2 日 china.xilinx.com
Vitis 嵌入式软件开发 3
Send Feedback
第 16 章：FPGA 支持 ...................................................................................................................................283
加密和身份验证.....................................................................................................................................................283
HSM 模式.............................................................................................................................................................. 284
同时使用身份验证和加密的 HSM 流程.................................................................................................................286
第 17 章：用例与示例 ................................................................................................................................. 288
Zynq MPSoC 用例.................................................................................................................................................288
Versal ACAP 用例................................................................................................................................................. 297
第 18 章：BIF 属性参考 .............................................................................................................................307
aarch32_mode..................................................................................................................................................... 307
aeskeyfile..............................................................................................................................................................308
alignment.............................................................................................................................................................310
auth_params........................................................................................................................................................311
authentication..................................................................................................................................................... 313
big_endian............................................................................................................................................................315
bbram_kek_iv....................................................................................................................................................... 316
bh_kek_iv.............................................................................................................................................................. 316
bh_keyfile..............................................................................................................................................................316
bh_key_iv.............................................................................................................................................................. 317
bhsignature..........................................................................................................................................................318
blocks....................................................................................................................................................................318
boot_config.......................................................................................................................................................... 320
boot_device..........................................................................................................................................................321
bootimage............................................................................................................................................................323
bootloader........................................................................................................................................................... 325
bootvectors..........................................................................................................................................................326
checksum............................................................................................................................................................. 326
copy.......................................................................................................................................................................327
core....................................................................................................................................................................... 328
delay_auth............................................................................................................................................................328
delay_handoff......................................................................................................................................................329
delay_load............................................................................................................................................................ 330
destination_cpu...................................................................................................................................................330
destination_device.............................................................................................................................................. 331
early_handoff.......................................................................................................................................................332
efuse_kek_iv......................................................................................................................................................... 332
efuse_user_kek0_iv..............................................................................................................................................332
efuse_user_kek1_iv..............................................................................................................................................333
encryption............................................................................................................................................................333
exception_level.................................................................................................................................................... 335
familykey.............................................................................................................................................................. 336
file..........................................................................................................................................................................336
fsbl_config............................................................................................................................................................337
headersignature..................................................................................................................................................338
UG1400 (v2022.2) 2023 年 1 月 2 日 china.xilinx.com
Vitis 嵌入式软件开发 4
Send Feedback
hivec......................................................................................................................................................................339
id............................................................................................................................................................................340
image....................................................................................................................................................................341
init......................................................................................................................................................................... 342
keysrc....................................................................................................................................................................342
keysrc_encryption................................................................................................................................................344
load....................................................................................................................................................................... 344
metaheader......................................................................................................................................................... 345
name.....................................................................................................................................................................346
offset.....................................................................................................................................................................347
overlay_cdo.......................................................................................................................................................... 348
parent_id.............................................................................................................................................................. 348
partition................................................................................................................................................................349
partition_owner 和 owner.................................................................................................................................. 350
pid......................................................................................................................................................................... 351
pmufw_image......................................................................................................................................................351
ppkfile...................................................................................................................................................................352
presign..................................................................................................................................................................353
pskfile................................................................................................................................................................... 353
puf_file..................................................................................................................................................................354
reserve..................................................................................................................................................................355
split........................................................................................................................................................................356
spkfile................................................................................................................................................................... 357
spksignature........................................................................................................................................................358
spk_select.............................................................................................................................................................359
sskfile....................................................................................................................................................................360
startup..................................................................................................................................................................361
trustzone..............................................................................................................................................................362
type....................................................................................................................................................................... 363
udf_bh...................................................................................................................................................................363
udf_data................................................................................................................................................................364
userkeys............................................................................................................................................................... 365
xip_mode..............................................................................................................................................................367
第 19 章：命令参考 .......................................................................................................................................368
arch.......................................................................................................................................................................368
authenticatedjtag................................................................................................................................................368
bif_help.................................................................................................................................................................369
dual_ospi_mode...................................................................................................................................................369
dual_qspi_mode...................................................................................................................................................370
dump.................................................................................................................................................................... 370
dump_dir..............................................................................................................................................................371
efuseppkbits........................................................................................................................................................ 371
encrypt..................................................................................................................................................................372
encryption_dump................................................................................................................................................372
fill...........................................................................................................................................................................372
generate_hashes.................................................................................................................................................373
UG1400 (v2022.2) 2023 年 1 月 2 日 china.xilinx.com
Vitis 嵌入式软件开发 5
Send Feedback
generate_keys......................................................................................................................................................374
h 和 help............................................................................................................................................................... 375
image....................................................................................................................................................................375
log......................................................................................................................................................................... 376
nonbooting.......................................................................................................................................................... 376
o.............................................................................................................................................................................377
p.............................................................................................................................................................................377
padimageheader.................................................................................................................................................377
process_bitstream...............................................................................................................................................378
read.......................................................................................................................................................................378
spksignature........................................................................................................................................................379
split........................................................................................................................................................................379
verify.....................................................................................................................................................................380
verify_kdf..............................................................................................................................................................380
w............................................................................................................................................................................381
zynqmpes1...........................................................................................................................................................381
初始化对和 INT 文件属性.....................................................................................................................................382
第 20 章：CDO 实用工具 ..........................................................................................................................383
访问....................................................................................................................................................................... 383
用法....................................................................................................................................................................... 383
示例....................................................................................................................................................................... 384
第 21 章：Bootgen 设计咨询 ................................................................................................................386
第四部分：赛灵思软件命令行工具 .......................................................................................................... 387
第 22 章：赛灵思软件命令行工具 ...................................................................................................... 388
第 23 章：XSCT 命令 ....................................................................................................................................389
目标连接管理.........................................................................................................................................................389
目标寄存器............................................................................................................................................................ 392
程序执行................................................................................................................................................................394
目标存储器............................................................................................................................................................ 405
目标下载 FPGA/二进制文件................................................................................................................................. 411
目标复位................................................................................................................................................................413
发送到 Versal PMC 的 IPI 命令............................................................................................................................415
目标断点/观察点...................................................................................................................................................417
Jtag UART..............................................................................................................................................................422
杂项....................................................................................................................................................................... 423
JTAG 访问.............................................................................................................................................................. 431
目标文件系统.........................................................................................................................................................439
SVF 操作................................................................................................................................................................ 446
器件配置系统.........................................................................................................................................................451
STAPL 操作............................................................................................................................................................452
Vitis 工程...............................................................................................................................................................455
UG1400 (v2022.2) 2023 年 1 月 2 日 china.xilinx.com
Vitis 嵌入式软件开发 6
Send Feedback
第 24 章：XSCT 用例 ....................................................................................................................................503
常见用例................................................................................................................................................................503
更改应用工程的编译器选项..................................................................................................................................503
使用应用模板创建应用工程 (Zynq UltraScale MPSoC FSBL)...........................................................................504
使用手动创建的域创建 FSBL 应用工程 (Zynq UltraScale MPSoC FSBL).........................................................504
创建可启动镜像并执行闪存编程...........................................................................................................................504
调试已在目标上运行的程序..................................................................................................................................505
在 Zynq UltraScale MPSoC 上调试应用............................................................................................................506
基于目标属性选择目标..........................................................................................................................................508
修改 BSP 设置....................................................................................................................................................... 509
执行独立应用调试.................................................................................................................................................509
生成 SVF 文件........................................................................................................................................................512
在非交互模式下运行应用......................................................................................................................................513
运行 Tcl 脚本......................................................................................................................................................... 513
在 XSCT 与 Vitis 集成设计环境之间进行切换.......................................................................................................514
使用 JTAG UART....................................................................................................................................................514
处理库....................................................................................................................................................................515
编辑 FSBL/PMUFW 源文件...................................................................................................................................516
编辑 FSBL/PMUFW 设置...................................................................................................................................... 516
在主机与 QEMU 上运行的 Linux 之间交换文件..................................................................................................517
第 25 章：硬件软件接口 (HSI) 命令 ..................................................................................................518
XSCT 接口示例...................................................................................................................................................... 518
微处理器软件规范 (MSS)......................................................................................................................................531
微处理器库定义 (MLD).........................................................................................................................................536
微处理器驱动程序定义 (MDD).............................................................................................................................546
微处理器应用定义 (MAD).....................................................................................................................................555
HSI 命令................................................................................................................................................................ 557
第五部分：GNU 编译器工具 ........................................................................................................................585
第 26 章：概述 ................................................................................................................................................. 586
第 27 章：编译器框架 ................................................................................................................................. 587
第 28 章：常用编译器用法和选项 ...................................................................................................... 589
用法....................................................................................................................................................................... 589
输入文件................................................................................................................................................................589
输出文件................................................................................................................................................................590
文件类型和扩展名.................................................................................................................................................590
库...........................................................................................................................................................................590
语言方言................................................................................................................................................................591
常用编译器选项：快速参考..................................................................................................................................592
常规选项................................................................................................................................................................592
库搜索选项............................................................................................................................................................ 593
UG1400 (v2022.2) 2023 年 1 月 2 日 china.xilinx.com
Vitis 嵌入式软件开发 7
Send Feedback
头文件搜索选项.....................................................................................................................................................594
默认搜索路径.........................................................................................................................................................594
连接器选项............................................................................................................................................................ 595
存储器布局............................................................................................................................................................ 595
对象文件节............................................................................................................................................................ 596
连接器脚本............................................................................................................................................................ 598
第 29 章：MicroBlaze 编译器的使用和选项 ...............................................................................600
MicroBlaze 编译器............................................................................................................................................... 600
处理器特性选择选项............................................................................................................................................. 600
常规程序选项.........................................................................................................................................................601
MicroBlaze 应用二进制接口.................................................................................................................................603
MicroBlaze 汇编程序............................................................................................................................................603
MicroBlaze 连接器选项........................................................................................................................................604
MicroBlaze 连接器脚本的各节.............................................................................................................................604
编写或自定义连接器脚本的技巧...........................................................................................................................605
启动文件................................................................................................................................................................605
修改启动文件.........................................................................................................................................................608
编译器库................................................................................................................................................................609
线程安全性............................................................................................................................................................ 609
命令行实参............................................................................................................................................................ 609
中断处理程序.........................................................................................................................................................610
第 30 章：Arm 编译器的使用和选项 ................................................................................................611
用法....................................................................................................................................................................... 611
第 31 章：其它注释 .......................................................................................................................................613
C 语言代码大小.................................................................................................................................................613
C 标准库............................................................................................................................................................ 613
位置无关代码（可重定位代码）...........................................................................................................................613
其它开关和功能特性............................................................................................................................................. 614
第六部分：嵌入式设计教程 ...........................................................................................................................615
第七部分：驱动程序和库 ................................................................................................................................616
附录 A：附加资源与法律声明 ......................................................................................................................617
赛灵思资源.................................................................................................................................................................. 617
Documentation Navigator 与设计中心....................................................................................................................617
修订历史......................................................................................................................................................................617
请阅读：重要法律声明................................................................................................................................................620