📚 课程目录第4章设备树基础

背光调节驱动开发：电子书阅读器PWM调光实战 - 第4节

4.1 设备树基础概念与语法

设备树（Device Tree）是一种描述硬件资源的数据结构，用于将硬件配置信息从内核代码中分离出来。在嵌入式Linux系统中，设备树是驱动开发者必须掌握的核心技能。

  核心作用：设备树向内核传递硬件拓扑、寄存器地址、中断号、时钟、PWM通道等资源信息，驱动通过匹配设备树节点来获取硬件参数。

4.1.1 设备树语法速览

设备树源文件（.dts）采用树形结构，每个节点代表一个硬件设备或总线。基本语法规则如下：

语法元素	示例	说明
根节点	`/ { ... };`	设备树的顶层容器
子节点	`backlight: pwm-backlight { ... };`	标签: 节点名 { 属性 };
属性	`compatible = "pwm-backlight";`	字符串键值对，用于驱动匹配
整型数组	`pwms = <&pwm1 0 1000000>;`	尖括号内为32位整数列表
引用	`&pwm1`	引用其他节点的标签

// 设备树基本结构示例
/dts-v1/;

/ {
    model = "E-Reader PWM Backlight Board";
    compatible = "vendor,ereader-v1";

    pwm1: pwm@ff450000 {
        compatible = "vendor,pwm-controller";
        reg = <0xff450000 0x1000>;
        #pwm-cells = <3>;
        clocks = <&clkc 10>;
    };

    backlight: pwm-backlight {
        compatible = "pwm-backlight";
        pwms = <&pwm1 0 1000000 0>;
        brightness-levels = <0 4 8 16 32 64 128 255>;
        default-brightness-level = <4>;
    };
};

提示：#pwm-cells 决定PWM控制器节点被引用时，尖括号内需要提供几个参数。常见值为2（PWM索引 + 周期）或3（PWM索引 + 周期 + 极性）。

4.1.2 设备树节点关系图

下图展示了背光驱动涉及的设备树节点层级关系：

关键理解：背光节点通过 pwms 属性中的 &pwm1 引用PWM控制器节点，形成硬件依赖关系。内核在解析设备树时会自动建立这种引用关系。

4.2 PWM控制器节点绑定

PWM控制器节点是设备树中描述PWM硬件模块的核心节点。不同SoC的PWM控制器寄存器布局和功能不同，但设备树绑定遵循统一规范。

4.2.1 标准PWM控制器绑定属性

属性名	类型	描述	是否必需
`compatible`	字符串	驱动匹配字符串，如 `"vendor,pwm-controller"`	是
`reg`	地址数组	寄存器基地址和长度，如 `<0xff450000 0x1000>`	是
`#pwm-cells`	整数	指定引用时需要的参数个数（2或3）	是
`clocks`	phandle数组	PWM模块的工作时钟引用	是
`clock-names`	字符串数组	时钟名称，与clocks对应	否
`interrupts`	中断描述	PWM中断号（如果支持中断）	否

4.2.2 #pwm-cells 详解

#pwm-cells 决定其他节点引用PWM控制器时，需要提供几个参数：

#pwm-cells = <2>：参数为 <PWM索引周期(ns)>，极性默认为正常
#pwm-cells = <3>：参数为 <PWM索引周期(ns) 极性>，极性0=正常，1=反转

// 实际设备树中的PWM控制器节点示例（基于全志H3 SoC）
pwm: pwm@1c21400 {
    compatible = "allwinner,sun8i-h3-pwm";
    reg = <0x01c21400 0x400>;
    clocks = <&ccu CLK_BUS_PWM>;
    resets = <&ccu RST_BUS_PWM>;
    #pwm-cells = <3>;
    status = "disabled";
};

注意：#pwm-cells 的值必须与PWM驱动中解析参数的数量一致。如果驱动期望3个参数但设备树只提供2个，会导致驱动解析错误，PWM无法正常工作。

4.3 背光设备节点定义

背光设备节点通常使用内核标准绑定 pwm-backlight，该绑定由 drivers/video/backlight/pwm_bl.c 驱动支持。

4.3.1 pwm-backlight 绑定属性

属性名	类型	描述	是否必需
`compatible`	字符串	必须为 `"pwm-backlight"`	是
`pwms`	phandle数组	引用PWM控制器并指定通道、周期、极性	是
`brightness-levels`	整型数组	背光亮度等级对应的PWM占空比数值列表	是
`default-brightness-level`	整数	默认亮度等级索引（从0开始）	是
`power-supply`	phandle	背光电源稳压器引用	否
`enable-gpios`	GPIO描述	背光使能GPIO引脚	否
`pwm-names`	字符串数组	PWM通道名称（可选）	否

4.3.2 brightness-levels 设计原则

brightness-levels 数组定义了从最暗到最亮的占空比映射。对于电子书阅读器，需要考虑人眼对亮度的非线性感知：

低亮度区段：步进应较小（如0→4→8→16），因为人眼在暗处对亮度变化更敏感
高亮度区段：步进可较大（如128→192→255），人眼在亮处对变化不敏感
总等级数：通常8~32级，兼顾调节细腻度和系统开销

// 完整的背光节点定义（电子书阅读器场景）
/ {
    backlight: pwm-backlight {
        compatible = "pwm-backlight";
        pwms = <&pwm 0 5000000 0>;  // PWM0, 周期5ms(200Hz), 正常极性
        brightness-levels = <
            0   1   2   3   4   5   6   7
            8   10  12  14  16  20  24  28
            32  40  48  56  64  80  96  112
            128 160 192 224 255
        >;
        default-brightness-level = <12>;  // 对应亮度值16
        power-supply = <®_vcc_bl>;
        enable-gpios = <&gpio 3 16 GPIO_ACTIVE_HIGH>;  // PD16
        pwm-names = "backlight";
    };
};

4.3.3 背光节点与PWM控制器的绑定关系图

下图展示了背光节点如何通过设备树与PWM控制器、电源、GPIO建立完整绑定：

4.4 设备树编译与调试

设备树源文件（.dts）需要编译为二进制设备树（.dtb）才能被内核使用。常用操作如下：

操作	命令	说明
编译	`dtc -I dts -O dtb -o output.dtb input.dts`	将.dts编译为.dtb
反编译	`dtc -I dtb -O dts -o output.dts input.dtb`	将.dtb反编译为.dts，用于调试
查看设备树	`ls /proc/device-tree/`	运行时查看内核解析后的设备树
验证绑定	`dt-validate -s schema.yaml dts文件`	使用YAML schema验证设备树

  调试技巧：在Linux启动时添加 earlycon 和 dtoc=1 内核参数，可以打印设备树解析过程中的错误信息。如果背光节点未正确匹配，首先检查 compatible 字符串是否与驱动完全一致。

4.5 本章小结

设备树是嵌入式Linux驱动开发的基石。本章重点掌握：

设备树基本语法：节点、属性、引用、标签
PWM控制器节点绑定：#pwm-cells 决定引用参数格式
背光节点定义：brightness-levels 设计需考虑人眼感知特性
设备树编译与调试方法：dtc 工具和运行时查看