10. PWM 使用

10.1. 前言

本章主要描述如何配置 PWM。

AIO-3588JQ 的 PWM 驱动为:kernel-5.10/drivers/pwm/pwm-rockchip.c

10.2. DTS配置

配置 PWM 主要有以下三大步骤:配置 PWM DTS 节点、配置 PWM 内核驱动、控制 PWM 设备。

10.2.1. 配置 PWM DTS节点

在 DTS 源文件 kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-demo.dtsi 添加 PWM DTS 配置,如下所示:

/{
    pwm_demo: pwm_demo {
        compatible = "firefly,rk3588-pwm";
        status = "okay";
        pwms = <&pwm15 0 100000000 1>;   
        duty_ns = <50000000>;   
        pinctrl-names = "default";
        pinctrl-0 = <&pwm15m2_pins>;
    };
};

&pwm15{
    status = "okay";
};

pwms参数分析: &pwm15: 在 rk3588s.dtsi 中有定义。 0 :表示 chip index ,一般是0,因为rockchip pwm每个chip只有一个。 100000000 : 一个周期时间为100000000纳秒 ,一秒有10个100000000纳秒 ,所以这个pwm输出周期为10Hz。 1: 表示极性, 0为正常极性,1为反转极性。

duty_ns表示占空比激活时间,单位也是纳秒

由于 pwm15 默认用作 FAN 控制,所以在上述的修改基础上,还需要关闭 FAN 功能,才可以使能 pwm demo:

/* FAN */
fan: pwm-fan {
    compatible = "pwm-fan";
    status = "disabled";
};

10.3. 接口说明

用户可在其它驱动文件中使用以上步骤生成的 PWM 节点。具体方法如下:

(1)、在要使用 PWM 控制的设备驱动文件中包含以下头文件:

#include <linux/pwm.h>

该头文件主要包含 PWM 的函数接口。

(2)、申请 PWM

使用

struct pwm_device *devm_pwm_get(struct device *dev, const char *con_id);

函数申请 PWM。 例如:

struct pwm_device * pwm0 = devm_pwm_get(&pdev->dev, NULL);

(3)、配置 PWM

使用

int pwm_config(struct pwm_device *pwm, int duty_ns, int period_ns);

配置 PWM 的占空比,例如:

pwm_config(pwm0, 500000, 1000000);

(4)、使能PWM函数

int pwm_enable(struct pwm_device *pwm);

用于使能 PWM,例如:

pwm_enable(pwm0);

(5)控制 PWM 输出主要使用以下接口函数:

  • 功能:用于申请 PWM

struct pwm_device *devm_pwm_get(struct device *dev, const char *con_id);
  • 功能:用于释放所申请的 PWM

void pwm_free(struct pwm_device *pwm);
  • 功能:用于配置 PWM 的占空比

int pwm_config(struct pwm_device *pwm, int duty_ns, int period_ns);
  • 功能:使能 PWM

int pwm_enable(struct pwm_device *pwm);
  • 功能:禁止 PWM

void pwm_disable(struct pwm_device *pwm);

参考例子: kernel-5.10/drivers/pwm/pwm-firefly-demo.c

10.4. 调试方法

通过内核丰富的 debug 接口查看 PWM 注册状态,adb shell 或者串口进入 Android 终端执行:

cat  /sys/kernel/debug/pwm

查看注册是否成功,成功则返回接口名和寄存器地址。

10.5. FAQs

10.5.1. PWM 无法注册成功:

  • dts 配置文件是否打开对应的 PWM。

  • PWM 所在的 IO 口是否被其他资源占用,可以根据报错的返回值去查看原因。