十二、使用PWM调整LCD背光亮度

和手机一样，开发板中也带有调整背光亮度的功能。

调整背光亮度依赖于PWM，它通过调节脉冲宽度来控制背光亮度，此方式需要使用PWM驱动。本章将对其进行讲解。

一、用户空间调整背光亮度

一般应用程序可以通过/sys/class/目录下的节点间接调整各个外设的参数。如下图，可通过命令行来控制背光亮度。设备节点不同开发板的目录不一定相同，读者需自行测试。

如果读者确定自己的开发板有PWM控制背光的功能，但是在LCD、背光和PWM等相关目录没有找到调整亮度操作，可能的原因有PWM没有被编译进内核。

我们可以在配置中执行搜索操作，如：

$ make menuconfig　　进入内核配置页面

按 / 键搜索，确认背光PWM是否被编译进内核。

如下图，我的背光PWM被编译进内核中了。需要注意，不同内核可能选项位置不同。

二、PWM子系统

在Linux3.5版本中并没有引入PWM子系统，而是使用总线设备驱动模型。我在此以Linux-4.4为例谈论PWM子系统。

PWM也分为设备属性和行为。属性使用struct pwm_device表示，行为使用struct pwm_ops表示，两结构体定义如下：

struct pwm_device {
    const char *label;
    unsigned long flags;
    unsigned int hwpwm;
    unsigned int pwm;
    struct pwm_chip *chip;
    void *chip_data;
    struct mutex lock;

    unsigned int period;        /* PWM周期 */
    unsigned int duty_cycle;    /* 占空比 */
    enum pwm_polarity polarity; /* 极性反转 */
};

enum pwm_polarity {
    PWM_POLARITY_NORMAL,
    PWM_POLARITY_INVERSED,
};

struct pwm_ops {
    int (*request)(struct pwm_chip *chip, struct pwm_device *pwm);
    void (*free)(struct pwm_chip *chip, struct pwm_device *pwm);
    int (*config)(struct pwm_chip *chip, struct pwm_device *pwm,
              int duty_ns, int period_ns);
    int (*set_polarity)(struct pwm_chip *chip, struct pwm_device *pwm,
                enum pwm_polarity polarity);
    int (*enable)(struct pwm_chip *chip, struct pwm_device *pwm);
    void (*disable)(struct pwm_chip *chip, struct pwm_device *pwm);
#ifdef CONFIG_DEBUG_FS
    void (*dbg_show)(struct pwm_chip *chip, struct seq_file *s);
#endif
    struct module *owner;
};

pwm_ops的上层函数有：

/* 下列函数与pwm_ops位置一一对应 */
struct pwm_device *pwm_request(int pwm, const char *label);
void pwm_free(struct pwm_device *pwm);
int pwm_config(struct pwm_device *pwm, int duty_ns, int period_ns);
int pwm_set_polarity(struct pwm_device *pwm, enum pwm_polarity polarity);
int pwm_enable(struct pwm_device *pwm);
void pwm_disable(struct pwm_device *pwm);

PWM虽然分层和LCD一致，但这两个结构体并不像LCD中可以互相访问。如LCD中fb_info定义有：

struct fb_info {
    ...
    struct fb_ops *fbops;    /* 可通过fb_info访问fb操作函数 */
    ...
};

既然struct pwm_device和struct pwm_ops不能互相访问，那么一定会有其他结构体连接两者。它就是struct pwm_chip：

struct pwm_chip {
    struct device *dev;
    struct list_head list;
    const struct pwm_ops *ops;  /* PWM操作函数 */
    int base;
    unsigned int npwm;          /* 这个chip中的PWM个数 */

    struct pwm_device *pwms;    /* PWM属性 */

    struct pwm_device * (*of_xlate)(struct pwm_chip *pc,
                    const struct of_phandle_args *args);
    unsigned int of_pwm_n_cells;
    bool can_sleep;
};

如果我们需要注册或注销PWM，使用的结构体应该也是struct pwm_chip。也就是PWM以chip注册。

注册函数pwmchip_add()实现如下：

 /* chip的属性 */
 static struct attribute *pwm_chip_attrs[] = {
     &dev_attr_export.attr,      /* 注册pwm，创建设备节点 */
     &dev_attr_unexport.attr,    /* 注销pwm，销毁设备节点 */
     &dev_attr_npwm.attr,        /* 当前chip中pwm个数 */
     NULL,
 };

 int pwmchip_add(struct pwm_chip *chip)
 {
     return pwmchip_add_with_polarity(chip, PWM_POLARITY_NORMAL);
 }
 EXPORT_SYMBOL_GPL(pwmchip_add);

 int pwmchip_add_with_polarity(struct pwm_chip *chip, enum pwm_polarity polarity)
 {
     struct pwm_device *pwm;
     unsigned int i;
     int ret;
 ...
     /* pwm子系统和input子系统类似，按顺序填充的，但pwm子系统没有设备号 */
     ret = alloc_pwms(chip->base, chip->npwm);
 ...
     /* 申请空间 */
     chip->pwms = kzalloc(chip->npwm * sizeof(*pwm), GFP_KERNEL);
 ...
     chip->base = ret;
     /* 设置pwm_device */
     for (i = ; i < chip->npwm; i++) {
         pwm = &chip->pwms[i];
         pwm->chip = chip;
         pwm->pwm = chip->base + i;
         pwm->hwpwm = i;
         pwm->polarity = polarity;
 ...
     }
 ...
     /* 创建pwmchip%d设备 */
     pwmchip_sysfs_export(chip);
 ...
 }

 void pwmchip_sysfs_export(struct pwm_chip *chip)
 {
 ...
     parent = device_create(&pwm_class, chip->dev, MKDEV(, ), chip, "pwmchip%d", chip->base);
 ...
 }

注销函数pwmchip_remove()实现如下：

 int pwmchip_remove(struct pwm_chip *chip)
 {
     unsigned int i;
     int ret = ;
     /* 此函数会卸载此chip下的所有PWM */
     pwmchip_sysfs_unexport_children(chip);
 ...
     free_pwms(chip);
     /* 注销设备 */
     pwmchip_sysfs_unexport(chip);
 ...
 }
 EXPORT_SYMBOL_GPL(pwmchip_remove);

 void pwmchip_sysfs_unexport(struct pwm_chip *chip)
 {
     struct device *parent;

     parent = class_find_device(&pwm_class, NULL, chip,
                    pwmchip_sysfs_match);
     if (parent) {
         /* for class_find_device() */
         put_device(parent);
         device_unregister(parent);
     }
 }

在注册和注销pwmchip函数中，只是创建和删除和设备节点。但是在此之前，它并没有创建类，而是使用了类pwm_class。分析可知PWM子系统在初始化过程中一定创建了类pwm_class。

 static struct class pwm_class = {
     .name = "pwm",                    /* 类名为pwm */
     .owner = THIS_MODULE,
     .dev_groups = pwm_chip_groups,    /* 存放所有chip */
 };

 static int __init pwm_sysfs_init(void)
 {
     return class_register(&pwm_class);
 }

现在，我们来整理一下整体框架。

二、三星平台驱动分析

1. platform_device

 static struct resource samsung_pwm_resource[] = {
     DEFINE_RES_MEM(SAMSUNG_PA_TIMER, SZ_4K),
 };

 struct platform_device samsung_device_pwm = {
     .name        = "samsung-pwm",
     .id        = -,
     .num_resources    = ARRAY_SIZE(samsung_pwm_resource),
     .resource    = samsung_pwm_resource,
 };

2. platform_driver

 static struct platform_driver pwm_samsung_driver = {
     .driver        = {
         .name    = "samsung-pwm",
         .pm    = &pwm_samsung_pm_ops,
         .of_match_table = of_match_ptr(samsung_pwm_matches),
     },
     .probe        = pwm_samsung_probe,
     .remove        = pwm_samsung_remove,
 };
 module_platform_driver(pwm_samsung_driver);

我们来分析probe()函数，它设置并注册了pwmchip：

 struct samsung_pwm_chip {
     struct pwm_chip chip;    /* pwm_chip */
     struct samsung_pwm_variant variant;
     u8 inverter_mask;

     void __iomem *base;
     struct clk *base_clk;
     struct clk *tclk0;
     struct clk *tclk1;
 };

 static int pwm_samsung_probe(struct platform_device *pdev)
 {
     struct device *dev = &pdev->dev;
     struct samsung_pwm_chip *chip;
     struct resource *res;
     unsigned int chan;
     int ret;

     /* 分配内存 */
     chip = devm_kzalloc(&pdev->dev, sizeof(*chip), GFP_KERNEL);
     /* 设置chip */
     chip->chip.dev = &pdev->dev;
     chip->chip.ops = &pwm_samsung_ops;
     chip->chip.base = -;
     chip->chip.npwm = SAMSUNG_PWM_NUM;
     chip->inverter_mask = BIT(SAMSUNG_PWM_NUM) - ;
 ...
         memcpy(&chip->variant, pdev->dev.platform_data, sizeof(chip->variant));

     res = platform_get_resource(pdev, IORESOURCE_MEM, );
     chip->base = devm_ioremap_resource(&pdev->dev, res);
 ...
     chip->base_clk = devm_clk_get(&pdev->dev, "timers");
 ...
     ret = clk_prepare_enable(chip->base_clk);
 ...
     for (chan = ; chan < SAMSUNG_PWM_NUM; ++chan)
         if (chip->variant.output_mask & BIT(chan))
             pwm_samsung_set_invert(chip, chan, true);

     /* Following clocks are optional. */
     chip->tclk0 = devm_clk_get(&pdev->dev, "pwm-tclk0");
     chip->tclk1 = devm_clk_get(&pdev->dev, "pwm-tclk1");

     platform_set_drvdata(pdev, chip);
     /* 注册pwm */
     ret = pwmchip_add(&chip->chip);
 ...
     return ;
 }

remove()应该注销pwmchip：

 static int pwm_samsung_remove(struct platform_device *pdev)
 {
     struct samsung_pwm_chip *chip = platform_get_drvdata(pdev);
     int ret;

     ret = pwmchip_remove(&chip->chip);
     if (ret < )
         return ret;

     clk_disable_unprepare(chip->base_clk);

     return ;
 }

关于三星平台的struct pwm_ops pwm_samsung_ops在此不做分析，这些函数只是对寄存器进行读写操作。

最后总结一下：

1. PWM是通过注册chip来注册一个芯片中所有的PWM的

2. 对于具体的PWM，可以使用sysfs中的attributre属性来分辨

3. 注册完成某个PWM后，它的周期、占空比、极性和使能可以在sysfs中更改

4. 在sysfs中修改降低了驱动程序修改的次数

pwmchip在/sys/class/目录下生成，我们可以执行以下命令查看和修改pwmchip0的占空比：

# cd /sys/class/pwm/

# ls

# cd ./pwmchip0

# ls

# cd ./pwm0

# ls

# ls duty_cycle

# echo 50 > duty_cycle

# ls duty_cycle

下一章  十三、GPIO子系统