[deliverable/linux.git] / include / linux / pwm.h

#ifndef __LINUX_PWM_H
#define __LINUX_PWM_H

#include <linux/err.h>
#include <linux/of.h>

struct pwm_device;
struct seq_file;

#if IS_ENABLED(CONFIG_PWM)
/*
 * pwm_request - request a PWM device
 */
struct pwm_device *pwm_request(int pwm_id, const char *label);

/*
 * pwm_free - free a PWM device
 */
void pwm_free(struct pwm_device *pwm);

/*
 * pwm_config - change a PWM device configuration
 */
int pwm_config(struct pwm_device *pwm, int duty_ns, int period_ns);

/*
 * pwm_enable - start a PWM output toggling
 */
int pwm_enable(struct pwm_device *pwm);

/*
 * pwm_disable - stop a PWM output toggling
 */
void pwm_disable(struct pwm_device *pwm);
#else
static inline struct pwm_device *pwm_request(int pwm_id, const char *label)
{
	return ERR_PTR(-ENODEV);
}

static inline void pwm_free(struct pwm_device *pwm)
{
}

static inline int pwm_config(struct pwm_device *pwm, int duty_ns, int period_ns)
{
	return -EINVAL;
}

static inline int pwm_enable(struct pwm_device *pwm)
{
	return -EINVAL;
}

static inline void pwm_disable(struct pwm_device *pwm)
{
}
#endif

struct pwm_chip;

/**
 * enum pwm_polarity - polarity of a PWM signal
 * @PWM_POLARITY_NORMAL: a high signal for the duration of the duty-
 * cycle, followed by a low signal for the remainder of the pulse
 * period
 * @PWM_POLARITY_INVERSED: a low signal for the duration of the duty-
 * cycle, followed by a high signal for the remainder of the pulse
 * period
 */
enum pwm_polarity {
	PWM_POLARITY_NORMAL,
	PWM_POLARITY_INVERSED,
};

enum {
	PWMF_REQUESTED = 1 << 0,
	PWMF_ENABLED = 1 << 1,
	PWMF_EXPORTED = 1 << 2,
};

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

	unsigned int		period; 	/* in nanoseconds */
	unsigned int		duty_cycle;	/* in nanoseconds */
	enum pwm_polarity	polarity;
};

static inline bool pwm_is_enabled(const struct pwm_device *pwm)
{
	return test_bit(PWMF_ENABLED, &pwm->flags);
}

static inline void pwm_set_period(struct pwm_device *pwm, unsigned int period)
{
	if (pwm)
		pwm->period = period;
}

static inline unsigned int pwm_get_period(const struct pwm_device *pwm)
{
	return pwm ? pwm->period : 0;
}

static inline void pwm_set_duty_cycle(struct pwm_device *pwm, unsigned int duty)
{
	if (pwm)
		pwm->duty_cycle = duty;
}

static inline unsigned int pwm_get_duty_cycle(const struct pwm_device *pwm)
{
	return pwm ? pwm->duty_cycle : 0;
}

/*
 * pwm_set_polarity - configure the polarity of a PWM signal
 */
int pwm_set_polarity(struct pwm_device *pwm, enum pwm_polarity polarity);

static inline enum pwm_polarity pwm_get_polarity(const struct pwm_device *pwm)
{
	return pwm ? pwm->polarity : PWM_POLARITY_NORMAL;
}

/**
 * struct pwm_ops - PWM controller operations
 * @request: optional hook for requesting a PWM
 * @free: optional hook for freeing a PWM
 * @config: configure duty cycles and period length for this PWM
 * @set_polarity: configure the polarity of this PWM
 * @enable: enable PWM output toggling
 * @disable: disable PWM output toggling
 * @dbg_show: optional routine to show contents in debugfs
 * @owner: helps prevent removal of modules exporting active PWMs
 */
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;
};

/**
 * struct pwm_chip - abstract a PWM controller
 * @dev: device providing the PWMs
 * @list: list node for internal use
 * @ops: callbacks for this PWM controller
 * @base: number of first PWM controlled by this chip
 * @npwm: number of PWMs controlled by this chip
 * @pwms: array of PWM devices allocated by the framework
 * @can_sleep: must be true if the .config(), .enable() or .disable()
 *             operations may sleep
 */
struct pwm_chip {
	struct device		*dev;
	struct list_head	list;
	const struct pwm_ops	*ops;
	int			base;
	unsigned int		npwm;

	struct pwm_device	*pwms;

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

#if IS_ENABLED(CONFIG_PWM)
int pwm_set_chip_data(struct pwm_device *pwm, void *data);
void *pwm_get_chip_data(struct pwm_device *pwm);

int pwmchip_add_with_polarity(struct pwm_chip *chip,
			      enum pwm_polarity polarity);
int pwmchip_add(struct pwm_chip *chip);
int pwmchip_remove(struct pwm_chip *chip);
struct pwm_device *pwm_request_from_chip(struct pwm_chip *chip,
					 unsigned int index,
					 const char *label);

struct pwm_device *of_pwm_xlate_with_flags(struct pwm_chip *pc,
		const struct of_phandle_args *args);

struct pwm_device *pwm_get(struct device *dev, const char *con_id);
struct pwm_device *of_pwm_get(struct device_node *np, const char *con_id);
void pwm_put(struct pwm_device *pwm);

struct pwm_device *devm_pwm_get(struct device *dev, const char *con_id);
struct pwm_device *devm_of_pwm_get(struct device *dev, struct device_node *np,
				   const char *con_id);
void devm_pwm_put(struct device *dev, struct pwm_device *pwm);

bool pwm_can_sleep(struct pwm_device *pwm);
#else
static inline int pwm_set_chip_data(struct pwm_device *pwm, void *data)
{
	return -EINVAL;
}

static inline void *pwm_get_chip_data(struct pwm_device *pwm)
{
	return NULL;
}

static inline int pwmchip_add(struct pwm_chip *chip)
{
	return -EINVAL;
}

static inline int pwmchip_add_inversed(struct pwm_chip *chip)
{
	return -EINVAL;
}

static inline int pwmchip_remove(struct pwm_chip *chip)
{
	return -EINVAL;
}

static inline struct pwm_device *pwm_request_from_chip(struct pwm_chip *chip,
						       unsigned int index,
						       const char *label)
{
	return ERR_PTR(-ENODEV);
}

static inline struct pwm_device *pwm_get(struct device *dev,
					 const char *consumer)
{
	return ERR_PTR(-ENODEV);
}

static inline struct pwm_device *of_pwm_get(struct device_node *np,
					    const char *con_id)
{
	return ERR_PTR(-ENODEV);
}

static inline void pwm_put(struct pwm_device *pwm)
{
}

static inline struct pwm_device *devm_pwm_get(struct device *dev,
					      const char *consumer)
{
	return ERR_PTR(-ENODEV);
}

static inline struct pwm_device *devm_of_pwm_get(struct device *dev,
						 struct device_node *np,
						 const char *con_id)
{
	return ERR_PTR(-ENODEV);
}

static inline void devm_pwm_put(struct device *dev, struct pwm_device *pwm)
{
}

static inline bool pwm_can_sleep(struct pwm_device *pwm)
{
	return false;
}
#endif

struct pwm_lookup {
	struct list_head list;
	const char *provider;
	unsigned int index;
	const char *dev_id;
	const char *con_id;
	unsigned int period;
	enum pwm_polarity polarity;
};

#define PWM_LOOKUP(_provider, _index, _dev_id, _con_id, _period, _polarity) \
	{						\
		.provider = _provider,			\
		.index = _index,			\
		.dev_id = _dev_id,			\
		.con_id = _con_id,			\
		.period = _period,			\
		.polarity = _polarity			\
	}

#if IS_ENABLED(CONFIG_PWM)
void pwm_add_table(struct pwm_lookup *table, size_t num);
void pwm_remove_table(struct pwm_lookup *table, size_t num);
#else
static inline void pwm_add_table(struct pwm_lookup *table, size_t num)
{
}

static inline void pwm_remove_table(struct pwm_lookup *table, size_t num)
{
}
#endif

#ifdef CONFIG_PWM_SYSFS
void pwmchip_sysfs_export(struct pwm_chip *chip);
void pwmchip_sysfs_unexport(struct pwm_chip *chip);
#else
static inline void pwmchip_sysfs_export(struct pwm_chip *chip)
{
}

static inline void pwmchip_sysfs_unexport(struct pwm_chip *chip)
{
}
#endif /* CONFIG_PWM_SYSFS */

#endif /* __LINUX_PWM_H */
Commit	Line	Data
1a189b97 RK	1	#ifndef __LINUX_PWM_H
	2	#define __LINUX_PWM_H
	3
0bcf168b	4	#include <linux/err.h>
7299ab70 TR	5	#include <linux/of.h>
7299ab70 TR	6
1a189b97	7	struct pwm_device;
62099abf	8	struct seq_file;
1a189b97	9
557fe99d	10	#if IS_ENABLED(CONFIG_PWM)
1a189b97 RK	11	/*
	12	* pwm_request - request a PWM device
	13	*/
	14	struct pwm_device pwm_request(int pwm_id, const char label);
	15
	16	/*
	17	* pwm_free - free a PWM device
	18	*/
	19	void pwm_free(struct pwm_device *pwm);
	20
	21	/*
	22	* pwm_config - change a PWM device configuration
	23	*/
	24	int pwm_config(struct pwm_device *pwm, int duty_ns, int period_ns);
	25
	26	/*
	27	* pwm_enable - start a PWM output toggling
	28	*/
	29	int pwm_enable(struct pwm_device *pwm);
	30
	31	/*
	32	* pwm_disable - stop a PWM output toggling
	33	*/
	34	void pwm_disable(struct pwm_device *pwm);
0bcf168b TB	35	#else
	36	static inline struct pwm_device pwm_request(int pwm_id, const char label)
	37	{
	38	return ERR_PTR(-ENODEV);
	39	}
	40
	41	static inline void pwm_free(struct pwm_device *pwm)
	42	{
	43	}
	44
	45	static inline int pwm_config(struct pwm_device *pwm, int duty_ns, int period_ns)
	46	{
	47	return -EINVAL;
	48	}
	49
	50	static inline int pwm_enable(struct pwm_device *pwm)
	51	{
	52	return -EINVAL;
	53	}
	54
	55	static inline void pwm_disable(struct pwm_device *pwm)
	56	{
	57	}
	58	#endif
1a189b97	59
0c2498f1 SH	60	struct pwm_chip;
0c2498f1 SH	61
0aa0869c PA	62	/**
	63	* enum pwm_polarity - polarity of a PWM signal
	64	* @PWM_POLARITY_NORMAL: a high signal for the duration of the duty-
	65	* cycle, followed by a low signal for the remainder of the pulse
	66	* period
	67	* @PWM_POLARITY_INVERSED: a low signal for the duration of the duty-
	68	* cycle, followed by a high signal for the remainder of the pulse
	69	* period
	70	*/
	71	enum pwm_polarity {
	72	PWM_POLARITY_NORMAL,
	73	PWM_POLARITY_INVERSED,
	74	};
	75
f051c466 TR	76	enum {
	77	PWMF_REQUESTED = 1 << 0,
	78	PWMF_ENABLED = 1 << 1,
76abbdde	79	PWMF_EXPORTED = 1 << 2,
f051c466 TR	80	};
	81
	82	struct pwm_device {
	83	const char *label;
	84	unsigned long flags;
	85	unsigned int hwpwm;
	86	unsigned int pwm;
	87	struct pwm_chip *chip;
	88	void *chip_data;
	89
76abbdde HS	90	unsigned int period; /* in nanoseconds */
	91	unsigned int duty_cycle; /* in nanoseconds */
	92	enum pwm_polarity polarity;
f051c466 TR	93	};
f051c466 TR	94
5c31252c BB	95	static inline bool pwm_is_enabled(const struct pwm_device *pwm)
	96	{
	97	return test_bit(PWMF_ENABLED, &pwm->flags);
	98	}
	99
f051c466 TR	100	static inline void pwm_set_period(struct pwm_device *pwm, unsigned int period)
	101	{
	102	if (pwm)
	103	pwm->period = period;
	104	}
	105
a1cf4217	106	static inline unsigned int pwm_get_period(const struct pwm_device *pwm)
f051c466 TR	107	{
	108	return pwm ? pwm->period : 0;
	109	}
	110
76abbdde HS	111	static inline void pwm_set_duty_cycle(struct pwm_device *pwm, unsigned int duty)
	112	{
	113	if (pwm)
	114	pwm->duty_cycle = duty;
	115	}
	116
a1cf4217	117	static inline unsigned int pwm_get_duty_cycle(const struct pwm_device *pwm)
76abbdde HS	118	{
	119	return pwm ? pwm->duty_cycle : 0;
	120	}
	121
0aa0869c PA	122	/*
	123	* pwm_set_polarity - configure the polarity of a PWM signal
	124	*/
	125	int pwm_set_polarity(struct pwm_device *pwm, enum pwm_polarity polarity);
	126
011e7631 BB	127	static inline enum pwm_polarity pwm_get_polarity(const struct pwm_device *pwm)
	128	{
	129	return pwm ? pwm->polarity : PWM_POLARITY_NORMAL;
	130	}
	131
0c2498f1 SH	132	/**
	133	* struct pwm_ops - PWM controller operations
	134	* @request: optional hook for requesting a PWM
	135	* @free: optional hook for freeing a PWM
	136	* @config: configure duty cycles and period length for this PWM
0aa0869c	137	* @set_polarity: configure the polarity of this PWM
0c2498f1 SH	138	* @enable: enable PWM output toggling
0c2498f1 SH	139	* @disable: disable PWM output toggling
62099abf	140	* @dbg_show: optional routine to show contents in debugfs
0c2498f1 SH	141	* @owner: helps prevent removal of modules exporting active PWMs
	142	*/
	143	struct pwm_ops {
f051c466 TR	144	int (request)(struct pwm_chip chip,
	145	struct pwm_device *pwm);
	146	void (free)(struct pwm_chip chip,
	147	struct pwm_device *pwm);
	148	int (config)(struct pwm_chip chip,
	149	struct pwm_device *pwm,
	150	int duty_ns, int period_ns);
0aa0869c PA	151	int (set_polarity)(struct pwm_chip chip,
	152	struct pwm_device *pwm,
	153	enum pwm_polarity polarity);
f051c466 TR	154	int (enable)(struct pwm_chip chip,
	155	struct pwm_device *pwm);
	156	void (disable)(struct pwm_chip chip,
	157	struct pwm_device *pwm);
62099abf TR	158	#ifdef CONFIG_DEBUG_FS
	159	void (dbg_show)(struct pwm_chip chip,
	160	struct seq_file *s);
	161	#endif
0c2498f1 SH	162	struct module *owner;
	163	};
	164
	165	/**
f051c466 TR	166	* struct pwm_chip - abstract a PWM controller
	167	* @dev: device providing the PWMs
	168	* @list: list node for internal use
	169	* @ops: callbacks for this PWM controller
	170	* @base: number of first PWM controlled by this chip
	171	* @npwm: number of PWMs controlled by this chip
	172	* @pwms: array of PWM devices allocated by the framework
6e69ab13 FV	173	* @can_sleep: must be true if the .config(), .enable() or .disable()
6e69ab13 FV	174	* operations may sleep
0c2498f1 SH	175	*/
0c2498f1 SH	176	struct pwm_chip {
f051c466 TR	177	struct device *dev;
	178	struct list_head list;
	179	const struct pwm_ops *ops;
	180	int base;
	181	unsigned int npwm;
	182
	183	struct pwm_device *pwms;
7299ab70 TR	184
	185	struct pwm_device * (of_xlate)(struct pwm_chip pc,
	186	const struct of_phandle_args *args);
	187	unsigned int of_pwm_n_cells;
6e69ab13	188	bool can_sleep;
0c2498f1 SH	189	};
0c2498f1 SH	190
0bcf168b	191	#if IS_ENABLED(CONFIG_PWM)
f051c466 TR	192	int pwm_set_chip_data(struct pwm_device pwm, void data);
	193	void pwm_get_chip_data(struct pwm_device pwm);
	194
b6a00fae TK	195	int pwmchip_add_with_polarity(struct pwm_chip *chip,
b6a00fae TK	196	enum pwm_polarity polarity);
0c2498f1 SH	197	int pwmchip_add(struct pwm_chip *chip);
0c2498f1 SH	198	int pwmchip_remove(struct pwm_chip *chip);
f051c466 TR	199	struct pwm_device pwm_request_from_chip(struct pwm_chip chip,
	200	unsigned int index,
	201	const char *label);
8138d2dd	202
83af2402 PA	203	struct pwm_device of_pwm_xlate_with_flags(struct pwm_chip pc,
	204	const struct of_phandle_args *args);
	205
d4c0c470	206	struct pwm_device pwm_get(struct device dev, const char *con_id);
8eb96127	207	struct pwm_device of_pwm_get(struct device_node np, const char *con_id);
8138d2dd TR	208	void pwm_put(struct pwm_device *pwm);
8138d2dd TR	209
d4c0c470	210	struct pwm_device devm_pwm_get(struct device dev, const char *con_id);
261a5edd PU	211	struct pwm_device devm_of_pwm_get(struct device dev, struct device_node *np,
261a5edd PU	212	const char *con_id);
6354316d	213	void devm_pwm_put(struct device dev, struct pwm_device pwm);
6e69ab13 FV	214
6e69ab13 FV	215	bool pwm_can_sleep(struct pwm_device *pwm);
0bcf168b TB	216	#else
	217	static inline int pwm_set_chip_data(struct pwm_device pwm, void data)
	218	{
	219	return -EINVAL;
	220	}
	221
	222	static inline void pwm_get_chip_data(struct pwm_device pwm)
	223	{
	224	return NULL;
	225	}
	226
	227	static inline int pwmchip_add(struct pwm_chip *chip)
	228	{
	229	return -EINVAL;
	230	}
	231
b6a00fae TK	232	static inline int pwmchip_add_inversed(struct pwm_chip *chip)
	233	{
	234	return -EINVAL;
	235	}
	236
0bcf168b TB	237	static inline int pwmchip_remove(struct pwm_chip *chip)
	238	{
	239	return -EINVAL;
	240	}
	241
	242	static inline struct pwm_device pwm_request_from_chip(struct pwm_chip chip,
	243	unsigned int index,
	244	const char *label)
	245	{
	246	return ERR_PTR(-ENODEV);
	247	}
	248
	249	static inline struct pwm_device pwm_get(struct device dev,
	250	const char *consumer)
	251	{
	252	return ERR_PTR(-ENODEV);
	253	}
	254
8eb96127 PU	255	static inline struct pwm_device of_pwm_get(struct device_node np,
	256	const char *con_id)
	257	{
	258	return ERR_PTR(-ENODEV);
	259	}
	260
0bcf168b TB	261	static inline void pwm_put(struct pwm_device *pwm)
	262	{
	263	}
	264
	265	static inline struct pwm_device devm_pwm_get(struct device dev,
	266	const char *consumer)
	267	{
	268	return ERR_PTR(-ENODEV);
	269	}
	270
261a5edd PU	271	static inline struct pwm_device devm_of_pwm_get(struct device dev,
	272	struct device_node *np,
	273	const char *con_id)
	274	{
	275	return ERR_PTR(-ENODEV);
	276	}
	277
0bcf168b TB	278	static inline void devm_pwm_put(struct device dev, struct pwm_device pwm)
	279	{
	280	}
6e69ab13 FV	281
	282	static inline bool pwm_can_sleep(struct pwm_device *pwm)
	283	{
	284	return false;
	285	}
0bcf168b	286	#endif
6354316d	287
8138d2dd TR	288	struct pwm_lookup {
	289	struct list_head list;
	290	const char *provider;
	291	unsigned int index;
	292	const char *dev_id;
	293	const char *con_id;
3796ce1d AB	294	unsigned int period;
3796ce1d AB	295	enum pwm_polarity polarity;
8138d2dd TR	296	};
8138d2dd TR	297
42844029	298	#define PWM_LOOKUP(_provider, _index, _dev_id, _con_id, _period, _polarity) \
8138d2dd TR	299	{ \
	300	.provider = _provider, \
	301	.index = _index, \
	302	.dev_id = _dev_id, \
	303	.con_id = _con_id, \
42844029 AB	304	.period = _period, \
42844029 AB	305	.polarity = _polarity \
8138d2dd TR	306	}
8138d2dd TR	307
0bcf168b	308	#if IS_ENABLED(CONFIG_PWM)
8138d2dd	309	void pwm_add_table(struct pwm_lookup *table, size_t num);
efb0de55	310	void pwm_remove_table(struct pwm_lookup *table, size_t num);
0bcf168b TB	311	#else
	312	static inline void pwm_add_table(struct pwm_lookup *table, size_t num)
	313	{
	314	}
efb0de55 SK	315
	316	static inline void pwm_remove_table(struct pwm_lookup *table, size_t num)
	317	{
	318	}
0c2498f1 SH	319	#endif
0c2498f1 SH	320
76abbdde HS	321	#ifdef CONFIG_PWM_SYSFS
	322	void pwmchip_sysfs_export(struct pwm_chip *chip);
	323	void pwmchip_sysfs_unexport(struct pwm_chip *chip);
	324	#else
	325	static inline void pwmchip_sysfs_export(struct pwm_chip *chip)
	326	{
	327	}
	328
	329	static inline void pwmchip_sysfs_unexport(struct pwm_chip *chip)
	330	{
	331	}
	332	#endif /* CONFIG_PWM_SYSFS */
	333
5243ef8b	334	#endif /* __LINUX_PWM_H */