ZYNQ：使用 PetaLinux 构建Linux项目

参考文档：ug1144-petalinux-tools-reference-guide.pdf

环境安装

tofrodos iproute2 gawk gcc g++ git make net-tools libncurses5-dev tftpd zlib1g:i386 libssl-dev flex bison libselinux1 gnupg wget diffstat chrpath socat xterm autoconf libtool tar unzip texinfo zlib1g-dev gcc-multilib build-essential libsdl1.2-dev libglib2.0-dev screen pax gzip automake glib2-devel openssl openssl-devel xinetd tftp tftp-server redhat-lsb u-boot-tools(或 uboot-tools)

创建目录：

su root

mkdir /opt/env

chown -R huangshuchao:embd /opt/env/

#chown -R huangshuchao:embd /opt/env/

# 2016.4以后的petalinux不能以超级权限去安装，必须在$下安装petalinux。

安装

./petalinux-v2018.3-final-installer.run /opt/env/petalinux/2018.3

Ubuntu bash

dpkg-reconfigure dash

	--> NO

使用

每次都需要：

 source /opt/env/petalinux/2018.3/settings.sh

本文链接：https://www.cnblogs.com/schips/p/using-petalinux-build-linux-env.html

导入硬件

拷贝design_1_wrapper_hw_platform_0到Linux

创建项目

petalinux-create --type project --template zynq --name 项目名称（目录）

INFO: Create project: ax_peta

INFO: New project successfully created in /home/huangshuchao/ax_peta

导入硬件信息

输入以下命令：

硬件信息包：design_1_wrapper_hw_platform_0_test.tgz（来自13_vdma_to_qspi_sd）

petalinux-config --get-hw-description ~/hw-vivado/design_1_wrapper_hw_platform_0_test

配置优化

我们这里再做一些优化工作，以方便我们的使用：

离线编译

注意，修改镜像时，填入的路径是以file://开头的。

-> Yocto Settings

	## 设置缓存：SState cache

    -> Local sstate feeds settings

       -> local sstate feeds url    ## 按 Enter

	   /home/xx/sstage_package_for_petalinux/arm

-> Yocto Settings

    ## 设置镜像：download mirror

    -> Add pre-mirror url           ## 按 Enter

    file:///home/xx/sstage_package_for_petalinux/downloads

-> Yocto Settings

    ## 设置离线编译

    [ ] Enable Network sstate feeds ## 按 N

    [*] Enable BB NO NETWORK        ## 按 Y

启动Linux时自动登录

避免输入账号密码。

-> Yocto Settings

	[*] Enable Debug Tweaks			## 按 Y

不自动获取IP地址

如果网口存在时，可以考虑关闭自动获取IP地址（会造成开机过慢）

-> Subsystem AUTO Hardware Settings (SUBSYSTEM_HARDWARE_AUTO [=y])

	-> Ethernet Settings

		Primary Ethernet ((ps7_ethernet_0)  # 确认 存在此项

		[ ] Obtain IP address automatically # 按下空格键取消，并设置一个IP

		(192.168.168.168) Static IP address

		(255.255.255.0) Static IP netmask (NEW)

		(192.168.168.1) Static IP gateway

u-boot Configuration  --->

		(192.168.168.1) TFTP Server IP addres # 设置TFTP服务器地址

修改文件系统类型（可选）

默认的文件系统类型会导致文件系统无法保存，一开始的时候可以保持默认，可以在后续修改为以下配置：

-> Image Packaging Configuration

  -> Root filesystem type

    -> Root filesystem type (SD card) --->

       (/dev/mmcblk0p2) Device node of SD device (NEW)

保存退出，以下是提示信息：

INFO: Getting hardware description...

[INFO] generating Kconfig for project

[INFO] menuconfig project

*** End of the configuration.

*** Execute 'make' to start the build or try 'make help'.

[INFO] sourcing bitbake

[INFO] generating plnxtool conf

[INFO] generating meta-plnx-generated layer

[INFO] generating machine configuration

[INFO] generating bbappends for project . This may take time !

[INFO] generating u-boot configuration files

[INFO] generating kernel configuration files

[INFO] generating kconfig for Rootfs

[INFO] oldconfig rootfs

[INFO] generating petalinux-user-image.bb

配置保护

保留Linux和UBoot源代码

echo 'RM_WORK_EXCLUDE += "linux-xlnx"'>> project-spec/meta-user/conf/petalinuxbsp.conf

echo 'RM_WORK_EXCLUDE += "u-boot-xlnx"'>> project-spec/meta-user/conf/petalinuxbsp.conf

echo ''>> project-spec/meta-user/conf/petalinuxbsp.conf

原理：run.do_rm_work中有对关键字进行解析，如果符合条件，那么不执行删除操作。

配置uboot

petalinux-config -c u-boot

进行如下配置：

配置项	值与说明
Boot media	Boot介质，配置从SD卡启动
delay in seconds before automatically booting	Boot自启动时间，默认4s，可修改
Disable support for parallel NOR flash	NOR flash支持，无支持
add U-Boot environment variable vers	U-Boot环境变量添加，无
Display information about the CPU during start up	启动阶段显示CPU信息，可选
Display information about the board during start up	启动阶段显示板卡信息，可选
Command line interface	命令行配置，用户可进一步配置
Device Tree Control	设备树控制，保持默认配置（embeded）

配置内核

输入：

petalinux-config -c kernel

以下是提示信息：

[INFO] generating Kconfig for project

[INFO] sourcing bitbake

[INFO] generating plnxtool conf

[INFO] generating meta-plnx-generated layer

[INFO] generating machine configuration

[INFO] configuring: kernel

[INFO] generating kernel configuration files

[INFO] bitbake virtual/kernel -c menuconfig

Parsing recipes:   100% |##########################################| ETA:  0:00:56

Parsing of 2569 .bb files complete (0 cached, 2569 parsed). 3445 targets, 149 skipped, 0 masked, 0 errors.

NOTE: Resolving any missing task queue dependencies

很快就会弹出Menuconfig菜单，选择

CONFIG_MICREL_PHY:

-> Device Drivers

	-> Network device support (NETDEVICES [=y])

		-> PHY Device support and infrastructure (PHYLIB [=y])

			[y] Micrel PHYs

保存，EXIT。

配置文件系统

petalinux-config -c rootfs

petalinux-config -c rootfs && petalinux-build

无更改，保存退出

编译 uboot、内核、文件系统、设备树

petalinux-build

此后，生成下面的文件

# ls image/linux

rootfs.cpio      rootfs.cpio.gz.u-boot  rootfs.ext4     rootfs.jffs2     rootfs.tar.gz         system.dtb        u-boot.elf  zynq_fsbl.elf      image.ub    rootfs.cpio.bz2  rootfs.ext3            rootfs.ext4.gz  rootfs.manifest  rootfs.testdata.json  System.map.linux  vmlinux    rootfs.bin  rootfs.cpio.gz   rootfs.ext3.bz2        rootfs.its      rootfs.tar.bz2   system.bit            u-boot.bin        zImage

生成BOOT.BIN

执行下面的代码生成BOOT.BIN

petalinux-package --boot --fsbl ./images/linux/zynq_fsbl.elf --fpga ./images/linux/system.bit --u-boot --force

下面的是提示信息：

INFO: Getting system flash information...

INFO: File in BOOT BIN: "/home/huangshuchao/ax_peta2/images/linux/zynq_fsbl.elf"

INFO: File in BOOT BIN: "/home/huangshuchao/ax_peta2/images/linux/system.bit"

INFO: File in BOOT BIN: "/home/huangshuchao/ax_peta2/images/linux/u-boot.elf"

INFO: Generating Zynq binary package BOOT.BIN...

****** Xilinx Bootgen v2018.3

  **** Build date : Nov 15 2018-19:22:29

    ** Copyright 1986-2018 Xilinx, Inc. All Rights Reserved.

INFO: Binary is ready.

生成image.ub

mkimage -f ./images/linux/rootfs.its image.ub

测试

从image/linux中拷贝：BOOT.BIN、image.ub，到SD卡即可。

创建项目的脚本

##

#    Copyright By Schips, All Rights Reserved

#    https://gitee.com/schips/

#

#    File Name:  copy_petalinux_project_with_hw.sh

#    Created  :  2020-07-25 11:28:24

#

##

#!/bin/sh

# 项目工程常见参数设置

## sstage包下载后设置

SSTATE_LOCAL_PATH="/home/huangshuchao/sstage_package_for_petalinux/"

## IP地址设置

NET=192.168.1

IPADDR=$NET.100

help () {

    echo "Error : need \$projectname \$hw_bsp"

    echo "  eg :"

    echo "      $0 ax_project ~/hw-vivado-bsp-for-petalinux/some_packakge"

    exit 1

}

if [ -z "$1" ]; then

	help

fi

if [ -z "$2" ]; then

	help

fi

command -v petalinux-create >/dev/null 2>&1 || { echo >&2 "Aborted : Require \"petalinux-create\" but not found."; exit 1;  }

command -v petalinux-config >/dev/null 2>&1 || { echo >&2 "Aborted : Require \"petalinux-config\" but not found."; exit 1;  }

## 删除源目录

rm $1 -rf

## 创建项目

petalinux-create --type project --template zynq --name $1

PROJECT=$1

## 导入硬件信息

cd $PROJECT

petalinux-config --get-hw-description $2

## 使PetaLinux不删除源码

echo 'RM_WORK_EXCLUDE += "linux-xlnx"'>> project-spec/meta-user/conf/petalinuxbsp.conf

echo 'RM_WORK_EXCLUDE += "u-boot-xlnx"'>> project-spec/meta-user/conf/petalinuxbsp.conf

echo ''>> project-spec/meta-user/conf/petalinuxbsp.conf

# 删除带有指定关键字的行

delete_line_with_special_word ()

{

    if [[ $# -lt 2 ]]; then

        return

    fi

    FILE=$1

    WORD=$2

    sed -i "/${WORD}/d" ${FILE}

}

# 文件内容追加

append_line_into_file ()

{

    if [[ $# -lt 2 ]]; then

        return

    fi

    FILE=$1

    LINE=$2

    echo $LINE >> $FILE

}

CONFIG=project-spec/configs/config

cp $CONFIG $CONFIG.old

## 网络设置

delete_line_with_special_word   $CONFIG  CONFIG_SUBSYSTEM_ETHERNET_PS7_ETHERNET_0_USE_DHCP

append_line_into_file           $CONFIG  "# CONFIG_SUBSYSTEM_ETHERNET_PS7_ETHERNET_0_USE_DHCP is not set"

append_line_into_file           $CONFIG  "CONFIG_SUBSYSTEM_ETHERNET_PS7_ETHERNET_0_IP_ADDRESS=\"$IPADDR\""

append_line_into_file           $CONFIG  "CONFIG_SUBSYSTEM_ETHERNET_PS7_ETHERNET_0_IP_NETMASK=\"255.255.255.0\""

append_line_into_file           $CONFIG  "CONFIG_SUBSYSTEM_ETHERNET_PS7_ETHERNET_0_IP_GATEWAY=\"$NET.1\""

## 本地包

delete_line_with_special_word   $CONFIG  CONFIG_YOCTO_NETWORK_SSTATE_FEEDS

append_line_into_file           $CONFIG  "# CONFIG_YOCTO_NETWORK_SSTATE_FEEDS is not set"

delete_line_with_special_word   $CONFIG  CONFIG_YOCTO_BB_NO_NETWORK

append_line_into_file           $CONFIG  "CONFIG_YOCTO_BB_NO_NETWORK=y"

delete_line_with_special_word   $CONFIG  CONFIG_PRE_MIRROR_URL

append_line_into_file           $CONFIG  "CONFIG_PRE_MIRROR_URL=\"file://${SSTATE_LOCAL_PATH}/downloads\""

delete_line_with_special_word   $CONFIG  CONFIG_YOCTO_LOCAL_SSTATE_FEEDS_URL

append_line_into_file           $CONFIG  "CONFIG_YOCTO_LOCAL_SSTATE_FEEDS_URL=\"${SSTATE_LOCAL_PATH}/arm\"" #zynq

        ## | 目录      | 平台        |

        ## | --------- | ----------- |

        ## | aarch64   | ZynqMP      |

        ## | arm       | Zynq        |

        ## | mb-full   | MB AXI      |

        ## | mb-lite   | MB AXI lite |

        ## | downloads | 全平台  |

## 免输入密码登陆

delete_line_with_special_word   $CONFIG  CONFIG_YOCTO_ENABLE_DEBUG_TWEAKS

append_line_into_file           $CONFIG  "CONFIG_YOCTO_ENABLE_DEBUG_TWEAKS=y"

附录：PetaLinux注意事项

导入项目创建项目以后，工程项目会确定当前路径，所以需要注意，不要随便改动工程路径。

ERROR:  OE-core's config sanity checker detected a potential misconfiguration.

    Either fix the cause of this error or at your own risk disable the checker (see sanity.conf).

    Following is the list of potential problems / advisories:

    Error, TMPDIR has changed location. You need to either move it back to /home/huangshuchao/ax_1_design1hw0_retry/build/tmp or rebuild

不过可以通过拷贝petalinux工程的配置到另外的目录，再build出那些临时文件。

详情见：加速 PetaLinux 工程编译、复制 PetaLinux 工程

附录：构建各部分

petalinux-build -c kernel

petalinux-build -c device-tree

petalinux-build -c fsbl

petalinux-build -c u-boot

petalinux-package --boot --fsbl --fpga --u-boot --force

这样在images目录下就会生成我们需要的uImage、system.dtb以及BOOT.BIN，为了确保设备树修改完好，我们这里先反编译一下设备树，生成system.dts，查看里面是否我们要修改的东西都已经修改好了（需要device-tree-compiler）。

在system.dtb文件的目录下运行

dtc -I dtb -O dts -o system.dts system.dtb

打开ststem.dts，我们可以看到已经修改完毕