本文转载自：亦梦云烟的博客
前言
在前面的学习中，我们已经学会了使用Vivado及SDK开发环境，熟悉了硬件开发与Linux软件驱动之间的联系及开发流程。本系列教程我们学习SDSoc的开发，在SDSoc IDE中，Xilinx为我们集成了比较流行的开发板硬件平台，如果我们使用的是其中的一个，可以直接使用。但笔者使用的是米尔科技的7z010开发板，在开发之前首先要定义我们自己的硬件平台，作为之后创建应用的模板工程。
一个SDSoc Platform工程应该包含如下文件：
1. 目标操作系统：Linux，文件系统
2. 启动文件：u-boot.elf，fsbl.elf
3. [可选]库文件
4. XML描述文件，描述硬件和软件结构
下图描述了这些文件的结构关系:
本例程的目的如下：
1. 创建硬件组件：硬件平台的的设备支撑架构DSA；
2. 创建平台的软件组件:
i.Fisrt Stage Boot Loader(FSBL)
ii."Hello World"可执行文件测试
iii.链接脚本，定义堆栈和内存
iv.启动文件BOOT.bin
3. 创建SDSoC平台
i. 使用SDx IDE创建用户自定义平台
ii. 在自定义的平台上运行硬件加速程序
硬件和软件环境:
软件:Windows 10 64bit, SDSoC2018.2
硬件:Zturn Board开发板(XC7z010), FAT32 SD card, mini USB数据线
一、创建硬件组件
使用Vivado创建开发板的基础硬件平台，这个操作流程在ZYNQ学习之路1.Linux系统从零开始建立.note中有详细的描述，或查看Vivado Design Suite User Guide,本文直接使用其创建好的模板工程。
模板工程的原理图如下图：
图1-1 vivado创建模板工程
注意两个名称：ZYNQ重命名ps7, proc_sys_reset_0为系统复位模块，这两个名词在Tcl命令中将会用到。
1.1 添加必要的IP
设置ZYNQ Processing System,双击ZYNQ IP，
在PS-PL Configuration中
展开AXI Non Secure Enablement->GP Master AXI Interface
不勾选 M AXI GP0 interface
图1-2 GP0的设置
在Interrupts中，勾选Fabric Interrupts,展开，PS-PS Interrupt Ports，勾选IRQ_F2P[15:0].
复制Processor System Reset IP，一共需要使用四个。
添加Clocking Wizard IP
添加Concat IP
删除掉不需要用到的IO端口：删除GPIO，I2C, UART1等外设。
最后的原理图如下：
图1-3 SDSoC 硬件原理图
1.2 使用Tcl命令创建硬件平台
在之前创建的Vivado模板工程的基础上打包硬件的DSA文件，打开Vivado模板工程，在Tcl命令中进行以下操作。
1.2.1 定义硬件平台的名称和描述
创建一个硬件平台文件
sdsoc::create_pfm
参数： 用户设定的平台的名称
返回：新硬件平台的句柄
设置硬件平台的名称和描述：
sdsoc::pfm_name
sdsoc::pfm_description
本例程创建的平台命令如下：
set pfm [sdsoc::create_pfm zturnTemplate.hpfm]
sdsoc::pfm_name $pfm "BIAC" "ZturnTemplate" "ZturnTemplate" "1.0"
sdsoc::pfm_description $pfm "Zturn board SDSoc Template"
1.2.2 声名时钟
在每个硬件平台文件中必须定义至少一个时钟，并且设定一个默认时钟(is_default=true)
sdsoc::pfm_clock 参数：
本例程设置时钟命令如下：
sdsoc::pfm_clock $pfm FCLK_CLK0 ps7 0 true proc_sys_reset_0
1.2.3 定义AXI端口
sdsoc::pfm_axi_port
参数:
本例程设置AXI端口命令如下：
sdsoc::pfm_axi_port $pfm M_AXI_GP0 ps7 M_AXI_GP
1.2.4 定义中断端口
硬件平台必须有Concat模块连接中断端PS7，定义中断方法如下:
sdsoc::pfm_irq
本例程定义中断端口命令如下：
for{set i 0} {$i<16} {incr i}{
sdsoc::pfm_irq $pfm In$i xlconcat_0
}
1.2.5 打包文件
在使用上述命令描述了硬件平台之后，使用如下命令写入一个描述文件中：
sdsoc::generate_hw_pfm $pfm
完整的命令如下：
set pfm [sdsoc::create_pfm zturnTemplate.hpfm]
sdsoc::pfm_name $pfm "BIAC" "ZturnTemplate" "ZturnTemplate" "1.0"
sdsoc::pfm_description $pfm "Zturn board SDSoc Template"
sdsoc::pfm_clock $pfm FCLK_CLK0 ps7 0 true proc_sys_reset_0
sdsoc::pfm_axi_port $pfm M_AXI_GP0 ps7 M_AXI_GP
for{set i 0} {$i<16} {incr i}{ sdsoc::pfm_irq $pfm In$i xlconcat_0 }
sdsoc::generate_hw_pfm $pfm
//设置dsa的属性
set name [get_property NAME [current_project]]
set_property dsa.vendor "xilinx.com" [current_project]
set_property dsa.board_id $name [current_project]
set_property dsa.name $name [current_project]
set_property dsa.version "1.0" [current_project]
write_dsa -force -include_bit F:/ZYNQ/ZturnTemplate/ZturnTemplate.dsa
1.3 使用窗口设置PFM
使用命令行对于初学者来说不是很方便，SDSoC另外提供了图形界面的操作。
1.3.1 使能Platform Interfaces Tab
点击Window->Platform Interfaces.
图1-4 Platform Interfaces 窗口
这里将显示所有可用的接口，右键点击一个接口或一组选择的接口，选择"Enable"，灰色的图标将变成深蓝色，只有使能的接口才能在SDx软件中使用。
图1-5 使能PFM接口
1.3.2 设置平台的名称
点击Sources选项卡，选中Design Sources中的框图设计文件，在下方的文件属性窗口中，设置PFM_NAME的属性:点击灰色的铅笔图标，设置Vendor, Library, Name, and Version.设置后如下图所示:
图1-6 设置PFM_NAME
1.3.3 设置主时钟
前文讲到，一个DSA文件中必须有一个默认时钟作为主时钟。在Platform Interfaces选项窗口中选择clk_wiz_0。
图1-7 选择并使能clk_wiz_0中的四个时钟
在下方的属性窗口中选择Options面板，勾选is_default属性
图1-8 勾选clk_out1为is_default
默认的clk_out1,clk_out2,clk_out3,clk_out4的id依次为1,2,3,4，将其依次修改为0,1,2,3，注意手动输入数字并按回车确定。
1.3.4 定义AXI端口
在Platforms Interfaces窗口中选择ps7端口，除了FCLK_CLK0，选择其他的M_AXI_GP0，M_AXI_GP1，S_AXI_ACP，S_AXI_HP0，S_AXI_HP1，S_AXI_HP2，S_AXI_HP3,选择使能。
图1-9 使能AXI端口
1.3.5 定义中断端口
在Platforms Interfaces窗口中选择In0到In15端口，在下方的属性窗口中勾选Enabled。
1.3.6 写入DSA文件
在block design文件上右键选择Generate Output Products...，然后生成。
编译综合，生成比特流文件，导出文件。
在设置完PFM的属性后可以将其写入DSA文件。在Tcl Console窗口中操作：
set name [get_property NAME [current_project]]
set_property dsa.vendor "BIAC" [current_project]
set_property dsa.board_id $name [current_project]
set_property dsa.name $name [current_project]
set_property dsa.version "1.0" [current_project]
write_dsa -force -include_bit F:/ZYNQ/ZturnTemplate/ZturnTemplate.dsa
如果没有问题，在工程目录下会生成ZturnTemplate.dsa文件。
注意:DSA文件的名称要与Vivado工程的名称一致。
二、 创建软件组件
本小节创建SDSoC平台的软件组件，包括以下三类软件。
2.1 创建Application工程
打开SDx软件，点击File->New->SDx Project...,选择创建Application工程。
图2-1 创建SDx应用程序
输入工程名：Helloworld，点击Next >
在平台类型选择窗口，选择Hardware specification(DSA/HDF)
图2-2 选择DSA文件创建新的平台
点击Add New DSA/HDF...，选择第一节中生成的DSA文件。新的平台将加入到列表中。选中自定义的平台，点Next,在系统配置界面配置如下：
OS Platform:standalone
Processor:ps7_cortexa9_0
Language:C
在工程模板中选择Hello World，点Finish完成工程的创建。
此时，在工程导航窗口中将创建Helloworld应用和平台的模板工程。
双击project.sdx，在Helloworld面板中，点击Modify BSP Settings...
图2-3 修改BSP设置
选择standalone，将stdin和stdout设置为ps7_uart_1.
图2-4 设置标准输入输出
在Assistant窗口中，右键单击Helloworld应用，选择Generate Linker Script。
在右侧Basic处修改堆栈的大小，默认值对于SDx应用程序来说太小。
设置Heap Size:805306368(768MB); Stack Size:262144(256KB)
图2-5 设置堆栈大小
在Assistant中展开Helloworld，右键点击Debug，选择Build，编译这个工程。
arm-none-eabi-size Helloworld.elf |tee "Helloworld.elf.size"
text data bss dec hex filename
19352 1144 805574696 805595192 30046838 Helloworld.elf
'Finished building: Helloworld.elf.size'
编译完成后，在Debug目录中将生成Helloworld.elf文件。
2.2 制作启动文件
现在，我们已经有了硬件和软件组件，我们可以用它们来启动Zyqn-7000 SoC了。SDx IDE提供了创建启动文件的功能。
在Assistant窗口，右键点击Helloworld[Application]，选择Create Boot Image
图3-6 Create Boot Image
i. 选择Zynq Architecture
ii. 选择Create new BIF file
iii. 默认Output BIF file path，不修改
iv. 输出路径：默认值不修改
V. 添加boot image的各个部分: fsbl.elf, ZturnTemplate.bit, HelloWorld.elf
图3-7 设置Boot Image的各个组件
其中，fsbl.elf由vivado中的SDK创建。
点击Create Image创建BOOT.bin文件，该文件在工程目录下的_sdx/bootimage目录中。
2.3 启动Zynq
复制BOOT.bin文件到FAT32格式的SD卡根目录下。
将SD卡插入Zturn Board，连接USB数据线，根据串口号打开串口终端。
上电启动开发板，在窗口终端中将打印如下字符。
图3-8 Helloworld工程输出结果
2.4 准备一个分级区
现在我们已经完成了所有组件的设计，可以用来创建一个裸机SDSoC平台的应用程序。为了之后的平台工程创建，我们将其打包成具有分级结构的文件。
a. 切换到SDx的workspace
b. 复制DSA文件
c. 创建boot目录
d. 进入boot目录
e. 复制fsbl.elf文件到boot目录
f. 复制Helloworld链接文件到boot目录
g. 复制Helloworld.bif文件到boot目录
h. 复制BOOT.bin文件到boot目录
以ZturnPlatform为父目录则目录结构如下
ZturnPlatform
|--ZturnTemplate.dsa
|boot
|--fsbl.elf
|--lscript.ld
|--Helloworld.bif
|--BOOT.bin
复制Helloworld.bif文件，重命名为platform.bif，编辑内容如下：
//arch = zynq; split = false; format = BIN
the_ROM_image:
{
[bootloader]
}
三、创建一个用户定义的平台
前面两节已经准备好了硬件组件和软件组件，并且使用裸机程序简单的测试了系统的正确性。
3.1 创建一个用户定义的平台工程
点击菜单File->New->New SDx Project...，选择Platform
点击Next >之后选择之前创建的平台。
图3-1 创建Platform工程
点击Next，选择前面ZturnPlatform目录中的ZturnTemplate.dsa文件。点Finish完成。
图3-2 选择DSA文件
创建的工程名自动命名为DSA文件的名称！
3.2 定义平台文件
创建完平台工程后，显示的窗口提示了四个设置步骤。
图3-3 四个定义平台步骤
i. 点击(1)Define System Configuration
输入Name: standalone,Display Name自动填充与之一致。
选择性输入描述语言
选择前面的boot文件夹
选择platform.bif文件。
图3-4 Define System Configuration
ii.点击(2)Add Processor Group/Domain
输入Name:a9_standalone，Display Name自动填充为与之一致
OS:standalone
Processor: ps7_cortexa9_0
Supported Runtimes:C/C++
Linker Script:lscript.ld
图3-5 Add Processor Group/Domain
iii. 点击(3)Generate Platform
iv. 点击(4)Add to Custom Respositories
此时在Assistant窗口将添加ZturnTemplate[Platform]
3.3 使用自定义的SDx平台创建应用
在SDx IDE的菜单中选择File->New->SDx Project，选择Application类型。
工程名输入sdx_app1,在Platform中选择上面添加的ZturnTemplate[custom]
点击Next,使用默认的设置。
点击Next,选择mmult_pipeline为模板创建FPGA加速的应用程序。
点击Finish完成应用的创建。
图3-6 创建的sdx_app1目录结构
在Assistant窗口中，选择sdx_app1，在Debug上右键选择Build.
编译完成后在Debug目录中将生产SD卡镜像文件,sd_card目录中是启动文件。
启动运行之后在终端窗口中显示如下：
图3-7 矩阵乘法硬件加速计算结果
错误：可能出现的错误：ERROR: [DMAnalysis 83-4503] No M_AXI_GP port found in the platform!这是由于FPM_NAME与DSA文件名不一致导致的，在开始做这个实验室，笔者的PFM_NAME=xilinx.com:zturn:zturnTemplate:1.0，DSA文件名为ZturnTemplate.dsa，因此要将DSA文件重命名为zturnTemplate.dsa.
错误：可能出现的错误：No suitable system port available for XFER(IN)\nin1 @102\nARRAY\n，在ZYNQ IP和设置时不要勾选GP0端口
错误：可能出现的错误：ERROR: [VPL 17-69] Command failed: Invalid constraints filename specified。这里会有一个警告:id 0不存在，vivado默认设置clk_out1为1开始，将其修改为0开始。
四 总结
第一节介绍了使用vivado创建硬件设计，添加硬件加速必备的IP核，ZYNQ, Reset, Concat以及ZYNQ核需要设置的外设，取消AXI外设，打开中断，设置时钟等。然后使用Tcl命令创建SDSoC所需要的DSA文件。
第二节介绍了如何使用SDx IDE创建硬件平台和硬件加速的应用程序，第三节使用硬件平台创建了一个硬件加速应用验证了平台设计的正确性。
由于开发板所使用的芯片不一样，可能按照官方的例程来操作会出现一些错误，根据错误消息，在xilinx社区基本都能找到解决方法。
参考资料
[1] Xilinx官方文档ug1146
[2] SDSoC tutorials
[3] PFM属性设置
