xref: /openbmc/linux/drivers/leds/leds-netxbig.c (revision 99a013c8)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3  * leds-netxbig.c - Driver for the 2Big and 5Big Network series LEDs
4  *
5  * Copyright (C) 2010 LaCie
6  *
7  * Author: Simon Guinot <sguinot@lacie.com>
8  */
9 
10 #include <linux/module.h>
11 #include <linux/irq.h>
12 #include <linux/slab.h>
13 #include <linux/spinlock.h>
14 #include <linux/platform_device.h>
15 #include <linux/gpio/consumer.h>
16 #include <linux/leds.h>
17 #include <linux/of.h>
18 #include <linux/of_platform.h>
19 
20 struct netxbig_gpio_ext {
21 	struct gpio_desc **addr;
22 	int		num_addr;
23 	struct gpio_desc **data;
24 	int		num_data;
25 	struct gpio_desc *enable;
26 };
27 
28 enum netxbig_led_mode {
29 	NETXBIG_LED_OFF,
30 	NETXBIG_LED_ON,
31 	NETXBIG_LED_SATA,
32 	NETXBIG_LED_TIMER1,
33 	NETXBIG_LED_TIMER2,
34 	NETXBIG_LED_MODE_NUM,
35 };
36 
37 #define NETXBIG_LED_INVALID_MODE NETXBIG_LED_MODE_NUM
38 
39 struct netxbig_led_timer {
40 	unsigned long		delay_on;
41 	unsigned long		delay_off;
42 	enum netxbig_led_mode	mode;
43 };
44 
45 struct netxbig_led {
46 	const char	*name;
47 	const char	*default_trigger;
48 	int		mode_addr;
49 	int		*mode_val;
50 	int		bright_addr;
51 	int		bright_max;
52 };
53 
54 struct netxbig_led_platform_data {
55 	struct netxbig_gpio_ext	*gpio_ext;
56 	struct netxbig_led_timer *timer;
57 	int			num_timer;
58 	struct netxbig_led	*leds;
59 	int			num_leds;
60 };
61 
62 /*
63  * GPIO extension bus.
64  */
65 
66 static DEFINE_SPINLOCK(gpio_ext_lock);
67 
68 static void gpio_ext_set_addr(struct netxbig_gpio_ext *gpio_ext, int addr)
69 {
70 	int pin;
71 
72 	for (pin = 0; pin < gpio_ext->num_addr; pin++)
73 		gpiod_set_value(gpio_ext->addr[pin], (addr >> pin) & 1);
74 }
75 
76 static void gpio_ext_set_data(struct netxbig_gpio_ext *gpio_ext, int data)
77 {
78 	int pin;
79 
80 	for (pin = 0; pin < gpio_ext->num_data; pin++)
81 		gpiod_set_value(gpio_ext->data[pin], (data >> pin) & 1);
82 }
83 
84 static void gpio_ext_enable_select(struct netxbig_gpio_ext *gpio_ext)
85 {
86 	/* Enable select is done on the raising edge. */
87 	gpiod_set_value(gpio_ext->enable, 0);
88 	gpiod_set_value(gpio_ext->enable, 1);
89 }
90 
91 static void gpio_ext_set_value(struct netxbig_gpio_ext *gpio_ext,
92 			       int addr, int value)
93 {
94 	unsigned long flags;
95 
96 	spin_lock_irqsave(&gpio_ext_lock, flags);
97 	gpio_ext_set_addr(gpio_ext, addr);
98 	gpio_ext_set_data(gpio_ext, value);
99 	gpio_ext_enable_select(gpio_ext);
100 	spin_unlock_irqrestore(&gpio_ext_lock, flags);
101 }
102 
103 /*
104  * Class LED driver.
105  */
106 
107 struct netxbig_led_data {
108 	struct netxbig_gpio_ext	*gpio_ext;
109 	struct led_classdev	cdev;
110 	int			mode_addr;
111 	int			*mode_val;
112 	int			bright_addr;
113 	struct			netxbig_led_timer *timer;
114 	int			num_timer;
115 	enum netxbig_led_mode	mode;
116 	int			sata;
117 	spinlock_t		lock;
118 };
119 
120 static int netxbig_led_get_timer_mode(enum netxbig_led_mode *mode,
121 				      unsigned long delay_on,
122 				      unsigned long delay_off,
123 				      struct netxbig_led_timer *timer,
124 				      int num_timer)
125 {
126 	int i;
127 
128 	for (i = 0; i < num_timer; i++) {
129 		if (timer[i].delay_on == delay_on &&
130 		    timer[i].delay_off == delay_off) {
131 			*mode = timer[i].mode;
132 			return 0;
133 		}
134 	}
135 	return -EINVAL;
136 }
137 
138 static int netxbig_led_blink_set(struct led_classdev *led_cdev,
139 				 unsigned long *delay_on,
140 				 unsigned long *delay_off)
141 {
142 	struct netxbig_led_data *led_dat =
143 		container_of(led_cdev, struct netxbig_led_data, cdev);
144 	enum netxbig_led_mode mode;
145 	int mode_val;
146 	int ret;
147 
148 	/* Look for a LED mode with the requested timer frequency. */
149 	ret = netxbig_led_get_timer_mode(&mode, *delay_on, *delay_off,
150 					 led_dat->timer, led_dat->num_timer);
151 	if (ret < 0)
152 		return ret;
153 
154 	mode_val = led_dat->mode_val[mode];
155 	if (mode_val == NETXBIG_LED_INVALID_MODE)
156 		return -EINVAL;
157 
158 	spin_lock_irq(&led_dat->lock);
159 
160 	gpio_ext_set_value(led_dat->gpio_ext, led_dat->mode_addr, mode_val);
161 	led_dat->mode = mode;
162 
163 	spin_unlock_irq(&led_dat->lock);
164 
165 	return 0;
166 }
167 
168 static void netxbig_led_set(struct led_classdev *led_cdev,
169 			    enum led_brightness value)
170 {
171 	struct netxbig_led_data *led_dat =
172 		container_of(led_cdev, struct netxbig_led_data, cdev);
173 	enum netxbig_led_mode mode;
174 	int mode_val;
175 	int set_brightness = 1;
176 	unsigned long flags;
177 
178 	spin_lock_irqsave(&led_dat->lock, flags);
179 
180 	if (value == LED_OFF) {
181 		mode = NETXBIG_LED_OFF;
182 		set_brightness = 0;
183 	} else {
184 		if (led_dat->sata)
185 			mode = NETXBIG_LED_SATA;
186 		else if (led_dat->mode == NETXBIG_LED_OFF)
187 			mode = NETXBIG_LED_ON;
188 		else /* Keep 'timer' mode. */
189 			mode = led_dat->mode;
190 	}
191 	mode_val = led_dat->mode_val[mode];
192 
193 	gpio_ext_set_value(led_dat->gpio_ext, led_dat->mode_addr, mode_val);
194 	led_dat->mode = mode;
195 	/*
196 	 * Note that the brightness register is shared between all the
197 	 * SATA LEDs. So, change the brightness setting for a single
198 	 * SATA LED will affect all the others.
199 	 */
200 	if (set_brightness)
201 		gpio_ext_set_value(led_dat->gpio_ext,
202 				   led_dat->bright_addr, value);
203 
204 	spin_unlock_irqrestore(&led_dat->lock, flags);
205 }
206 
207 static ssize_t netxbig_led_sata_store(struct device *dev,
208 				      struct device_attribute *attr,
209 				      const char *buff, size_t count)
210 {
211 	struct led_classdev *led_cdev = dev_get_drvdata(dev);
212 	struct netxbig_led_data *led_dat =
213 		container_of(led_cdev, struct netxbig_led_data, cdev);
214 	unsigned long enable;
215 	enum netxbig_led_mode mode;
216 	int mode_val;
217 	int ret;
218 
219 	ret = kstrtoul(buff, 10, &enable);
220 	if (ret < 0)
221 		return ret;
222 
223 	enable = !!enable;
224 
225 	spin_lock_irq(&led_dat->lock);
226 
227 	if (led_dat->sata == enable) {
228 		ret = count;
229 		goto exit_unlock;
230 	}
231 
232 	if (led_dat->mode != NETXBIG_LED_ON &&
233 	    led_dat->mode != NETXBIG_LED_SATA)
234 		mode = led_dat->mode; /* Keep modes 'off' and 'timer'. */
235 	else if (enable)
236 		mode = NETXBIG_LED_SATA;
237 	else
238 		mode = NETXBIG_LED_ON;
239 
240 	mode_val = led_dat->mode_val[mode];
241 	if (mode_val == NETXBIG_LED_INVALID_MODE) {
242 		ret = -EINVAL;
243 		goto exit_unlock;
244 	}
245 
246 	gpio_ext_set_value(led_dat->gpio_ext, led_dat->mode_addr, mode_val);
247 	led_dat->mode = mode;
248 	led_dat->sata = enable;
249 
250 	ret = count;
251 
252 exit_unlock:
253 	spin_unlock_irq(&led_dat->lock);
254 
255 	return ret;
256 }
257 
258 static ssize_t netxbig_led_sata_show(struct device *dev,
259 				     struct device_attribute *attr, char *buf)
260 {
261 	struct led_classdev *led_cdev = dev_get_drvdata(dev);
262 	struct netxbig_led_data *led_dat =
263 		container_of(led_cdev, struct netxbig_led_data, cdev);
264 
265 	return sprintf(buf, "%d\n", led_dat->sata);
266 }
267 
268 static DEVICE_ATTR(sata, 0644, netxbig_led_sata_show, netxbig_led_sata_store);
269 
270 static struct attribute *netxbig_led_attrs[] = {
271 	&dev_attr_sata.attr,
272 	NULL
273 };
274 ATTRIBUTE_GROUPS(netxbig_led);
275 
276 static int create_netxbig_led(struct platform_device *pdev,
277 			      struct netxbig_led_platform_data *pdata,
278 			      struct netxbig_led_data *led_dat,
279 			      const struct netxbig_led *template)
280 {
281 	spin_lock_init(&led_dat->lock);
282 	led_dat->gpio_ext = pdata->gpio_ext;
283 	led_dat->cdev.name = template->name;
284 	led_dat->cdev.default_trigger = template->default_trigger;
285 	led_dat->cdev.blink_set = netxbig_led_blink_set;
286 	led_dat->cdev.brightness_set = netxbig_led_set;
287 	/*
288 	 * Because the GPIO extension bus don't allow to read registers
289 	 * value, there is no way to probe the LED initial state.
290 	 * So, the initial sysfs LED value for the "brightness" and "sata"
291 	 * attributes are inconsistent.
292 	 *
293 	 * Note that the initial LED state can't be reconfigured.
294 	 * The reason is that the LED behaviour must stay uniform during
295 	 * the whole boot process (bootloader+linux).
296 	 */
297 	led_dat->sata = 0;
298 	led_dat->cdev.brightness = LED_OFF;
299 	led_dat->cdev.max_brightness = template->bright_max;
300 	led_dat->cdev.flags |= LED_CORE_SUSPENDRESUME;
301 	led_dat->mode_addr = template->mode_addr;
302 	led_dat->mode_val = template->mode_val;
303 	led_dat->bright_addr = template->bright_addr;
304 	led_dat->timer = pdata->timer;
305 	led_dat->num_timer = pdata->num_timer;
306 	/*
307 	 * If available, expose the SATA activity blink capability through
308 	 * a "sata" sysfs attribute.
309 	 */
310 	if (led_dat->mode_val[NETXBIG_LED_SATA] != NETXBIG_LED_INVALID_MODE)
311 		led_dat->cdev.groups = netxbig_led_groups;
312 
313 	return devm_led_classdev_register(&pdev->dev, &led_dat->cdev);
314 }
315 
316 /**
317  * netxbig_gpio_ext_remove() - Clean up GPIO extension data
318  * @data: managed resource data to clean up
319  *
320  * Since we pick GPIO descriptors from another device than the device our
321  * driver is probing to, we need to register a specific callback to free
322  * these up using managed resources.
323  */
324 static void netxbig_gpio_ext_remove(void *data)
325 {
326 	struct netxbig_gpio_ext *gpio_ext = data;
327 	int i;
328 
329 	for (i = 0; i < gpio_ext->num_addr; i++)
330 		gpiod_put(gpio_ext->addr[i]);
331 	for (i = 0; i < gpio_ext->num_data; i++)
332 		gpiod_put(gpio_ext->data[i]);
333 	gpiod_put(gpio_ext->enable);
334 }
335 
336 /**
337  * netxbig_gpio_ext_get() - Obtain GPIO extension device data
338  * @dev: main LED device
339  * @gpio_ext_dev: the GPIO extension device
340  * @gpio_ext: the data structure holding the GPIO extension data
341  *
342  * This function walks the subdevice that only contain GPIO line
343  * handles in the device tree and obtains the GPIO descriptors from that
344  * device.
345  */
346 static int netxbig_gpio_ext_get(struct device *dev,
347 				struct device *gpio_ext_dev,
348 				struct netxbig_gpio_ext *gpio_ext)
349 {
350 	struct gpio_desc **addr, **data;
351 	int num_addr, num_data;
352 	struct gpio_desc *gpiod;
353 	int ret;
354 	int i;
355 
356 	ret = gpiod_count(gpio_ext_dev, "addr");
357 	if (ret < 0) {
358 		dev_err(dev,
359 			"Failed to count GPIOs in DT property addr-gpios\n");
360 		return ret;
361 	}
362 	num_addr = ret;
363 	addr = devm_kcalloc(dev, num_addr, sizeof(*addr), GFP_KERNEL);
364 	if (!addr)
365 		return -ENOMEM;
366 
367 	/*
368 	 * We cannot use devm_ managed resources with these GPIO descriptors
369 	 * since they are associated with the "GPIO extension device" which
370 	 * does not probe any driver. The device tree parser will however
371 	 * populate a platform device for it so we can anyway obtain the
372 	 * GPIO descriptors from the device.
373 	 */
374 	for (i = 0; i < num_addr; i++) {
375 		gpiod = gpiod_get_index(gpio_ext_dev, "addr", i,
376 					GPIOD_OUT_LOW);
377 		if (IS_ERR(gpiod))
378 			return PTR_ERR(gpiod);
379 		gpiod_set_consumer_name(gpiod, "GPIO extension addr");
380 		addr[i] = gpiod;
381 	}
382 	gpio_ext->addr = addr;
383 	gpio_ext->num_addr = num_addr;
384 
385 	ret = gpiod_count(gpio_ext_dev, "data");
386 	if (ret < 0) {
387 		dev_err(dev,
388 			"Failed to count GPIOs in DT property data-gpios\n");
389 		return ret;
390 	}
391 	num_data = ret;
392 	data = devm_kcalloc(dev, num_data, sizeof(*data), GFP_KERNEL);
393 	if (!data)
394 		return -ENOMEM;
395 
396 	for (i = 0; i < num_data; i++) {
397 		gpiod = gpiod_get_index(gpio_ext_dev, "data", i,
398 					GPIOD_OUT_LOW);
399 		if (IS_ERR(gpiod))
400 			return PTR_ERR(gpiod);
401 		gpiod_set_consumer_name(gpiod, "GPIO extension data");
402 		data[i] = gpiod;
403 	}
404 	gpio_ext->data = data;
405 	gpio_ext->num_data = num_data;
406 
407 	gpiod = gpiod_get(gpio_ext_dev, "enable", GPIOD_OUT_LOW);
408 	if (IS_ERR(gpiod)) {
409 		dev_err(dev,
410 			"Failed to get GPIO from DT property enable-gpio\n");
411 		return PTR_ERR(gpiod);
412 	}
413 	gpiod_set_consumer_name(gpiod, "GPIO extension enable");
414 	gpio_ext->enable = gpiod;
415 
416 	return devm_add_action_or_reset(dev, netxbig_gpio_ext_remove, gpio_ext);
417 }
418 
419 static int netxbig_leds_get_of_pdata(struct device *dev,
420 				     struct netxbig_led_platform_data *pdata)
421 {
422 	struct device_node *np = dev_of_node(dev);
423 	struct device_node *gpio_ext_np;
424 	struct platform_device *gpio_ext_pdev;
425 	struct device *gpio_ext_dev;
426 	struct device_node *child;
427 	struct netxbig_gpio_ext *gpio_ext;
428 	struct netxbig_led_timer *timers;
429 	struct netxbig_led *leds, *led;
430 	int num_timers;
431 	int num_leds = 0;
432 	int ret;
433 	int i;
434 
435 	/* GPIO extension */
436 	gpio_ext_np = of_parse_phandle(np, "gpio-ext", 0);
437 	if (!gpio_ext_np) {
438 		dev_err(dev, "Failed to get DT handle gpio-ext\n");
439 		return -EINVAL;
440 	}
441 	gpio_ext_pdev = of_find_device_by_node(gpio_ext_np);
442 	if (!gpio_ext_pdev) {
443 		dev_err(dev, "Failed to find platform device for gpio-ext\n");
444 		return -ENODEV;
445 	}
446 	gpio_ext_dev = &gpio_ext_pdev->dev;
447 
448 	gpio_ext = devm_kzalloc(dev, sizeof(*gpio_ext), GFP_KERNEL);
449 	if (!gpio_ext) {
450 		of_node_put(gpio_ext_np);
451 		return -ENOMEM;
452 	}
453 	ret = netxbig_gpio_ext_get(dev, gpio_ext_dev, gpio_ext);
454 	of_node_put(gpio_ext_np);
455 	if (ret)
456 		return ret;
457 	pdata->gpio_ext = gpio_ext;
458 
459 	/* Timers (optional) */
460 	ret = of_property_count_u32_elems(np, "timers");
461 	if (ret > 0) {
462 		if (ret % 3)
463 			return -EINVAL;
464 		num_timers = ret / 3;
465 		timers = devm_kcalloc(dev, num_timers, sizeof(*timers),
466 				      GFP_KERNEL);
467 		if (!timers)
468 			return -ENOMEM;
469 		for (i = 0; i < num_timers; i++) {
470 			u32 tmp;
471 
472 			of_property_read_u32_index(np, "timers", 3 * i,
473 						   &timers[i].mode);
474 			if (timers[i].mode >= NETXBIG_LED_MODE_NUM)
475 				return -EINVAL;
476 			of_property_read_u32_index(np, "timers",
477 						   3 * i + 1, &tmp);
478 			timers[i].delay_on = tmp;
479 			of_property_read_u32_index(np, "timers",
480 						   3 * i + 2, &tmp);
481 			timers[i].delay_off = tmp;
482 		}
483 		pdata->timer = timers;
484 		pdata->num_timer = num_timers;
485 	}
486 
487 	/* LEDs */
488 	num_leds = of_get_available_child_count(np);
489 	if (!num_leds) {
490 		dev_err(dev, "No LED subnodes found in DT\n");
491 		return -ENODEV;
492 	}
493 
494 	leds = devm_kcalloc(dev, num_leds, sizeof(*leds), GFP_KERNEL);
495 	if (!leds)
496 		return -ENOMEM;
497 
498 	led = leds;
499 	for_each_available_child_of_node(np, child) {
500 		const char *string;
501 		int *mode_val;
502 		int num_modes;
503 
504 		ret = of_property_read_u32(child, "mode-addr",
505 					   &led->mode_addr);
506 		if (ret)
507 			goto err_node_put;
508 
509 		ret = of_property_read_u32(child, "bright-addr",
510 					   &led->bright_addr);
511 		if (ret)
512 			goto err_node_put;
513 
514 		ret = of_property_read_u32(child, "max-brightness",
515 					   &led->bright_max);
516 		if (ret)
517 			goto err_node_put;
518 
519 		mode_val =
520 			devm_kcalloc(dev,
521 				     NETXBIG_LED_MODE_NUM, sizeof(*mode_val),
522 				     GFP_KERNEL);
523 		if (!mode_val) {
524 			ret = -ENOMEM;
525 			goto err_node_put;
526 		}
527 
528 		for (i = 0; i < NETXBIG_LED_MODE_NUM; i++)
529 			mode_val[i] = NETXBIG_LED_INVALID_MODE;
530 
531 		ret = of_property_count_u32_elems(child, "mode-val");
532 		if (ret < 0 || ret % 2) {
533 			ret = -EINVAL;
534 			goto err_node_put;
535 		}
536 		num_modes = ret / 2;
537 		if (num_modes > NETXBIG_LED_MODE_NUM) {
538 			ret = -EINVAL;
539 			goto err_node_put;
540 		}
541 
542 		for (i = 0; i < num_modes; i++) {
543 			int mode;
544 			int val;
545 
546 			of_property_read_u32_index(child,
547 						   "mode-val", 2 * i, &mode);
548 			of_property_read_u32_index(child,
549 						   "mode-val", 2 * i + 1, &val);
550 			if (mode >= NETXBIG_LED_MODE_NUM) {
551 				ret = -EINVAL;
552 				goto err_node_put;
553 			}
554 			mode_val[mode] = val;
555 		}
556 		led->mode_val = mode_val;
557 
558 		if (!of_property_read_string(child, "label", &string))
559 			led->name = string;
560 		else
561 			led->name = child->name;
562 
563 		if (!of_property_read_string(child,
564 					     "linux,default-trigger", &string))
565 			led->default_trigger = string;
566 
567 		led++;
568 	}
569 
570 	pdata->leds = leds;
571 	pdata->num_leds = num_leds;
572 
573 	return 0;
574 
575 err_node_put:
576 	of_node_put(child);
577 	return ret;
578 }
579 
580 static const struct of_device_id of_netxbig_leds_match[] = {
581 	{ .compatible = "lacie,netxbig-leds", },
582 	{},
583 };
584 MODULE_DEVICE_TABLE(of, of_netxbig_leds_match);
585 
586 static int netxbig_led_probe(struct platform_device *pdev)
587 {
588 	struct netxbig_led_platform_data *pdata;
589 	struct netxbig_led_data *leds_data;
590 	int i;
591 	int ret;
592 
593 	pdata = devm_kzalloc(&pdev->dev, sizeof(*pdata), GFP_KERNEL);
594 	if (!pdata)
595 		return -ENOMEM;
596 	ret = netxbig_leds_get_of_pdata(&pdev->dev, pdata);
597 	if (ret)
598 		return ret;
599 
600 	leds_data = devm_kcalloc(&pdev->dev,
601 				 pdata->num_leds, sizeof(*leds_data),
602 				 GFP_KERNEL);
603 	if (!leds_data)
604 		return -ENOMEM;
605 
606 	for (i = 0; i < pdata->num_leds; i++) {
607 		ret = create_netxbig_led(pdev, pdata,
608 					 &leds_data[i], &pdata->leds[i]);
609 		if (ret < 0)
610 			return ret;
611 	}
612 
613 	return 0;
614 }
615 
616 static struct platform_driver netxbig_led_driver = {
617 	.probe		= netxbig_led_probe,
618 	.driver		= {
619 		.name		= "leds-netxbig",
620 		.of_match_table	= of_netxbig_leds_match,
621 	},
622 };
623 
624 module_platform_driver(netxbig_led_driver);
625 
626 MODULE_AUTHOR("Simon Guinot <sguinot@lacie.com>");
627 MODULE_DESCRIPTION("LED driver for LaCie xBig Network boards");
628 MODULE_LICENSE("GPL");
629 MODULE_ALIAS("platform:leds-netxbig");
630