本篇Petalinux安裝，選自 ALINX 黑金云課堂 FPGA 免費直播課。該課程由 ALINX 資深工程師團隊傾力打造，從 0 到 1 系統(tǒng)化教學，幫助每位工程師跨過 FPGA 開發(fā)門檻。

Petalinux 安裝

工具安裝

在 Ubuntu 安裝環(huán)境依賴

sudo  apt-get  update
sudo dpkg --add-architecture i386
sudo apt-get install iproute2 gawk python3  build-essential gcc git make net-tools libncurses-dev tftpd-hpa zlib1g-dev libssl-dev flex bison libselinux1 gnupg wget diffstat chrpath socat xterm autoconf libtool tar unzip texinfo zlib1g-dev gcc-multilib automake zlib1g:i386 screen pax gzip cpio python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa-dev libsdl1.2-dev pylint libtinfo5

修改系統(tǒng)默認 shell

sudo dpkg-reconfigure dash  

創(chuàng)建安裝目錄

sudo  chown  -R  $USER:$USER     /opt
mkdir   -p   /opt/pkg/petalinux/2025.2
sudo  chmod   0755   /opt/pkg/petalinux/2025.2  

確保 en_US.UTF-8 語言集已安裝

sudo apt install -y locales
sudo locale-gen en_US.UTF-8 

安裝 Petalinux 工具

chmod   +x   petalinux-v2025.2-11160223-installer.run
./petalinux-v2025.2-11160223-installer.run   -d   /opt/pkg/petalinux/2025.2

Petalinux 常用命令講解

工程創(chuàng)建：petalinux-create project

petalinux-create  project  --template    --name  

硬件配置導入：petalinux-config --get-hw-description

petalinux-config  --get-hw-description  

配置工程：petalinux-config

petalinux-config  -c   

petalinux-build  -c   

Petalinux 測試工程創(chuàng)建

創(chuàng)建工作目錄

mkdir  -p  ~/peta_prj/linuxPsBase/hardware

拷貝 xsa 文件

將 vivado 工程導出的 xsa 文件拷貝到上一步創(chuàng)建的 hardware 目錄中

解壓離線資源文件

在 Downloads 目錄下創(chuàng)建 offline_pkg 目錄

將我們提供的離線資源壓縮文件 sstate_aarch64_2025.2_11151021.tar.gz 和 downloads_2025.2_11151021.tar.gz 分別解壓到 offline_pkg 目錄下

配置 petalinux 環(huán)境變量

cd   ~/peta_prj/linuxPsBase
source   /opt/pkg/petalinux/2025.2/settings.sh 

創(chuàng)建petalinux工程

petalinux-create  project  --template  zynqMP  --name  petalinux
cd   petalinux

導入硬件信息，初始化 petalinux 工程

petalinux-config   --get-hw-description   ../hardware

配置界面控制說明

導入硬件信息后會進入 petalinux 工程全局配置界面，之后可以通過petalinux-config命令再次進入 在配置界面中，使用鍵盤的上下方向鍵控制界面中間藍色光標移動，使用鍵盤的左右方向鍵控制界面底部藍色光標移動

如果界面中間的光標選中一個選項分支，且界面底部光標選中Select，按下鍵盤的回車鍵就會進入該選項分支界面

如果界面底部光標選中Exit，按下回車，會退出當前選項分支界面。如果光標選中Save，則會保存配置到工程中

按下鍵盤的/，進入配置搜索界面，通過關鍵詞搜索相關配置。在搜索結果界面通過滾輪翻動搜索結果，通過數(shù)字鍵1~9快速跳轉到配置選項

配置選項一般可以通過鍵盤的y鍵選中，n鍵取消選中

取消在線編譯

進入Yocto Settings ->，取消Enable Network sstate feeds選項

設置離線編譯資源路徑

進入Yocto Settings -> Local sstate feeds settings ->，修改local sstate feeds url內容為解壓出來的離線資源目錄 sstate 的路徑: /home/alinx/Downloads/offline_pkg/aarch64

進入Yocto Settings —> Add pre-mirror url —>，修改pre-mirror url path內容為解壓出來的離線資源目錄 downloads 的路徑，并在路徑前添加file://: file:///home/alinx/Downloads/offline_pkg/downloads

選擇Save保存配置，然后一直選擇Exit直到退出配置界面

修改用戶設備樹文件

修改plnx-proj-root>/project-spec/meta-user/recipes-bsp/device-tree/files下的設備樹文件system-user.dtsi

編譯 petalinux 工程

petalinux-build

合成啟動鏡像文件 BOOT.BIN

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

制作包含 linux 系統(tǒng)啟動鏡像的 sd 卡

將plnx-proj-root>/images/linux目錄下BOOT.BIN、boot.scr、image.ub文件拷貝到 FAT32 格式的 SD 卡中

板卡啟動測試

將 SD 卡插入板卡，板卡上撥碼設置為 SD 啟動模式，通過 usb 線連接板卡 PS_UART 接口和主機的 usb 接口，打開串口終端軟件，上電啟動

登錄系統(tǒng)

等待系統(tǒng)啟動完成后，輸入用戶名（默認用戶名是 petalinux）

初次登錄會提示設置用戶密碼，設置完成后進入系統(tǒng)

因為 petalinux 制作的根文件默認為 ram 類型，所以文件系統(tǒng)不能保存文件和配置，即重啟后恢復初始狀態(tài)

使用 petalinux 的 bsp 包，可以方便快速地復現(xiàn)別人驗證好的 petalinux 工程，或者導出我們驗證好的 petalinux 工程的 bsp 包供他人使用。

創(chuàng)建 bsp 包

petalinux-package  --bsp   -p   ./petalinux/   --output   petalinux.bsp

使用 bsp 包

petalinux-create  project   -n   petalinux   -s   ./petalinux.bsp

配置 SD 卡根文件系統(tǒng)

Petalinux 默認的根文件系統(tǒng)類型是 INITRAMFS，不能保存文件和配置。需要使用 sd 卡掛載根文件系統(tǒng)，制作一個可以保存文件和配置的板載 linux 系統(tǒng)。

進入全局配置界面

petalinux-config

配置 SD 卡根文件系統(tǒng)

進入Image Packaging Configuration ->Root filesystem type選項，選擇EXT4 (SD/eMMC/QSPI/SATA/USB)

選擇Device node of SD device選項，設置根文件系統(tǒng)路徑為/dev/mmcblk1p2

保存配置后，退出配置界面，編譯 petalinux 工程，合成 BOOT.BIN 文件

使用 disks 軟件對 SD 卡進行分區(qū)

將 SD 卡插入讀卡器，然后將讀卡器插入電腦的 USB 口

在 Ubuntu 的搜索欄中搜索 disks，打開 disks 軟件

對 SD 卡重新分區(qū)

在 disks 界面中選擇 SD 卡對應設備，如果 SD 卡已經有分區(qū)，需要點擊分區(qū)刪除圖標，將所有分區(qū)刪除

點擊創(chuàng)建分區(qū)圖標，創(chuàng)建第一個分區(qū)，分區(qū)大小設置為 1GB，分區(qū)名稱為 BOOT，分區(qū)格式為 FAT

點擊創(chuàng)建分區(qū)圖標，創(chuàng)建第二個分區(qū)，分區(qū)大小設置為 5GB，分區(qū)名稱為 ROOTFS，分區(qū)格式為 EXT4

點擊分區(qū)掛載圖標，手動掛載 SD 卡的兩個新分區(qū)到 Ubuntu 系統(tǒng)

解壓根文件系統(tǒng)到 SD 卡

sudo   tar   -zxvf   rootfs.tar.gz   -C   /media/alinx/ROOTFS/
sudo   sync

拷貝啟動鏡像文件到 SD 卡

將 /images/linux 目錄下 BOOT.BIN、boot.scr、image.ub 文件拷貝到 SD 卡的 BOOT 分區(qū)

完成拷貝后，在 Ubuntu 系統(tǒng)中彈出 SD 卡

板卡啟動測試

將 SD 卡插入板卡，板卡上撥碼設置為 SD 啟動模式，上電啟動

本次啟動后系統(tǒng)就能夠保存配置和文件了

應用開發(fā)工具安裝

SDK 生成及安裝

進入 rootfs 配置界面

petalinux-config   -c   rootfs

配置組合包選項

packagegroup-xilinx-audio   ---> 	[*] packagegroup-xilinx-audio 
packagegroup-xilinx-gstreamer   ---> 	[*] packagegroup-xilinx-gstreamer 
packagegroup-xilinx-matchbox   ---> 	[*] packagegroup-xilinx-matchbox 
packagegroup-xilinx-multimedia   --->	 [*] packagegroup-xilinx-multimedia 
packagegroup-networking-stack   --->	[*] packagegroup-networking-stack
packagegroup-opencv   --->	 [*] packagegroup-opencv 
packagegroup-xilinx-qt   --->	[*] packagegroup-xilinx-qt 
                     			 [*] populate_sdk_qt5 
packagegroup-xilinx-qt-extended   --->	[*] packagegroup-xilinx-qt-extended
packagegroup-core-x11   --->	 [*] packagegroup-core-x11

配置 GPU 庫和 GDB 調試選項

libs   ---> libmali-xlnx   --->	               [*] libmali-xlnx
misc   ---> gdb   --->	               [*] gdb
[*] gdbserver

編譯 petalinux 工程

選擇Save保存配置，然后選擇Exit退出配置界面，編譯 petalinux 工程

生成 SDK

petalinux-build    --sdk

安裝 SDK

#  創(chuàng)建安裝目錄
mkdir  -p  /opt/petalinux/2025.2/aarch64
#  安裝SDK
./sdk.sh   -d   /opt/petalinux/2025.2/aarch64/

QtCreator 安裝及配置

安裝 QtCreator 以及 Qt5 的庫

sudo   apt   update 
sudo   apt   install  qtcreator  qtbase5-dev
sudo   apt   install  qt5*

打開 QtCreator

qtcreator  & 

添加 SDK 對應的 qmake 版本

在 QtCreator 界面中選擇 Tools -> Options，進入配置界面

點擊左側 Kits 欄目，選擇上方 Qt Versions 標簽頁

點擊Add...選項，添加 /opt/petalinux/2025.2/aarch64/sysroots/x86_64-petalinux-linux/usr/bin/ 路徑下的 qmake 文件

添加 SDK 對應的 C 編譯器

選擇上方 Compilers 標簽頁，點擊 Add -> GCC -> C

設置 Name 為 GCC_zynqMP，Compiler path 為 /opt/petalinux/2025.2/aarch64/sysroots/x86_64-petalinux-linux/usr/bin/aarch64-amd-linux/aarch64-amd-linux-gcc

添加 SDK 對應的 C++ 編譯器 點擊 Add -> GCC -> C++ 設置 Name 為 G++_zynqMP，Compiler path 為 /opt/petalinux/2025.2/aarch64/sysroots/x86_64-petalinux-linux/usr/bin/aarch64-amd-linux/aarch64-amd-linux-g++

添加 SDK 對應的 GDB 調試器

選擇上方 Debuggers 標簽頁，點擊 Add，添加調試器

設置 Name 為 GDB_ZYNQMP，path 為 /opt/petalinux/2025.2/aarch64/sysroots/x86_64-petalinux-linux/usr/bin/aarch64-amd-linux/aarch64-amd-linux-gdb

點擊 Apply，使之前的所有配置生效

添加 SDK 對應的 Kits

選擇上方 Kits 標簽頁，點擊 Add，添加新的開發(fā)套件

設置 File system name 為 ZynqMP，Compiler C 為 GCC_ZYNQMP，Compiler C++ 為 G++_ZYNQMP

Debugger 為GDB_ZYNQMP，Qt version 為 Qt 5.15.13(system)

點擊 Apply，使配置生效，最后點擊 OK，完成環(huán)境配置

創(chuàng)建 Qt 測試程序

創(chuàng)建 Qt 工程

在 QtCreator 界面中，點擊File-> New File or Project

在工程創(chuàng)建界面中保持默認配置，點擊 Choose，創(chuàng)建一個 Qt Widgets Application

設置工程的 Name 為 qt_demo，工程位置為/home/alinx/peta_prj/linuxPsBase/app（app目錄需自己創(chuàng)建）

Build system、Details、Translation 配置界面保持默認選項

在 Kits 界面中，選擇開發(fā)套件 ZynqMP

最后在 Summary 界面中點擊 Finish，完成工程創(chuàng)建

添加頭文件索引

INCLUDEPATH += /opt/petalinux/2025.2/aarch64/sysroots/cortexa72-cortexa53-amd-linux/usr/include 

qt 界面設計

雙擊mainwindow.ui文件，進入設計界面

拖動設計界面左側的Push Button組件到主界面，鼠標可以拉伸組件大小，雙擊組件的文字部分，修改內容為ALINX DEMO

編譯 qt 工程

使用ctrl+s保存后，點擊界面左下角的錘子圖標，編譯工程

編譯完成后，可以在/home/alinx/peta_prj/linuxPsBase/app/build-qt_demo-ZynqMP-Debug目錄下找到可執(zhí)行程序qt_demo

制作測試 SD 卡

qt 程序運行會依賴新的 rootfs.tar.gz 里的qt庫

將 SD卡的 ROOTFS 分區(qū)舊文件全部刪除，解壓新的 rootfs.tar.gz 文件到 SD 卡的 ROOTFS 分區(qū)

同步緩存數(shù)據(jù)后，彈出 SD

執(zhí)行測試程序

將 SD 卡插入板卡，板卡 dp 接口連接顯示器，上電啟動

系統(tǒng)啟動完成并登錄后，在串口終端中輸入如下命令，執(zhí)行 qt 測試程序

export  DISPLAY=:0.0
./qt_demo 

更多細節(jié)歡迎關注我們黑金云課堂全年免費直播課， 黑金云課堂四月直播日歷 我們將在每周二、三、四，同步推進Verilog開發(fā)、Vitis開發(fā)、Linux開發(fā)三大系列，帶你從零開始，穩(wěn)扎穩(wěn)打掌握 FPGA 開發(fā)全流程！

系列	內容定位
Verilog開發(fā)	硬件描述語言基礎、邏輯設計、仿真調試
Vitis開發(fā)	Zynq軟硬件協(xié)同、外設驅動、網絡協(xié)議棧
Linux開發(fā)	嵌入式Linux系統(tǒng)移植、驅動編寫、應用開發(fā)

審核編輯 黃宇