[实战] 深入解析Petalinux下Zynq7000设备树开发：从理论到实战

深入解析Petalinux下Zynq7000设备树开发：从理论到实战

一、Petalinux工程设备树架构解析

1.1 设备树在嵌入式Linux中的核心地位

在基于Zynq7000的嵌入式系统开发中，设备树（Device Tree）作为硬件描述的核心机制，承担着连接硬件平台与操作系统的桥梁作用。它通过结构化的数据格式，将传统硬件描述从内核代码中解耦出来，实现了硬件配置的灵活性和可维护性。

1.2 Petalinux工程目录结构全景

典型的Petalinux工程目录结构如下：

<project>/
├── project-spec/
│   └── meta-user/
│       └── recipes-bsp/
│           └── device-tree/
│               ├── files/
│               │   ├── system-user.dtsi
│               │   ├── pl.dtsi
│               │   └── pcw.dtsi
│               └── device-tree.bbappend
└── components/
    └── plnx_workspace/
        └── device-tree/
            └── device-tree/

其中关键路径为project-spec/meta-user/recipes-bsp/device-tree/files，该目录存放所有用户自定义设备树文件。

1.3 核心设备树文件解析

1.3.1 system-user.dtsi

• 作用：用户主设备树包含文件
• 内容：

#include "pl.dtsi"
#include "pcw.dtsi"

/ {
    chosen {
        bootargs = "console=ttyPS0,115200 earlyprintk";
    };
    
    memory@0 {
        device_type = "memory";
        reg = <0x0 0x40000000>;
    };
};

1.3.2 pl.dtsi

• 生成方式：由Vivado导出的硬件设计
• 典型内容：

amba_pl: amba_pl@0 {
    #address-cells = <1>;
    #size-cells = <1>;
    compatible = "simple-bus";
    ranges ;
    
    axi_gpio_0: gpio@41200000 {
        #gpio-cells = <2>;
        compatible = "xlnx,xps-gpio-1.00.a";
        gpio-controller ;
        reg = <0x41200000 0x10000>;
        xlnx,all-inputs = <0x0>;
        xlnx,all-outputs = <0x1>;
        xlnx,dout-default = <0x00000000>;
        xlnx,gpio-width = <0x8>;
        xlnx,interrupt-present = <0x0>;
        xlnx,is-dual = <0x0>;
        xlnx,tri-default = <0xFFFFFFFF>;
    };
};

1.3.3 pcw.dtsi

• 来源：处理系统（PS）配置生成
• 关键配置项：
  • 时钟配置
  • 外设地址映射
  • 中断控制器设置
  • DMA通道配置

1.3.4 system_conf.dtsi

• 文件路径：project-spec/meta-user/recipes-bsp/device-tree/files/system_conf.dtsi
• 核心作用：系统级全局配置定义文件
• 典型内容：

// 系统时钟配置
/ {
    clocks {
        sys_clk: sys_clk {
            #clock-cells = <0>;
            clock-frequency = <100000000>; // PS端主时钟
            compatible = "fixed-clock";
        };
    };
};

// 处理器配置
&cpu0 {
    operating-points = <
        666667 1000000
        333334 1000000
    >;
    clock-latency = <1000>;
};

// 存储设备映射
&qspi {
    #address-cells = <1>;
    #size-cells = <0>;
    flash0: flash@0 {
        compatible = "micron,n25q128a13";
        reg = <0>;
        spi-max-frequency = <50000000>;
    };
};

关键配置项说明：

配置项	作用说明	典型值示例
clock-frequency	定义系统主时钟频率	<100000000> (100MHz)
operating-points	CPU动态调频电压曲线	[频率(Hz), 电压(uV)]对
spi-max-frequency	SPI Flash最大工作频率	<50000000> (50MHz)

1.3.5 skeleton.dtsi

• 文件路径：components/plnx_workspace/device-tree/device-tree/skeleton.dtsi
• 特殊作用：设备树基础框架文件（Petalinux自动生成）
• 典型结构：

// 根节点基础定义
/ {
    #address-cells = <1>;
    #size-cells = <1>;
    compatible = "xlnx,zynq-7000";
    model = "Xilinx Zynq Platform";

    // 默认中断控制器配置
    intc: interrupt-controller@f8f01000 {
        #interrupt-cells = <3>;
        compatible = "arm,cortex-a9-gic";
        interrupt-controller;
        reg = <0xf8f01000 0x1000>,
              <0xf8f00100 0x100>;
    };

    // 默认内存映射
    memory@0 {
        device_type = "memory";
        reg = <0x0 0x40000000>;
    };
};

文件特性说明：

1. 自动生成机制：该文件由Petalinux根据硬件设计(XSA文件)自动生成
2. 禁止修改规则：用户不应直接修改此文件，修改会被工程重建覆盖
3. 覆盖策略：用户自定义配置应通过system-user.dtsi覆盖默认设置

1.4 文件包含关系图解

1.5 多文件协作示例

system-user.dtsi中的覆盖操作：

// 覆盖skeleton中的内存配置
/ {
    memory@0 {
        reg = <0x0 0x20000000>; // 将内存从1GB改为512MB
    };
};

// 扩展system_conf的时钟配置
&clocks {
    pl_clk: pl_clk {
        #clock-cells = <0>;
        clock-frequency = <150000000>;
        compatible = "fixed-clock";
    };
};

// 修改默认中断映射
&intc {
    arm,routable-irqs = <0x0 0x3 0x1>; // 允许IRQ0-1路由
};

1.6 文件更新机制对比

文件类型	生成方式	用户可修改性	版本控制建议
skeleton.dtsi	Petalinux自动生成	禁止修改	不加入版本控制
system_conf.dtsi	半自动生成（工具+手动）	谨慎修改	需标记自动生成部分
system-user.dtsi	完全手动创建	自由修改	必须版本控制
pl.dtsi	Vivado导出	只读	随硬件设计版本控制

1.7 实战配置案例：双网口配置

在system_conf.dtsi中配置：

&gem0 {
    phy-handle = <&phy0>;
    phy-mode = "rgmii-id";
    status = "okay";
    
    mdio {
        #address-cells = <1>;
        #size-cells = <0>;
        phy0: phy@1 {
            reg = <1>;
            ti,rx-internal-delay = <0x8>;
            ti,tx-internal-delay = <0xa>;
        };
    };
};

&gem1 {
    phy-handle = <&phy1>;
    phy-mode = "rgmii-id";
    status = "okay";
    
    mdio {
        #address-cells = <1>;
        #size-cells = <0>;
        phy1: phy@2 {
            reg = <2>;
            rx-fifo-depth = <0x1000>;
            tx-fifo-depth = <0x1000>;
        };
    };
};

在skeleton.dtsi中基础定义：

amba: amba {
    gem0: ethernet@e000b000 {
        compatible = "cdns,zynq-gem";
        reg = <0xe000b000 0x1000>;
        interrupts = <0 22 4>;
        clocks = <&clkc 30>, <&clkc 30>;
    };
    
    gem1: ethernet@e000c000 {
        compatible = "cdns,zynq-gem";
        reg = <0xe000c000 0x1000>;
        interrupts = <0 45 4>;
        clocks = <&clkc 31>, <&clkc 31>;
    };
};

1.8 重要调试技巧

检查文件包含顺序：

petalinux-config --get-hw-description
petalinux-build -c device-tree -x cleansstate
petalinux-build -c device-tree -v

观察编译日志中的包含顺序：

Dependency: system-top.dts
  Includes: skeleton.dtsi
  Includes: pcw.dtsi
  Includes: pl.dtsi
  Includes: system-conf.dtsi
  Includes: system-user.dtsi

逆向验证方法：

扫描二维码关注公众号，回复： 17602804 查看本文章

1. 编译完成后在images/linux/目录获取.dtb文件
2. 反编译验证配置：

dtc -I dtb -O dts system.dtb > reverse.dts
grep -rnw 'reverse.dts' -e 'gem0'

二、设备树语法深度解析

2.1 DTS与DTSI的协同机制

文件类型	扩展名	作用	编译方式
设备树源文件	.dts	顶层设备树描述	直接编译
包含文件	.dtsi	模块化设备树片段	通过#include包含

典型包含关系示例：

// 主设备树文件zynq-7000.dts
/dts-v1/;

#include "zynq-7000.dtsi"
#include "system-user.dtsi"

/ {
    model = "Custom Zynq Board";
    compatible = "xlnx,zynq-7000";
};

2.2 设备树节点结构详解

node-name@unit-address {
    [property definitions]
    [child nodes]
};

典型属性解析：

• compatible: 驱动匹配的关键字
• reg: 寄存器地址和长度
• interrupts: 中断号配置
• clocks: 时钟源绑定

三、Petalinux设备树配置实战

3.1 配置流程全景图

3.2 实战案例：添加UART外设

步骤1：修改pl.dtsi

axi_uartlite_0: serial@42c00000 {
    compatible = "xlnx,xps-uartlite-1.00.a";
    current-speed = <115200>;
    device_type = "serial";
    port-number = <1>;
    reg = <0x42c00000 0x10000>;
    xlnx,baudrate = <0x1c200>;
    xlnx,data-bits = <0x8>;
    xlnx,odd-parity = <0x0>;
    xlnx,s-axi-aclk-freq-hz-d = "100.0";
    xlnx,use-parity = <0x0>;
};

步骤2：更新system-user.dtsi

/ {
    aliases {
        serial0 = &axi_uartlite_0;
    };

    chosen {
        stdout-path = "serial0:115200n8";
    };
};

3.3 高级配置技巧

3.3.1 引脚复用配置

&amba {
    gpio@e000a000 {
        #gpio-cells = <2>;
        compatible = "xlnx,zynq-gpio-1.0";
        clocks = <&clkc 42>;
        emio-gpio-width = <64>;
        gpio-controller;
        gpio-mask-high = <0x0>;
        gpio-mask-low = <0x5600>;
        interrupt-parent = <&intc>;
        interrupts = <0 20 4>;
        reg = <0xe000a000 0x1000>;
    };
};

3.3.2 中断配置示例

axi_intc_0: interrupt-controller@41800000 {
    #interrupt-cells = <2>;
    compatible = "xlnx,xps-intc-1.00.a";
    interrupt-controller;
    interrupt-parent = <&intc>;
    interrupts = <0 29 1>;
    reg = <0x41800000 0x10000>;
    xlnx,kind-of-intr = <0x1>;
    xlnx,num-intr-inputs = <0x8>;
};

四、设备树调试与验证

4.1 编译过程监控

petalinux-build -c device-tree -v

观察编译输出中的关键信息：

DTC     pl.dtsi
DTC     system-user.dtsi
Merging device trees...
Final DTB size: 24576 bytes

4.2 运行时调试技巧

查看已加载设备树：

dtc -I fs /proc/device-tree

内核日志分析：

dmesg | grep -i 'of_platform'

4.3 逆向分析工具

# 将dtb转换为dts
dtc -I dtb -O dts system.dtb > debug.dts

五、常见问题解决方案

5.1 典型错误案例

案例1：地址映射冲突

Error: reg size is invalid

解决方案：检查寄存器地址范围是否超过PS端定义

案例2：驱动匹配失败

of: modalias: no compatible found for 'xlnx,xps-gpio-2.0'

解决方案：核对compatible字符串与驱动定义

5.2 性能优化建议

1. 使用预处理指令减少冗余包含
2. 合理划分dtsi文件结构
3. 启用设备树缓存机制

六、进阶开发指南

6.1 动态设备树加载

fdtput -t s /sys/firmware/fdt /chosen bootargs "console=ttyPS0,115200 root=/dev/mmcblk0p2"

6.2 设备树覆盖技术

// overlay.dts
/dts-v1/;
/plugin/;

&axi_gpio_0 {
    gpio-line-names = "led0", "led1", "btn0", "btn1";
    xlnx,all-outputs = <0x1>;
};

编译命令：

dtc -@ -O dtb -o overlay.dtbo overlay.dts

七、总结与最佳实践

1. 版本控制策略：将设备树文件纳入Git管理，建立分支管理不同硬件版本
2. 模块化设计：按功能模块划分dtsi文件（如sensors.dtsi、network.dtsi）
3. 持续集成：将设备树编译纳入自动化构建流程
4. 文档规范：在文件头部添加版本注释：

/*
 * Device Tree for Zynq7020 Custom Board
 * Version: 2.1
 * Date: 2023-08-20
 * Author: Embedded Developer
 */

通过本文的深度解析和实战演示，开发者应能够：

• 熟练掌握Petalinux设备树配置的全流程
• 理解设备树各组件的作用及相互关系
• 具备复杂外设的集成能力
• 掌握设备树调试和优化方法
• 建立规范的开发流程管理体系

建议结合Xilinx官方文档UG1144和Linux内核文档devicetree/，持续跟踪设备树技术的最新发展动态。