1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * LED state routines for driver control interface
7 #include <linux/slab.h>
8 #include <linux/module.h>
9 #include <linux/leds.h>
10 #include <sound/core.h>
11 #include <sound/control.h>
14 MODULE_DESCRIPTION("ALSA control interface to LED trigger code.");
15 MODULE_LICENSE("GPL");
17 #define MAX_LED (((SNDRV_CTL_ELEM_ACCESS_MIC_LED - SNDRV_CTL_ELEM_ACCESS_SPK_LED) \
18 >> SNDRV_CTL_ELEM_ACCESS_LED_SHIFT) + 1)
20 #define to_led_card_dev(_dev) \
21 container_of(_dev, struct snd_ctl_led_card, dev)
23 enum snd_ctl_led_mode {
30 struct snd_ctl_led_card {
33 struct snd_ctl_led *led;
38 struct list_head controls;
41 enum led_audio trigger_type;
42 enum snd_ctl_led_mode mode;
43 struct snd_ctl_led_card *cards[SNDRV_CARDS];
46 struct snd_ctl_led_ctl {
47 struct list_head list;
48 struct snd_card *card;
50 struct snd_kcontrol *kctl;
51 unsigned int index_offset;
54 static DEFINE_MUTEX(snd_ctl_led_mutex);
55 static bool snd_ctl_led_card_valid[SNDRV_CARDS];
56 static struct snd_ctl_led snd_ctl_leds[MAX_LED] = {
59 .group = (SNDRV_CTL_ELEM_ACCESS_SPK_LED >> SNDRV_CTL_ELEM_ACCESS_LED_SHIFT) - 1,
60 .trigger_type = LED_AUDIO_MUTE,
61 .mode = MODE_FOLLOW_MUTE,
65 .group = (SNDRV_CTL_ELEM_ACCESS_MIC_LED >> SNDRV_CTL_ELEM_ACCESS_LED_SHIFT) - 1,
66 .trigger_type = LED_AUDIO_MICMUTE,
67 .mode = MODE_FOLLOW_MUTE,
71 static void snd_ctl_led_sysfs_add(struct snd_card *card);
72 static void snd_ctl_led_sysfs_remove(struct snd_card *card);
74 #define UPDATE_ROUTE(route, cb) \
78 route = route < 0 ? route2 : (route | route2); \
81 static inline unsigned int access_to_group(unsigned int access)
83 return ((access & SNDRV_CTL_ELEM_ACCESS_LED_MASK) >>
84 SNDRV_CTL_ELEM_ACCESS_LED_SHIFT) - 1;
87 static inline unsigned int group_to_access(unsigned int group)
89 return (group + 1) << SNDRV_CTL_ELEM_ACCESS_LED_SHIFT;
92 static struct snd_ctl_led *snd_ctl_led_get_by_access(unsigned int access)
94 unsigned int group = access_to_group(access);
97 return &snd_ctl_leds[group];
101 * A note for callers:
102 * The two static variables info and value are protected using snd_ctl_led_mutex.
104 static int snd_ctl_led_get(struct snd_ctl_led_ctl *lctl)
106 static struct snd_ctl_elem_info info;
107 static struct snd_ctl_elem_value value;
108 struct snd_kcontrol *kctl = lctl->kctl;
112 memset(&info, 0, sizeof(info));
114 info.id.index += lctl->index_offset;
115 info.id.numid += lctl->index_offset;
116 result = kctl->info(kctl, &info);
119 memset(&value, 0, sizeof(value));
121 result = kctl->get(kctl, &value);
124 if (info.type == SNDRV_CTL_ELEM_TYPE_BOOLEAN ||
125 info.type == SNDRV_CTL_ELEM_TYPE_INTEGER) {
126 for (i = 0; i < info.count; i++)
127 if (value.value.integer.value[i] != info.value.integer.min)
129 } else if (info.type == SNDRV_CTL_ELEM_TYPE_INTEGER64) {
130 for (i = 0; i < info.count; i++)
131 if (value.value.integer64.value[i] != info.value.integer64.min)
137 static void snd_ctl_led_set_state(struct snd_card *card, unsigned int access,
138 struct snd_kcontrol *kctl, unsigned int ioff)
140 struct snd_ctl_led *led;
141 struct snd_ctl_led_ctl *lctl;
145 led = snd_ctl_led_get_by_access(access);
150 scoped_guard(mutex, &snd_ctl_led_mutex) {
151 /* the card may not be registered (active) at this point */
152 if (card && !snd_ctl_led_card_valid[card->number])
154 list_for_each_entry(lctl, &led->controls, list) {
155 if (lctl->kctl == kctl && lctl->index_offset == ioff)
157 UPDATE_ROUTE(route, snd_ctl_led_get(lctl));
159 if (!found && kctl && card) {
160 lctl = kzalloc(sizeof(*lctl), GFP_KERNEL);
163 lctl->access = access;
165 lctl->index_offset = ioff;
166 list_add(&lctl->list, &led->controls);
167 UPDATE_ROUTE(route, snd_ctl_led_get(lctl));
172 case MODE_OFF: route = 1; break;
173 case MODE_ON: route = 0; break;
174 case MODE_FOLLOW_ROUTE: if (route >= 0) route ^= 1; break;
175 case MODE_FOLLOW_MUTE: /* noop */ break;
178 ledtrig_audio_set(led->trigger_type, route ? LED_OFF : LED_ON);
181 static struct snd_ctl_led_ctl *snd_ctl_led_find(struct snd_kcontrol *kctl, unsigned int ioff)
183 struct list_head *controls;
184 struct snd_ctl_led_ctl *lctl;
187 for (group = 0; group < MAX_LED; group++) {
188 controls = &snd_ctl_leds[group].controls;
189 list_for_each_entry(lctl, controls, list)
190 if (lctl->kctl == kctl && lctl->index_offset == ioff)
196 static unsigned int snd_ctl_led_remove(struct snd_kcontrol *kctl, unsigned int ioff,
199 struct snd_ctl_led_ctl *lctl;
200 unsigned int ret = 0;
202 guard(mutex)(&snd_ctl_led_mutex);
203 lctl = snd_ctl_led_find(kctl, ioff);
204 if (lctl && (access == 0 || access != lctl->access)) {
206 list_del(&lctl->list);
212 static void snd_ctl_led_notify(struct snd_card *card, unsigned int mask,
213 struct snd_kcontrol *kctl, unsigned int ioff)
215 struct snd_kcontrol_volatile *vd;
216 unsigned int access, access2;
218 if (mask == SNDRV_CTL_EVENT_MASK_REMOVE) {
219 access = snd_ctl_led_remove(kctl, ioff, 0);
221 snd_ctl_led_set_state(card, access, NULL, 0);
222 } else if (mask & SNDRV_CTL_EVENT_MASK_INFO) {
223 vd = &kctl->vd[ioff];
224 access = vd->access & SNDRV_CTL_ELEM_ACCESS_LED_MASK;
225 access2 = snd_ctl_led_remove(kctl, ioff, access);
227 snd_ctl_led_set_state(card, access2, NULL, 0);
229 snd_ctl_led_set_state(card, access, kctl, ioff);
230 } else if ((mask & (SNDRV_CTL_EVENT_MASK_ADD |
231 SNDRV_CTL_EVENT_MASK_VALUE)) != 0) {
232 vd = &kctl->vd[ioff];
233 access = vd->access & SNDRV_CTL_ELEM_ACCESS_LED_MASK;
235 snd_ctl_led_set_state(card, access, kctl, ioff);
239 DEFINE_FREE(snd_card_unref, struct snd_card *, if (_T) snd_card_unref(_T))
241 static int snd_ctl_led_set_id(int card_number, struct snd_ctl_elem_id *id,
242 unsigned int group, bool set)
244 struct snd_card *card __free(snd_card_unref) = NULL;
245 struct snd_kcontrol *kctl;
246 struct snd_kcontrol_volatile *vd;
247 unsigned int ioff, access, new_access;
249 card = snd_card_ref(card_number);
252 guard(rwsem_write)(&card->controls_rwsem);
253 kctl = snd_ctl_find_id_locked(card, id);
256 ioff = snd_ctl_get_ioff(kctl, id);
257 vd = &kctl->vd[ioff];
258 access = vd->access & SNDRV_CTL_ELEM_ACCESS_LED_MASK;
259 if (access != 0 && access != group_to_access(group))
261 new_access = vd->access & ~SNDRV_CTL_ELEM_ACCESS_LED_MASK;
263 new_access |= group_to_access(group);
264 if (new_access != vd->access) {
265 vd->access = new_access;
266 snd_ctl_led_notify(card, SNDRV_CTL_EVENT_MASK_INFO, kctl, ioff);
271 static void snd_ctl_led_refresh(void)
275 for (group = 0; group < MAX_LED; group++)
276 snd_ctl_led_set_state(NULL, group_to_access(group), NULL, 0);
279 static void snd_ctl_led_ctl_destroy(struct snd_ctl_led_ctl *lctl)
281 list_del(&lctl->list);
285 static void snd_ctl_led_clean(struct snd_card *card)
288 struct snd_ctl_led_ctl *lctl, *_lctl;
289 struct snd_ctl_led *led;
291 for (group = 0; group < MAX_LED; group++) {
292 led = &snd_ctl_leds[group];
293 list_for_each_entry_safe(lctl, _lctl, &led->controls, list)
294 if (!card || lctl->card == card)
295 snd_ctl_led_ctl_destroy(lctl);
299 static int snd_ctl_led_reset(int card_number, unsigned int group)
301 struct snd_card *card __free(snd_card_unref) = NULL;
302 struct snd_ctl_led_ctl *lctl, *_lctl;
303 struct snd_ctl_led *led;
304 struct snd_kcontrol_volatile *vd;
307 card = snd_card_ref(card_number);
311 scoped_guard(mutex, &snd_ctl_led_mutex) {
312 if (!snd_ctl_led_card_valid[card_number])
314 led = &snd_ctl_leds[group];
315 list_for_each_entry_safe(lctl, _lctl, &led->controls, list)
316 if (lctl->card == card) {
317 vd = &lctl->kctl->vd[lctl->index_offset];
318 vd->access &= ~group_to_access(group);
319 snd_ctl_led_ctl_destroy(lctl);
324 snd_ctl_led_set_state(NULL, group_to_access(group), NULL, 0);
328 static void snd_ctl_led_register(struct snd_card *card)
330 struct snd_kcontrol *kctl;
333 if (snd_BUG_ON(card->number < 0 ||
334 card->number >= ARRAY_SIZE(snd_ctl_led_card_valid)))
336 scoped_guard(mutex, &snd_ctl_led_mutex)
337 snd_ctl_led_card_valid[card->number] = true;
338 /* the register callback is already called with held card->controls_rwsem */
339 list_for_each_entry(kctl, &card->controls, list)
340 for (ioff = 0; ioff < kctl->count; ioff++)
341 snd_ctl_led_notify(card, SNDRV_CTL_EVENT_MASK_VALUE, kctl, ioff);
342 snd_ctl_led_refresh();
343 snd_ctl_led_sysfs_add(card);
346 static void snd_ctl_led_disconnect(struct snd_card *card)
348 snd_ctl_led_sysfs_remove(card);
349 scoped_guard(mutex, &snd_ctl_led_mutex) {
350 snd_ctl_led_card_valid[card->number] = false;
351 snd_ctl_led_clean(card);
353 snd_ctl_led_refresh();
356 static void snd_ctl_led_card_release(struct device *dev)
358 struct snd_ctl_led_card *led_card = to_led_card_dev(dev);
363 static void snd_ctl_led_release(struct device *dev)
367 static void snd_ctl_led_dev_release(struct device *dev)
375 static ssize_t mode_show(struct device *dev,
376 struct device_attribute *attr, char *buf)
378 struct snd_ctl_led *led = container_of(dev, struct snd_ctl_led, dev);
379 const char *str = NULL;
382 case MODE_FOLLOW_MUTE: str = "follow-mute"; break;
383 case MODE_FOLLOW_ROUTE: str = "follow-route"; break;
384 case MODE_ON: str = "on"; break;
385 case MODE_OFF: str = "off"; break;
387 return sysfs_emit(buf, "%s\n", str);
390 static ssize_t mode_store(struct device *dev,
391 struct device_attribute *attr,
392 const char *buf, size_t count)
394 struct snd_ctl_led *led = container_of(dev, struct snd_ctl_led, dev);
396 size_t l = min(count, sizeof(_buf) - 1);
397 enum snd_ctl_led_mode mode;
399 memcpy(_buf, buf, l);
401 if (strstr(_buf, "mute"))
402 mode = MODE_FOLLOW_MUTE;
403 else if (strstr(_buf, "route"))
404 mode = MODE_FOLLOW_ROUTE;
405 else if (strncmp(_buf, "off", 3) == 0 || strncmp(_buf, "0", 1) == 0)
407 else if (strncmp(_buf, "on", 2) == 0 || strncmp(_buf, "1", 1) == 0)
412 scoped_guard(mutex, &snd_ctl_led_mutex)
415 snd_ctl_led_set_state(NULL, group_to_access(led->group), NULL, 0);
419 static ssize_t brightness_show(struct device *dev,
420 struct device_attribute *attr, char *buf)
422 struct snd_ctl_led *led = container_of(dev, struct snd_ctl_led, dev);
424 return sysfs_emit(buf, "%u\n", ledtrig_audio_get(led->trigger_type));
427 static DEVICE_ATTR_RW(mode);
428 static DEVICE_ATTR_RO(brightness);
430 static struct attribute *snd_ctl_led_dev_attrs[] = {
432 &dev_attr_brightness.attr,
436 static const struct attribute_group snd_ctl_led_dev_attr_group = {
437 .attrs = snd_ctl_led_dev_attrs,
440 static const struct attribute_group *snd_ctl_led_dev_attr_groups[] = {
441 &snd_ctl_led_dev_attr_group,
445 static char *find_eos(char *s)
447 while (*s && *s != ',')
454 static char *parse_uint(char *s, unsigned int *val)
456 unsigned long long res;
457 if (kstrtoull(s, 10, &res))
463 static char *parse_string(char *s, char *val, size_t val_size)
465 if (*s == '"' || *s == '\'') {
468 while (*s && *s != c) {
476 while (*s && *s != ',') {
490 static char *parse_iface(char *s, snd_ctl_elem_iface_t *val)
492 if (!strncasecmp(s, "card", 4))
493 *val = SNDRV_CTL_ELEM_IFACE_CARD;
494 else if (!strncasecmp(s, "mixer", 5))
495 *val = SNDRV_CTL_ELEM_IFACE_MIXER;
500 * These types of input strings are accepted:
502 * unsigned integer - numid (equivaled to numid=UINT)
503 * string - basic mixer name (equivalent to iface=MIXER,name=STR)
505 * [iface=MIXER,][device=UINT,][subdevice=UINT,]name=STR[,index=UINT]
507 static ssize_t set_led_id(struct snd_ctl_led_card *led_card, const char *buf, size_t count,
510 char buf2[256], *s, *os;
511 struct snd_ctl_elem_id id;
514 if (strscpy(buf2, buf, sizeof(buf2)) < 0)
516 memset(&id, 0, sizeof(id));
517 id.iface = SNDRV_CTL_ELEM_IFACE_MIXER;
521 if (!strncasecmp(s, "numid=", 6)) {
522 s = parse_uint(s + 6, &id.numid);
523 } else if (!strncasecmp(s, "iface=", 6)) {
524 s = parse_iface(s + 6, &id.iface);
525 } else if (!strncasecmp(s, "device=", 7)) {
526 s = parse_uint(s + 7, &id.device);
527 } else if (!strncasecmp(s, "subdevice=", 10)) {
528 s = parse_uint(s + 10, &id.subdevice);
529 } else if (!strncasecmp(s, "name=", 5)) {
530 s = parse_string(s + 5, id.name, sizeof(id.name));
531 } else if (!strncasecmp(s, "index=", 6)) {
532 s = parse_uint(s + 6, &id.index);
533 } else if (s == buf2) {
535 if (*s < '0' || *s > '9')
540 parse_uint(buf2, &id.numid);
542 for (; *s >= ' '; s++);
544 strscpy(id.name, buf2, sizeof(id.name));
554 err = snd_ctl_led_set_id(led_card->number, &id, led_card->led->group, attach);
561 static ssize_t attach_store(struct device *dev,
562 struct device_attribute *attr,
563 const char *buf, size_t count)
565 struct snd_ctl_led_card *led_card = container_of(dev, struct snd_ctl_led_card, dev);
566 return set_led_id(led_card, buf, count, true);
569 static ssize_t detach_store(struct device *dev,
570 struct device_attribute *attr,
571 const char *buf, size_t count)
573 struct snd_ctl_led_card *led_card = container_of(dev, struct snd_ctl_led_card, dev);
574 return set_led_id(led_card, buf, count, false);
577 static ssize_t reset_store(struct device *dev,
578 struct device_attribute *attr,
579 const char *buf, size_t count)
581 struct snd_ctl_led_card *led_card = container_of(dev, struct snd_ctl_led_card, dev);
584 if (count > 0 && buf[0] == '1') {
585 err = snd_ctl_led_reset(led_card->number, led_card->led->group);
592 static ssize_t list_show(struct device *dev,
593 struct device_attribute *attr, char *buf)
595 struct snd_ctl_led_card *led_card = container_of(dev, struct snd_ctl_led_card, dev);
596 struct snd_card *card __free(snd_card_unref) = NULL;
597 struct snd_ctl_led_ctl *lctl;
600 card = snd_card_ref(led_card->number);
603 guard(rwsem_read)(&card->controls_rwsem);
604 guard(mutex)(&snd_ctl_led_mutex);
605 if (snd_ctl_led_card_valid[led_card->number]) {
606 list_for_each_entry(lctl, &led_card->led->controls, list) {
607 if (lctl->card != card)
610 l += sysfs_emit_at(buf, l, " ");
611 l += sysfs_emit_at(buf, l, "%u",
612 lctl->kctl->id.numid + lctl->index_offset);
618 static DEVICE_ATTR_WO(attach);
619 static DEVICE_ATTR_WO(detach);
620 static DEVICE_ATTR_WO(reset);
621 static DEVICE_ATTR_RO(list);
623 static struct attribute *snd_ctl_led_card_attrs[] = {
624 &dev_attr_attach.attr,
625 &dev_attr_detach.attr,
626 &dev_attr_reset.attr,
631 static const struct attribute_group snd_ctl_led_card_attr_group = {
632 .attrs = snd_ctl_led_card_attrs,
635 static const struct attribute_group *snd_ctl_led_card_attr_groups[] = {
636 &snd_ctl_led_card_attr_group,
640 static struct device snd_ctl_led_dev;
642 static void snd_ctl_led_sysfs_add(struct snd_card *card)
645 struct snd_ctl_led_card *led_card;
646 struct snd_ctl_led *led;
649 for (group = 0; group < MAX_LED; group++) {
650 led = &snd_ctl_leds[group];
651 led_card = kzalloc(sizeof(*led_card), GFP_KERNEL);
654 led_card->number = card->number;
656 device_initialize(&led_card->dev);
657 led_card->dev.release = snd_ctl_led_card_release;
658 if (dev_set_name(&led_card->dev, "card%d", card->number) < 0)
660 led_card->dev.parent = &led->dev;
661 led_card->dev.groups = snd_ctl_led_card_attr_groups;
662 if (device_add(&led_card->dev))
664 led->cards[card->number] = led_card;
665 snprintf(link_name, sizeof(link_name), "led-%s", led->name);
666 WARN(sysfs_create_link(&card->ctl_dev->kobj, &led_card->dev.kobj, link_name),
667 "can't create symlink to controlC%i device\n", card->number);
668 WARN(sysfs_create_link(&led_card->dev.kobj, &card->card_dev.kobj, "card"),
669 "can't create symlink to card%i\n", card->number);
673 put_device(&led_card->dev);
675 printk(KERN_ERR "snd_ctl_led: unable to add card%d", card->number);
679 static void snd_ctl_led_sysfs_remove(struct snd_card *card)
682 struct snd_ctl_led_card *led_card;
683 struct snd_ctl_led *led;
686 for (group = 0; group < MAX_LED; group++) {
687 led = &snd_ctl_leds[group];
688 led_card = led->cards[card->number];
691 snprintf(link_name, sizeof(link_name), "led-%s", led->name);
692 sysfs_remove_link(&card->ctl_dev->kobj, link_name);
693 sysfs_remove_link(&led_card->dev.kobj, "card");
694 device_unregister(&led_card->dev);
695 led->cards[card->number] = NULL;
700 * Control layer registration
702 static struct snd_ctl_layer_ops snd_ctl_led_lops = {
703 .module_name = SND_CTL_LAYER_MODULE_LED,
704 .lregister = snd_ctl_led_register,
705 .ldisconnect = snd_ctl_led_disconnect,
706 .lnotify = snd_ctl_led_notify,
709 static int __init snd_ctl_led_init(void)
711 struct snd_ctl_led *led;
714 device_initialize(&snd_ctl_led_dev);
715 snd_ctl_led_dev.class = &sound_class;
716 snd_ctl_led_dev.release = snd_ctl_led_dev_release;
717 dev_set_name(&snd_ctl_led_dev, "ctl-led");
718 if (device_add(&snd_ctl_led_dev)) {
719 put_device(&snd_ctl_led_dev);
722 for (group = 0; group < MAX_LED; group++) {
723 led = &snd_ctl_leds[group];
724 INIT_LIST_HEAD(&led->controls);
725 device_initialize(&led->dev);
726 led->dev.parent = &snd_ctl_led_dev;
727 led->dev.release = snd_ctl_led_release;
728 led->dev.groups = snd_ctl_led_dev_attr_groups;
729 dev_set_name(&led->dev, led->name);
730 if (device_add(&led->dev)) {
731 put_device(&led->dev);
732 for (; group > 0; group--) {
733 led = &snd_ctl_leds[group - 1];
734 device_unregister(&led->dev);
736 device_unregister(&snd_ctl_led_dev);
740 snd_ctl_register_layer(&snd_ctl_led_lops);
744 static void __exit snd_ctl_led_exit(void)
746 struct snd_ctl_led *led;
747 struct snd_card *card;
748 unsigned int group, card_number;
750 snd_ctl_disconnect_layer(&snd_ctl_led_lops);
751 for (card_number = 0; card_number < SNDRV_CARDS; card_number++) {
752 if (!snd_ctl_led_card_valid[card_number])
754 card = snd_card_ref(card_number);
756 snd_ctl_led_sysfs_remove(card);
757 snd_card_unref(card);
760 for (group = 0; group < MAX_LED; group++) {
761 led = &snd_ctl_leds[group];
762 device_unregister(&led->dev);
764 device_unregister(&snd_ctl_led_dev);
765 snd_ctl_led_clean(NULL);
768 module_init(snd_ctl_led_init)
769 module_exit(snd_ctl_led_exit)