leds.h 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152
  1. /*
  2. * Driver model for leds and led triggers
  3. *
  4. * Copyright (C) 2005 John Lenz <lenz@cs.wisc.edu>
  5. * Copyright (C) 2005 Richard Purdie <rpurdie@openedhand.com>
  6. *
  7. * This program is free software; you can redistribute it and/or modify
  8. * it under the terms of the GNU General Public License version 2 as
  9. * published by the Free Software Foundation.
  10. *
  11. */
  12. #ifndef __LINUX_LEDS_H_INCLUDED
  13. #define __LINUX_LEDS_H_INCLUDED
  14. #include <linux/list.h>
  15. #include <linux/spinlock.h>
  16. #include <linux/rwsem.h>
  17. struct device;
  18. /*
  19. * LED Core
  20. */
  21. enum led_brightness {
  22. LED_OFF = 0,
  23. LED_HALF = 127,
  24. LED_FULL = 255,
  25. };
  26. struct led_classdev {
  27. const char *name;
  28. int brightness;
  29. int flags;
  30. #define LED_SUSPENDED (1 << 0)
  31. /* Set LED brightness level */
  32. /* Must not sleep, use a workqueue if needed */
  33. void (*brightness_set)(struct led_classdev *led_cdev,
  34. enum led_brightness brightness);
  35. /* Get LED brightness level */
  36. enum led_brightness (*brightness_get)(struct led_classdev *led_cdev);
  37. /* Activate hardware accelerated blink */
  38. int (*blink_set)(struct led_classdev *led_cdev,
  39. unsigned long *delay_on,
  40. unsigned long *delay_off);
  41. struct device *dev;
  42. struct list_head node; /* LED Device list */
  43. const char *default_trigger; /* Trigger to use */
  44. #ifdef CONFIG_LEDS_TRIGGERS
  45. /* Protects the trigger data below */
  46. struct rw_semaphore trigger_lock;
  47. struct led_trigger *trigger;
  48. struct list_head trig_list;
  49. void *trigger_data;
  50. #endif
  51. };
  52. extern int led_classdev_register(struct device *parent,
  53. struct led_classdev *led_cdev);
  54. extern void led_classdev_unregister(struct led_classdev *lcd);
  55. extern void led_classdev_suspend(struct led_classdev *led_cdev);
  56. extern void led_classdev_resume(struct led_classdev *led_cdev);
  57. /*
  58. * LED Triggers
  59. */
  60. #ifdef CONFIG_LEDS_TRIGGERS
  61. #define TRIG_NAME_MAX 50
  62. struct led_trigger {
  63. /* Trigger Properties */
  64. const char *name;
  65. void (*activate)(struct led_classdev *led_cdev);
  66. void (*deactivate)(struct led_classdev *led_cdev);
  67. /* LEDs under control by this trigger (for simple triggers) */
  68. rwlock_t leddev_list_lock;
  69. struct list_head led_cdevs;
  70. /* Link to next registered trigger */
  71. struct list_head next_trig;
  72. };
  73. /* Registration functions for complex triggers */
  74. extern int led_trigger_register(struct led_trigger *trigger);
  75. extern void led_trigger_unregister(struct led_trigger *trigger);
  76. /* Registration functions for simple triggers */
  77. #define DEFINE_LED_TRIGGER(x) static struct led_trigger *x;
  78. #define DEFINE_LED_TRIGGER_GLOBAL(x) struct led_trigger *x;
  79. extern void led_trigger_register_simple(const char *name,
  80. struct led_trigger **trigger);
  81. extern void led_trigger_unregister_simple(struct led_trigger *trigger);
  82. extern void led_trigger_event(struct led_trigger *trigger,
  83. enum led_brightness event);
  84. #else
  85. /* Triggers aren't active - null macros */
  86. #define DEFINE_LED_TRIGGER(x)
  87. #define DEFINE_LED_TRIGGER_GLOBAL(x)
  88. #define led_trigger_register_simple(x, y) do {} while(0)
  89. #define led_trigger_unregister_simple(x) do {} while(0)
  90. #define led_trigger_event(x, y) do {} while(0)
  91. #endif
  92. /* Trigger specific functions */
  93. #ifdef CONFIG_LEDS_TRIGGER_IDE_DISK
  94. extern void ledtrig_ide_activity(void);
  95. #else
  96. #define ledtrig_ide_activity() do {} while(0)
  97. #endif
  98. /*
  99. * Generic LED platform data for describing LED names and default triggers.
  100. */
  101. struct led_info {
  102. const char *name;
  103. char *default_trigger;
  104. int flags;
  105. };
  106. struct led_platform_data {
  107. int num_leds;
  108. struct led_info *leds;
  109. };
  110. /* For the leds-gpio driver */
  111. struct gpio_led {
  112. const char *name;
  113. char *default_trigger;
  114. unsigned gpio;
  115. u8 active_low;
  116. };
  117. struct gpio_led_platform_data {
  118. int num_leds;
  119. struct gpio_led *leds;
  120. int (*gpio_blink_set)(unsigned gpio,
  121. unsigned long *delay_on,
  122. unsigned long *delay_off);
  123. };
  124. #endif /* __LINUX_LEDS_H_INCLUDED */