从零开始玩转PetaLinux：一次完整的内核定制实战之旅
你有没有遇到过这样的场景？
手头一块Zynq开发板，Vivado工程已经跑通了AXI GPIO和ADC IP，但Linux系统就是“看不见”这些外设；或者内核启动卡在串口输出一半，日志戛然而止；又或者想让一个采集程序随系统自动运行，却不知道该把可执行文件放哪儿……
别急——这些问题的根源，往往都出在系统级配置环节。而解决它们的核心钥匙，就是掌握PetaLinux 的全栈定制能力。
本文不讲空泛理论，也不堆砌命令手册。我们将以一位嵌入式工程师的真实工作流为线索，带你亲手完成一次从创建工程到部署镜像的完整闭环。重点聚焦“内核怎么改、设备树怎么写、应用怎么塞进去”这三个最常卡人的关键点，用你能听懂的“人话”，还原每一个操作背后的逻辑与坑点。
第一步：先搭个架子——PetaLinux工程是怎么来的？
所有故事的起点，都是这行命令：
source /opt/petalinux/2023.1/settings.sh petalinux-create -t project --name my_zynq_project --template zynq看起来很简单对吧？但背后其实藏着不少门道。
为什么一定要 source settings.sh？
你可以把它理解成“激活开发环境许可证”。PetaLinux 是闭源工具链，它依赖一些私有库和脚本路径。settings.sh的作用就是把你当前终端“注入”正确的环境变量（比如PATH、PETALINUX_SDK_DIR等），否则后续所有petalinux-*命令都会报错找不到。
✅ 小技巧：建议把这个 source 命令写进
.bashrc或单独做个 alias，避免每次新开终端都要手动加载。
工程模板选哪个？zynq 还是 zynqmp？
--template zynq：适用于 Zynq-7000 系列（如 ZedBoard、MicroZed），双核 Cortex-A9 架构；--template zynqmp：用于 Zynq UltraScale+ MPSoC（如 ZCU106），四核 A53 + 双核 R5；--template versal：面向 Versal ACAP 平台。
选错模板会导致默认设备树、电源管理策略、驱动集都不匹配，轻则功能异常，重则根本启动不了。
创建完之后，项目长什么样？
执行完命令后，你会看到一个标准目录结构：
my_zynq_project/ ├── components/ # 子系统源码区 │ └── libs/ # 第三方库支持 ├── project-spec/ # 所有配置集中地！ │ ├── config/ # 全局配置 │ ├── meta-user/ # 用户自定义层（应用、补丁） │ └── dts/ # 设备树文件存放处 ├── build/ # 构建中间产物 └── images/ # 最终生成的镜像输出目录其中project-spec/是你未来90%时间会打交道的地方，务必记住它的存在。
第二步：动内核——裁剪不是删代码，而是做减法的艺术
当你输入：
cd my_zynq_project petalinux-config -c kernel屏幕上弹出的那个黑白界面，其实是 Linux 内核自带的menuconfig配置工具。它不像图形操作系统那样点点鼠标就行，但它足够强大且精准。
到底哪些可以关？哪些必须留？
很多新手一上来就想“瘦身”，把 USB、Bluetooth、Wi-Fi 全都[ ]掉。这没错，但在裁剪之前，请先确认三件事：
你现在能通过串口登录吗？
- 检查路径：Device Drivers → Serial drivers → <*> 8250/16550 and compatible serial support
- 如果这里被禁用了，哪怕你的硬件 UART 正常，Linux 也打不出任何 log！根文件系统怎么加载？
- 默认通常是 SD 卡或 QSPI 启动。
- 要确保：MMC/SD/SDIO support开启EXT4 filesystem support编译进内核（不要模块化）
是否需要动态加载驱动调试？
- 如果你还在开发阶段，强烈建议开启：text [*] Enable loadable module support
- 否则所有驱动必须静态编译进内核，修改一次就得重新烧录整个 image.ub，效率极低。
实战案例：我想用 SPI 接个温湿度传感器
假设你要用/dev/spidev1.0访问一个外挂的 SPI 设备，那至少要打开以下几项：
Device Drivers ---> <*> SPI support ---> <*> Xilinx SPI controller <*> User mode SPI device driver support保存退出后，PetaLinux 会在project-spec/configs/下生成或更新kernel_config文件，并在下次构建时自动应用。
⚠️ 血泪教训：如果误删了
amba总线或Clock Driver相关选项，可能导致内核 hang 在 early boot 阶段，连串口都没输出。遇到这种情况，最快恢复方式是删除project-spec/configs/kernel_config，再重新运行petalinux-config -c kernel加载默认配置。
第三步：写设备树——让内核“看见”你的PL外设
这是最容易出问题的一环。很多人以为 Vivado 导出hdf就万事大吉，殊不知设备树才是连接软硬件的最后一公里。
它到底干了啥？
简单说：设备树告诉内核，“某个地址上有个什么东西，该怎么访问”。
比如你在 PL 里加了个 AXI GPIO，地址分配是0x41200000，中断连到了 GIC 的 SPI ID 29（对应 CPU IRQ 61）。如果不写设备树节点，Linux 根本不知道这个寄存器块的存在。
正确姿势：编辑 system-top.dts
文件路径：project-spec/dts/system-top.dts
在这个文件末尾追加：
&amba { axi_gpio_0: gpio@41200000 { compatible = "xlnx,xps-gpio-1.00.a"; reg = <0x41200000 0x10000>; interrupt-parent = <&intc>; interrupts = <0 29 4>; xlnx,all-inputs = <0>; xlnx,all-outputs = <1>; xlnx,tri-default = <0xffffffff>; }; };我们逐行拆解：
| 行 | 解释 |
|---|---|
&amba | 表示挂载在 AMBA 总线上（Zynq PS 的主总线） |
gpio@41200000 | 节点命名规范：设备类型@基地址 |
compatible | 驱动匹配字段！必须和内核中of_match_table一致 |
reg | 地址空间描述：起始地址 + 大小（单位字节） |
interrupt-parent | 指定中断控制器，这里是 Zynq 的 intc（GIC） |
interrupts | <type line trigger>，其中0=SPI中断，29=GIC中的SPI编号，4=上升沿触发 |
🔍 如何查中断号？
在 Vivado Address Editor 中查看 AXI Interrupt Controller 输出的irq连接到 Processing System 的哪一个IRQ_F2P[x]，然后根据 UG585 手册第6章换算成 GIC SPI ID。
验证方法：运行时检查
烧录新镜像后，在板子上执行：
ls /proc/device-tree/amba/gpio@41200000/如果有这个目录，说明设备树已生效。接着可以用devmem测试读写：
# 设置方向为输出（写 control register） devmem 0x41200008 32 0x00000000 # 输出高电平 devmem 0x41200004 32 0xFFFFFFFF如果对应的 LED 亮了，恭喜你，打通任督二脉！
第四步：塞应用——让程序开机自启其实很简单
你想写的采集程序、通信服务、AI推理脚本……最终都要变成系统的一部分。PetaLinux 提供了两种主流方式：
- 传统方式：编译好扔进 rootfs；
- 现代方式：注册为 systemd 服务（推荐）。
下面我们一步步来。
1. 创建应用模板
petalinux-create -t apps --name hello_app --template c这会生成：
project-spec/meta-user/recipes-apps/hello_app/ ├── hello_app.bb # BitBake 配方文件 └── files/ └── hello_app.c # 示例代码2. 改配方文件，让它开机启动
编辑hello_app.bb，加入 systemd 支持：
SUMMARY = "My first auto-run app" LICENSE = "MIT" SRC_URI = "file://hello_app.c" S = "${WORKDIR}" do_compile() { ${CC} ${CFLAGS} ${LDFLAGS} hello_app.c -o hello_app } do_install() { install -d ${D}${bindir} install -m 0755 hello_app ${D}${bindir}/ } # 关键在这里 ↓ SYSTEMD_PACKAGES = "${PN}" SYSTEMD_SERVICE_${PN} = "hello_app.service"然后创建files/hello_app.service：
[Unit] Description=Hello World Service After=network.target [Service] Type=simple ExecStart=/usr/bin/hello_app Restart=on-failure [Install] WantedBy=multi-user.target3. 构建并验证
petalinux-build构建完成后，进入images/linux/目录，你会看到image.ub和rootfs.cpio.gz。烧录到板子上，启动后执行：
systemctl status hello_app如果显示active (running)，说明成功了！
💡 提示：如果你的应用依赖 Python 或 OpenCV，记得在
petalinux-config -c rootfs中启用相应包组。
调试那些年我们踩过的坑
❌ 串口没输出？
优先排查顺序：
- 设备树中
chosen节点是否指定了正确 stdout-path？dts chosen { bootargs = "console=ttyPS0,115200 earlyprintk"; stdout-path = "serial0:115200"; }; - 内核是否禁用了 UART 驱动？
- 实际硬件接的是
ttyPS0还是ttyPS1？别搞混了。
❌ 网络不通？
常见原因：
- PHY 地址不对（设备树中
phy-handle指向错误节点）； - RMII/MII 模式未配置；
- 复位引脚延迟不够（需添加
phy-reset-duration属性）。
❌ 应用启动失败？
查看日志最有效：
journalctl -u hello_app.service可能原因包括：
- 动态库缺失（交叉编译时没链接好）；
- 权限不足（脚本没加可执行位）；
- 路径错误（
/usr/binvs/bin）。
写在最后：真正的嵌入式开发，是从这里开始的
看到这里，你应该已经完成了：
✅ 创建 PetaLinux 工程
✅ 修改内核配置启用所需驱动
✅ 添加 PL 外设设备树节点
✅ 编写用户程序并实现开机自启
✅ 构建完整镜像并部署验证
但这还只是起点。
当你掌握了这套流程，就可以进一步挑战更复杂的任务：
- 把 ROS2 打包进根文件系统，做机器人控制器；
- 集成 AI 推理引擎（如 TensorFlow Lite），实现边缘智能；
- 使用 Yocto 图层机制管理多个项目共用组件；
- 配置安全启动与加密固件更新……
更重要的是，你会建立起一种全栈视角：不再把 FPGA 和 Linux 当作两个割裂的世界，而是真正理解“软硬协同”的含义。
所以，别再只停留在“Vivado 能跑就行”的阶段了。动手改一次内核、写一段设备树、让自己的程序随着系统一起醒来——这才是嵌入式开发的魅力所在。
如果你在实践中遇到了其他难题，欢迎留言交流。我们一起把这条路走得更远。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
