1 // SPDX-License-Identifier: GPL-2.0-only
3 * Driver for TWL4030/6030 Pulse Width Modulator used as LED driver
5 * Copyright (C) 2012 Texas Instruments
6 * Author: Peter Ujfalusi <peter.ujfalusi@ti.com>
8 * This driver is a complete rewrite of the former pwm-twl6030.c authorded by:
9 * Hemanth V <hemanthv@ti.com>
11 * Reference manual for the twl6030 is available at:
12 * https://www.ti.com/lit/ds/symlink/twl6030.pdf
15 * - The twl6030 hardware only supports two period lengths (128 clock ticks and
16 * 64 clock ticks), the driver only uses 128 ticks
17 * - The hardware doesn't support ON = 0, so the active part of a period doesn't
18 * start at its beginning.
19 * - The hardware could support inverted polarity (with a similar limitation as
20 * for normal: the last clock tick is always inactive).
21 * - The hardware emits a constant low output when disabled.
22 * - A request for .duty_cycle = 0 results in an output wave with one active
23 * clock tick per period. This should better use the disabled state.
24 * - The driver only implements setting the relative duty cycle.
25 * - The driver doesn't implement .get_state().
28 #include <linux/module.h>
30 #include <linux/platform_device.h>
31 #include <linux/pwm.h>
32 #include <linux/mfd/twl.h>
33 #include <linux/slab.h>
36 * This driver handles the PWM driven LED terminals of TWL4030 and TWL6030.
37 * To generate the signal on TWL4030:
40 * TWL6030 has one LED pin with dedicated LEDPWM
43 #define TWL4030_LED_MAX 0x7f
44 #define TWL6030_LED_MAX 0xff
46 /* Registers, bits and macro for TWL4030 */
47 #define TWL4030_LEDEN_REG 0x00
48 #define TWL4030_PWMA_REG 0x01
50 #define TWL4030_LEDXON (1 << 0)
51 #define TWL4030_LEDXPWM (1 << 4)
52 #define TWL4030_LED_PINS (TWL4030_LEDXON | TWL4030_LEDXPWM)
53 #define TWL4030_LED_TOGGLE(led, x) ((x) << (led))
55 /* Register, bits and macro for TWL6030 */
56 #define TWL6030_LED_PWM_CTRL1 0xf4
57 #define TWL6030_LED_PWM_CTRL2 0xf5
59 #define TWL6040_LED_MODE_HW 0x00
60 #define TWL6040_LED_MODE_ON 0x01
61 #define TWL6040_LED_MODE_OFF 0x02
62 #define TWL6040_LED_MODE_MASK 0x03
64 struct twl_pwmled_chip {
69 static inline struct twl_pwmled_chip *to_twl(struct pwm_chip *chip)
71 return container_of(chip, struct twl_pwmled_chip, chip);
74 static int twl4030_pwmled_config(struct pwm_chip *chip, struct pwm_device *pwm,
75 int duty_ns, int period_ns)
77 int duty_cycle = DIV_ROUND_UP(duty_ns * TWL4030_LED_MAX, period_ns) + 1;
78 u8 pwm_config[2] = { 1, 0 };
82 * To configure the duty period:
83 * On-cycle is set to 1 (the minimum allowed value)
84 * The off time of 0 is not configurable, so the mapping is:
88 * 126 - > off cycle 127,
90 * When on cycle == off cycle the PWM will be always on
94 else if (duty_cycle > TWL4030_LED_MAX)
97 base = pwm->hwpwm * 2 + TWL4030_PWMA_REG;
99 pwm_config[1] = duty_cycle;
101 ret = twl_i2c_write(TWL4030_MODULE_LED, pwm_config, base, 2);
103 dev_err(chip->dev, "%s: Failed to configure PWM\n", pwm->label);
108 static int twl4030_pwmled_enable(struct pwm_chip *chip, struct pwm_device *pwm)
110 struct twl_pwmled_chip *twl = to_twl(chip);
114 mutex_lock(&twl->mutex);
115 ret = twl_i2c_read_u8(TWL4030_MODULE_LED, &val, TWL4030_LEDEN_REG);
117 dev_err(chip->dev, "%s: Failed to read LEDEN\n", pwm->label);
121 val |= TWL4030_LED_TOGGLE(pwm->hwpwm, TWL4030_LED_PINS);
123 ret = twl_i2c_write_u8(TWL4030_MODULE_LED, val, TWL4030_LEDEN_REG);
125 dev_err(chip->dev, "%s: Failed to enable PWM\n", pwm->label);
128 mutex_unlock(&twl->mutex);
132 static void twl4030_pwmled_disable(struct pwm_chip *chip,
133 struct pwm_device *pwm)
135 struct twl_pwmled_chip *twl = to_twl(chip);
139 mutex_lock(&twl->mutex);
140 ret = twl_i2c_read_u8(TWL4030_MODULE_LED, &val, TWL4030_LEDEN_REG);
142 dev_err(chip->dev, "%s: Failed to read LEDEN\n", pwm->label);
146 val &= ~TWL4030_LED_TOGGLE(pwm->hwpwm, TWL4030_LED_PINS);
148 ret = twl_i2c_write_u8(TWL4030_MODULE_LED, val, TWL4030_LEDEN_REG);
150 dev_err(chip->dev, "%s: Failed to disable PWM\n", pwm->label);
153 mutex_unlock(&twl->mutex);
156 static int twl4030_pwmled_apply(struct pwm_chip *chip, struct pwm_device *pwm,
157 const struct pwm_state *state)
161 if (state->polarity != PWM_POLARITY_NORMAL)
164 if (!state->enabled) {
165 if (pwm->state.enabled)
166 twl4030_pwmled_disable(chip, pwm);
172 * We cannot skip calling ->config even if state->period ==
173 * pwm->state.period && state->duty_cycle == pwm->state.duty_cycle
174 * because we might have exited early in the last call to
175 * pwm_apply_state because of !state->enabled and so the two values in
176 * pwm->state might not be configured in hardware.
178 ret = twl4030_pwmled_config(pwm->chip, pwm,
179 state->duty_cycle, state->period);
183 if (!pwm->state.enabled)
184 ret = twl4030_pwmled_enable(chip, pwm);
190 static const struct pwm_ops twl4030_pwmled_ops = {
191 .apply = twl4030_pwmled_apply,
194 static int twl6030_pwmled_config(struct pwm_chip *chip, struct pwm_device *pwm,
195 int duty_ns, int period_ns)
197 int duty_cycle = (duty_ns * TWL6030_LED_MAX) / period_ns;
201 on_time = duty_cycle & 0xff;
203 ret = twl_i2c_write_u8(TWL6030_MODULE_ID1, on_time,
204 TWL6030_LED_PWM_CTRL1);
206 dev_err(chip->dev, "%s: Failed to configure PWM\n", pwm->label);
211 static int twl6030_pwmled_enable(struct pwm_chip *chip, struct pwm_device *pwm)
213 struct twl_pwmled_chip *twl = to_twl(chip);
217 mutex_lock(&twl->mutex);
218 ret = twl_i2c_read_u8(TWL6030_MODULE_ID1, &val, TWL6030_LED_PWM_CTRL2);
220 dev_err(chip->dev, "%s: Failed to read PWM_CTRL2\n",
225 val &= ~TWL6040_LED_MODE_MASK;
226 val |= TWL6040_LED_MODE_ON;
228 ret = twl_i2c_write_u8(TWL6030_MODULE_ID1, val, TWL6030_LED_PWM_CTRL2);
230 dev_err(chip->dev, "%s: Failed to enable PWM\n", pwm->label);
233 mutex_unlock(&twl->mutex);
237 static void twl6030_pwmled_disable(struct pwm_chip *chip,
238 struct pwm_device *pwm)
240 struct twl_pwmled_chip *twl = to_twl(chip);
244 mutex_lock(&twl->mutex);
245 ret = twl_i2c_read_u8(TWL6030_MODULE_ID1, &val, TWL6030_LED_PWM_CTRL2);
247 dev_err(chip->dev, "%s: Failed to read PWM_CTRL2\n",
252 val &= ~TWL6040_LED_MODE_MASK;
253 val |= TWL6040_LED_MODE_OFF;
255 ret = twl_i2c_write_u8(TWL6030_MODULE_ID1, val, TWL6030_LED_PWM_CTRL2);
257 dev_err(chip->dev, "%s: Failed to disable PWM\n", pwm->label);
260 mutex_unlock(&twl->mutex);
263 static int twl6030_pwmled_apply(struct pwm_chip *chip, struct pwm_device *pwm,
264 const struct pwm_state *state)
268 if (state->polarity != pwm->state.polarity)
271 if (!state->enabled) {
272 if (pwm->state.enabled)
273 twl6030_pwmled_disable(chip, pwm);
278 err = twl6030_pwmled_config(pwm->chip, pwm,
279 state->duty_cycle, state->period);
283 if (!pwm->state.enabled)
284 err = twl6030_pwmled_enable(chip, pwm);
289 static int twl6030_pwmled_request(struct pwm_chip *chip, struct pwm_device *pwm)
291 struct twl_pwmled_chip *twl = to_twl(chip);
295 mutex_lock(&twl->mutex);
296 ret = twl_i2c_read_u8(TWL6030_MODULE_ID1, &val, TWL6030_LED_PWM_CTRL2);
298 dev_err(chip->dev, "%s: Failed to read PWM_CTRL2\n",
303 val &= ~TWL6040_LED_MODE_MASK;
304 val |= TWL6040_LED_MODE_OFF;
306 ret = twl_i2c_write_u8(TWL6030_MODULE_ID1, val, TWL6030_LED_PWM_CTRL2);
308 dev_err(chip->dev, "%s: Failed to request PWM\n", pwm->label);
311 mutex_unlock(&twl->mutex);
315 static void twl6030_pwmled_free(struct pwm_chip *chip, struct pwm_device *pwm)
317 struct twl_pwmled_chip *twl = to_twl(chip);
321 mutex_lock(&twl->mutex);
322 ret = twl_i2c_read_u8(TWL6030_MODULE_ID1, &val, TWL6030_LED_PWM_CTRL2);
324 dev_err(chip->dev, "%s: Failed to read PWM_CTRL2\n",
329 val &= ~TWL6040_LED_MODE_MASK;
330 val |= TWL6040_LED_MODE_HW;
332 ret = twl_i2c_write_u8(TWL6030_MODULE_ID1, val, TWL6030_LED_PWM_CTRL2);
334 dev_err(chip->dev, "%s: Failed to free PWM\n", pwm->label);
337 mutex_unlock(&twl->mutex);
340 static const struct pwm_ops twl6030_pwmled_ops = {
341 .apply = twl6030_pwmled_apply,
342 .request = twl6030_pwmled_request,
343 .free = twl6030_pwmled_free,
346 static int twl_pwmled_probe(struct platform_device *pdev)
348 struct twl_pwmled_chip *twl;
350 twl = devm_kzalloc(&pdev->dev, sizeof(*twl), GFP_KERNEL);
354 if (twl_class_is_4030()) {
355 twl->chip.ops = &twl4030_pwmled_ops;
358 twl->chip.ops = &twl6030_pwmled_ops;
362 twl->chip.dev = &pdev->dev;
364 mutex_init(&twl->mutex);
366 return devm_pwmchip_add(&pdev->dev, &twl->chip);
370 static const struct of_device_id twl_pwmled_of_match[] = {
371 { .compatible = "ti,twl4030-pwmled" },
372 { .compatible = "ti,twl6030-pwmled" },
375 MODULE_DEVICE_TABLE(of, twl_pwmled_of_match);
378 static struct platform_driver twl_pwmled_driver = {
380 .name = "twl-pwmled",
381 .of_match_table = of_match_ptr(twl_pwmled_of_match),
383 .probe = twl_pwmled_probe,
385 module_platform_driver(twl_pwmled_driver);
387 MODULE_AUTHOR("Peter Ujfalusi <peter.ujfalusi@ti.com>");
388 MODULE_DESCRIPTION("PWM driver for TWL4030 and TWL6030 LED outputs");
389 MODULE_ALIAS("platform:twl-pwmled");
390 MODULE_LICENSE("GPL");