pwm: Add TI PWM subsystem driver

In some platforms (like am33xx), PWM sub modules (ECAP, EHRPWM, EQEP) are integrated to PWM subsystem. These PWM submodules has resources shared and only one register bit-field is provided to control module/clock enable/disable, makes it difficult to handle common resources from independent PWMSS submodule drivers. So the solution here implemented in this patch is, to create driver for PWMSS and take the role of parent driver for PWM submodules. PWMSS parent driver enumerates all the child nodes under PWMSS module. Also symbol "pwmss_submodule_state_change" exported to enable clock gating for individual PWMSS submodules, and submodule drivers has to enable clock gating from their drivers. As this is only supported during DT boot, the parent/child relationship is created and populated in DT execution flow. The only required change is inside DTS file, making EHRPWM & ECAP as a child to PWMSS node. Signed-off-by: Philip, Avinash <avinashphilip@ti.com> Signed-off-by: Thierry Reding <thierry.reding@avionic-design.de>

pwm: Add TI PWM subsystem driver
In some platforms (like am33xx), PWM sub modules (ECAP, EHRPWM, EQEP) are integrated to PWM subsystem. These PWM submodules has resources shared and only one register bit-field is provided to control module/clock enable/disable, makes it difficult to handle common resources from independent PWMSS submodule drivers. So the solution here implemented in this patch is, to create driver for PWMSS and take the role of parent driver for PWM submodules. PWMSS parent driver enumerates all the child nodes under PWMSS module. Also symbol "pwmss_submodule_state_change" exported to enable clock gating for individual PWMSS submodules, and submodule drivers has to enable clock gating from their drivers. As this is only supported during DT boot, the parent/child relationship is created and populated in DT execution flow. The only required change is inside DTS file, making EHRPWM & ECAP as a child to PWMSS node. Signed-off-by: Philip, Avinash <avinashphilip@ti.com> Signed-off-by: Thierry Reding <thierry.reding@avionic-design.de>
Philip, Avinash · Thierry Reding
1 parent 83af24027b
Showing 5 changed files with 221 additions and 0 deletions Side-by-side Diff
Documentation/devicetree/bindings/pwm/pwm-tipwmss.txt
drivers/pwm/Kconfig
drivers/pwm/Makefile
drivers/pwm/pwm-tipwmss.c
drivers/pwm/pwm-tipwmss.h
+TI SOC based PWM Subsystem
+
+Required properties:
+- compatible: Must be "ti,am33xx-pwmss";
+- reg: physical base address and size of the registers map.
+- address-cells: Specify the number of u32 entries needed in child nodes.
+		  Should set to 1.
+- size-cells: specify number of u32 entries needed to specify child nodes size
+		in reg property. Should set to 1.
+- ranges: describes the address mapping of a memory-mapped bus. Should set to
+	   physical address map of child's base address, physical address within
+	   parent's address  space and length of the address map. For am33xx,
+	   3 set of child register maps present, ECAP register space, EQEP
+	   register space, EHRPWM register space.
+
+Also child nodes should also populated under PWMSS DT node.
+
+Example:
+pwmss0: pwmss@48300000 {
+	compatible = "ti,am33xx-pwmss";
+	reg = <0x48300000 0x10>;
+	ti,hwmods = "epwmss0";
+	#address-cells = <1>;
+	#size-cells = <1>;
+	status = "disabled";
+	ranges = <0x48300100 0x48300100 0x80   /* ECAP */
+		  0x48300180 0x48300180 0x80   /* EQEP */
+		  0x48300200 0x48300200 0x80>; /* EHRPWM */
+
+	/* child nodes go here */
+};
@@ -136,6 +136,7 @@
 config  PWM_TIECAP
 	tristate "ECAP PWM support"
 	depends on SOC_AM33XX
+	select PWM_TIPWMSS
 	help
 	  PWM driver support for the ECAP APWM controller found on AM33XX
 	  TI SOC
  
@@ -146,12 +147,22 @@
 config  PWM_TIEHRPWM
 	tristate "EHRPWM PWM support"
 	depends on SOC_AM33XX
+	select PWM_TIPWMSS
 	help
 	  PWM driver support for the EHRPWM controller found on AM33XX
 	  TI SOC
  
 	  To compile this driver as a module, choose M here: the module
 	  will be called pwm-tiehrpwm.
+
+config  PWM_TIPWMSS
+	bool
+	depends on SOC_AM33XX && (PWM_TIEHRPWM || PWM_TIECAP)
+	help
+	  PWM Subsystem driver support for AM33xx SOC.
+
+	  PWM submodules require PWM config space access from submodule
+	  drivers and require common parent driver support.
  
 config PWM_TWL6030
 	tristate "TWL6030 PWM support"
@@ -12,6 +12,7 @@
 obj-$(CONFIG_PWM_TEGRA)		+= pwm-tegra.o
 obj-$(CONFIG_PWM_TIECAP)	+= pwm-tiecap.o
 obj-$(CONFIG_PWM_TIEHRPWM)	+= pwm-tiehrpwm.o
+obj-$(CONFIG_PWM_TIPWMSS)	+= pwm-tipwmss.o
 obj-$(CONFIG_PWM_TWL6030)	+= pwm-twl6030.o
 obj-$(CONFIG_PWM_VT8500)	+= pwm-vt8500.o
+/*
+ * TI PWM Subsystem driver
+ *
+ * Copyright (C) 2012 Texas Instruments Incorporated - http://www.ti.com/
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ */
+
+#include <linux/module.h>
+#include <linux/platform_device.h>
+#include <linux/io.h>
+#include <linux/err.h>
+#include <linux/pm_runtime.h>
+#include <linux/of_device.h>
+
+#include "pwm-tipwmss.h"
+
+#define PWMSS_CLKCONFIG		0x8	/* Clock gating reg */
+#define PWMSS_CLKSTATUS		0xc	/* Clock gating status reg */
+
+struct pwmss_info {
+	void __iomem	*mmio_base;
+	struct mutex	pwmss_lock;
+	u16		pwmss_clkconfig;
+};
+
+u16 pwmss_submodule_state_change(struct device *dev, int set)
+{
+	struct pwmss_info *info = dev_get_drvdata(dev);
+	u16 val;
+
+	mutex_lock(&info->pwmss_lock);
+	val = readw(info->mmio_base + PWMSS_CLKCONFIG);
+	val |= set;
+	writew(val , info->mmio_base + PWMSS_CLKCONFIG);
+	mutex_unlock(&info->pwmss_lock);
+
+	return readw(info->mmio_base + PWMSS_CLKSTATUS);
+}
+EXPORT_SYMBOL(pwmss_submodule_state_change);
+
+static const struct of_device_id pwmss_of_match[] = {
+	{ .compatible	= "ti,am33xx-pwmss" },
+	{},
+};
+MODULE_DEVICE_TABLE(of, pwmss_of_match);
+
+static int pwmss_probe(struct platform_device *pdev)
+{
+	int ret;
+	struct resource *r;
+	struct pwmss_info *info;
+	struct device_node *node = pdev->dev.of_node;
+
+	info = devm_kzalloc(&pdev->dev, sizeof(*info), GFP_KERNEL);
+	if (!info) {
+		dev_err(&pdev->dev, "failed to allocate memory\n");
+		return -ENOMEM;
+	}
+
+	mutex_init(&info->pwmss_lock);
+
+	r = platform_get_resource(pdev, IORESOURCE_MEM, 0);
+	if (!r) {
+		dev_err(&pdev->dev, "no memory resource defined\n");
+		return -ENODEV;
+	}
+
+	info->mmio_base = devm_request_and_ioremap(&pdev->dev, r);
+	if (!info->mmio_base)
+		return -EADDRNOTAVAIL;
+
+	pm_runtime_enable(&pdev->dev);
+	pm_runtime_get_sync(&pdev->dev);
+	platform_set_drvdata(pdev, info);
+
+	/* Populate all the child nodes here... */
+	ret = of_platform_populate(node, NULL, NULL, &pdev->dev);
+	if (ret)
+		dev_err(&pdev->dev, "no child node found\n");
+
+	return ret;
+}
+
+static int pwmss_remove(struct platform_device *pdev)
+{
+	struct pwmss_info *info = platform_get_drvdata(pdev);
+
+	pm_runtime_put_sync(&pdev->dev);
+	pm_runtime_disable(&pdev->dev);
+	mutex_destroy(&info->pwmss_lock);
+	return 0;
+}
+
+static int pwmss_suspend(struct device *dev)
+{
+	struct pwmss_info *info = dev_get_drvdata(dev);
+
+	info->pwmss_clkconfig = readw(info->mmio_base + PWMSS_CLKCONFIG);
+	pm_runtime_put_sync(dev);
+	return 0;
+}
+
+static int pwmss_resume(struct device *dev)
+{
+	struct pwmss_info *info = dev_get_drvdata(dev);
+
+	pm_runtime_get_sync(dev);
+	writew(info->pwmss_clkconfig, info->mmio_base + PWMSS_CLKCONFIG);
+	return 0;
+}
+
+static SIMPLE_DEV_PM_OPS(pwmss_pm_ops, pwmss_suspend, pwmss_resume);
+
+static struct platform_driver pwmss_driver = {
+	.driver	= {
+		.name	= "pwmss",
+		.owner	= THIS_MODULE,
+		.pm	= &pwmss_pm_ops,
+		.of_match_table	= pwmss_of_match,
+	},
+	.probe	= pwmss_probe,
+	.remove	= pwmss_remove,
+};
+
+module_platform_driver(pwmss_driver);
+
+MODULE_DESCRIPTION("PWM Subsystem driver");
+MODULE_AUTHOR("Texas Instruments");
+MODULE_LICENSE("GPL");
+/*
+ * TI PWM Subsystem driver
+ *
+ * Copyright (C) 2012 Texas Instruments Incorporated - http://www.ti.com/
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ */
+
+#ifndef __TIPWMSS_H
+#define __TIPWMSS_H
+
+#ifdef CONFIG_PWM_TIPWMSS
+/* PWM substem clock gating */
+#define PWMSS_ECAPCLK_EN	BIT(0)
+#define PWMSS_ECAPCLK_STOP_REQ	BIT(1)
+#define PWMSS_EPWMCLK_EN	BIT(8)
+#define PWMSS_EPWMCLK_STOP_REQ	BIT(9)
+
+#define PWMSS_ECAPCLK_EN_ACK	BIT(0)
+#define PWMSS_EPWMCLK_EN_ACK	BIT(8)
+
+extern u16 pwmss_submodule_state_change(struct device *dev, int set);
+#else
+static inline u16 pwmss_submodule_state_change(struct device *dev, int set)
+{
+	/* return success status value */
+	return 0xFFFF;
+}
+#endif
+#endif	/* __TIPWMSS_H */
	1	+TI SOC based PWM Subsystem
	2	+
	3	+Required properties:
	4	+- compatible: Must be "ti,am33xx-pwmss";
	5	+- reg: physical base address and size of the registers map.
	6	+- address-cells: Specify the number of u32 entries needed in child nodes.
	7	+ Should set to 1.
	8	+- size-cells: specify number of u32 entries needed to specify child nodes size
	9	+ in reg property. Should set to 1.
	10	+- ranges: describes the address mapping of a memory-mapped bus. Should set to
	11	+ physical address map of child's base address, physical address within
	12	+ parent's address space and length of the address map. For am33xx,
	13	+ 3 set of child register maps present, ECAP register space, EQEP
	14	+ register space, EHRPWM register space.
	15	+
	16	+Also child nodes should also populated under PWMSS DT node.
	17	+
	18	+Example:
	19	+pwmss0: pwmss@48300000 {
	20	+ compatible = "ti,am33xx-pwmss";
	21	+ reg = <0x48300000 0x10>;
	22	+ ti,hwmods = "epwmss0";
	23	+ #address-cells = <1>;
	24	+ #size-cells = <1>;
	25	+ status = "disabled";
	26	+ ranges = <0x48300100 0x48300100 0x80 /* ECAP */
	27	+ 0x48300180 0x48300180 0x80 /* EQEP */
	28	+ 0x48300200 0x48300200 0x80>; /* EHRPWM */
	29	+
	30	+ /* child nodes go here */
	31	+};
...	...	@@ -136,6 +136,7 @@
136	136	config PWM_TIECAP
137	137	tristate "ECAP PWM support"
138	138	depends on SOC_AM33XX
	139	+ select PWM_TIPWMSS
139	140	help
140	141	PWM driver support for the ECAP APWM controller found on AM33XX
141	142	TI SOC
142	143
...	...	@@ -146,12 +147,22 @@
146	147	config PWM_TIEHRPWM
147	148	tristate "EHRPWM PWM support"
148	149	depends on SOC_AM33XX
	150	+ select PWM_TIPWMSS
149	151	help
150	152	PWM driver support for the EHRPWM controller found on AM33XX
151	153	TI SOC
152	154
153	155	To compile this driver as a module, choose M here: the module
154	156	will be called pwm-tiehrpwm.
	157	+
	158	+config PWM_TIPWMSS
	159	+ bool
	160	+ depends on SOC_AM33XX && (PWM_TIEHRPWM \|\| PWM_TIECAP)
	161	+ help
	162	+ PWM Subsystem driver support for AM33xx SOC.
	163	+
	164	+ PWM submodules require PWM config space access from submodule
	165	+ drivers and require common parent driver support.
155	166
156	167	config PWM_TWL6030
157	168	tristate "TWL6030 PWM support"
...	...	@@ -12,6 +12,7 @@
12	12	obj-$(CONFIG_PWM_TEGRA) += pwm-tegra.o
13	13	obj-$(CONFIG_PWM_TIECAP) += pwm-tiecap.o
14	14	obj-$(CONFIG_PWM_TIEHRPWM) += pwm-tiehrpwm.o
	15	+obj-$(CONFIG_PWM_TIPWMSS) += pwm-tipwmss.o
15	16	obj-$(CONFIG_PWM_TWL6030) += pwm-twl6030.o
16	17	obj-$(CONFIG_PWM_VT8500) += pwm-vt8500.o
	1	+/*
	2	+ * TI PWM Subsystem driver
	3	+ *
	4	+ * Copyright (C) 2012 Texas Instruments Incorporated - http://www.ti.com/
	5	+ *
	6	+ * This program is free software; you can redistribute it and/or modify
	7	+ * it under the terms of the GNU General Public License as published by
	8	+ * the Free Software Foundation; either version 2 of the License, or
	9	+ * (at your option) any later version.
	10	+ *
	11	+ * This program is distributed in the hope that it will be useful,
	12	+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
	13	+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	14	+ * GNU General Public License for more details.
	15	+ *
	16	+ */
	17	+
	18	+#include <linux/module.h>
	19	+#include <linux/platform_device.h>
	20	+#include <linux/io.h>
	21	+#include <linux/err.h>
	22	+#include <linux/pm_runtime.h>
	23	+#include <linux/of_device.h>
	24	+
	25	+#include "pwm-tipwmss.h"
	26	+
	27	+#define PWMSS_CLKCONFIG 0x8 /* Clock gating reg */
	28	+#define PWMSS_CLKSTATUS 0xc /* Clock gating status reg */
	29	+
	30	+struct pwmss_info {
	31	+ void __iomem *mmio_base;
	32	+ struct mutex pwmss_lock;
	33	+ u16 pwmss_clkconfig;
	34	+};
	35	+
	36	+u16 pwmss_submodule_state_change(struct device *dev, int set)
	37	+{
	38	+ struct pwmss_info *info = dev_get_drvdata(dev);
	39	+ u16 val;
	40	+
	41	+ mutex_lock(&info->pwmss_lock);
	42	+ val = readw(info->mmio_base + PWMSS_CLKCONFIG);
	43	+ val \|= set;
	44	+ writew(val , info->mmio_base + PWMSS_CLKCONFIG);
	45	+ mutex_unlock(&info->pwmss_lock);
	46	+
	47	+ return readw(info->mmio_base + PWMSS_CLKSTATUS);
	48	+}
	49	+EXPORT_SYMBOL(pwmss_submodule_state_change);
	50	+
	51	+static const struct of_device_id pwmss_of_match[] = {
	52	+ { .compatible = "ti,am33xx-pwmss" },
	53	+ {},
	54	+};
	55	+MODULE_DEVICE_TABLE(of, pwmss_of_match);
	56	+
	57	+static int pwmss_probe(struct platform_device *pdev)
	58	+{
	59	+ int ret;
	60	+ struct resource *r;
	61	+ struct pwmss_info *info;
	62	+ struct device_node *node = pdev->dev.of_node;
	63	+
	64	+ info = devm_kzalloc(&pdev->dev, sizeof(*info), GFP_KERNEL);
	65	+ if (!info) {
	66	+ dev_err(&pdev->dev, "failed to allocate memory\n");
	67	+ return -ENOMEM;
	68	+ }
	69	+
	70	+ mutex_init(&info->pwmss_lock);
	71	+
	72	+ r = platform_get_resource(pdev, IORESOURCE_MEM, 0);
	73	+ if (!r) {
	74	+ dev_err(&pdev->dev, "no memory resource defined\n");
	75	+ return -ENODEV;
	76	+ }
	77	+
	78	+ info->mmio_base = devm_request_and_ioremap(&pdev->dev, r);
	79	+ if (!info->mmio_base)
	80	+ return -EADDRNOTAVAIL;
	81	+
	82	+ pm_runtime_enable(&pdev->dev);
	83	+ pm_runtime_get_sync(&pdev->dev);
	84	+ platform_set_drvdata(pdev, info);
	85	+
	86	+ /* Populate all the child nodes here... */
	87	+ ret = of_platform_populate(node, NULL, NULL, &pdev->dev);
	88	+ if (ret)
	89	+ dev_err(&pdev->dev, "no child node found\n");
	90	+
	91	+ return ret;
	92	+}
	93	+
	94	+static int pwmss_remove(struct platform_device *pdev)
	95	+{
	96	+ struct pwmss_info *info = platform_get_drvdata(pdev);
	97	+
	98	+ pm_runtime_put_sync(&pdev->dev);
	99	+ pm_runtime_disable(&pdev->dev);
	100	+ mutex_destroy(&info->pwmss_lock);
	101	+ return 0;
	102	+}
	103	+
	104	+static int pwmss_suspend(struct device *dev)
	105	+{
	106	+ struct pwmss_info *info = dev_get_drvdata(dev);
	107	+
	108	+ info->pwmss_clkconfig = readw(info->mmio_base + PWMSS_CLKCONFIG);
	109	+ pm_runtime_put_sync(dev);
	110	+ return 0;
	111	+}
	112	+
	113	+static int pwmss_resume(struct device *dev)
	114	+{
	115	+ struct pwmss_info *info = dev_get_drvdata(dev);
	116	+
	117	+ pm_runtime_get_sync(dev);
	118	+ writew(info->pwmss_clkconfig, info->mmio_base + PWMSS_CLKCONFIG);
	119	+ return 0;
	120	+}
	121	+
	122	+static SIMPLE_DEV_PM_OPS(pwmss_pm_ops, pwmss_suspend, pwmss_resume);
	123	+
	124	+static struct platform_driver pwmss_driver = {
	125	+ .driver = {
	126	+ .name = "pwmss",
	127	+ .owner = THIS_MODULE,
	128	+ .pm = &pwmss_pm_ops,
	129	+ .of_match_table = pwmss_of_match,
	130	+ },
	131	+ .probe = pwmss_probe,
	132	+ .remove = pwmss_remove,
	133	+};
	134	+
	135	+module_platform_driver(pwmss_driver);
	136	+
	137	+MODULE_DESCRIPTION("PWM Subsystem driver");
	138	+MODULE_AUTHOR("Texas Instruments");
	139	+MODULE_LICENSE("GPL");