xref: /OK3568_Linux_fs/kernel/drivers/leds/trigger/ledtrig-transient.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun //
3*4882a593Smuzhiyun // LED Kernel Transient Trigger
4*4882a593Smuzhiyun //
5*4882a593Smuzhiyun // Transient trigger allows one shot timer activation. Please refer to
6*4882a593Smuzhiyun // Documentation/leds/ledtrig-transient.rst for details
7*4882a593Smuzhiyun // Copyright (C) 2012 Shuah Khan <shuahkhan@gmail.com>
8*4882a593Smuzhiyun //
9*4882a593Smuzhiyun // Based on Richard Purdie's ledtrig-timer.c and Atsushi Nemoto's
10*4882a593Smuzhiyun // ledtrig-heartbeat.c
11*4882a593Smuzhiyun // Design and use-case input from Jonas Bonn <jonas@southpole.se> and
12*4882a593Smuzhiyun // Neil Brown <neilb@suse.de>
13*4882a593Smuzhiyun 
14*4882a593Smuzhiyun #include <linux/module.h>
15*4882a593Smuzhiyun #include <linux/kernel.h>
16*4882a593Smuzhiyun #include <linux/init.h>
17*4882a593Smuzhiyun #include <linux/device.h>
18*4882a593Smuzhiyun #include <linux/slab.h>
19*4882a593Smuzhiyun #include <linux/timer.h>
20*4882a593Smuzhiyun #include <linux/leds.h>
21*4882a593Smuzhiyun #include "../leds.h"
22*4882a593Smuzhiyun 
23*4882a593Smuzhiyun struct transient_trig_data {
24*4882a593Smuzhiyun 	int activate;
25*4882a593Smuzhiyun 	int state;
26*4882a593Smuzhiyun 	int restore_state;
27*4882a593Smuzhiyun 	unsigned long duration;
28*4882a593Smuzhiyun 	struct timer_list timer;
29*4882a593Smuzhiyun 	struct led_classdev *led_cdev;
30*4882a593Smuzhiyun };
31*4882a593Smuzhiyun 
transient_timer_function(struct timer_list * t)32*4882a593Smuzhiyun static void transient_timer_function(struct timer_list *t)
33*4882a593Smuzhiyun {
34*4882a593Smuzhiyun 	struct transient_trig_data *transient_data =
35*4882a593Smuzhiyun 		from_timer(transient_data, t, timer);
36*4882a593Smuzhiyun 	struct led_classdev *led_cdev = transient_data->led_cdev;
37*4882a593Smuzhiyun 
38*4882a593Smuzhiyun 	transient_data->activate = 0;
39*4882a593Smuzhiyun 	led_set_brightness_nosleep(led_cdev, transient_data->restore_state);
40*4882a593Smuzhiyun }
41*4882a593Smuzhiyun 
transient_activate_show(struct device * dev,struct device_attribute * attr,char * buf)42*4882a593Smuzhiyun static ssize_t transient_activate_show(struct device *dev,
43*4882a593Smuzhiyun 		struct device_attribute *attr, char *buf)
44*4882a593Smuzhiyun {
45*4882a593Smuzhiyun 	struct transient_trig_data *transient_data =
46*4882a593Smuzhiyun 		led_trigger_get_drvdata(dev);
47*4882a593Smuzhiyun 
48*4882a593Smuzhiyun 	return sprintf(buf, "%d\n", transient_data->activate);
49*4882a593Smuzhiyun }
50*4882a593Smuzhiyun 
transient_activate_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)51*4882a593Smuzhiyun static ssize_t transient_activate_store(struct device *dev,
52*4882a593Smuzhiyun 		struct device_attribute *attr, const char *buf, size_t size)
53*4882a593Smuzhiyun {
54*4882a593Smuzhiyun 	struct led_classdev *led_cdev = led_trigger_get_led(dev);
55*4882a593Smuzhiyun 	struct transient_trig_data *transient_data =
56*4882a593Smuzhiyun 		led_trigger_get_drvdata(dev);
57*4882a593Smuzhiyun 	unsigned long state;
58*4882a593Smuzhiyun 	ssize_t ret;
59*4882a593Smuzhiyun 
60*4882a593Smuzhiyun 	ret = kstrtoul(buf, 10, &state);
61*4882a593Smuzhiyun 	if (ret)
62*4882a593Smuzhiyun 		return ret;
63*4882a593Smuzhiyun 
64*4882a593Smuzhiyun 	if (state != 1 && state != 0)
65*4882a593Smuzhiyun 		return -EINVAL;
66*4882a593Smuzhiyun 
67*4882a593Smuzhiyun 	/* cancel the running timer */
68*4882a593Smuzhiyun 	if (state == 0 && transient_data->activate == 1) {
69*4882a593Smuzhiyun 		del_timer(&transient_data->timer);
70*4882a593Smuzhiyun 		transient_data->activate = state;
71*4882a593Smuzhiyun 		led_set_brightness_nosleep(led_cdev,
72*4882a593Smuzhiyun 					transient_data->restore_state);
73*4882a593Smuzhiyun 		return size;
74*4882a593Smuzhiyun 	}
75*4882a593Smuzhiyun 
76*4882a593Smuzhiyun 	/* start timer if there is no active timer */
77*4882a593Smuzhiyun 	if (state == 1 && transient_data->activate == 0 &&
78*4882a593Smuzhiyun 	    transient_data->duration != 0) {
79*4882a593Smuzhiyun 		transient_data->activate = state;
80*4882a593Smuzhiyun 		led_set_brightness_nosleep(led_cdev, transient_data->state);
81*4882a593Smuzhiyun 		transient_data->restore_state =
82*4882a593Smuzhiyun 		    (transient_data->state == LED_FULL) ? LED_OFF : LED_FULL;
83*4882a593Smuzhiyun 		mod_timer(&transient_data->timer,
84*4882a593Smuzhiyun 			  jiffies + msecs_to_jiffies(transient_data->duration));
85*4882a593Smuzhiyun 	}
86*4882a593Smuzhiyun 
87*4882a593Smuzhiyun 	/* state == 0 && transient_data->activate == 0
88*4882a593Smuzhiyun 		timer is not active - just return */
89*4882a593Smuzhiyun 	/* state == 1 && transient_data->activate == 1
90*4882a593Smuzhiyun 		timer is already active - just return */
91*4882a593Smuzhiyun 
92*4882a593Smuzhiyun 	return size;
93*4882a593Smuzhiyun }
94*4882a593Smuzhiyun 
transient_duration_show(struct device * dev,struct device_attribute * attr,char * buf)95*4882a593Smuzhiyun static ssize_t transient_duration_show(struct device *dev,
96*4882a593Smuzhiyun 		struct device_attribute *attr, char *buf)
97*4882a593Smuzhiyun {
98*4882a593Smuzhiyun 	struct transient_trig_data *transient_data = led_trigger_get_drvdata(dev);
99*4882a593Smuzhiyun 
100*4882a593Smuzhiyun 	return sprintf(buf, "%lu\n", transient_data->duration);
101*4882a593Smuzhiyun }
102*4882a593Smuzhiyun 
transient_duration_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)103*4882a593Smuzhiyun static ssize_t transient_duration_store(struct device *dev,
104*4882a593Smuzhiyun 		struct device_attribute *attr, const char *buf, size_t size)
105*4882a593Smuzhiyun {
106*4882a593Smuzhiyun 	struct transient_trig_data *transient_data =
107*4882a593Smuzhiyun 		led_trigger_get_drvdata(dev);
108*4882a593Smuzhiyun 	unsigned long state;
109*4882a593Smuzhiyun 	ssize_t ret;
110*4882a593Smuzhiyun 
111*4882a593Smuzhiyun 	ret = kstrtoul(buf, 10, &state);
112*4882a593Smuzhiyun 	if (ret)
113*4882a593Smuzhiyun 		return ret;
114*4882a593Smuzhiyun 
115*4882a593Smuzhiyun 	transient_data->duration = state;
116*4882a593Smuzhiyun 	return size;
117*4882a593Smuzhiyun }
118*4882a593Smuzhiyun 
transient_state_show(struct device * dev,struct device_attribute * attr,char * buf)119*4882a593Smuzhiyun static ssize_t transient_state_show(struct device *dev,
120*4882a593Smuzhiyun 		struct device_attribute *attr, char *buf)
121*4882a593Smuzhiyun {
122*4882a593Smuzhiyun 	struct transient_trig_data *transient_data =
123*4882a593Smuzhiyun 		led_trigger_get_drvdata(dev);
124*4882a593Smuzhiyun 	int state;
125*4882a593Smuzhiyun 
126*4882a593Smuzhiyun 	state = (transient_data->state == LED_FULL) ? 1 : 0;
127*4882a593Smuzhiyun 	return sprintf(buf, "%d\n", state);
128*4882a593Smuzhiyun }
129*4882a593Smuzhiyun 
transient_state_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t size)130*4882a593Smuzhiyun static ssize_t transient_state_store(struct device *dev,
131*4882a593Smuzhiyun 		struct device_attribute *attr, const char *buf, size_t size)
132*4882a593Smuzhiyun {
133*4882a593Smuzhiyun 	struct transient_trig_data *transient_data =
134*4882a593Smuzhiyun 		led_trigger_get_drvdata(dev);
135*4882a593Smuzhiyun 	unsigned long state;
136*4882a593Smuzhiyun 	ssize_t ret;
137*4882a593Smuzhiyun 
138*4882a593Smuzhiyun 	ret = kstrtoul(buf, 10, &state);
139*4882a593Smuzhiyun 	if (ret)
140*4882a593Smuzhiyun 		return ret;
141*4882a593Smuzhiyun 
142*4882a593Smuzhiyun 	if (state != 1 && state != 0)
143*4882a593Smuzhiyun 		return -EINVAL;
144*4882a593Smuzhiyun 
145*4882a593Smuzhiyun 	transient_data->state = (state == 1) ? LED_FULL : LED_OFF;
146*4882a593Smuzhiyun 	return size;
147*4882a593Smuzhiyun }
148*4882a593Smuzhiyun 
149*4882a593Smuzhiyun static DEVICE_ATTR(activate, 0644, transient_activate_show,
150*4882a593Smuzhiyun 		   transient_activate_store);
151*4882a593Smuzhiyun static DEVICE_ATTR(duration, 0644, transient_duration_show,
152*4882a593Smuzhiyun 		   transient_duration_store);
153*4882a593Smuzhiyun static DEVICE_ATTR(state, 0644, transient_state_show, transient_state_store);
154*4882a593Smuzhiyun 
155*4882a593Smuzhiyun static struct attribute *transient_trig_attrs[] = {
156*4882a593Smuzhiyun 	&dev_attr_activate.attr,
157*4882a593Smuzhiyun 	&dev_attr_duration.attr,
158*4882a593Smuzhiyun 	&dev_attr_state.attr,
159*4882a593Smuzhiyun 	NULL
160*4882a593Smuzhiyun };
161*4882a593Smuzhiyun ATTRIBUTE_GROUPS(transient_trig);
162*4882a593Smuzhiyun 
transient_trig_activate(struct led_classdev * led_cdev)163*4882a593Smuzhiyun static int transient_trig_activate(struct led_classdev *led_cdev)
164*4882a593Smuzhiyun {
165*4882a593Smuzhiyun 	struct transient_trig_data *tdata;
166*4882a593Smuzhiyun 
167*4882a593Smuzhiyun 	tdata = kzalloc(sizeof(struct transient_trig_data), GFP_KERNEL);
168*4882a593Smuzhiyun 	if (!tdata)
169*4882a593Smuzhiyun 		return -ENOMEM;
170*4882a593Smuzhiyun 
171*4882a593Smuzhiyun 	led_set_trigger_data(led_cdev, tdata);
172*4882a593Smuzhiyun 	tdata->led_cdev = led_cdev;
173*4882a593Smuzhiyun 
174*4882a593Smuzhiyun 	timer_setup(&tdata->timer, transient_timer_function, 0);
175*4882a593Smuzhiyun 
176*4882a593Smuzhiyun 	return 0;
177*4882a593Smuzhiyun }
178*4882a593Smuzhiyun 
transient_trig_deactivate(struct led_classdev * led_cdev)179*4882a593Smuzhiyun static void transient_trig_deactivate(struct led_classdev *led_cdev)
180*4882a593Smuzhiyun {
181*4882a593Smuzhiyun 	struct transient_trig_data *transient_data = led_get_trigger_data(led_cdev);
182*4882a593Smuzhiyun 
183*4882a593Smuzhiyun 	del_timer_sync(&transient_data->timer);
184*4882a593Smuzhiyun 	led_set_brightness_nosleep(led_cdev, transient_data->restore_state);
185*4882a593Smuzhiyun 	kfree(transient_data);
186*4882a593Smuzhiyun }
187*4882a593Smuzhiyun 
188*4882a593Smuzhiyun static struct led_trigger transient_trigger = {
189*4882a593Smuzhiyun 	.name     = "transient",
190*4882a593Smuzhiyun 	.activate = transient_trig_activate,
191*4882a593Smuzhiyun 	.deactivate = transient_trig_deactivate,
192*4882a593Smuzhiyun 	.groups = transient_trig_groups,
193*4882a593Smuzhiyun };
194*4882a593Smuzhiyun module_led_trigger(transient_trigger);
195*4882a593Smuzhiyun 
196*4882a593Smuzhiyun MODULE_AUTHOR("Shuah Khan <shuahkhan@gmail.com>");
197*4882a593Smuzhiyun MODULE_DESCRIPTION("Transient LED trigger");
198*4882a593Smuzhiyun MODULE_LICENSE("GPL v2");
199