【Xilinx-Petalinux学习】-02-建立PetaLinux工程
前面我已经把PetaLinux成功安装到了Ubuntu虚拟机当中了，接下来就要实际操作，将PetaLinux移植到我们自己的硬件平台当中去。
step1：硬件描述文件
有两种PetaLinux工程建立的方法，一种是下载官方开发板的BSP包并安装，一种就是针对自己的硬件平台去剪裁Linux功能以适应自己的需求。
第一种，比较简单，官方提供了完整的demo和已经预编译好的各种文件。
比如说我们从网上下载了Avnet-Digilent-ZedBoard-v2015.4-final.bsp，我们直接执行下面的命令就可以安装这个BSP包了。安装完成后，PetaLinux工程就安装在了Avnet-Digilent-ZedBoard-v2015.4-final文件夹下面。可以选择自己重新编译，或者直接使用预编译好的文件直接拷贝到SD卡中，马上就能够在ZedBoard上运行PetaLinux了。
| 1 |
petalinux-create -t project -s ./Avnet-Digilent-ZedBoard-v2015.4-final.bsp
|
第二种，根据我们自行设计的硬件平台去创建PetaLinux工程。这就稍微复杂一些了，需要进行各种配置，我也是尝试了各种配置方法，最终获得了一个基本上满足我需求的结果。
选用的芯片是ZYNQ系列的芯片，我们将会在内部的ARM硬核上去跑Linux。
首先，为了让PetaLinux正常的运行，需要分配一些硬件外设资源给PetaLinux，文档ug1144中也说明了PetaLinux中对Zynq-7000系列FPGA硬件资源的需求。若用到了MicroBlaze或者Zynq Ultrascal+ MPSoC的话，自己查看文档说明吧。
| 1 2 3 4 5 |
1.TTC模块（必须） #如果多个TTC都使用了的话，Linux内核将会使用第一个TTC模块。
2.外部32MB存储空间（必须）
3.UART模块（可选，控制台打印信息用） #如果用UART IP模块的话，如AXI UART，需要确保中断信号有连接到PS
4.非易失存储器（可选） #如QSPI Flash，SD/MMC
5.以太网接口（可选） #若果用Ethernet IP模块或外部PHY的话，需要确保中断信号连接道PS
|
知道这些后，我们在Vivado中设计硬件平台时需要预留好上述模块就可以了。Vivado设计，综合，实现后，我们在Vivado中使用“Export Hardware”输出PetaLinux需要的硬件描述文件。
输出的文件都在“/<vivado project>/<project name>.sdk/<top module name>_hw_platform_0”文件夹下。
如果我们使用的是Windows版本的Vivado，我们就需要把“***_hw_platform_0”这个文件夹拖到Linux虚拟机当中去。如果使用Linux版本的Vivado，之后直接定位到这个文件夹就可以了。
step2：创建PetaLinux工程
接下来就能够根据这些硬件描述文件，来创建基于我们自己的硬件平台的PetaLinux工程了。
首先，创建一个PetaLinux工程目录。执行命令：
| 1 2 |
#创建工程，针对Zynq芯片，工程名称ifc_petalinux
petalinux-create --type project --template zynq --name ifc_petalinux
|
创建成功后，在ifc_petalinux目录下将包含2个文件夹和一个文件，如下所示。
接着，我们来引用刚才输出的硬件描述文件。执行命令：
| 1 |
petalinux-config --get-hw-description=/home/xilinx-arm/PetaLinux/ifc_v1_0/ifc_hw_description/IFC_TOP_wrapper_hw_platform_0
|
因为是空工程，我们会进入一个配置界面。在里面我们可以配置一些系统参数，主要的配置包括：启动方式，启动存储器分区表，启动文件名称等等。
这里我们仅需要修改两个启动方式选项即可。boot和kernel的存储位置，都选到QSPI Flash即可。配置如下：
| 1 2 3 4 5 6 |
#Subsystem AUTO Hardware Settings --->
# Advanced bootable images storage Settings --->
# boot image settings --->
# image storage media ---> choose primary flash
# kernel image settings --->
# image storage media ---> choose primary flash
|
这里要说明一下，因为我自己的板子上包含了QSPI Flash、eMMC、USB，而没有SD卡、以太网。
所以非常尴尬，不能通过简单的SD卡复制文件去进行系统boot，必须通过JTAG下载BOOT.bin和image.ub文件。非常非常的e'xin！！下载两个文件就要下载好久，这也导致我每次尝试都花费大量时间在下载Flash上。
所以在这里，建议大家一定要在设计板子的时候尽量留好SD卡的位置，或者就算留上几个测试点飞线出来也好，对开发来说肯定会提供很多方便。
回到正题，配置完成后，按ESC并选择YES保存配置。系统就自动进行配置了，配置成功的打印信息如下：
为了方便我们之后复制和修改文件，执行命令：
| 1 |
chmod -R 777 ../ifc_petalinux/
|
step3：内核配置
因为硬件平台没有SD卡和网口，尴尬的我很难复制文件。想了个办法，就是通过U盘去复制文件，所以我需要把USB配置一下，让系统能够识别出U盘，并进行读写操作。而且以后可能用到USB摄像头，就顺便把这个功能也打开吧。参考网址：http://www.wiki.xilinx.com/Zynq+Linux+USB+Device+Driver
配置kernel，执行命令：
| 1 |
petalinux-config -c kernel
|
打开了kernel的配置界面，
USB的配置如下：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
#Device Drivers --->
# USB support --->
# <*> Support for Host-side USB
# <*> OTG support
# <*> EHCI HCD (USB 2.0) support
# <*> USB Mass Storage support
# <*> ChipIdea Highspeed Dual Role Controller
# <*> ChipIdea host controller
# <*> ChipIdea device controller
# USB Physical Layer drivers --->
# <*> NOP USB Transceiver Driver ####!!!在2015.4中不用打开这个
# <*> USB Gadget Support
# <M> USB Gadget Drivers
# <M> USB functions configurable through configfs
# [*] Mass storage
|
上面都是按照OTG功能来配置的，但我暂时没有OTG的转接线，没法调试不敢确认是否能用，所以我们最后在设备树中只开启host功能。
其实除了“NOP USB Transceiver Driver”是默认没有打开，剩下都是默认打开的，我最终根据自己的配置并没有打开这个选项！！！
USB摄像头配置如下：
| 1 2 3 4 5 6 |
#Device Drivers --->
# Multimedia Support --->
# Media USB Adapter --->
# <*>USB Video Class (UVC) (also UVC Input Event Support) #打开
# USB Support --->
# < >USB 2.0 OTG FSM Implementation #关闭
|
配置完成后，ESC并保存。
step4：设备树配置
我设计的板子是参考ZYBO开发板的，usb phy上有一个reset引脚连接到了PS的MIO46管脚上。
需要在设备树中告诉系统。
设备树文件都在目录 ./subsystems/linux/configs/device-tree 底下
首先修改pcw.dtsi文件：（在最下面的问题二中，解决了usb reset的问题。按照解决方法配置好后，就不用修改pcw.dtsi文件了，它能够自动生成！）
| 1 2 3 4 5 6 7 8 9 |
gedit subsystems/linux/configs/device-tree/pcw.dtsi
#在&usb0上增加一行usb-reset = <&gpio0 46 0>;
#最后如下：
&usb0 {
dr_mode = "host";
phy_type = "ulpi";
status = "okay";
usb-reset = <&gpio0 46 0>;
};
|
接着修改system-top.dts文件：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
gedit subsystems/linux/configs/device-tree/system-top.dts
#可以看到里面基本是空的
#在里面增加以下内容
&qspi {
flash0: flash@0 {
compatible = "micron,n25q128a11";
};
};
/{
usb_phy0: usb_phy@0 {
compatible="ulpi-phy"; ###假如前面的kernel配置中打开了“NOP USB Transceiver Driver”,需要配置为compatible="usb-nop-xceiv";
#phy-cells = <0>;
reg = <0xe0002000 0x1000>;
view-port=<0x170>;
reset-gpios = <&gpio0 46 1>;
drv-vbus;
};
};
&usb0 {
status = "okay";
dr_mode = "host";
usb-phy = <&usb_phy0>;
};
|
其中QSPI Flash我用到型号是N25Q128A11EF740E，所以要在这个设备树中说明。而USB配置为host模式，并打开VBUS电源。
step5：编译和下载程序
终于，配置完成了，接下来就可以愉快的编译了，执行命令：
| 1 |
petalinux-build
|
编译成功log：
最终在./images/linux文件夹下，就能够找到我们需要的各种文件了。
我们需要的四个文件是：
| 1 2 3 4 |
zynq_fsbl.elf #FSBL可执行文件
IFC_TOP_wrapper.bit #FPGA配置bit文件
u-boot.elf #SSBL可执行文件
image.ub #linux镜像文件
|
由于我没有在Linux虚拟机中安装Vivado，所以我没有办法使用“petalinux-package”命令。
因此我将这四个文件拖到Windows中进行处理，
在Windows中打开Xilinx SDK，选择 Xilinx Tools->Create Boot Image，可以参考一下官方手册，
分别按顺序加入 zynq_fsbl.elf--->IFC_TOP_wrapper.bit--->u-boot.elf 三个文件。点击 Create Image 按钮，生成BOOT.bin文件。
因为我的系统中没有SD卡，而且一开始就配置为了QSPI FLASH启动的方式，在Xilinx SDK中选择 Xilinx Tools->Program Flash。
Image File选择刚才生成的BOOT.bin文件，Flash Type选择qspi_single，Offset填写0，点击Program按钮。烧录完成后，我们的FSBL,bit,SSBL就成功下载到QSPI Flash中去了，我们就已经可以实现u-boot的启动了，但是还不能引导kernel。
接下来烧录image.ub文件，因为Image File只能选择.bin或者.mcs文件，所以需要把image.ub重新命名为image.ub.bin，好像有点粗暴。。。
然后Offset需要填写偏移地址，这个地址可以通过petalinux-config配置，或者可以通过system-config.dtsi文件查看。内容如下：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
&qspi {
#address-cells = <1>;
#size-cells = <0>;
flash0: flash@0 {
compatible = "micron,n25q128";
reg = <0x0>;
#address-cells = <1>;
#size-cells = <1>;
spi-max-frequency = <50000000>;
partition@0x00000000 {
label = "boot";
reg = <0x00000000 0x00500000>;
};
partition@0x00500000 {
label = "bootenv";
reg = <0x00500000 0x00020000>;
};
partition@0x00520000 {
label = "kernel";
reg = <0x00520000 0x00a80000>;
};
partition@0x00fa0000 {
label = "spare";
reg = <0x00fa0000 0x00000000>;
};
};
};
|
可以看到kernel的偏移地址是0x00520000，所以Offset就填写这个数值。点击Program烧录。
最终，我们通过跳线方式将板子的启动方式配置为QSPI Flash，上电，启动~~~~
我们的PetaLinux就成功运行了~~~~哈哈哈哈
运行后插入了USB Hub和U盘，成功挂载！之后传输文件或者更新BOOT.bin和image.ub就可以用U盘复制了，JTAG下载flash的方式实在是太慢了！
Log打印没有截图，有空了copy一下。先留个位置。
| 1 |
log信息
|
需要做PetaLinux版本控制时，需要备份如下几个文件夹内的所有文件：
| 1 2 3 |
• "<plnx-proj-root>/.petalinux"
• "<plnx-proj-root>/build/"
• "<plnx-proj-root>/images/"
|
需要注意的问题：
1.假如在FPGA中用到了VDMA模块，在编译时会提示有错误出现。
原因是VDMA的中断编号有错误，我的处理方法是在pl.dtsi设备树文件中，把每个VDMA模块里的MM2S,S2MM通道的interrupt=-1那两行直接删除，这样就能够成功编译了。但是有什么影响我就不知道了。以后再研究吧。
2.在petalinux-config配置完成后，提示类似No USB reset found, No ethernet reset found类似的警告。
一直以为是设备树的问题，最后发现原来是在Vivado中Zynq系统配置时，没有设置Reset对应的MIO管脚。配置好后就不需要修改pcw.dtsi文件了。如下图，配置了USB的Reset为MIO46。
配置这个后，当调用 petalinux-config --get-hw-description=/*** 命令时，就会自动在pcw.dtsi文件中生成“usb-reset = <&gpio0 46 0>;”这段描述了。
3.USB HOST模式，USB PHY的CPEN不使能电源，导致不能向外供电。
由于我使用的是2015.4的PetaLinux，这个bug已经被修复了。在之前的版本会出现这个现象，大致原因就是就算配置设备树成host模式，系统仍然按otg方式配置了USB。
问题描述的网址：
https://forums.xilinx.com/t5/Embedded-Linux/Petalinux-2015-2-1-usb-not-working/td-p/654349
http://zedboard.org/content/using-petalinux-configure-zedboard%EF%BC%8C-usb-otg-can-not-work解决方法就是在petalinux中安装一个app，每次启动时候运行脚本强制打开USB。也可以手动打开，针对usb0，执行命令：devmem 0xe0002170 32 0x600a0067
补丁网址：https://forums.xilinx.com/xlnx/attachments/xlnx/ELINUX/14090/1/force_usb_power.tar.gz
app的安装方法参考ug1144，执行的命令大致包括：
| 1 2 3 4 5 6 7 8 |
mkdir ./components/apps/force_usb_power
#复制force_usb_power.sh, Kconfig, Makefile, README四个文件到文件夹下
petalinux-config -c rootfs
#进入Applications ---> 使能force_usb_power应用
petalinux-build -c /rootfs/force_usb_power
petalinux-build -c /rootfs/force_usb_power
petalinux-build -x package
#得到了打了补丁的image.ub文件
|
原文：https://www.cnblogs.com/vacajk/p/6148857.html