PetaLinux工程目录设备树文件结构与作用
设备树文件列表
wpf@minglie:~/petalinux/ant$find.\(-path ./build -o -path ./tmp -o -path ./out -o -path ./components/yocto\)-prune -o -type f\(-name"*.dts"-o -name"*.dtsi"\)-print ./components/plnx_workspace/device-tree/device-tree/pl.dtsi ./components/plnx_workspace/device-tree/device-tree/zynq-7000.dtsi ./components/plnx_workspace/device-tree/device-tree/pcw.dtsi ./components/plnx_workspace/device-tree/device-tree/system-top.dts ./components/plnx_workspace/device-tree/device-tree/system-conf.dtsi ./components/plnx_workspace/device-tree/device-tree/skeleton.dtsi ./project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi ./project-spec/meta-user/recipes-bsp/device-tree/files/pl-custom.dtsi| 文件名 | 功能说明 | 受影响来源 |
|---|---|---|
pl.dtsi | 描述 PL（可编程逻辑）层的所有外设 IP 节点（AXI GPIO、AXI UARTLite、PWM、Timer 等），包含 AXI 地址、寄存器映射和中断连接信息。Linux 内核使用此信息访问 PL 外设。 | XSA / Vivado 硬件设计中 PL AXI IP 配置、地址、中断 |
zynq-7000.dtsi | 通用 Zynq-7000 平台 DTS，定义 PS 内置外设（CPU、DDR、UART/I2C/SPI/GPIO/Timer/ETH/USB）、总线结构和中断控制器（GIC）。系统 DTS 的基础文件。 | 通用 Zynq-7000 PS 平台，不随 XSA 变化 |
pcw.dtsi | 来自 PCW（Platform Creator Wizard）生成的 DTSI，自动包含 PS 配置、PL AXI IP 地址和 IRQ 分配，作为顶层 DTS 的 include 文件，用于将硬件描述映射到 Linux DTS。 | XSA / PCW 自动生成的硬件平台配置 |
system-top.dts | 顶层 DTS 文件，最终 Linux 内核使用，include 其他 DTSI 文件，定义chosen节点和板级覆盖节点。 | 受 XSA 生成的pl.dtsi和pcw.dtsi影响，同时可被用户覆盖节点修改 |
system-conf.dtsi | 系统级配置 DTSI，调整内核参数、内存映射、IRQ 优化等，可覆盖默认节点属性，不直接添加新外设节点。 | 可参考 XSA 配置（时钟、IRQ、DDR）进行调整，但主要由用户定义 |
skeleton.dtsi | PetaLinux / PCW 默认模板 DTSI，提供板级 DTS 编写示例，包含示例节点（AXI GPIO、UARTLite），可作为自定义板级 DTSI 的参考。 | 模板文件，仅参考，未受 XSA 自动生成影响 |
system-user.dtsi | 用户自定义设备树覆盖文件，用于启用 PL 外设、I2C/EEPROM 节点、修改 IRQ、调整节点属性。Linux 内核启动时被 include，可直接修改而不影响 PCW 自动生成的 DTSI。 | 用户自定义，不受 XSA 影响 |
pl-custom.dtsi | 用户自定义的 PL 外设节点扩展文件，通常用于添加额外的 AXI IP 或外设，并在system-user.dtsi中 include，使 Linux 内核识别自定义 PL 外设。 | 用户自定义，不受 XSA 影响 |
文件包含关系
system-top.dts │ ├── zynq-7000.dtsi ├── pcw.dtsi ├── pl.dtsi ├── system-conf.dtsi └── system-user.dtsi └── pl-custom.dtsi skeleton.dtsi(模板文件，不被顶层使用)system-top.dts 是顶层 DTS，Linux 内核直接使用。
PL/PS 外设信息分别由 pl.dtsi 和 zynq-7000.dtsi 定义。
pcw.dtsi 提供 XSA 自动生成的硬件配置。
用户自定义扩展在 system-user.dtsi + pl-custom.dtsi 中。
模板 skeleton.dtsi 仅供参考，不参与编译。