【嵌入式Linux-01】Xilinx ZynqMP Petalinux 2019.2 项目创建与配置全流程指南

原创 已于 2026-05-05 19:46:31 修改 · 601 阅读 · 10 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
收录于
嵌入式 linux 实战 专栏

当前文章被收录于：

嵌入式 linux 实战 专栏
7 篇文章 1 人学习

本专栏主要是快速呈现linux项目的平台搭建过程

订阅专栏 查看详情
于 2026-04-15 04:00:51 首次发布

前言

在基于 Xilinx ZynqMP 平台的 FPGA 开发中，Petalinux 是构建嵌入式 Linux 系统的核心工具，涵盖工程创建、硬件配置、内核裁剪、根文件系统定制、应用开发与编译打包等全流程。本文基于Petalinux 2019.2版本，详细记录 ZynQMP 工程从 0 到 1 的完整配置步骤，包含环境配置、设备树修改、外设驱动开启、应用程序创建、启动脚本定制等实操内容，适用于同平台开发人员参考。

一、环境准备与工程基础配置

1.1 工作目录与环境变量配置

首先进入 Petalinux 工作目录，加载 Petalinux 环境变量，这是执行所有 Petalinux 命令的前提：

# 进入工程工作目录
cd /opt/****/petalinux/

# 加载Petalinux 2019.2环境变量（路径根据实际安装目录调整）
source /opt/pkg/petalinux/2019.2/settings.sh

执行成功后，终端会显示 Petalinux 版本信息，代表环境配置完成。

1.2 创建 Petalinux 工程

基于 ZynqMP 模板创建多个工程（根据项目需求自定义工程名），--force参数强制覆盖已存在的同名工程：

# 基础工程
petalinux-create -t project --template zynqMP --force -n XX_XXX 
# 自定义工程1
petalinux-create -t project --template zynqMP --force -n OPT8_XXX
# 自定义工程2
petalinux-create -t project --template zynqMP --force -n TCC_XXX
  • -t project：指定创建工程类型
  • --template zynqMP：指定硬件平台为 Zynq UltraScale+ MPSoC
  • -n：指定工程名称

1.3 导入硬件描述文件（HDF/XSA）

FPGA 工程师提供的硬件描述文件（.hdf/.xsa） 包含 FPGA 引脚、外设、时钟等硬件配置，必须导入 Petalinux 工程才能匹配硬件平台。

操作步骤：

  1. 进入对应工程目录
  2. 执行命令导入硬件配置文件
  3. 特殊说明：将NR_HUB_XCZU11EG_TOP.bit比特流文件放入配置目录
# 示例1：进入NR_HUB工程并导入配置
cd NR_HUB
petalinux-config --get-hw-description=/opt/lwp/petalinux/config

# 示例2：OPT8_HUB工程配置
petalinux-config --get-hw-description=/opt/lwp/petalinux/OPT8_HUB/config

# 示例3：TCC_HUB工程配置
petalinux-config --get-hw-description=/opt/lwp/petalinux/TCC_HUB/config

# 示例4：NR-HUBLWP工程配置（需提前放入bit文件）
# 前置操作：将 NR_HUB_XCZU11EG_TOP.bit 复制到 /opt/xxx/petalinux/NR-HUBLWP/config
petalinux-config --get-hw-description=/opt/lwp/petalinux/NR-HUBLWP/config
  • /opt/lwp/petalinux/config：为 HDF/XSA 硬件文件统一存放路径（根据实际调整）
  • 执行命令后会弹出图形化配置界面，直接保存退出即可完成硬件导入

二、工程核心配置（U-Boot / 内核 / 根文件系统）

导入硬件后，需要对工程、U-Boot、Linux 内核、根文件系统进行定制化配置。

2.1 工程全局配置

# 进入工程图形化配置界面
petalinux-config

配置完成后务必保存配置，所有工程均需执行此操作。

2.2 U-Boot 配置

U-Boot 是嵌入式 Linux 的引导程序，配置硬件初始化、启动参数等：

petalinux-config -c u-boot

根据硬件需求配置串口、启动介质、网络等参数，保存退出。

2.3 Linux 内核配置

petalinux-config -c kernel

2.4 根文件系统配置（开启必备工具）

根文件系统配置用于添加系统运行所需的工具，本文需开启i2c-tools和tcpdump：

petalinux-config -c rootfs

配置步骤：

  1. 进入Filesystem -> Utilities目录
  2. 勾选i2c-tools（I2C 调试工具）
  3. 勾选tcpdump（网络抓包工具）
  4. 保存配置并退出

三、设备树（DTS）配置（核心外设驱动）

设备树是 Linux 内核识别硬件外设的关键，所有外设（串口、网口、NAND、SD 卡、SPI、共享内存等）均通过设备树配置。

3.1 设备树文件路径

Petalinux 用户自定义设备树文件路径：

project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi

直接编辑该文件，添加外设配置。

3.2 完整设备树配置代码

以下配置包含共享内存、启动参数、串口、网口、NAND Flash、SD 卡、SPI等外设，直接复制替换即可：

/include/ "system-conf.dtsi"
/ {
    // 共享内存配置（AXI reserved-memory）
    reserved-memory {
        #address-cells = <2>;
        #size-cells = <2>;
        ranges;
        sharememory_reserved: sharemme@30000000 {
            reg = <0x0 0x30000000 0x0 0x00200000>;
        };
    };
    // 内核启动参数配置
    chosen {
        bootargs = "earlycon clk_ignore_unused root=/dev/ram rw cpuidle.off=1";
        stdout-path = "serial0:115200n8";
    };
};

// 使能UART1串口
&uart1 {
    status = "okay";
};

// GEM2网口 RGMII配置
&gem2 {
    local-mac-address = [00 0a 35 00 00 01];
    status = "okay";
    fixed-link{
        speed=<1000>;
        full-duplex;
    };
};

// NAND Flash分区配置
&nand0 {
    status = "okay";
    arasan,has-mdma;
    // 删除默认分区
    /delete-node/  partition@0x00000000; 
    /delete-node/  partition@0x00040000; 
    /delete-node/  partition@0x00060000; 
    nand@0 {
        reg = <0x0>;
        #address-cells = <0x2>;
        #size-cells = <0x1>;

        /* 30MB for BOOT.BIN */
        partition@0 {
            label = "BOOT.BIN 40M";
            reg = <0x0 0x00000000 0x2800000>;
        };

        /* 1MB for u-boot env */
        partition@1 {
            label = "u-boot env 1M";
            reg = <0x0 0x02800000 0x00100000>;
        };

        /* 1MB for u-boot env backup */
        partition@2 {
            label = "u-boot env backup 1M";
            reg = <0x0 0x02900000 0x00100000>;
        };

        /* 150MB for Image0 */
        partition@3 {
            label = "NAND Image-0 150M";
            reg = <0x0 0x03a00000 0x09600000>;
        };

        /* 150MB for Image1 */
        partition@4 {
            label = "NAND Image-1 150M";
            reg = <0x0 0x0d000000 0x09600000>;
        };

        /* 40M for log file */
        partition@5 {
            label = "log file 40M";
            reg = <0x0 0x16600000 0x02800000>;
        };

        /* 8M for rf data */
        partition@6 {
            label = "rf data 8M";
            reg = <0x0 0x18e00000 0x00800000>;
        };

        /* 100MB for mnt data */
        partition@7 {
            label = "mnt data 100M";
            reg = <0x0 0x19600000 0x06400000>;
        };

        /* 32MB for reserved */
        partition@8 {
            label = "reserved 22M";
            reg = <0x0 0x1fa00000 0x01600000>;
        };
    };
};

// SD卡1配置
&sdhci1 {
    status = "okay";
    max-frequency = <50000000>;
    no-1-8-v;
    disable-wp;
};	

// SPI0配置（用户态SPI驱动）
&spi0 {
    status = "okay";
  
    spidev@0x00 {
        buswidth = <32>;
        compatible = "spidev";
        status = "okay";
        reg = <0>;
        spi-max-frequency = <25000000>;
    };
};

3.3 SPI 内核驱动开启

设备树配置 SPI 后，需要在内核中开启 SPI 用户态驱动支持：

  1. 执行内核配置命令：petalinux-config -c kernel
  2. 进入路径：Device Drivers -> SPI support
  3. 勾选User mode SPI device driver support
  4. 保存配置退出

四、应用程序与启动脚本创建

Petalinux 支持创建 C 语言应用、安装型脚本，用于定制系统功能。

4.1 创建 C 语言应用程序

创建 C 语言模板应用，默认自动编译并集成到 rootfs：

# 基础应用
petalinux-create -t apps --template c -n myapp --enable
# SPI测试应用
petalinux-create -t apps --template c -n spidev-test --enable
# SPI工具应用
petalinux-create -t apps --template c -n spitools --enable
  • 应用存放路径：<PROJECT>/project-spec/meta-user/recipes-apps/
  • --enable：默认开启编译，自动打包到系统

4.2 创建安装型启动脚本 / 工具

创建安装型应用（用于启动脚本、bin 文件、shell 脚本部署）：

# 系统启动脚本
petalinux-create -t apps --template install -n startup --enable
# si5383时钟配置脚本
petalinux-create -t apps --template install -n si5383 --enable
# GPIO控制脚本
petalinux-create -t apps --template install -n gpio  --enable
# 重启控制脚本
petalinux-create -t apps --template install -n reboot --enable
# SFP模块配置脚本
petalinux-create -t apps --template install -n sfp --enable

4.3 部署自定义 Bin/Shell 脚本

以gpio脚本为例，将预编译的 bin 文件或 shell 脚本部署到系统：

  1. 脚本存放路径：<PROJECT>/project-spec/meta-user/recipes-apps/gpio/files/
  2. 将自定义gpio脚本替换该目录下的默认文件
  3. 编译后脚本会自动拷贝到系统/usr/bin/目录，可直接执行

五、工程编译与镜像打包

配置完成后，执行编译生成 Linux 镜像，再打包生成启动文件BOOT.BIN。

5.1 编译 Linux 系统镜像

# 全编译工程，生成image.ub、内核、U-Boot等文件
petalinux-build

编译时间根据电脑配置而定，编译成功后输出文件在：images/linux/

5.2 打包 BOOT.BIN 启动文件

进入镜像目录，将 FSBL、U-Boot、PMUFW、FPGA 比特流打包为启动文件：

# 进入镜像输出目录
cd images/linux 

# 打包命令（当前目录存在bit文件）
petalinux-package --boot --format BIN --fsbl zynqmp_fsbl.elf --u-boot u-boot.elf --pmufw pmufw.elf --fpga *.bit --force

# 打包命令（bit文件在上级目录）
petalinux-package --boot --format BIN --fsbl zynqmp_fsbl.elf --u-boot u-boot.elf --pmufw pmufw.elf --fpga ../../*.bit --force
  • --force：强制覆盖已存在的 BOOT.BIN
  • 最终生成的BOOT.BIN和image.ub为系统启动核心文件，烧录至开发板即可运行

六、总结

本文完整梳理了Petalinux 2019.2基于 ZynqMP 平台的工程开发全流程，核心要点如下：

  1. 环境配置与工程创建是基础，必须正确导入 FPGA 硬件描述文件；
  2. 设备树是外设驱动的核心，需根据硬件平台精准配置；
  3. 内核、U-Boot、根文件系统按需裁剪，开启必备工具与驱动；
  4. 自定义应用与脚本可快速扩展系统功能；
  5. 编译打包后生成的 BOOT.BIN 和 image.ub 为最终启动镜像。

本流程适用于 Xilinx Zynq UltraScale + 系列 FPGA 的 Linux 系统开发，可根据实际项目硬件调整配置参数，快速完成嵌入式 Linux 系统定制。

标签
#fpga开发
【Xilinx】开发环境（三）- Petalinux构建工程，编译
顶级小学生
03-30 4821
Xilinx开发，ARM开发，嵌入式，Linux开发
ZYNQ MPSoC通过petalinux运行DMA驱动（1）
weixin_57361675的博客
10-09 1923
如果我们希望通过在软件层面驱动硬件DMA，就需要根据硬件平台来编写相应的驱动代码。本博客以一个基础的DMA环通测试为硬件平台，将ALINX教程中有关Linux中的DMA驱动进行完整的实现。
【Xlinx】【ZynqMP】Petalinux2020.1 QSPI Flash启动Linux的常见问题与优化实践
weixin_29186249的博客
01-23 413
本文详细解析了在Xlinx ZynqMP平台上使用Petalinux2020.1通过QSPI Flash启动Linux系统的核心挑战与优化实践。针对分区规划、CRC校验失败等常见问题，提供了实战解决方案和高效烧录技巧，包括分区对齐策略、boot.scr零填充方法及性能优化配置，帮助开发者提升系统启动可靠性和运行效率。
告别Petalinux！手把手教你用Vitis 2021.2为ZynqMP构建传统Linux启动镜像（附黑金AXU2CGB板卡实测）
weixin_33738982的博客
04-27 377
本文详细介绍了如何使用Vitis 2021.2为ZynqMP平台构建传统Linux启动镜像，绕过Petalinux的复杂性。从环境配置、固件编译到U-Boot和Linux内核定制，再到镜像打包与启动配置，手把手教你完成整个流程，并以黑金AXU2CGB板卡为例进行实测验证。
ZYNQ MPSoC通过petalinux运行DMA驱动（2）
weixin_57361675的博客
10-13 1692
本教程使用Zynq UltraScale+ MPSoC开发板平台，在构建出dma环通测试的硬件平台的基础上，配置petalinux，编译并运行github开源项目xilinx_axidma驱动，并运行相关测试程序。
linux 2.6.32 sdxc 补丁,AR# 73079: 2019.2 Zynq UltraScale+ MPSoC: PetaLinux ZCU106 BSP fails to detect ...
weixin_42374930的博客
05-16 2034
Xilinx Zynq MP First Stage Boot LoaderRelease 2019.2 Oct 25 2019 - 09:07:59NOTICE: ATF running on XCZU7EV/silicon v4/RTL5.1 at 0xfffea000NOTICE: BL31: Secure code at 0x0NOTICE: BL31: Non secure...
花旗linux 内核 如何调试,petalinux如何保留u-boot和kernel源码
weixin_36432875的博客
04-30 706
5. Open Source Linux和UBoot 5.1. 保留Linux和UBoot源代码缺省情况下，PetaLinux在编译完成后会删除源代码，以节省硬盘空间。在project-spec/meta-user/conf/petalinuxbsp.conf里，添加如下内容，可以保留Linux和UBoot源代码。RM_WORK_EXCLUDE += "linux-xlnx"RM_WORK_EXC...
canutils移植到arm linux,【分享】 PetaLinux工程出现大量Taskhash mismatch错误的原因
weixin_39983350的博客
05-13 684
1. AuthorHank Fu (付汉杰) Staff FAE embedded, Xilinx, Inc.hankf@xilinx.com2. 问题有工程师反映，在编译PetaLinux工程时，出现大量Taskhash mismatch错误。工程还没有编译完成，检查build.log，已经出现超过200个的Taskhash mismatch错误。最早出现的错误信息如下。ERROR: zlib...
ZYNQ MPSoC基于Petalinux的DMA驱动性能优化与实战分析
jjj34的博客
02-14 202
本文深入探讨了ZYNQ MPSoC基于Petalinux的DMA驱动性能优化与实战分析。通过环境搭建、系统配置、瓶颈分析到代码优化策略，详细介绍了如何提升DMA传输效率，并分享了多通道配置、性能测试对比及常见问题解决方案，为开发者实现高速数据采集等应用提供实用指导。
01_VHDL基础入门
QQ_778132974的博客
06-27 39
摘要：VHDL是一种硬件描述语言，用于数字电路设计，具有可移植性强、设计效率高等优势。文章介绍了VHDL的发展历程，并与Verilog进行对比。重点讲解了VHDL的基本语法结构，包括实体声明、结构体定义和常用数据类型（如std_logic和std_logic_vector）。此外，还详细说明了逻辑、算术、关系和移位等运算符。最后通过2输入与门和4位二进制比较器两个实战案例，展示了VHDL代码的实际应用，帮助初学者理解数字电路设计的基本流程和方法。
信号处理名词解释
2401_87190807的博客
06-29 218
数字调制技术名词解释
lattice 中Reveal Inserter 中add controller和逻辑分析仪有什么区别么
m0_59337107的博客
07-01 297
在 Lattice 的 Reveal Inserter 中，，用于解决不同类型的问题。
AMD/XILINX(赛灵思)代理现货库存XC7S50-2FGGA484C
2603_95400241的博客
06-29 403
芯片基础：Spartan-7 XC7S50、商用 C 档结温 0℃~+85℃、速度等级 - 2、FGGA484 23×23mm 0.8mm BGA、28nm、Vivado 开发、无 GTP 高速收发器、内置 XADC/AES 加密 / MultiBoot、支持 DDR3、必须外挂 QSPI Flash、无硬件 SEU 纠错。自带 12 位高速 ADC，实时监测芯片温度、各路电源电压、外部传感器模拟量，用于设备过热保护、电源故障告警，节约 ADC、运放、基准源外围器件。双镜像分区远程升级不怕断电变砖；
星载高性能计算平台低纹波抗辐射电源架构设计与ASP4644适配性分析
最新发布
ANSILIC的博客
07-02 169
星载高性能计算平台对电源系统的纹波抑制、瞬态响应与电压跟踪能力提出了极高要求。本文围绕国科安芯ASP4644四通道降压稳压器，基于该器件数据手册与芯片测试报告中的实测数据，系统分析了其在低纹波输出、动态负载响应、多通道电压跟踪等关键性能指标上的表现。研究结果表明，ASP4644在典型工作条件下的输出纹波可低至4.5mV，负载调整率约为0.4%，动态响应峰峰值约320mV，并具备多通道输出跟踪功能，能够为星载FPGA与处理器供电系统提供符合工程要求的电源解决方案。
基于FPGA的通用化BPSK调制解调模块verilog开发,可配置载波频率,符号速率,滤波滚降系数
fpga/matlab/simulink算法仿真工程
06-27 191
本文介绍了一种基于FPGA的可配置BPSK调制解调系统。该系统通过将二进制比特流映射为正交两路相位调制信号，经根升余弦滤波成型后实现载波调制，接收端通过载波同步、匹配滤波和相位判决恢复原始数据。系统支持通过寄存器配置载波频率、符号速率和滚降系数，具有通用性和灵活性。测试结果表明，该系统在MATLAB和FPGA环境下均能实现良好的调制解调性能，星座图清晰显示了理想调制符号和受噪声影响的接收符号。文章还详细阐述了BPSK的理论基础、FPGA实现步骤和核心程序代码，为相关领域的研究提供了技术参考。
国产多功能高速数字化仪PXIe-7964R FPGA板卡（250M/16bit：4AI+2AO）兼容LabVIEW FPGA软件开发
qq_40694786的博客
06-28 412
1、二合一，同时支持PXIe总线、Ethernet千兆以太网总线通信的高速数字化仪PXIe-7964R系列FPGA RIO板卡诞生了，后发优势，覆盖NI-57xx等FlexRIO系列FPGA板卡，兼容LabVIEW My FPGA开发环境。 2、指标：4通道16位同步并行AI（250MS/s采样率）、2通道16位同步并行AO（250MS/s更新率）、8路双向高速DIO、8路LED灯、PXIe接口、Ethernet千兆以太网接口。
嵌入式系统 VHDL 入门笔记：从语法到状态机
2403_87969572的博客
06-27 475
本文基于个人 VHDL 学习笔记整理，系统介绍硬件描述语言的基本语法与事件驱动原理，并通过逻辑门、多路选择器、数码管编码、表决器、D/JK 触发器、计数器、分频 PWM 及 RGB 状态机等实例，帮助读者从零掌握嵌入式数字电路设计。
【FPGA通信入门】完整2ASK调制解调工程（非相干+相干Costas锁相解调 超详细）（附源码）
nskksms的博客
06-30 357
本文介绍了一个基于FPGA实现的2ASK调制与双解调方案项目。系统包含标准2ASK调制（载波100kHz，码率25kbps）及两种解调方案：非相干解调（包络检波）采用整流+滑动滤波+判决的简易结构；相干解调则通过Costas锁相环实现I/Q正交混频的高精度解调。文章详细解析了各模块设计，包括M序列生成、载波ROM存储、乘法调制，以及解调端的整流、滤波和锁相环等关键电路。重点对比了两种解调方案的特点：非相干解调简单但抗噪性差，相干解调复杂度高但性能优越。项目完整复现了通信原理中的ASK技术，特别适合初学者理解
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值