xref: /openbmc/linux/drivers/leds/leds-gpio.c (revision 828ff2ad)
1 /*
2  * LEDs driver for GPIOs
3  *
4  * Copyright (C) 2007 8D Technologies inc.
5  * Raphael Assenat <raph@8d.com>
6  * Copyright (C) 2008 Freescale Semiconductor, Inc.
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License version 2 as
10  * published by the Free Software Foundation.
11  *
12  */
13 #include <linux/err.h>
14 #include <linux/gpio.h>
15 #include <linux/gpio/consumer.h>
16 #include <linux/kernel.h>
17 #include <linux/leds.h>
18 #include <linux/module.h>
19 #include <linux/of.h>
20 #include <linux/platform_device.h>
21 #include <linux/property.h>
22 #include <linux/slab.h>
23 
24 struct gpio_led_data {
25 	struct led_classdev cdev;
26 	struct gpio_desc *gpiod;
27 	u8 can_sleep;
28 	u8 blinking;
29 	gpio_blink_set_t platform_gpio_blink_set;
30 };
31 
32 static inline struct gpio_led_data *
33 			cdev_to_gpio_led_data(struct led_classdev *led_cdev)
34 {
35 	return container_of(led_cdev, struct gpio_led_data, cdev);
36 }
37 
38 static void gpio_led_set(struct led_classdev *led_cdev,
39 	enum led_brightness value)
40 {
41 	struct gpio_led_data *led_dat = cdev_to_gpio_led_data(led_cdev);
42 	int level;
43 
44 	if (value == LED_OFF)
45 		level = 0;
46 	else
47 		level = 1;
48 
49 	if (led_dat->blinking) {
50 		led_dat->platform_gpio_blink_set(led_dat->gpiod, level,
51 						 NULL, NULL);
52 		led_dat->blinking = 0;
53 	} else {
54 		if (led_dat->can_sleep)
55 			gpiod_set_value_cansleep(led_dat->gpiod, level);
56 		else
57 			gpiod_set_value(led_dat->gpiod, level);
58 	}
59 }
60 
61 static int gpio_led_set_blocking(struct led_classdev *led_cdev,
62 	enum led_brightness value)
63 {
64 	gpio_led_set(led_cdev, value);
65 	return 0;
66 }
67 
68 static int gpio_blink_set(struct led_classdev *led_cdev,
69 	unsigned long *delay_on, unsigned long *delay_off)
70 {
71 	struct gpio_led_data *led_dat = cdev_to_gpio_led_data(led_cdev);
72 
73 	led_dat->blinking = 1;
74 	return led_dat->platform_gpio_blink_set(led_dat->gpiod, GPIO_LED_BLINK,
75 						delay_on, delay_off);
76 }
77 
78 static int create_gpio_led(const struct gpio_led *template,
79 	struct gpio_led_data *led_dat, struct device *parent,
80 	struct device_node *np, gpio_blink_set_t blink_set)
81 {
82 	int ret, state;
83 
84 	led_dat->cdev.name = template->name;
85 	led_dat->cdev.default_trigger = template->default_trigger;
86 	led_dat->can_sleep = gpiod_cansleep(led_dat->gpiod);
87 	if (!led_dat->can_sleep)
88 		led_dat->cdev.brightness_set = gpio_led_set;
89 	else
90 		led_dat->cdev.brightness_set_blocking = gpio_led_set_blocking;
91 	led_dat->blinking = 0;
92 	if (blink_set) {
93 		led_dat->platform_gpio_blink_set = blink_set;
94 		led_dat->cdev.blink_set = gpio_blink_set;
95 	}
96 	if (template->default_state == LEDS_GPIO_DEFSTATE_KEEP) {
97 		state = gpiod_get_value_cansleep(led_dat->gpiod);
98 		if (state < 0)
99 			return state;
100 	} else {
101 		state = (template->default_state == LEDS_GPIO_DEFSTATE_ON);
102 	}
103 	led_dat->cdev.brightness = state ? LED_FULL : LED_OFF;
104 	if (!template->retain_state_suspended)
105 		led_dat->cdev.flags |= LED_CORE_SUSPENDRESUME;
106 	if (template->panic_indicator)
107 		led_dat->cdev.flags |= LED_PANIC_INDICATOR;
108 	if (template->retain_state_shutdown)
109 		led_dat->cdev.flags |= LED_RETAIN_AT_SHUTDOWN;
110 
111 	ret = gpiod_direction_output(led_dat->gpiod, state);
112 	if (ret < 0)
113 		return ret;
114 
115 	return devm_of_led_classdev_register(parent, np, &led_dat->cdev);
116 }
117 
118 struct gpio_leds_priv {
119 	int num_leds;
120 	struct gpio_led_data leds[];
121 };
122 
123 static inline int sizeof_gpio_leds_priv(int num_leds)
124 {
125 	return sizeof(struct gpio_leds_priv) +
126 		(sizeof(struct gpio_led_data) * num_leds);
127 }
128 
129 static struct gpio_leds_priv *gpio_leds_create(struct platform_device *pdev)
130 {
131 	struct device *dev = &pdev->dev;
132 	struct fwnode_handle *child;
133 	struct gpio_leds_priv *priv;
134 	int count, ret;
135 
136 	count = device_get_child_node_count(dev);
137 	if (!count)
138 		return ERR_PTR(-ENODEV);
139 
140 	priv = devm_kzalloc(dev, sizeof_gpio_leds_priv(count), GFP_KERNEL);
141 	if (!priv)
142 		return ERR_PTR(-ENOMEM);
143 
144 	device_for_each_child_node(dev, child) {
145 		struct gpio_led_data *led_dat = &priv->leds[priv->num_leds];
146 		struct gpio_led led = {};
147 		const char *state = NULL;
148 		struct device_node *np = to_of_node(child);
149 
150 		ret = fwnode_property_read_string(child, "label", &led.name);
151 		if (ret && IS_ENABLED(CONFIG_OF) && np)
152 			led.name = np->name;
153 		if (!led.name) {
154 			fwnode_handle_put(child);
155 			return ERR_PTR(-EINVAL);
156 		}
157 
158 		led.gpiod = devm_fwnode_get_gpiod_from_child(dev, NULL, child,
159 							     GPIOD_ASIS,
160 							     led.name);
161 		if (IS_ERR(led.gpiod)) {
162 			fwnode_handle_put(child);
163 			return ERR_CAST(led.gpiod);
164 		}
165 
166 		led_dat->gpiod = led.gpiod;
167 
168 		fwnode_property_read_string(child, "linux,default-trigger",
169 					    &led.default_trigger);
170 
171 		if (!fwnode_property_read_string(child, "default-state",
172 						 &state)) {
173 			if (!strcmp(state, "keep"))
174 				led.default_state = LEDS_GPIO_DEFSTATE_KEEP;
175 			else if (!strcmp(state, "on"))
176 				led.default_state = LEDS_GPIO_DEFSTATE_ON;
177 			else
178 				led.default_state = LEDS_GPIO_DEFSTATE_OFF;
179 		}
180 
181 		if (fwnode_property_present(child, "retain-state-suspended"))
182 			led.retain_state_suspended = 1;
183 		if (fwnode_property_present(child, "retain-state-shutdown"))
184 			led.retain_state_shutdown = 1;
185 		if (fwnode_property_present(child, "panic-indicator"))
186 			led.panic_indicator = 1;
187 
188 		ret = create_gpio_led(&led, led_dat, dev, np, NULL);
189 		if (ret < 0) {
190 			fwnode_handle_put(child);
191 			return ERR_PTR(ret);
192 		}
193 		led_dat->cdev.dev->of_node = np;
194 		priv->num_leds++;
195 	}
196 
197 	return priv;
198 }
199 
200 static const struct of_device_id of_gpio_leds_match[] = {
201 	{ .compatible = "gpio-leds", },
202 	{},
203 };
204 
205 MODULE_DEVICE_TABLE(of, of_gpio_leds_match);
206 
207 static struct gpio_desc *gpio_led_get_gpiod(struct device *dev, int idx,
208 					    const struct gpio_led *template)
209 {
210 	struct gpio_desc *gpiod;
211 	unsigned long flags = GPIOF_OUT_INIT_LOW;
212 	int ret;
213 
214 	/*
215 	 * This means the LED does not come from the device tree
216 	 * or ACPI, so let's try just getting it by index from the
217 	 * device, this will hit the board file, if any and get
218 	 * the GPIO from there.
219 	 */
220 	gpiod = devm_gpiod_get_index(dev, NULL, idx, flags);
221 	if (!IS_ERR(gpiod)) {
222 		gpiod_set_consumer_name(gpiod, template->name);
223 		return gpiod;
224 	}
225 	if (PTR_ERR(gpiod) != -ENOENT)
226 		return gpiod;
227 
228 	/*
229 	 * This is the legacy code path for platform code that
230 	 * still uses GPIO numbers. Ultimately we would like to get
231 	 * rid of this block completely.
232 	 */
233 
234 	/* skip leds that aren't available */
235 	if (!gpio_is_valid(template->gpio))
236 		return ERR_PTR(-ENOENT);
237 
238 	if (template->active_low)
239 		flags |= GPIOF_ACTIVE_LOW;
240 
241 	ret = devm_gpio_request_one(dev, template->gpio, flags,
242 				    template->name);
243 	if (ret < 0)
244 		return ERR_PTR(ret);
245 
246 	gpiod = gpio_to_desc(template->gpio);
247 	if (!gpiod)
248 		return ERR_PTR(-EINVAL);
249 
250 	return gpiod;
251 }
252 
253 static int gpio_led_probe(struct platform_device *pdev)
254 {
255 	struct gpio_led_platform_data *pdata = dev_get_platdata(&pdev->dev);
256 	struct gpio_leds_priv *priv;
257 	int i, ret = 0;
258 
259 	if (pdata && pdata->num_leds) {
260 		priv = devm_kzalloc(&pdev->dev,
261 				sizeof_gpio_leds_priv(pdata->num_leds),
262 					GFP_KERNEL);
263 		if (!priv)
264 			return -ENOMEM;
265 
266 		priv->num_leds = pdata->num_leds;
267 		for (i = 0; i < priv->num_leds; i++) {
268 			const struct gpio_led *template = &pdata->leds[i];
269 			struct gpio_led_data *led_dat = &priv->leds[i];
270 
271 			if (template->gpiod)
272 				led_dat->gpiod = template->gpiod;
273 			else
274 				led_dat->gpiod =
275 					gpio_led_get_gpiod(&pdev->dev,
276 							   i, template);
277 			if (IS_ERR(led_dat->gpiod)) {
278 				dev_info(&pdev->dev, "Skipping unavailable LED gpio %d (%s)\n",
279 					 template->gpio, template->name);
280 				continue;
281 			}
282 
283 			ret = create_gpio_led(template, led_dat,
284 					      &pdev->dev, NULL,
285 					      pdata->gpio_blink_set);
286 			if (ret < 0)
287 				return ret;
288 		}
289 	} else {
290 		priv = gpio_leds_create(pdev);
291 		if (IS_ERR(priv))
292 			return PTR_ERR(priv);
293 	}
294 
295 	platform_set_drvdata(pdev, priv);
296 
297 	return 0;
298 }
299 
300 static void gpio_led_shutdown(struct platform_device *pdev)
301 {
302 	struct gpio_leds_priv *priv = platform_get_drvdata(pdev);
303 	int i;
304 
305 	for (i = 0; i < priv->num_leds; i++) {
306 		struct gpio_led_data *led = &priv->leds[i];
307 
308 		if (!(led->cdev.flags & LED_RETAIN_AT_SHUTDOWN))
309 			gpio_led_set(&led->cdev, LED_OFF);
310 	}
311 }
312 
313 static struct platform_driver gpio_led_driver = {
314 	.probe		= gpio_led_probe,
315 	.shutdown	= gpio_led_shutdown,
316 	.driver		= {
317 		.name	= "leds-gpio",
318 		.of_match_table = of_gpio_leds_match,
319 	},
320 };
321 
322 module_platform_driver(gpio_led_driver);
323 
324 MODULE_AUTHOR("Raphael Assenat <raph@8d.com>, Trent Piepho <tpiepho@freescale.com>");
325 MODULE_DESCRIPTION("GPIO LED driver");
326 MODULE_LICENSE("GPL");
327 MODULE_ALIAS("platform:leds-gpio");
328