2 * LED Kernel Netdev Trigger
4 * Toggles the LED to reflect the link and traffic state of a named net device
6 * Copyright 2007 Oliver Jowett <oliver@opencloud.com>
8 * Derived from ledtrig-timer.c which is:
9 * Copyright 2005-2006 Openedhand Ltd.
10 * Author: Richard Purdie <rpurdie@openedhand.com>
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License version 2 as
14 * published by the Free Software Foundation.
18 #include <linux/module.h>
19 #include <linux/jiffies.h>
20 #include <linux/kernel.h>
21 #include <linux/init.h>
22 #include <linux/list.h>
23 #include <linux/spinlock.h>
24 #include <linux/device.h>
25 #include <linux/sysdev.h>
26 #include <linux/netdevice.h>
27 #include <linux/timer.h>
28 #include <linux/ctype.h>
29 #include <linux/leds.h>
30 #include <linux/version.h>
32 #if LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,26)
33 #include <net/net_namespace.h>
39 * Configurable sysfs attributes:
41 * device_name - network device name to monitor
43 * interval - duration of LED blink, in milliseconds
45 * mode - either "none" (LED is off) or a space separated list of one or more of:
46 * link: LED's normal state reflects whether the link is up (has carrier) or not
47 * tx: LED blinks on transmitted data
48 * rx: LED blinks on receive data
52 * Simple link status LED:
53 * $ echo netdev >someled/trigger
54 * $ echo eth0 >someled/device_name
55 * $ echo link >someled/mode
57 * Ethernet-style link/activity LED:
58 * $ echo netdev >someled/trigger
59 * $ echo eth0 >someled/device_name
60 * $ echo "link tx rx" >someled/mode
62 * Modem-style tx/rx LEDs:
63 * $ echo netdev >led1/trigger
64 * $ echo ppp0 >led1/device_name
65 * $ echo tx >led1/mode
66 * $ echo netdev >led2/trigger
67 * $ echo ppp0 >led2/device_name
68 * $ echo rx >led2/mode
76 struct led_netdev_data
{
79 struct timer_list timer
;
80 struct notifier_block notifier
;
82 struct led_classdev
*led_cdev
;
83 struct net_device
*net_dev
;
85 char device_name
[IFNAMSIZ
];
89 unsigned last_activity
;
92 static void set_baseline_state(struct led_netdev_data
*trigger_data
)
94 if ((trigger_data
->mode
& MODE_LINK
) != 0 && trigger_data
->link_up
)
95 led_set_brightness(trigger_data
->led_cdev
, LED_FULL
);
97 led_set_brightness(trigger_data
->led_cdev
, LED_OFF
);
99 if ((trigger_data
->mode
& (MODE_TX
| MODE_RX
)) != 0 && trigger_data
->link_up
)
100 mod_timer(&trigger_data
->timer
, jiffies
+ trigger_data
->interval
);
102 del_timer(&trigger_data
->timer
);
105 static ssize_t
led_device_name_show(struct device
*dev
,
106 struct device_attribute
*attr
, char *buf
)
108 struct led_classdev
*led_cdev
= dev_get_drvdata(dev
);
109 struct led_netdev_data
*trigger_data
= led_cdev
->trigger_data
;
111 read_lock(&trigger_data
->lock
);
112 sprintf(buf
, "%s\n", trigger_data
->device_name
);
113 read_unlock(&trigger_data
->lock
);
115 return strlen(buf
) + 1;
118 #if LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,21)
119 extern struct net init_net
;
122 static ssize_t
led_device_name_store(struct device
*dev
,
123 struct device_attribute
*attr
, const char *buf
, size_t size
)
125 struct led_classdev
*led_cdev
= dev_get_drvdata(dev
);
126 struct led_netdev_data
*trigger_data
= led_cdev
->trigger_data
;
128 if (size
< 0 || size
>= IFNAMSIZ
)
131 write_lock(&trigger_data
->lock
);
133 strcpy(trigger_data
->device_name
, buf
);
134 if (size
> 0 && trigger_data
->device_name
[size
-1] == '\n')
135 trigger_data
->device_name
[size
-1] = 0;
137 if (trigger_data
->device_name
[0] != 0) {
138 /* check for existing device to update from */
139 #if LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,26)
140 trigger_data
->net_dev
= dev_get_by_name(&init_net
, trigger_data
->device_name
);
142 trigger_data
->net_dev
= dev_get_by_name(trigger_data
->device_name
);
144 if (trigger_data
->net_dev
!= NULL
)
145 trigger_data
->link_up
= (dev_get_flags(trigger_data
->net_dev
) & IFF_LOWER_UP
) != 0;
146 set_baseline_state(trigger_data
); /* updates LEDs, may start timers */
149 write_unlock(&trigger_data
->lock
);
153 static DEVICE_ATTR(device_name
, 0644, led_device_name_show
, led_device_name_store
);
155 static ssize_t
led_mode_show(struct device
*dev
,
156 struct device_attribute
*attr
, char *buf
)
158 struct led_classdev
*led_cdev
= dev_get_drvdata(dev
);
159 struct led_netdev_data
*trigger_data
= led_cdev
->trigger_data
;
161 read_lock(&trigger_data
->lock
);
163 if (trigger_data
->mode
== 0) {
164 strcpy(buf
, "none\n");
166 if (trigger_data
->mode
& MODE_LINK
)
167 strcat(buf
, "link ");
168 if (trigger_data
->mode
& MODE_TX
)
170 if (trigger_data
->mode
& MODE_RX
)
175 read_unlock(&trigger_data
->lock
);
177 return strlen(buf
)+1;
180 static ssize_t
led_mode_store(struct device
*dev
,
181 struct device_attribute
*attr
, const char *buf
, size_t size
)
183 struct led_classdev
*led_cdev
= dev_get_drvdata(dev
);
184 struct led_netdev_data
*trigger_data
= led_cdev
->trigger_data
;
189 /* take a copy since we don't want to trash the inbound buffer when using strsep */
190 strncpy(copybuf
, buf
, sizeof(copybuf
));
191 copybuf
[sizeof(copybuf
) - 1] = 0;
194 while ((token
= strsep(&p
, " \t\n")) != NULL
) {
201 if (!strcmp(token
, "none"))
203 else if (!strcmp(token
, "tx"))
205 else if (!strcmp(token
, "rx"))
207 else if (!strcmp(token
, "link"))
208 new_mode
|= MODE_LINK
;
216 write_lock(&trigger_data
->lock
);
217 trigger_data
->mode
= new_mode
;
218 set_baseline_state(trigger_data
);
219 write_unlock(&trigger_data
->lock
);
224 static DEVICE_ATTR(mode
, 0644, led_mode_show
, led_mode_store
);
226 static ssize_t
led_interval_show(struct device
*dev
,
227 struct device_attribute
*attr
, char *buf
)
229 struct led_classdev
*led_cdev
= dev_get_drvdata(dev
);
230 struct led_netdev_data
*trigger_data
= led_cdev
->trigger_data
;
232 read_lock(&trigger_data
->lock
);
233 sprintf(buf
, "%u\n", jiffies_to_msecs(trigger_data
->interval
));
234 read_unlock(&trigger_data
->lock
);
236 return strlen(buf
) + 1;
239 static ssize_t
led_interval_store(struct device
*dev
,
240 struct device_attribute
*attr
, const char *buf
, size_t size
)
242 struct led_classdev
*led_cdev
= dev_get_drvdata(dev
);
243 struct led_netdev_data
*trigger_data
= led_cdev
->trigger_data
;
246 unsigned long value
= simple_strtoul(buf
, &after
, 10);
247 size_t count
= after
- buf
;
249 if (*after
&& isspace(*after
))
252 /* impose some basic bounds on the timer interval */
253 if (count
== size
&& value
>= 5 && value
<= 10000) {
254 write_lock(&trigger_data
->lock
);
255 trigger_data
->interval
= msecs_to_jiffies(value
);
256 set_baseline_state(trigger_data
); // resets timer
257 write_unlock(&trigger_data
->lock
);
264 static DEVICE_ATTR(interval
, 0644, led_interval_show
, led_interval_store
);
266 static int netdev_trig_notify(struct notifier_block
*nb
,
270 struct net_device
*dev
= dv
;
271 struct led_netdev_data
*trigger_data
= container_of(nb
, struct led_netdev_data
, notifier
);
273 if (evt
!= NETDEV_UP
&& evt
!= NETDEV_DOWN
&& evt
!= NETDEV_CHANGE
&& evt
!= NETDEV_REGISTER
&& evt
!= NETDEV_UNREGISTER
)
276 write_lock(&trigger_data
->lock
);
278 if (strcmp(dev
->name
, trigger_data
->device_name
))
281 if (evt
== NETDEV_REGISTER
) {
282 if (trigger_data
->net_dev
!= NULL
)
283 dev_put(trigger_data
->net_dev
);
285 trigger_data
->net_dev
= dev
;
286 trigger_data
->link_up
= 0;
290 if (evt
== NETDEV_UNREGISTER
&& trigger_data
->net_dev
!= NULL
) {
291 dev_put(trigger_data
->net_dev
);
292 trigger_data
->net_dev
= NULL
;
296 /* UP / DOWN / CHANGE */
298 trigger_data
->link_up
= (evt
!= NETDEV_DOWN
&& netif_carrier_ok(dev
));
299 set_baseline_state(trigger_data
);
302 write_unlock(&trigger_data
->lock
);
306 /* here's the real work! */
307 static void netdev_trig_timer(unsigned long arg
)
309 struct led_netdev_data
*trigger_data
= (struct led_netdev_data
*)arg
;
310 const struct net_device_stats
*dev_stats
;
311 unsigned new_activity
;
313 write_lock(&trigger_data
->lock
);
315 if (!trigger_data
->link_up
|| !trigger_data
->net_dev
|| (trigger_data
->mode
& (MODE_TX
| MODE_RX
)) == 0) {
316 /* we don't need to do timer work, just reflect link state. */
317 led_set_brightness(trigger_data
->led_cdev
, ((trigger_data
->mode
& MODE_LINK
) != 0 && trigger_data
->link_up
) ? LED_FULL
: LED_OFF
);
321 dev_stats
= dev_get_stats(trigger_data
->net_dev
);
323 ((trigger_data
->mode
& MODE_TX
) ? dev_stats
->tx_packets
: 0) +
324 ((trigger_data
->mode
& MODE_RX
) ? dev_stats
->rx_packets
: 0);
326 if (trigger_data
->mode
& MODE_LINK
) {
327 /* base state is ON (link present) */
328 /* if there's no link, we don't get this far and the LED is off */
330 /* OFF -> ON always */
331 /* ON -> OFF on activity */
332 if (trigger_data
->led_cdev
->brightness
== LED_OFF
) {
333 led_set_brightness(trigger_data
->led_cdev
, LED_FULL
);
334 } else if (trigger_data
->last_activity
!= new_activity
) {
335 led_set_brightness(trigger_data
->led_cdev
, LED_OFF
);
338 /* base state is OFF */
339 /* ON -> OFF always */
340 /* OFF -> ON on activity */
341 if (trigger_data
->led_cdev
->brightness
== LED_FULL
) {
342 led_set_brightness(trigger_data
->led_cdev
, LED_OFF
);
343 } else if (trigger_data
->last_activity
!= new_activity
) {
344 led_set_brightness(trigger_data
->led_cdev
, LED_FULL
);
348 trigger_data
->last_activity
= new_activity
;
349 mod_timer(&trigger_data
->timer
, jiffies
+ trigger_data
->interval
);
352 write_unlock(&trigger_data
->lock
);
355 static void netdev_trig_activate(struct led_classdev
*led_cdev
)
357 struct led_netdev_data
*trigger_data
;
360 trigger_data
= kzalloc(sizeof(struct led_netdev_data
), GFP_KERNEL
);
364 rwlock_init(&trigger_data
->lock
);
366 trigger_data
->notifier
.notifier_call
= netdev_trig_notify
;
367 trigger_data
->notifier
.priority
= 10;
369 setup_timer(&trigger_data
->timer
, netdev_trig_timer
, (unsigned long) trigger_data
);
371 trigger_data
->led_cdev
= led_cdev
;
372 trigger_data
->net_dev
= NULL
;
373 trigger_data
->device_name
[0] = 0;
375 trigger_data
->mode
= 0;
376 trigger_data
->interval
= msecs_to_jiffies(50);
377 trigger_data
->link_up
= 0;
378 trigger_data
->last_activity
= 0;
380 led_cdev
->trigger_data
= trigger_data
;
382 rc
= device_create_file(led_cdev
->dev
, &dev_attr_device_name
);
385 rc
= device_create_file(led_cdev
->dev
, &dev_attr_mode
);
387 goto err_out_device_name
;
388 rc
= device_create_file(led_cdev
->dev
, &dev_attr_interval
);
392 register_netdevice_notifier(&trigger_data
->notifier
);
396 device_remove_file(led_cdev
->dev
, &dev_attr_mode
);
398 device_remove_file(led_cdev
->dev
, &dev_attr_device_name
);
400 led_cdev
->trigger_data
= NULL
;
404 static void netdev_trig_deactivate(struct led_classdev
*led_cdev
)
406 struct led_netdev_data
*trigger_data
= led_cdev
->trigger_data
;
409 unregister_netdevice_notifier(&trigger_data
->notifier
);
411 device_remove_file(led_cdev
->dev
, &dev_attr_device_name
);
412 device_remove_file(led_cdev
->dev
, &dev_attr_mode
);
413 device_remove_file(led_cdev
->dev
, &dev_attr_interval
);
415 write_lock(&trigger_data
->lock
);
417 if (trigger_data
->net_dev
) {
418 dev_put(trigger_data
->net_dev
);
419 trigger_data
->net_dev
= NULL
;
422 write_unlock(&trigger_data
->lock
);
424 del_timer_sync(&trigger_data
->timer
);
430 static struct led_trigger netdev_led_trigger
= {
432 .activate
= netdev_trig_activate
,
433 .deactivate
= netdev_trig_deactivate
,
436 static int __init
netdev_trig_init(void)
438 return led_trigger_register(&netdev_led_trigger
);
441 static void __exit
netdev_trig_exit(void)
443 led_trigger_unregister(&netdev_led_trigger
);
446 module_init(netdev_trig_init
);
447 module_exit(netdev_trig_exit
);
449 MODULE_AUTHOR("Oliver Jowett <oliver@opencloud.com>");
450 MODULE_DESCRIPTION("Netdev LED trigger");
451 MODULE_LICENSE("GPL");