1 // SPDX-License-Identifier: GPL-2.0
5 // LED Kernel Netdev Trigger
7 // Toggles the LED to reflect the link and traffic state of a named net device
9 // Derived from ledtrig-timer.c which is:
10 // Copyright 2005-2006 Openedhand Ltd.
13 #include <linux/atomic.h>
14 #include <linux/ctype.h>
15 #include <linux/device.h>
16 #include <linux/init.h>
17 #include <linux/jiffies.h>
18 #include <linux/kernel.h>
19 #include <linux/leds.h>
20 #include <linux/list.h>
21 #include <linux/module.h>
22 #include <linux/netdevice.h>
23 #include <linux/spinlock.h>
24 #include <linux/timer.h>
28 * Configurable sysfs attributes:
30 * device_name - network device name to monitor
31 * interval - duration of LED blink, in milliseconds
32 * link - LED's normal state reflects whether the link is up
33 * (has carrier) or not
34 * tx - LED blinks on transmitted data
35 * rx - LED blinks on receive data
39 struct led_netdev_data {
42 struct delayed_work work;
43 struct notifier_block notifier;
45 struct led_classdev *led_cdev;
46 struct net_device *net_dev;
48 char device_name[IFNAMSIZ];
50 unsigned int last_activity;
53 #define NETDEV_LED_LINK 0
54 #define NETDEV_LED_TX 1
55 #define NETDEV_LED_RX 2
56 #define NETDEV_LED_MODE_LINKUP 3
59 enum netdev_led_attr {
65 static void set_baseline_state(struct led_netdev_data *trigger_data)
67 int current_brightness;
68 struct led_classdev *led_cdev = trigger_data->led_cdev;
70 current_brightness = led_cdev->brightness;
71 if (current_brightness)
72 led_cdev->blink_brightness = current_brightness;
73 if (!led_cdev->blink_brightness)
74 led_cdev->blink_brightness = led_cdev->max_brightness;
76 if (!test_bit(NETDEV_LED_MODE_LINKUP, &trigger_data->mode))
77 led_set_brightness(led_cdev, LED_OFF);
79 if (test_bit(NETDEV_LED_LINK, &trigger_data->mode))
80 led_set_brightness(led_cdev,
81 led_cdev->blink_brightness);
83 led_set_brightness(led_cdev, LED_OFF);
85 /* If we are looking for RX/TX start periodically
88 if (test_bit(NETDEV_LED_TX, &trigger_data->mode) ||
89 test_bit(NETDEV_LED_RX, &trigger_data->mode))
90 schedule_delayed_work(&trigger_data->work, 0);
94 static ssize_t device_name_show(struct device *dev,
95 struct device_attribute *attr, char *buf)
97 struct led_netdev_data *trigger_data = led_trigger_get_drvdata(dev);
100 spin_lock_bh(&trigger_data->lock);
101 len = sprintf(buf, "%s\n", trigger_data->device_name);
102 spin_unlock_bh(&trigger_data->lock);
107 static ssize_t device_name_store(struct device *dev,
108 struct device_attribute *attr, const char *buf,
111 struct led_netdev_data *trigger_data = led_trigger_get_drvdata(dev);
113 if (size >= IFNAMSIZ)
116 cancel_delayed_work_sync(&trigger_data->work);
118 spin_lock_bh(&trigger_data->lock);
120 if (trigger_data->net_dev) {
121 dev_put(trigger_data->net_dev);
122 trigger_data->net_dev = NULL;
125 memcpy(trigger_data->device_name, buf, size);
126 trigger_data->device_name[size] = 0;
127 if (size > 0 && trigger_data->device_name[size - 1] == '\n')
128 trigger_data->device_name[size - 1] = 0;
130 if (trigger_data->device_name[0] != 0)
131 trigger_data->net_dev =
132 dev_get_by_name(&init_net, trigger_data->device_name);
134 clear_bit(NETDEV_LED_MODE_LINKUP, &trigger_data->mode);
135 if (trigger_data->net_dev != NULL)
136 if (netif_carrier_ok(trigger_data->net_dev))
137 set_bit(NETDEV_LED_MODE_LINKUP, &trigger_data->mode);
139 trigger_data->last_activity = 0;
141 set_baseline_state(trigger_data);
142 spin_unlock_bh(&trigger_data->lock);
147 static DEVICE_ATTR_RW(device_name);
149 static ssize_t netdev_led_attr_show(struct device *dev, char *buf,
150 enum netdev_led_attr attr)
152 struct led_netdev_data *trigger_data = led_trigger_get_drvdata(dev);
156 case NETDEV_ATTR_LINK:
157 bit = NETDEV_LED_LINK;
169 return sprintf(buf, "%u\n", test_bit(bit, &trigger_data->mode));
172 static ssize_t netdev_led_attr_store(struct device *dev, const char *buf,
173 size_t size, enum netdev_led_attr attr)
175 struct led_netdev_data *trigger_data = led_trigger_get_drvdata(dev);
180 ret = kstrtoul(buf, 0, &state);
185 case NETDEV_ATTR_LINK:
186 bit = NETDEV_LED_LINK;
198 cancel_delayed_work_sync(&trigger_data->work);
201 set_bit(bit, &trigger_data->mode);
203 clear_bit(bit, &trigger_data->mode);
205 set_baseline_state(trigger_data);
210 static ssize_t link_show(struct device *dev,
211 struct device_attribute *attr, char *buf)
213 return netdev_led_attr_show(dev, buf, NETDEV_ATTR_LINK);
216 static ssize_t link_store(struct device *dev,
217 struct device_attribute *attr, const char *buf, size_t size)
219 return netdev_led_attr_store(dev, buf, size, NETDEV_ATTR_LINK);
222 static DEVICE_ATTR_RW(link);
224 static ssize_t tx_show(struct device *dev,
225 struct device_attribute *attr, char *buf)
227 return netdev_led_attr_show(dev, buf, NETDEV_ATTR_TX);
230 static ssize_t tx_store(struct device *dev,
231 struct device_attribute *attr, const char *buf, size_t size)
233 return netdev_led_attr_store(dev, buf, size, NETDEV_ATTR_TX);
236 static DEVICE_ATTR_RW(tx);
238 static ssize_t rx_show(struct device *dev,
239 struct device_attribute *attr, char *buf)
241 return netdev_led_attr_show(dev, buf, NETDEV_ATTR_RX);
244 static ssize_t rx_store(struct device *dev,
245 struct device_attribute *attr, const char *buf, size_t size)
247 return netdev_led_attr_store(dev, buf, size, NETDEV_ATTR_RX);
250 static DEVICE_ATTR_RW(rx);
252 static ssize_t interval_show(struct device *dev,
253 struct device_attribute *attr, char *buf)
255 struct led_netdev_data *trigger_data = led_trigger_get_drvdata(dev);
257 return sprintf(buf, "%u\n",
258 jiffies_to_msecs(atomic_read(&trigger_data->interval)));
261 static ssize_t interval_store(struct device *dev,
262 struct device_attribute *attr, const char *buf,
265 struct led_netdev_data *trigger_data = led_trigger_get_drvdata(dev);
269 ret = kstrtoul(buf, 0, &value);
273 /* impose some basic bounds on the timer interval */
274 if (value >= 5 && value <= 10000) {
275 cancel_delayed_work_sync(&trigger_data->work);
277 atomic_set(&trigger_data->interval, msecs_to_jiffies(value));
278 set_baseline_state(trigger_data); /* resets timer */
284 static DEVICE_ATTR_RW(interval);
286 static struct attribute *netdev_trig_attrs[] = {
287 &dev_attr_device_name.attr,
291 &dev_attr_interval.attr,
294 ATTRIBUTE_GROUPS(netdev_trig);
296 static int netdev_trig_notify(struct notifier_block *nb,
297 unsigned long evt, void *dv)
299 struct net_device *dev =
300 netdev_notifier_info_to_dev((struct netdev_notifier_info *)dv);
301 struct led_netdev_data *trigger_data =
302 container_of(nb, struct led_netdev_data, notifier);
304 if (evt != NETDEV_UP && evt != NETDEV_DOWN && evt != NETDEV_CHANGE
305 && evt != NETDEV_REGISTER && evt != NETDEV_UNREGISTER
306 && evt != NETDEV_CHANGENAME)
309 if (!(dev == trigger_data->net_dev ||
310 (evt == NETDEV_CHANGENAME && !strcmp(dev->name, trigger_data->device_name)) ||
311 (evt == NETDEV_REGISTER && !strcmp(dev->name, trigger_data->device_name))))
314 cancel_delayed_work_sync(&trigger_data->work);
316 spin_lock_bh(&trigger_data->lock);
318 clear_bit(NETDEV_LED_MODE_LINKUP, &trigger_data->mode);
320 case NETDEV_CHANGENAME:
321 case NETDEV_REGISTER:
322 if (trigger_data->net_dev)
323 dev_put(trigger_data->net_dev);
325 trigger_data->net_dev = dev;
327 case NETDEV_UNREGISTER:
328 dev_put(trigger_data->net_dev);
329 trigger_data->net_dev = NULL;
333 if (netif_carrier_ok(dev))
334 set_bit(NETDEV_LED_MODE_LINKUP, &trigger_data->mode);
338 set_baseline_state(trigger_data);
340 spin_unlock_bh(&trigger_data->lock);
345 /* here's the real work! */
346 static void netdev_trig_work(struct work_struct *work)
348 struct led_netdev_data *trigger_data =
349 container_of(work, struct led_netdev_data, work.work);
350 struct rtnl_link_stats64 *dev_stats;
351 unsigned int new_activity;
352 struct rtnl_link_stats64 temp;
353 unsigned long interval;
356 /* If we dont have a device, insure we are off */
357 if (!trigger_data->net_dev) {
358 led_set_brightness(trigger_data->led_cdev, LED_OFF);
362 /* If we are not looking for RX/TX then return */
363 if (!test_bit(NETDEV_LED_TX, &trigger_data->mode) &&
364 !test_bit(NETDEV_LED_RX, &trigger_data->mode))
367 dev_stats = dev_get_stats(trigger_data->net_dev, &temp);
369 (test_bit(NETDEV_LED_TX, &trigger_data->mode) ?
370 dev_stats->tx_packets : 0) +
371 (test_bit(NETDEV_LED_RX, &trigger_data->mode) ?
372 dev_stats->rx_packets : 0);
374 if (trigger_data->last_activity != new_activity) {
375 led_stop_software_blink(trigger_data->led_cdev);
377 invert = test_bit(NETDEV_LED_LINK, &trigger_data->mode);
378 interval = jiffies_to_msecs(
379 atomic_read(&trigger_data->interval));
380 /* base state is ON (link present) */
381 led_blink_set_oneshot(trigger_data->led_cdev,
385 trigger_data->last_activity = new_activity;
388 schedule_delayed_work(&trigger_data->work,
389 (atomic_read(&trigger_data->interval)*2));
392 static int netdev_trig_activate(struct led_classdev *led_cdev)
394 struct led_netdev_data *trigger_data;
397 trigger_data = kzalloc(sizeof(struct led_netdev_data), GFP_KERNEL);
401 spin_lock_init(&trigger_data->lock);
403 trigger_data->notifier.notifier_call = netdev_trig_notify;
404 trigger_data->notifier.priority = 10;
406 INIT_DELAYED_WORK(&trigger_data->work, netdev_trig_work);
408 trigger_data->led_cdev = led_cdev;
409 trigger_data->net_dev = NULL;
410 trigger_data->device_name[0] = 0;
412 trigger_data->mode = 0;
413 atomic_set(&trigger_data->interval, msecs_to_jiffies(50));
414 trigger_data->last_activity = 0;
416 led_set_trigger_data(led_cdev, trigger_data);
418 rc = register_netdevice_notifier(&trigger_data->notifier);
425 static void netdev_trig_deactivate(struct led_classdev *led_cdev)
427 struct led_netdev_data *trigger_data = led_get_trigger_data(led_cdev);
429 unregister_netdevice_notifier(&trigger_data->notifier);
431 cancel_delayed_work_sync(&trigger_data->work);
433 if (trigger_data->net_dev)
434 dev_put(trigger_data->net_dev);
439 static struct led_trigger netdev_led_trigger = {
441 .activate = netdev_trig_activate,
442 .deactivate = netdev_trig_deactivate,
443 .groups = netdev_trig_groups,
446 static int __init netdev_trig_init(void)
448 return led_trigger_register(&netdev_led_trigger);
451 static void __exit netdev_trig_exit(void)
453 led_trigger_unregister(&netdev_led_trigger);
456 module_init(netdev_trig_init);
457 module_exit(netdev_trig_exit);
461 MODULE_DESCRIPTION("Netdev LED trigger");
462 MODULE_LICENSE("GPL v2");