T113 PWM设备树配置常见问题解析

Question

**T113 PWM设备树配置中PWM通道无法正常输出信号如何排查？** 在配置T113的PWM设备树时，若出现PWM通道无法输出信号的问题，常见原因包括：设备树中PWM节点未正确启用、引脚复用配置错误、时钟未使能或PWM频率占空比设置不合理。需检查`pwm-controller`属性是否正确声明，确认对应的PIN是否映射到正确的PWM通道，并确保`clocks`属性配置无误。此外，内核驱动是否加载对应PWM模块也会影响功能正常运行。

Answer 1

一、问题背景与现象描述

在嵌入式Linux开发中，T113芯片作为国产主控平台之一，其PWM模块常用于电机控制、LED调光、蜂鸣器驱动等场景。在设备树配置过程中，若PWM通道无法正常输出信号，将直接影响功能实现。

典型表现为：应用层调用成功，但示波器检测不到输出波形，或输出波形频率、占空比与预期不符。

二、排查流程图

graph TD
            A[PWM输出异常] --> B{设备树配置是否正确?}
            B -- 否 --> C[检查pwm-controller节点]
            B -- 是 --> D{引脚复用配置是否正确?}
            D -- 否 --> E[配置PINMUX]
            D -- 是 --> F{时钟是否使能?}
            F -- 否 --> G[检查clocks属性]
            F -- 是 --> H{驱动是否加载?}
            H -- 否 --> I[加载pwm-sun8i模块]
            H -- 是 --> J{频率/占空比设置合理?}
            J -- 否 --> K[调整参数]
            J -- 是 --> L[使用示波器进一步检测]

三、设备树配置排查

设备树是Linux系统中硬件描述的关键部分，T113的PWM控制器节点通常位于/soc/pwm@1c23400等路径下。

• pwm-controller属性：必须设置为1，表示该节点为PWM控制器。
• #pwm-cells：应为3，表示每个PWM通道需要三个参数：通道号、周期、占空比。
• status属性：应设为"okay"以启用该节点。
• clocks属性：需正确引用时钟控制器节点，如&pwm_clk。

示例设备树节点：

pwm0: pwm@1c23400 {
    compatible = "allwinner,sun8i-h3-pwm";
    reg = <0x1c23400 0x20>;
    #pwm-cells = <3>;
    pwm-controller;
    clocks = <&pwm_clk>;
    status = "okay";
};
    

四、引脚复用（PINMUX）配置

T113的每个PWM通道对应特定的GPIO引脚，需在设备树中配置引脚复用为PWM功能。

例如，若使用PWM0通道，对应的GPIO应配置为PWM0输出功能。

PWM通道	默认GPIO	功能选择
PWM0	PG11	ALT5
PWM1	PG12	ALT5

设备树中引脚配置示例：

pinctrl_pwm0: pwm0 {
    pins = "PG11";
    function = "pwm0";
};
    

五、时钟配置与电源管理

PWM控制器依赖于系统时钟源，T113中通常使用内部时钟源（如osc24M）或外部晶振。

设备树中需确认时钟节点是否被正确引用，例如：

clock-controller@1c20c00 {
    compatible = "allwinner,sun8i-h3-ccu";
    reg = <0x1c20c00 0x400>;
    #clock-cells = <1>;
    clocks = <&osc24m>;
};
    

此外，还需检查电源管理配置是否禁用了PWM模块的电源关闭策略。

六、驱动与模块加载

内核中需加载支持T113 PWM的驱动模块，通常是pwm-sun8i.ko。

可通过以下命令检查模块是否加载：

dmesg | grep pwm

若未加载，可手动加载：

modprobe pwm-sun8i

确认sysfs中是否存在PWM接口：

ls /sys/class/pwm/

七、应用层参数设置

用户空间可通过sysfs接口控制PWM输出，路径通常为/sys/class/pwm/pwmchip0/pwm0/。

关键参数包括：

• period：周期（单位：纳秒）
• duty_cycle：占空比（单位：纳秒）
• enable：使能输出（0/1）

示例设置：

echo 1000000 > period
echo 500000 > duty_cycle
echo 1 > enable
    

若设置后仍无输出，建议使用示波器测量引脚电压波形，排除硬件连接问题。