1
2
3
4
5
6
7
8
9
10
11
12#ifndef __LINUX_LEDS_H_INCLUDED
13#define __LINUX_LEDS_H_INCLUDED
14
15#include <linux/device.h>
16#include <linux/kernfs.h>
17#include <linux/list.h>
18#include <linux/mutex.h>
19#include <linux/rwsem.h>
20#include <linux/spinlock.h>
21#include <linux/timer.h>
22#include <linux/workqueue.h>
23
24struct device;
25
26
27
28
29enum led_brightness {
30 LED_OFF = 0,
31 LED_ON = 1,
32 LED_HALF = 127,
33 LED_FULL = 255,
34};
35
36struct led_classdev {
37 const char *name;
38 enum led_brightness brightness;
39 enum led_brightness max_brightness;
40 int flags;
41
42
43#define LED_SUSPENDED (1 << 0)
44#define LED_UNREGISTERING (1 << 1)
45
46#define LED_CORE_SUSPENDRESUME (1 << 16)
47#define LED_SYSFS_DISABLE (1 << 17)
48#define LED_DEV_CAP_FLASH (1 << 18)
49#define LED_HW_PLUGGABLE (1 << 19)
50#define LED_PANIC_INDICATOR (1 << 20)
51#define LED_BRIGHT_HW_CHANGED (1 << 21)
52
53
54 unsigned long work_flags;
55
56#define LED_BLINK_SW 0
57#define LED_BLINK_ONESHOT 1
58#define LED_BLINK_ONESHOT_STOP 2
59#define LED_BLINK_INVERT 3
60#define LED_BLINK_BRIGHTNESS_CHANGE 4
61#define LED_BLINK_DISABLE 5
62
63
64
65
66
67 void (*brightness_set)(struct led_classdev *led_cdev,
68 enum led_brightness brightness);
69
70
71
72
73 int (*brightness_set_blocking)(struct led_classdev *led_cdev,
74 enum led_brightness brightness);
75
76 enum led_brightness (*brightness_get)(struct led_classdev *led_cdev);
77
78
79
80
81
82
83
84
85
86 int (*blink_set)(struct led_classdev *led_cdev,
87 unsigned long *delay_on,
88 unsigned long *delay_off);
89
90 struct device *dev;
91 const struct attribute_group **groups;
92
93 struct list_head node;
94 const char *default_trigger;
95
96 unsigned long blink_delay_on, blink_delay_off;
97 struct timer_list blink_timer;
98 int blink_brightness;
99 int new_blink_brightness;
100 void (*flash_resume)(struct led_classdev *led_cdev);
101
102 struct work_struct set_brightness_work;
103 int delayed_set_value;
104
105#ifdef CONFIG_LEDS_TRIGGERS
106
107 struct rw_semaphore trigger_lock;
108
109 struct led_trigger *trigger;
110 struct list_head trig_list;
111 void *trigger_data;
112
113 bool activated;
114#endif
115
116#ifdef CONFIG_LEDS_BRIGHTNESS_HW_CHANGED
117 int brightness_hw_changed;
118 struct kernfs_node *brightness_hw_changed_kn;
119#endif
120
121
122 struct mutex led_access;
123};
124
125extern int of_led_classdev_register(struct device *parent,
126 struct device_node *np,
127 struct led_classdev *led_cdev);
128#define led_classdev_register(parent, led_cdev) \
129 of_led_classdev_register(parent, NULL, led_cdev)
130extern int devm_of_led_classdev_register(struct device *parent,
131 struct device_node *np,
132 struct led_classdev *led_cdev);
133#define devm_led_classdev_register(parent, led_cdev) \
134 devm_of_led_classdev_register(parent, NULL, led_cdev)
135extern void led_classdev_unregister(struct led_classdev *led_cdev);
136extern void devm_led_classdev_unregister(struct device *parent,
137 struct led_classdev *led_cdev);
138extern void led_classdev_suspend(struct led_classdev *led_cdev);
139extern void led_classdev_resume(struct led_classdev *led_cdev);
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156extern void led_blink_set(struct led_classdev *led_cdev,
157 unsigned long *delay_on,
158 unsigned long *delay_off);
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173extern void led_blink_set_oneshot(struct led_classdev *led_cdev,
174 unsigned long *delay_on,
175 unsigned long *delay_off,
176 int invert);
177
178
179
180
181
182
183
184
185
186extern void led_set_brightness(struct led_classdev *led_cdev,
187 enum led_brightness brightness);
188
189
190
191
192
193
194
195
196
197
198
199
200extern int led_set_brightness_sync(struct led_classdev *led_cdev,
201 enum led_brightness value);
202
203
204
205
206
207
208
209
210
211
212extern int led_update_brightness(struct led_classdev *led_cdev);
213
214
215
216
217
218
219
220extern void led_sysfs_disable(struct led_classdev *led_cdev);
221
222
223
224
225
226
227
228extern void led_sysfs_enable(struct led_classdev *led_cdev);
229
230
231
232
233
234
235
236static inline bool led_sysfs_is_disabled(struct led_classdev *led_cdev)
237{
238 return led_cdev->flags & LED_SYSFS_DISABLE;
239}
240
241
242
243
244
245#define DEFINE_LED_TRIGGER(x) static struct led_trigger *x;
246#define DEFINE_LED_TRIGGER_GLOBAL(x) struct led_trigger *x;
247
248#ifdef CONFIG_LEDS_TRIGGERS
249
250#define TRIG_NAME_MAX 50
251
252struct led_trigger {
253
254 const char *name;
255 void (*activate)(struct led_classdev *led_cdev);
256 void (*deactivate)(struct led_classdev *led_cdev);
257
258
259 rwlock_t leddev_list_lock;
260 struct list_head led_cdevs;
261
262
263 struct list_head next_trig;
264};
265
266ssize_t led_trigger_store(struct device *dev, struct device_attribute *attr,
267 const char *buf, size_t count);
268ssize_t led_trigger_show(struct device *dev, struct device_attribute *attr,
269 char *buf);
270
271
272extern int led_trigger_register(struct led_trigger *trigger);
273extern void led_trigger_unregister(struct led_trigger *trigger);
274extern int devm_led_trigger_register(struct device *dev,
275 struct led_trigger *trigger);
276
277extern void led_trigger_register_simple(const char *name,
278 struct led_trigger **trigger);
279extern void led_trigger_unregister_simple(struct led_trigger *trigger);
280extern void led_trigger_event(struct led_trigger *trigger,
281 enum led_brightness event);
282extern void led_trigger_blink(struct led_trigger *trigger,
283 unsigned long *delay_on,
284 unsigned long *delay_off);
285extern void led_trigger_blink_oneshot(struct led_trigger *trigger,
286 unsigned long *delay_on,
287 unsigned long *delay_off,
288 int invert);
289extern void led_trigger_set_default(struct led_classdev *led_cdev);
290extern void led_trigger_set(struct led_classdev *led_cdev,
291 struct led_trigger *trigger);
292extern void led_trigger_remove(struct led_classdev *led_cdev);
293
294static inline void *led_get_trigger_data(struct led_classdev *led_cdev)
295{
296 return led_cdev->trigger_data;
297}
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314extern void led_trigger_rename_static(const char *name,
315 struct led_trigger *trig);
316
317#else
318
319
320struct led_trigger {};
321
322
323static inline void led_trigger_register_simple(const char *name,
324 struct led_trigger **trigger) {}
325static inline void led_trigger_unregister_simple(struct led_trigger *trigger) {}
326static inline void led_trigger_event(struct led_trigger *trigger,
327 enum led_brightness event) {}
328static inline void led_trigger_blink(struct led_trigger *trigger,
329 unsigned long *delay_on,
330 unsigned long *delay_off) {}
331static inline void led_trigger_blink_oneshot(struct led_trigger *trigger,
332 unsigned long *delay_on,
333 unsigned long *delay_off,
334 int invert) {}
335static inline void led_trigger_set_default(struct led_classdev *led_cdev) {}
336static inline void led_trigger_set(struct led_classdev *led_cdev,
337 struct led_trigger *trigger) {}
338static inline void led_trigger_remove(struct led_classdev *led_cdev) {}
339static inline void *led_get_trigger_data(struct led_classdev *led_cdev)
340{
341 return NULL;
342}
343
344#endif
345
346
347#ifdef CONFIG_LEDS_TRIGGER_DISK
348extern void ledtrig_disk_activity(void);
349#else
350static inline void ledtrig_disk_activity(void) {}
351#endif
352
353#ifdef CONFIG_LEDS_TRIGGER_MTD
354extern void ledtrig_mtd_activity(void);
355#else
356static inline void ledtrig_mtd_activity(void) {}
357#endif
358
359#if defined(CONFIG_LEDS_TRIGGER_CAMERA) || defined(CONFIG_LEDS_TRIGGER_CAMERA_MODULE)
360extern void ledtrig_flash_ctrl(bool on);
361extern void ledtrig_torch_ctrl(bool on);
362#else
363static inline void ledtrig_flash_ctrl(bool on) {}
364static inline void ledtrig_torch_ctrl(bool on) {}
365#endif
366
367
368
369
370struct led_info {
371 const char *name;
372 const char *default_trigger;
373 int flags;
374};
375
376struct led_platform_data {
377 int num_leds;
378 struct led_info *leds;
379};
380
381struct gpio_desc;
382typedef int (*gpio_blink_set_t)(struct gpio_desc *desc, int state,
383 unsigned long *delay_on,
384 unsigned long *delay_off);
385
386
387struct gpio_led {
388 const char *name;
389 const char *default_trigger;
390 unsigned gpio;
391 unsigned active_low : 1;
392 unsigned retain_state_suspended : 1;
393 unsigned panic_indicator : 1;
394 unsigned default_state : 2;
395
396 struct gpio_desc *gpiod;
397};
398#define LEDS_GPIO_DEFSTATE_OFF 0
399#define LEDS_GPIO_DEFSTATE_ON 1
400#define LEDS_GPIO_DEFSTATE_KEEP 2
401
402struct gpio_led_platform_data {
403 int num_leds;
404 const struct gpio_led *leds;
405
406#define GPIO_LED_NO_BLINK_LOW 0
407#define GPIO_LED_NO_BLINK_HIGH 1
408#define GPIO_LED_BLINK 2
409 gpio_blink_set_t gpio_blink_set;
410};
411
412#ifdef CONFIG_NEW_LEDS
413struct platform_device *gpio_led_register_device(
414 int id, const struct gpio_led_platform_data *pdata);
415#else
416static inline struct platform_device *gpio_led_register_device(
417 int id, const struct gpio_led_platform_data *pdata)
418{
419 return 0;
420}
421#endif
422
423enum cpu_led_event {
424 CPU_LED_IDLE_START,
425 CPU_LED_IDLE_END,
426 CPU_LED_START,
427 CPU_LED_STOP,
428 CPU_LED_HALTED,
429};
430#ifdef CONFIG_LEDS_TRIGGER_CPU
431extern void ledtrig_cpu(enum cpu_led_event evt);
432#else
433static inline void ledtrig_cpu(enum cpu_led_event evt)
434{
435 return;
436}
437#endif
438
439#ifdef CONFIG_LEDS_BRIGHTNESS_HW_CHANGED
440extern void led_classdev_notify_brightness_hw_changed(
441 struct led_classdev *led_cdev, enum led_brightness brightness);
442#else
443static inline void led_classdev_notify_brightness_hw_changed(
444 struct led_classdev *led_cdev, enum led_brightness brightness) { }
445#endif
446
447#endif
448