PWM 背光亮度调整教程

1️⃣ 内核配置驱动支持

首先需要保证系统内核已经支持 PWM 驱动和背光驱动。

开启 PWM 驱动

进入内核配置菜单：

make kernel_menuconfig

菜单路径：

> Device Drivers
    > Pulse-Width Modulation (PWM) Support
        <*>   Allwinner PWM support
  • Allwinner PWM support 必须编译进内核（<*>）。

开启背光驱动

同样在内核配置中：

> Device Drivers
    > Graphics support
        > Backlight & LCD device support
            <*> Lowlevel Backlight controls
                <*>   Generic (aka Sharp Corgi) Backlight Driver
                <*>   Generic PWM based Backlight Driver
  • 确保选中 Generic PWM based Backlight Driver。

2️⃣ 修改设备树配置

PWM 背光驱动通过设备树进行参数设置。编辑：

Tina-Linux/lichee/linux-5.4/arch/arm/boot/dts/sun8iw20p1.dtsi

在根节点 {} 下添加：

backlight: backlight {
        compatible = "pwm-backlight"; 
        pwms = <&pwm 7 50000 0>; // PWM 控制器 & 通道7 & 周期 50000ns & 0极性
        pwm-names = "backlight";
        brightness-levels = <
            0   1   2   3   4   5   6   7
            8   9  10  11  12  13  14  15
            16  17  18  19  20  21  22  23
            24  25  26  27  28  29  30  31
            32  33  34  35  36  37  38  39
            40  41  42  43  44  45  46  47
            48  49  50  51  52  53  54  55
            56  57  58  59  60  61  62  63
            64  65  66  67  68  69  70  71
            72  73  74  75  76  77  78  79
            80  81  82  83  84  85  86  87
            88  89  90  91  92  93  94  95
            96  97  98  99 100 101 102 103
            104 105 106 107 108 109 110 111
            112 113 114 115 116 117 118 119
            120 121 122 123 124 125 126 127
            128 129 130 131 132 133 134 135
            136 137 138 139 140 141 142 143
            144 145 146 147 148 149 150 151
            152 153 154 155 156 157 158 159
            160 161 162 163 164 165 166 167
            168 169 170 171 172 173 174 175
            176 177 178 179 180 181 182 183
            184 185 186 187 188 189 190 191
            192 193 194 195 196 197 198 199
            200 201 202 203 204 205 206 207
            208 209 210 211 212 213 214 215
            216 217 218 219 220 221 222 223
            224 225 226 227 228 229 230 231
            232 233 234 235 236 237 238 239
            240 241 242 243 244 245 246 247
            248 249 250 251 252 253 254 255 
        >;
        default-brightness-level = <200>; // 默认亮度
        status = "okay";
    };

关键参数解释：

  • pwms = <&pwm 7 50000 0>
  • &pwm 表示使用 PWM 控制器节点
  • 7 为 PWM 通道编号
  • 50000 为 PWM周期（单位 ns）即 50µs
  • 0 为极性，0 表示正常极性
  • brightness-levels 数组定义亮度等级，0~255 对应 PWM 占空比
  • default-brightness-level 设置开机默认亮度（这里为 200）

3️⃣ 编译并更新设备树

保存修改后，重新编译内核：

make

更新到开发板：

pack

4️⃣ 背光测试

系统启动后，通过 sysfs 接口测试：

查看当前亮度：

cat /sys/class/backlight/backlight/brightness

设置亮度：

echo 20 > /sys/class/backlight/backlight/brightness

数值范围：0 ~ 255

5️⃣ 常见问题与排查

  1. 设置亮度无效果

  2. 检查 PWM 驱动是否加载：

    bash ls /sys/class/pwm

  3. 检查背光驱动是否加载：

    bash ls /sys/class/backlight

  4. 如果 /sys/class/backlight 为空，说明设备树或驱动未正确加载。

  5. 亮度反向（0 时最亮）

  6. 修改设备树 pwms 最后一个参数极性为 1：

    dts pwms = <&pwm 7 50000 1>;

  7. 亮度调节颗粒度太细/太粗

  8. 可调整 brightness-levels 数组的步进值或长度。