pwm.h 2.75 KB
Newer Older
1
/* SPDX-License-Identifier: GPL-2.0+ */
Donghwa Lee's avatar
Donghwa Lee committed
2
3
4
/*
 * header file for pwm driver.
 *
Simon Glass's avatar
Simon Glass committed
5
 * Copyright 2016 Google Inc.
Donghwa Lee's avatar
Donghwa Lee committed
6
7
8
9
10
11
12
 * Copyright (c) 2011 samsung electronics
 * Donghwa Lee <dh09.lee@samsung.com>
 */

#ifndef _pwm_h_
#define _pwm_h_

13
14
struct udevice;

Simon Glass's avatar
Simon Glass committed
15
16
17
18
19
/* struct pwm_ops: Operations for the PWM uclass */
struct pwm_ops {
	/**
	 * set_config() - Set the PWM configuration
	 *
20
21
22
23
	 * Change both the PWM device's period and it's duty period if
	 * possible. Otherwise, set an appropriate duty period that best
	 * matches the given period_ns / duty_ns ratio for the device.
	 *
Simon Glass's avatar
Simon Glass committed
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
	 * @dev:	PWM device to update
	 * @channel:	PWM channel to update
	 * @period_ns:	PWM period in nanoseconds
	 * @duty_ns:	PWM duty period in nanoseconds
	 * @return 0 if OK, -ve on error
	 */
	int (*set_config)(struct udevice *dev, uint channel, uint period_ns,
			  uint duty_ns);

	/**
	 * set_enable() - Enable or disable the PWM
	 *
	 * @dev:	PWM device to update
	 * @channel:	PWM channel to update
	 * @enable:	true to enable, false to disable
	 * @return 0 if OK, -ve on error
	 */
	int (*set_enable)(struct udevice *dev, uint channel, bool enable);
42
43
44
45
46
47
48
49
50
	/**
	 * set_invert() - Set the PWM invert
	 *
	 * @dev:        PWM device to update
	 * @channel:    PWM channel to update
	 * @polarity:   true to invert, false to keep normal polarity
	 * @return 0 if OK, -ve on error
	 */
	int (*set_invert)(struct udevice *dev, uint channel, bool polarity);
Simon Glass's avatar
Simon Glass committed
51
52
53
54
55
56
57
};

#define pwm_get_ops(dev)	((struct pwm_ops *)(dev)->driver->ops)

/**
 * pwm_set_config() - Set the PWM configuration
 *
58
59
60
61
 * Change both the PWM device's period and it's duty period if
 * possible. Otherwise, set an appropriate duty period that best
 * matches the given period_ns / duty_ns ratio for the device.
 *
Simon Glass's avatar
Simon Glass committed
62
63
64
65
 * @dev:	PWM device to update
 * @channel:	PWM channel to update
 * @period_ns:	PWM period in nanoseconds
 * @duty_ns:	PWM duty period in nanoseconds
66
 * Return: 0 if OK, -ve on error
Simon Glass's avatar
Simon Glass committed
67
68
69
70
71
72
73
74
75
76
 */
int pwm_set_config(struct udevice *dev, uint channel, uint period_ns,
		   uint duty_ns);

/**
 * pwm_set_enable() - Enable or disable the PWM
 *
 * @dev:	PWM device to update
 * @channel:	PWM channel to update
 * @enable:	true to enable, false to disable
77
 * Return: 0 if OK, -ve on error
Simon Glass's avatar
Simon Glass committed
78
79
80
 */
int pwm_set_enable(struct udevice *dev, uint channel, bool enable);

81
82
83
84
85
86
/**
 * pwm_set_invert() - Set pwm default polarity
 *
 * @dev:	PWM device to update
 * @channel:	PWM channel to update
 * @polarity:	true to invert, false to keep normal polarity
87
 * Return: 0 if OK, -ve on error
88
89
90
 */
int pwm_set_invert(struct udevice *dev, uint channel, bool polarity);

Simon Glass's avatar
Simon Glass committed
91
92
/* Legacy interface */
#ifndef CONFIG_DM_PWM
Donghwa Lee's avatar
Donghwa Lee committed
93
94
95
96
int	pwm_init		(int pwm_id, int div, int invert);
int	pwm_config		(int pwm_id, int duty_ns, int period_ns);
int	pwm_enable		(int pwm_id);
void	pwm_disable		(int pwm_id);
Simon Glass's avatar
Simon Glass committed
97
#endif
Donghwa Lee's avatar
Donghwa Lee committed
98
99

#endif /* _pwm_h_ */