1 // SPDX-License-Identifier: GPL-2.0-only
5 * The TCA6507 is a programmable LED controller that can drive 7
6 * separate lines either by holding them low, or by pulsing them
7 * with modulated width.
8 * The modulation can be varied in a simple pattern to produce a
9 * blink or double-blink.
11 * This driver can configure each line either as a 'GPIO' which is
12 * out-only (pull-up resistor required) or as an LED with variable
13 * brightness and hardware-assisted blinking.
15 * Apart from OFF and ON there are three programmable brightness
16 * levels which can be programmed from 0 to 15 and indicate how many
17 * 500usec intervals in each 8msec that the led is 'on'. The levels
18 * are named MASTER, BANK0 and BANK1.
20 * There are two different blink rates that can be programmed, each
21 * with separate time for rise, on, fall, off and second-off. Thus if
22 * 3 or more different non-trivial rates are required, software must
23 * be used for the extra rates. The two different blink rates must
24 * align with the two levels BANK0 and BANK1. This driver does not
25 * support double-blink so 'second-off' always matches 'off'.
27 * Only 16 different times can be programmed in a roughly logarithmic
28 * scale from 64ms to 16320ms. To be precise the possible times are:
29 * 0, 64, 128, 192, 256, 384, 512, 768,
30 * 1024, 1536, 2048, 3072, 4096, 5760, 8128, 16320
32 * Times that cannot be closely matched with these must be handled in
33 * software. This driver allows 12.5% error in matching.
35 * This driver does not allow rise/fall rates to be set explicitly.
36 * When trying to match a given 'on' or 'off' period, an appropriate
37 * pair of 'change' and 'hold' times are chosen to get a close match.
38 * If the target delay is even, the 'change' number will be the
39 * smaller; if odd, the 'hold' number will be the smaller.
41 * Choosing pairs of delays with 12.5% errors allows us to match
42 * delays in the ranges: 56-72, 112-144, 168-216, 224-27504,
44 * 26% of the achievable sums can be matched by multiple pairings.
45 * For example 1536 == 1536+0, 1024+512, or 768+768.
46 * This driver will always choose the pairing with the least
47 * maximum - 768+768 in this case. Other pairings are not available.
49 * Access to the 3 levels and 2 blinks are on a first-come,
50 * first-served basis. Access can be shared by multiple leds if they
51 * have the same level and either same blink rates, or some don't
52 * blink. When a led changes, it relinquishes access and tries again,
53 * so it might lose access to hardware blink.
55 * If a blink engine cannot be allocated, software blink is used. If
56 * the desired brightness cannot be allocated, the closest available
57 * non-zero brightness is used. As 'full' is always available, the
58 * worst case would be to have two different blink rates at '1', with
59 * Max at '2', then other leds will have to choose between '2' and
60 * '16'. Hopefully this is not likely.
62 * Each bank (BANK0 and BANK1) has two usage counts - LEDs using the
63 * brightness and LEDs using the blink. It can only be reprogrammed
64 * when the appropriate counter is zero. The MASTER level has a
67 * Each LED has programmable 'on' and 'off' time as milliseconds.
68 * With each there is a flag saying if it was explicitly requested or
69 * defaulted. Similarly the banks know if each time was explicit or a
70 * default. Defaults are permitted to be changed freely - they are
71 * not recognised when matching.
74 #include <linux/module.h>
75 #include <linux/slab.h>
76 #include <linux/leds.h>
77 #include <linux/err.h>
78 #include <linux/i2c.h>
79 #include <linux/gpio/driver.h>
80 #include <linux/property.h>
81 #include <linux/workqueue.h>
83 /* LED select registers determine the source that drives LED outputs */
84 #define TCA6507_LS_LED_OFF 0x0 /* Output HI-Z (off) */
85 #define TCA6507_LS_LED_OFF1 0x1 /* Output HI-Z (off) - not used */
86 #define TCA6507_LS_LED_PWM0 0x2 /* Output LOW with Bank0 rate */
87 #define TCA6507_LS_LED_PWM1 0x3 /* Output LOW with Bank1 rate */
88 #define TCA6507_LS_LED_ON 0x4 /* Output LOW (on) */
89 #define TCA6507_LS_LED_MIR 0x5 /* Output LOW with Master Intensity */
90 #define TCA6507_LS_BLINK0 0x6 /* Blink at Bank0 rate */
91 #define TCA6507_LS_BLINK1 0x7 /* Blink at Bank1 rate */
93 struct tca6507_platform_data {
94 struct led_platform_data leds;
100 #define TCA6507_MAKE_GPIO 1
107 static int bank_source[3] = {
112 static int blink_source[2] = {
118 #define TCA6507_REG_CNT 11
121 * 0x00, 0x01, 0x02 encode the TCA6507_LS_* values, each output
122 * owns one bit in each register
124 #define TCA6507_FADE_ON 0x03
125 #define TCA6507_FULL_ON 0x04
126 #define TCA6507_FADE_OFF 0x05
127 #define TCA6507_FIRST_OFF 0x06
128 #define TCA6507_SECOND_OFF 0x07
129 #define TCA6507_MAX_INTENSITY 0x08
130 #define TCA6507_MASTER_INTENSITY 0x09
131 #define TCA6507_INITIALIZE 0x0A
133 #define INIT_CODE 0x8
136 static int time_codes[TIMECODES] = {
137 0, 64, 128, 192, 256, 384, 512, 768,
138 1024, 1536, 2048, 3072, 4096, 5760, 8128, 16320
141 /* Convert an led.brightness level (0..255) to a TCA6507 level (0..15) */
142 static inline int TO_LEVEL(int brightness)
144 return brightness >> 4;
147 /* ...and convert back */
148 static inline int TO_BRIGHT(int level)
151 return (level << 4) | 0xf;
156 struct tca6507_chip {
157 int reg_set; /* One bit per register where
158 * a '1' means the register
159 * should be written */
160 u8 reg_file[TCA6507_REG_CNT];
161 /* Bank 2 is Master Intensity and doesn't use times */
165 int on_dflt, off_dflt;
166 int time_use, level_use;
168 struct i2c_client *client;
169 struct work_struct work;
173 struct tca6507_chip *chip;
174 struct led_classdev led_cdev;
177 int on_dflt, off_dflt;
178 int bank; /* Bank used, or -1 */
179 int blink; /* Set if hardware-blinking */
181 #ifdef CONFIG_GPIOLIB
182 struct gpio_chip gpio;
183 int gpio_map[NUM_LEDS];
187 static const struct i2c_device_id tca6507_id[] = {
191 MODULE_DEVICE_TABLE(i2c, tca6507_id);
193 static int choose_times(int msec, int *c1p, int *c2p)
196 * Choose two timecodes which add to 'msec' as near as
197 * possible. The first returned is the 'on' or 'off' time.
198 * The second is to be used as a 'fade-on' or 'fade-off' time.
199 * If 'msec' is even, the first will not be smaller than the
200 * second. If 'msec' is odd, the first will not be larger
202 * If we cannot get a sum within 1/8 of 'msec' fail with
203 * -EINVAL, otherwise return the sum that was achieved, plus 1
204 * if the first is smaller.
205 * If two possibilities are equally good (e.g. 512+0,
206 * 256+256), choose the first pair so there is more
207 * change-time visible (i.e. it is softer).
210 int tmax = msec * 9 / 8;
211 int tmin = msec * 7 / 8;
214 /* We start at '1' to ensure we never even think of choosing a
217 for (c1 = 1; c1 < TIMECODES; c1++) {
218 int t = time_codes[c1];
223 for (c2 = 0; c2 <= c1; c2++) {
224 int tt = t + time_codes[c2];
247 actual = time_codes[*c1p] + time_codes[*c2p];
258 * Update the register file with the appropriate 3-bit state for the
261 static void set_select(struct tca6507_chip *tca, int led, int val)
263 int mask = (1 << led);
266 for (bit = 0; bit < 3; bit++) {
267 int n = tca->reg_file[bit] & ~mask;
268 if (val & (1 << bit))
270 if (tca->reg_file[bit] != n) {
271 tca->reg_file[bit] = n;
272 tca->reg_set |= (1 << bit);
277 /* Update the register file with the appropriate 4-bit code for one
278 * bank or other. This can be used for timers, for levels, or for
281 static void set_code(struct tca6507_chip *tca, int reg, int bank, int new)
289 n = tca->reg_file[reg] & ~mask;
291 if (tca->reg_file[reg] != n) {
292 tca->reg_file[reg] = n;
293 tca->reg_set |= 1 << reg;
297 /* Update brightness level. */
298 static void set_level(struct tca6507_chip *tca, int bank, int level)
303 set_code(tca, TCA6507_MAX_INTENSITY, bank, level);
306 set_code(tca, TCA6507_MASTER_INTENSITY, 0, level);
309 tca->bank[bank].level = level;
312 /* Record all relevant time codes for a given bank */
313 static void set_times(struct tca6507_chip *tca, int bank)
318 result = choose_times(tca->bank[bank].ontime, &c1, &c2);
321 dev_dbg(&tca->client->dev,
322 "Chose on times %d(%d) %d(%d) for %dms\n",
324 c2, time_codes[c2], tca->bank[bank].ontime);
325 set_code(tca, TCA6507_FADE_ON, bank, c2);
326 set_code(tca, TCA6507_FULL_ON, bank, c1);
327 tca->bank[bank].ontime = result;
329 result = choose_times(tca->bank[bank].offtime, &c1, &c2);
330 dev_dbg(&tca->client->dev,
331 "Chose off times %d(%d) %d(%d) for %dms\n",
333 c2, time_codes[c2], tca->bank[bank].offtime);
334 set_code(tca, TCA6507_FADE_OFF, bank, c2);
335 set_code(tca, TCA6507_FIRST_OFF, bank, c1);
336 set_code(tca, TCA6507_SECOND_OFF, bank, c1);
337 tca->bank[bank].offtime = result;
339 set_code(tca, TCA6507_INITIALIZE, bank, INIT_CODE);
342 /* Write all needed register of tca6507 */
344 static void tca6507_work(struct work_struct *work)
346 struct tca6507_chip *tca = container_of(work, struct tca6507_chip,
348 struct i2c_client *cl = tca->client;
350 u8 file[TCA6507_REG_CNT];
353 spin_lock_irq(&tca->lock);
355 memcpy(file, tca->reg_file, TCA6507_REG_CNT);
357 spin_unlock_irq(&tca->lock);
359 for (r = 0; r < TCA6507_REG_CNT; r++)
361 i2c_smbus_write_byte_data(cl, r, file[r]);
364 static void led_release(struct tca6507_led *led)
366 /* If led owns any resource, release it. */
367 struct tca6507_chip *tca = led->chip;
368 if (led->bank >= 0) {
369 struct bank *b = tca->bank + led->bank;
378 static int led_prepare(struct tca6507_led *led)
380 /* Assign this led to a bank, configuring that bank if
382 int level = TO_LEVEL(led->led_cdev.brightness);
383 struct tca6507_chip *tca = led->chip;
389 led->led_cdev.brightness = TO_BRIGHT(level);
391 set_select(tca, led->num, TCA6507_LS_LED_OFF);
395 if (led->ontime == 0 || led->offtime == 0) {
397 * Just set the brightness, choosing first usable
398 * bank. If none perfect, choose best. Count
399 * backwards so we check MASTER bank first to avoid
402 int best = -1;/* full-on */
406 set_select(tca, led->num, TCA6507_LS_LED_ON);
410 for (i = MASTER; i >= BANK0; i--) {
412 if (tca->bank[i].level == level ||
413 tca->bank[i].level_use == 0) {
417 d = abs(level - tca->bank[i].level);
424 /* Best brightness is full-on */
425 set_select(tca, led->num, TCA6507_LS_LED_ON);
426 led->led_cdev.brightness = LED_FULL;
430 if (!tca->bank[best].level_use)
431 set_level(tca, best, level);
433 tca->bank[best].level_use++;
435 set_select(tca, led->num, bank_source[best]);
436 led->led_cdev.brightness = TO_BRIGHT(tca->bank[best].level);
441 * We have on/off time so we need to try to allocate a timing
442 * bank. First check if times are compatible with hardware
443 * and give up if not.
445 if (choose_times(led->ontime, &c1, &c2) < 0)
447 if (choose_times(led->offtime, &c1, &c2) < 0)
450 for (i = BANK0; i <= BANK1; i++) {
451 if (tca->bank[i].level_use == 0)
452 /* not in use - it is ours! */
454 if (tca->bank[i].level != level)
455 /* Incompatible level - skip */
456 /* FIX: if timer matches we maybe should consider
461 if (tca->bank[i].time_use == 0)
462 /* Timer not in use, and level matches - use it */
465 if (!(tca->bank[i].on_dflt ||
467 tca->bank[i].ontime == led->ontime))
468 /* on time is incompatible */
471 if (!(tca->bank[i].off_dflt ||
473 tca->bank[i].offtime == led->offtime))
474 /* off time is incompatible */
477 /* looks like a suitable match */
482 /* Nothing matches - how sad */
486 if (b->level_use == 0)
487 set_level(tca, i, level);
494 b->ontime = led->ontime;
495 b->on_dflt = led->on_dflt;
502 b->offtime = led->offtime;
503 b->off_dflt = led->off_dflt;
510 led->ontime = b->ontime;
511 led->offtime = b->offtime;
515 led->led_cdev.brightness = TO_BRIGHT(b->level);
516 set_select(tca, led->num, blink_source[i]);
520 static int led_assign(struct tca6507_led *led)
522 struct tca6507_chip *tca = led->chip;
526 spin_lock_irqsave(&tca->lock, flags);
528 err = led_prepare(led);
531 * Can only fail on timer setup. In that case we need
532 * to re-establish as steady level.
538 spin_unlock_irqrestore(&tca->lock, flags);
541 schedule_work(&tca->work);
545 static void tca6507_brightness_set(struct led_classdev *led_cdev,
546 enum led_brightness brightness)
548 struct tca6507_led *led = container_of(led_cdev, struct tca6507_led,
550 led->led_cdev.brightness = brightness;
556 static int tca6507_blink_set(struct led_classdev *led_cdev,
557 unsigned long *delay_on,
558 unsigned long *delay_off)
560 struct tca6507_led *led = container_of(led_cdev, struct tca6507_led,
565 else if (delay_on != &led_cdev->blink_delay_on)
567 led->ontime = *delay_on;
571 else if (delay_off != &led_cdev->blink_delay_off)
573 led->offtime = *delay_off;
575 if (led->ontime == 0)
577 if (led->offtime == 0)
580 if (led->led_cdev.brightness == LED_OFF)
581 led->led_cdev.brightness = LED_FULL;
582 if (led_assign(led) < 0) {
585 led->led_cdev.brightness = LED_OFF;
588 *delay_on = led->ontime;
589 *delay_off = led->offtime;
593 #ifdef CONFIG_GPIOLIB
594 static void tca6507_gpio_set_value(struct gpio_chip *gc,
595 unsigned offset, int val)
597 struct tca6507_chip *tca = gpiochip_get_data(gc);
600 spin_lock_irqsave(&tca->lock, flags);
602 * 'OFF' is floating high, and 'ON' is pulled down, so it has
603 * the inverse sense of 'val'.
605 set_select(tca, tca->gpio_map[offset],
606 val ? TCA6507_LS_LED_OFF : TCA6507_LS_LED_ON);
607 spin_unlock_irqrestore(&tca->lock, flags);
609 schedule_work(&tca->work);
612 static int tca6507_gpio_direction_output(struct gpio_chip *gc,
613 unsigned offset, int val)
615 tca6507_gpio_set_value(gc, offset, val);
619 static int tca6507_probe_gpios(struct device *dev,
620 struct tca6507_chip *tca,
621 struct tca6507_platform_data *pdata)
627 for (i = 0; i < NUM_LEDS; i++)
628 if (pdata->leds.leds[i].name && pdata->leds.leds[i].flags) {
629 /* Configure as a gpio */
630 tca->gpio_map[gpios] = i;
637 tca->gpio.label = "gpio-tca6507";
638 tca->gpio.ngpio = gpios;
639 tca->gpio.base = pdata->gpio_base;
640 tca->gpio.owner = THIS_MODULE;
641 tca->gpio.direction_output = tca6507_gpio_direction_output;
642 tca->gpio.set = tca6507_gpio_set_value;
643 tca->gpio.parent = dev;
644 err = gpiochip_add_data(&tca->gpio, tca);
652 static void tca6507_remove_gpio(struct tca6507_chip *tca)
655 gpiochip_remove(&tca->gpio);
657 #else /* CONFIG_GPIOLIB */
658 static int tca6507_probe_gpios(struct device *dev,
659 struct tca6507_chip *tca,
660 struct tca6507_platform_data *pdata)
664 static void tca6507_remove_gpio(struct tca6507_chip *tca)
667 #endif /* CONFIG_GPIOLIB */
669 static struct tca6507_platform_data *
670 tca6507_led_dt_init(struct device *dev)
672 struct tca6507_platform_data *pdata;
673 struct fwnode_handle *child;
674 struct led_info *tca_leds;
677 count = device_get_child_node_count(dev);
678 if (!count || count > NUM_LEDS)
679 return ERR_PTR(-ENODEV);
681 tca_leds = devm_kcalloc(dev, NUM_LEDS, sizeof(struct led_info),
684 return ERR_PTR(-ENOMEM);
686 device_for_each_child_node(dev, child) {
691 if (fwnode_property_read_string(child, "label", &led.name))
692 led.name = fwnode_get_name(child);
694 if (fwnode_property_read_string(child, "linux,default-trigger",
695 &led.default_trigger))
696 led.default_trigger = NULL;
699 if (fwnode_device_is_compatible(child, "gpio"))
700 led.flags |= TCA6507_MAKE_GPIO;
702 ret = fwnode_property_read_u32(child, "reg", ®);
703 if (ret || reg >= NUM_LEDS) {
704 fwnode_handle_put(child);
705 return ERR_PTR(ret ? : -EINVAL);
711 pdata = devm_kzalloc(dev, sizeof(struct tca6507_platform_data),
714 return ERR_PTR(-ENOMEM);
716 pdata->leds.leds = tca_leds;
717 pdata->leds.num_leds = NUM_LEDS;
718 #ifdef CONFIG_GPIOLIB
719 pdata->gpio_base = -1;
725 static const struct of_device_id __maybe_unused of_tca6507_leds_match[] = {
726 { .compatible = "ti,tca6507", },
729 MODULE_DEVICE_TABLE(of, of_tca6507_leds_match);
731 static int tca6507_probe(struct i2c_client *client)
733 struct device *dev = &client->dev;
734 struct i2c_adapter *adapter;
735 struct tca6507_chip *tca;
736 struct tca6507_platform_data *pdata;
740 adapter = client->adapter;
742 if (!i2c_check_functionality(adapter, I2C_FUNC_I2C))
745 pdata = tca6507_led_dt_init(dev);
747 dev_err(dev, "Need %d entries in platform-data list\n", NUM_LEDS);
748 return PTR_ERR(pdata);
750 tca = devm_kzalloc(dev, sizeof(*tca), GFP_KERNEL);
754 tca->client = client;
755 INIT_WORK(&tca->work, tca6507_work);
756 spin_lock_init(&tca->lock);
757 i2c_set_clientdata(client, tca);
759 for (i = 0; i < NUM_LEDS; i++) {
760 struct tca6507_led *l = tca->leds + i;
764 if (pdata->leds.leds[i].name && !pdata->leds.leds[i].flags) {
765 l->led_cdev.name = pdata->leds.leds[i].name;
766 l->led_cdev.default_trigger
767 = pdata->leds.leds[i].default_trigger;
768 l->led_cdev.brightness_set = tca6507_brightness_set;
769 l->led_cdev.blink_set = tca6507_blink_set;
771 err = led_classdev_register(dev, &l->led_cdev);
776 err = tca6507_probe_gpios(dev, tca, pdata);
779 /* set all registers to known state - zero */
781 schedule_work(&tca->work);
786 if (tca->leds[i].led_cdev.name)
787 led_classdev_unregister(&tca->leds[i].led_cdev);
792 static void tca6507_remove(struct i2c_client *client)
795 struct tca6507_chip *tca = i2c_get_clientdata(client);
796 struct tca6507_led *tca_leds = tca->leds;
798 for (i = 0; i < NUM_LEDS; i++) {
799 if (tca_leds[i].led_cdev.name)
800 led_classdev_unregister(&tca_leds[i].led_cdev);
802 tca6507_remove_gpio(tca);
803 cancel_work_sync(&tca->work);
806 static struct i2c_driver tca6507_driver = {
808 .name = "leds-tca6507",
809 .of_match_table = of_match_ptr(of_tca6507_leds_match),
811 .probe = tca6507_probe,
812 .remove = tca6507_remove,
813 .id_table = tca6507_id,
816 module_i2c_driver(tca6507_driver);
818 MODULE_AUTHOR("NeilBrown <neilb@suse.de>");
819 MODULE_DESCRIPTION("TCA6507 LED/GPO driver");
820 MODULE_LICENSE("GPL v2");