PWM 使用

前言

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

AIO-3588SJD4 的 PWM 驱动为："kernel-5.10/drivers/pwm/pwm-rockchip.c"

DTS配置

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

配置 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"表示占空比激活时间，单位也是纳秒

接口说明

用户可在其它驱动文件中使用以上步骤生成的 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"

调试方法

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

   cat  /sys/kernel/debug/pwm

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

FAQs

PWM 无法注册成功：

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

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