xref: /linux/Documentation/ABI/testing/sysfs-class-rc (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0)
1What:		/sys/class/rc/
2Date:		Apr 2010
3KernelVersion:	2.6.35
4Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
5Description:
6		The rc/ class sub-directory belongs to the Remote Controller
7		core and provides a sysfs interface for configuring infrared
8		remote controller receivers.
9
10What:		/sys/class/rc/rc<N>/
11Date:		Apr 2010
12KernelVersion:	2.6.35
13Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
14Description:
15		A /sys/class/rc/rcN directory is created for each remote
16		control receiver device where N is the number of the receiver.
17
18What:		/sys/class/rc/rc<N>/protocols
19Date:		Jun 2010
20KernelVersion:	2.6.36
21Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
22Description:
23		Reading this file returns a list of available protocols,
24		something like::
25
26		    "rc5 [rc6] nec jvc [sony]"
27
28		Enabled protocols are shown in [] brackets.
29
30		Writing "+proto" will add a protocol to the list of enabled
31		protocols.
32
33		Writing "-proto" will remove a protocol from the list of enabled
34		protocols.
35
36		Writing "proto" will enable only "proto".
37
38		Writing "none" will disable all protocols.
39
40		Write fails with EINVAL if an invalid protocol combination or
41		unknown protocol name is used.
42
43What:		/sys/class/rc/rc<N>/filter
44Date:		Jan 2014
45KernelVersion:	3.15
46Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
47Description:
48		Sets the scancode filter expected value.
49
50		Use in combination with /sys/class/rc/rcN/filter_mask to set the
51		expected value of the bits set in the filter mask.
52		If the hardware supports it then scancodes which do not match
53		the filter will be ignored. Otherwise the write will fail with
54		an error.
55
56		This value may be reset to 0 if the current protocol is altered.
57
58What:		/sys/class/rc/rc<N>/filter_mask
59Date:		Jan 2014
60KernelVersion:	3.15
61Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
62Description:
63		Sets the scancode filter mask of bits to compare.
64		Use in combination with /sys/class/rc/rcN/filter to set the bits
65		of the scancode which should be compared against the expected
66		value. A value of 0 disables the filter to allow all valid
67		scancodes to be processed.
68
69		If the hardware supports it then scancodes which do not match
70		the filter will be ignored. Otherwise the write will fail with
71		an error.
72
73		This value may be reset to 0 if the current protocol is altered.
74
75What:		/sys/class/rc/rc<N>/wakeup_protocols
76Date:		Feb 2017
77KernelVersion:	4.11
78Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
79Description:
80		Reading this file returns a list of available protocols to use
81		for the wakeup filter, something like::
82
83		    "rc-5 nec nec-x rc-6-0 rc-6-6a-24 [rc-6-6a-32] rc-6-mce"
84
85		Note that protocol variants are listed, so "nec", "sony",
86		"rc-5", "rc-6" have their different bit length encodings
87		listed if available.
88
89		The enabled wakeup protocol is shown in [] brackets.
90
91		Only one protocol can be selected at a time.
92
93		Writing "proto" will use "proto" for wakeup events.
94
95		Writing "none" will disable wakeup.
96
97		Write fails with EINVAL if an invalid protocol combination or
98		unknown protocol name is used, or if wakeup is not supported by
99		the hardware.
100
101What:		/sys/class/rc/rc<N>/wakeup_filter
102Date:		Jan 2014
103KernelVersion:	3.15
104Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
105Description:
106		Sets the scancode wakeup filter expected value.
107
108		Use in combination with /sys/class/rc/rcN/wakeup_filter_mask to
109		set the expected value of the bits set in the wakeup filter mask
110		to trigger a system wake event.
111
112		If the hardware supports it and wakeup_filter_mask is not 0 then
113		scancodes which match the filter will wake the system from e.g.
114		suspend to RAM or power off.
115
116		Otherwise the write will fail with an error.
117
118		This value may be reset to 0 if the wakeup protocol is altered.
119
120What:		/sys/class/rc/rc<N>/wakeup_filter_mask
121Date:		Jan 2014
122KernelVersion:	3.15
123Contact:	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
124Description:
125		Sets the scancode wakeup filter mask of bits to compare.
126
127		Use in combination with /sys/class/rc/rcN/wakeup_filter to set
128		the bits of the scancode which should be compared against the
129		expected value to trigger a system wake event.
130
131		If the hardware supports it and wakeup_filter_mask is not 0 then
132		scancodes which match the filter will wake the system from e.g.
133		suspend to RAM or power off.
134
135		Otherwise the write will fail with an error.
136
137		This value may be reset to 0 if the wakeup protocol is altered.
138