本篇Petalinux安裝，選自 ALINX 黑金云課堂 FPGA 免費(fèi)直播課。該課程由 ALINX 資深工程師團(tuán)隊(duì)傾力打造，從 0 到 1 系統(tǒng)化教學(xué)，幫助每位工程師跨過 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)默認(rèn) 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  

硬件配置導(dǎo)入：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 工程導(dǎo)出的 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

導(dǎo)入硬件信息，初始化 petalinux 工程

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

配置界面控制說明

導(dǎo)入硬件信息后會進(jìn)入 petalinux 工程全局配置界面，之后可以通過petalinux-config命令再次進(jìn)入 在配置界面中，使用鍵盤的上下方向鍵控制界面中間藍(lán)色光標(biāo)移動(dòng)，使用鍵盤的左右方向鍵控制界面底部藍(lán)色光標(biāo)移動(dòng)

如果界面中間的光標(biāo)選中一個(gè)選項(xiàng)分支，且界面底部光標(biāo)選中Select，按下鍵盤的回車鍵就會進(jìn)入該選項(xiàng)分支界面

如果界面底部光標(biāo)選中Exit，按下回車，會退出當(dāng)前選項(xiàng)分支界面。如果光標(biāo)選中Save，則會保存配置到工程中

按下鍵盤的/，進(jìn)入配置搜索界面，通過關(guān)鍵詞搜索相關(guān)配置。在搜索結(jié)果界面通過滾輪翻動(dòng)搜索結(jié)果，通過數(shù)字鍵1~9快速跳轉(zhuǎn)到配置選項(xiàng)

配置選項(xiàng)一般可以通過鍵盤的y鍵選中，n鍵取消選中

取消在線編譯

進(jìn)入Yocto Settings ->，取消Enable Network sstate feeds選項(xiàng)

設(shè)置離線編譯資源路徑

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

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

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

修改用戶設(shè)備樹文件

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

編譯 petalinux 工程

petalinux-build

合成啟動(dòng)鏡像文件 BOOT.BIN

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

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

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

板卡啟動(dòng)測試

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

登錄系統(tǒng)

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

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

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

使用 petalinux 的 bsp 包，可以方便快速地復(fù)現(xiàn)別人驗(yàn)證好的 petalinux 工程，或者導(dǎo)出我們驗(yàn)證好的 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 默認(rèn)的根文件系統(tǒng)類型是 INITRAMFS，不能保存文件和配置。需要使用 sd 卡掛載根文件系統(tǒng)，制作一個(gè)可以保存文件和配置的板載 linux 系統(tǒng)。

進(jìn)入全局配置界面

petalinux-config

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

進(jìn)入Image Packaging Configuration ->Root filesystem type選項(xiàng)，選擇EXT4 (SD/eMMC/QSPI/SATA/USB)

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

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

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

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

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

對 SD 卡重新分區(qū)

在 disks 界面中選擇 SD 卡對應(yīng)設(shè)備，如果 SD 卡已經(jīng)有分區(qū)，需要點(diǎn)擊分區(qū)刪除圖標(biāo)，將所有分區(qū)刪除

點(diǎn)擊創(chuàng)建分區(qū)圖標(biāo)，創(chuàng)建第一個(gè)分區(qū)，分區(qū)大小設(shè)置為 1GB，分區(qū)名稱為 BOOT，分區(qū)格式為 FAT

點(diǎn)擊創(chuàng)建分區(qū)圖標(biāo)，創(chuàng)建第二個(gè)分區(qū)，分區(qū)大小設(shè)置為 5GB，分區(qū)名稱為 ROOTFS，分區(qū)格式為 EXT4

點(diǎn)擊分區(qū)掛載圖標(biāo)，手動(dòng)掛載 SD 卡的兩個(gè)新分區(qū)到 Ubuntu 系統(tǒng)

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

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

拷貝啟動(dòng)鏡像文件到 SD 卡

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

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

板卡啟動(dòng)測試

將 SD 卡插入板卡，板卡上撥碼設(shè)置為 SD 啟動(dòng)模式，上電啟動(dòng)

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

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

SDK 生成及安裝

進(jìn)入 rootfs 配置界面

petalinux-config   -c   rootfs

配置組合包選項(xiàng)

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 調(diào)試選項(xiàng)

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 對應(yīng)的 qmake 版本

在 QtCreator 界面中選擇 Tools -> Options，進(jìn)入配置界面

點(diǎn)擊左側(cè) Kits 欄目，選擇上方 Qt Versions 標(biāo)簽頁

點(diǎn)擊Add...選項(xiàng)，添加 /opt/petalinux/2025.2/aarch64/sysroots/x86_64-petalinux-linux/usr/bin/ 路徑下的 qmake 文件

添加 SDK 對應(yīng)的 C 編譯器

選擇上方 Compilers 標(biāo)簽頁，點(diǎn)擊 Add -> GCC -> C

設(shè)置 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 對應(yīng)的 C++ 編譯器 點(diǎn)擊 Add -> GCC -> C++ 設(shè)置 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 對應(yīng)的 GDB 調(diào)試器

選擇上方 Debuggers 標(biāo)簽頁，點(diǎn)擊 Add，添加調(diào)試器

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

點(diǎn)擊 Apply，使之前的所有配置生效

添加 SDK 對應(yīng)的 Kits

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

設(shè)置 File system name 為 ZynqMP，Compiler C 為 GCC_ZYNQMP，Compiler C++ 為 G++_ZYNQMP

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

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

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

創(chuàng)建 Qt 工程

在 QtCreator 界面中，點(diǎn)擊File-> New File or Project

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

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

Build system、Details、Translation 配置界面保持默認(rèn)選項(xiàng)

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

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

添加頭文件索引

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

qt 界面設(shè)計(jì)

雙擊mainwindow.ui文件，進(jìn)入設(shè)計(jì)界面

拖動(dòng)設(shè)計(jì)界面左側(cè)的Push Button組件到主界面，鼠標(biāo)可以拉伸組件大小，雙擊組件的文字部分，修改內(nèi)容為ALINX DEMO

編譯 qt 工程

使用ctrl+s保存后，點(diǎn)擊界面左下角的錘子圖標(biāo)，編譯工程

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

制作測試 SD 卡

qt 程序運(yùn)行會依賴新的 rootfs.tar.gz 里的qt庫

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

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

執(zhí)行測試程序

將 SD 卡插入板卡，板卡 dp 接口連接顯示器，上電啟動(dòng)

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

export  DISPLAY=:0.0
./qt_demo 

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

系列	內(nèi)容定位
Verilog開發(fā)	硬件描述語言基礎(chǔ)、邏輯設(shè)計(jì)、仿真調(diào)試
Vitis開發(fā)	Zynq軟硬件協(xié)同、外設(shè)驅(qū)動(dòng)、網(wǎng)絡(luò)協(xié)議棧
Linux開發(fā)	嵌入式Linux系統(tǒng)移植、驅(qū)動(dòng)編寫、應(yīng)用開發(fā)

審核編輯 黃宇