blob: 530809ccfacf336710a40cf501401ccae0bb6ae4 [file] [log] [blame]
Jonathan Cameronb3874062011-08-30 12:32:49 +01001What: /sys/bus/iio/devices/iio:deviceX
Jonathan Camerone34d2c52010-05-04 14:43:05 +01002KernelVersion: 2.6.35
3Contact: linux-iio@vger.kernel.org
4Description:
Jonathan Cameronde1874b2011-08-12 16:55:38 +01005 Hardware chip or device accessed by one communication port.
Jonathan Cameronf386caa2010-11-22 23:31:16 +00006 Corresponds to a grouping of sensor channels. X is the IIO
7 index of the device.
Jonathan Camerone34d2c52010-05-04 14:43:05 +01008
Jonathan Cameronf386caa2010-11-22 23:31:16 +00009What: /sys/bus/iio/devices/triggerX
Jonathan Camerone34d2c52010-05-04 14:43:05 +010010KernelVersion: 2.6.35
11Contact: linux-iio@vger.kernel.org
12Description:
13 An event driven driver of data capture to an in kernel buffer.
14 May be provided by a device driver that also has an IIO device
15 based on hardware generated events (e.g. data ready) or
16 provided by a separate driver for other hardware (e.g.
Jonathan Cameronf386caa2010-11-22 23:31:16 +000017 periodic timer, GPIO or high resolution timer).
Jonathan Camerone34d2c52010-05-04 14:43:05 +010018 Contains trigger type specific elements. These do not
19 generalize well and hence are not documented in this file.
Jonathan Cameronf386caa2010-11-22 23:31:16 +000020 X is the IIO index of the trigger.
Jonathan Camerone34d2c52010-05-04 14:43:05 +010021
Jonathan Cameronb3874062011-08-30 12:32:49 +010022What: /sys/bus/iio/devices/iio:deviceX/buffer
Jonathan Camerone34d2c52010-05-04 14:43:05 +010023KernelVersion: 2.6.35
24Contact: linux-iio@vger.kernel.org
25Description:
Jonathan Cameronb3874062011-08-30 12:32:49 +010026 Directory of attributes relating to the buffer for the device.
Jonathan Camerone34d2c52010-05-04 14:43:05 +010027
Jonathan Cameronb3874062011-08-30 12:32:49 +010028What: /sys/bus/iio/devices/iio:deviceX/name
Jonathan Camerone34d2c52010-05-04 14:43:05 +010029KernelVersion: 2.6.35
30Contact: linux-iio@vger.kernel.org
31Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +000032 Description of the physical chip / device for device X.
33 Typically a part number.
Jonathan Camerone34d2c52010-05-04 14:43:05 +010034
Gregor Boiriebc2b7da2016-03-09 19:05:49 +010035What: /sys/bus/iio/devices/iio:deviceX/timestamp_clock
36KernelVersion: 4.5
37Contact: linux-iio@vger.kernel.org
38Description:
39 String identifying current posix clock used to timestamp
40 buffered samples and events for device X.
41
Jonathan Cameronb3874062011-08-30 12:32:49 +010042What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency
Jonathan Cameron15739cd2011-09-21 11:15:51 +010043What: /sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency
44What: /sys/bus/iio/devices/triggerX/sampling_frequency
Jonathan Camerone34d2c52010-05-04 14:43:05 +010045KernelVersion: 2.6.35
46Contact: linux-iio@vger.kernel.org
47Description:
48 Some devices have internal clocks. This parameter sets the
49 resulting sampling frequency. In many devices this
Peter Meerwald8b417d72012-06-12 15:31:27 +020050 parameter has an effect on input filters etc. rather than
Jonathan Camerone34d2c52010-05-04 14:43:05 +010051 simply controlling when the input is sampled. As this
Peter Meerwald8b417d72012-06-12 15:31:27 +020052 effects data ready triggers, hardware buffers and the sysfs
Jonathan Camerone34d2c52010-05-04 14:43:05 +010053 direct access interfaces, it may be found in any of the
54 relevant directories. If it effects all of the above
Jonathan Cameron15739cd2011-09-21 11:15:51 +010055 then it is to be found in the base device directory.
Jonathan Camerone34d2c52010-05-04 14:43:05 +010056
Jonathan Cameronb3874062011-08-30 12:32:49 +010057What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency_available
Jonathan Cameron15739cd2011-09-21 11:15:51 +010058What: /sys/.../iio:deviceX/buffer/sampling_frequency_available
59What: /sys/bus/iio/devices/triggerX/sampling_frequency_available
Jonathan Camerone34d2c52010-05-04 14:43:05 +010060KernelVersion: 2.6.35
61Contact: linux-iio@vger.kernel.org
62Description:
63 When the internal sampling clock can only take a small
Jonathan Cameronf386caa2010-11-22 23:31:16 +000064 discrete set of values, this file lists those available.
Jonathan Camerone34d2c52010-05-04 14:43:05 +010065
Jonathan Cameronb3874062011-08-30 12:32:49 +010066What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio
Michael Hennerichb9618c02011-02-22 21:46:18 +010067KernelVersion: 2.6.38
68Contact: linux-iio@vger.kernel.org
69Description:
70 Hardware dependent ADC oversampling. Controls the sampling ratio
71 of the digital filter if available.
72
Jonathan Cameronb3874062011-08-30 12:32:49 +010073What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available
Michael Hennerichb9618c02011-02-22 21:46:18 +010074KernelVersion: 2.6.38
75Contact: linux-iio@vger.kernel.org
76Description:
77 Hardware dependent values supported by the oversampling filter.
78
Jonathan Camerona37b5492011-09-02 17:14:35 +010079What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
80What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +020081What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_raw
82What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_raw
Jonathan Camerone34d2c52010-05-04 14:43:05 +010083KernelVersion: 2.6.35
84Contact: linux-iio@vger.kernel.org
85Description:
Peter Meerwald8b417d72012-06-12 15:31:27 +020086 Raw (unscaled no bias removal etc.) voltage measurement from
Jonathan Cameronf386caa2010-11-22 23:31:16 +000087 channel Y. In special cases where the channel does not
88 correspond to externally available input one of the named
89 versions may be used. The number must always be specified and
Jonathan Cameron15739cd2011-09-21 11:15:51 +010090 unique to allow association with event codes. Units after
Lars-Peter Clausenc2b2db72013-09-28 10:31:00 +010091 application of scale and offset are millivolts.
Jonathan Camerone34d2c52010-05-04 14:43:05 +010092
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +020093 Channels with 'i' and 'q' modifiers always exist in pairs and both
94 channels refer to the same signal. The 'i' channel contains the in-phase
95 component of the signal while the 'q' channel contains the quadrature
96 component.
97
Jonathan Camerona37b5492011-09-02 17:14:35 +010098What: /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw
Jonathan Camerone34d2c52010-05-04 14:43:05 +010099KernelVersion: 2.6.35
100Contact: linux-iio@vger.kernel.org
101Description:
102 Raw (unscaled) differential voltage measurement equivalent to
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000103 channel Y - channel Z where these channel numbers apply to the
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100104 physically equivalent inputs when non differential readings are
105 separately available. In differential only parts, then all that
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100106 is required is a consistent labeling. Units after application
Lars-Peter Clausenc2b2db72013-09-28 10:31:00 +0100107 of scale and offset are millivolts.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100108
Adam Thomson7f1c2cb2014-11-25 18:25:39 +0000109What: /sys/bus/iio/devices/iio:deviceX/in_currentY_raw
110What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_raw
111KernelVersion: 3.17
112Contact: linux-iio@vger.kernel.org
113Description:
114 Raw (unscaled no bias removal etc.) current measurement from
115 channel Y. In special cases where the channel does not
116 correspond to externally available input one of the named
117 versions may be used. The number must always be specified and
118 unique to allow association with event codes. Units after
119 application of scale and offset are milliamps.
120
Jonathan Cameron0baf29d2011-09-21 11:15:52 +0100121What: /sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw
122KernelVersion: 3.2
123Contact: linux-iio@vger.kernel.org
124Description:
125 Raw capacitance measurement from channel Y. Units after
126 application of scale and offset are nanofarads.
127
128What: /sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw
129KernelVersion: 3.2
130Contact: linux-iio@vger.kernel.org
131Description:
132 Raw differential capacitance measurement equivalent to
133 channel Y - channel Z where these channel numbers apply to the
134 physically equivalent inputs when non differential readings are
135 separately available. In differential only parts, then all that
136 is required is a consistent labeling. Units after application
Jonathan Cameron68284a12012-04-25 15:54:57 +0100137 of scale and offset are nanofarads.
Jonathan Cameron0baf29d2011-09-21 11:15:52 +0100138
Jonathan Camerona37b5492011-09-02 17:14:35 +0100139What: /sys/bus/iio/devices/iio:deviceX/in_temp_raw
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100140What: /sys/bus/iio/devices/iio:deviceX/in_tempX_raw
Jonathan Camerona37b5492011-09-02 17:14:35 +0100141What: /sys/bus/iio/devices/iio:deviceX/in_temp_x_raw
142What: /sys/bus/iio/devices/iio:deviceX/in_temp_y_raw
Peter Meerwald888c9c72014-02-05 16:57:00 +0000143What: /sys/bus/iio/devices/iio:deviceX/in_temp_ambient_raw
144What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_raw
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000145KernelVersion: 2.6.35
146Contact: linux-iio@vger.kernel.org
147Description:
Peter Meerwald8b417d72012-06-12 15:31:27 +0200148 Raw (unscaled no bias removal etc.) temperature measurement.
Jonathan Cameron68284a12012-04-25 15:54:57 +0100149 If an axis is specified it generally means that the temperature
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000150 sensor is associated with one part of a compound device (e.g.
Peter Meerwald888c9c72014-02-05 16:57:00 +0000151 a gyroscope axis). The ambient and object modifiers distinguish
152 between ambient (reference) and distant temperature for contact-
153 less measurements. Units after application of scale and offset
Peter Meerwaldcf655d22012-06-15 19:25:23 +0200154 are milli degrees Celsius.
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000155
Jonathan Camerona37b5492011-09-02 17:14:35 +0100156What: /sys/bus/iio/devices/iio:deviceX/in_tempX_input
Michael Hennerich7c31b982011-02-24 12:32:45 +0100157KernelVersion: 2.6.38
158Contact: linux-iio@vger.kernel.org
159Description:
160 Scaled temperature measurement in milli degrees Celsius.
161
Jonathan Camerona37b5492011-09-02 17:14:35 +0100162What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw
163What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_raw
164What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_raw
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100165KernelVersion: 2.6.35
166Contact: linux-iio@vger.kernel.org
167Description:
168 Acceleration in direction x, y or z (may be arbitrarily assigned
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100169 but should match other such assignments on device).
170 Has all of the equivalent parameters as per voltageY. Units
171 after application of scale and offset are m/s^2.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100172
Song Hongyan571299d2017-01-05 18:24:03 +0800173What: /sys/bus/iio/devices/iio:deviceX/in_gravity_x_raw
174What: /sys/bus/iio/devices/iio:deviceX/in_gravity_y_raw
175What: /sys/bus/iio/devices/iio:deviceX/in_gravity_z_raw
176KernelVersion: 4.11
177Contact: linux-iio@vger.kernel.org
178Description:
179 Gravity in direction x, y or z (may be arbitrarily assigned
180 but should match other such assignments on device).
181 Units after application of scale and offset are m/s^2.
182
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100183What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw
184What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw
185What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100186KernelVersion: 2.6.35
187Contact: linux-iio@vger.kernel.org
188Description:
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100189 Angular velocity about axis x, y or z (may be arbitrarily
Peter Meerwald8b417d72012-06-12 15:31:27 +0200190 assigned). Has all the equivalent parameters as per voltageY.
191 Units after application of scale and offset are radians per
192 second.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100193
Jonathan Camerona37b5492011-09-02 17:14:35 +0100194What: /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
195What: /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
196What: /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
Jonathan Camerone5107fb2010-05-07 15:38:57 +0100197KernelVersion: 2.6.35
198Contact: linux-iio@vger.kernel.org
199Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000200 Inclination raw reading about axis x, y or z (may be
201 arbitrarily assigned). Data converted by application of offset
Peter Meerwald8b417d72012-06-12 15:31:27 +0200202 and scale to degrees.
Jonathan Camerone5107fb2010-05-07 15:38:57 +0100203
Jonathan Camerona37b5492011-09-02 17:14:35 +0100204What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
205What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
206What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100207KernelVersion: 2.6.35
208Contact: linux-iio@vger.kernel.org
209Description:
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100210 Magnetic field along axis x, y or z (may be arbitrarily
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100211 assigned). Data converted by application of offset
212 then scale to Gauss.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100213
Jonathan Camerona37b5492011-09-02 17:14:35 +0100214What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
215What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
216What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000217KernelVersion: 2.6.36
218Contact: linux-iio@vger.kernel.org
219Description:
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100220 Highest value since some reset condition. These
221 attributes allow access to this and are otherwise
222 the direct equivalent of the <type>Y[_name]_raw attributes.
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000223
Jonathan Camerona37b5492011-09-02 17:14:35 +0100224What: /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000225KernelVersion: 2.6.36
226Contact: linux-iio@vger.kernel.org
227Description:
228 A computed peak value based on the sum squared magnitude of
229 the underlying value in the specified directions.
230
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000231What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_raw
232What: /sys/bus/iio/devices/iio:deviceX/in_pressure_raw
233KernelVersion: 3.8
234Contact: linux-iio@vger.kernel.org
235Description:
236 Raw pressure measurement from channel Y. Units after
237 application of scale and offset are kilopascal.
238
Vlad Dogaruc22e15f2014-10-13 14:53:00 +0100239What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_input
240What: /sys/bus/iio/devices/iio:deviceX/in_pressure_input
241KernelVersion: 3.8
242Contact: linux-iio@vger.kernel.org
243Description:
244 Scaled pressure measurement from channel Y, in kilopascal.
245
Harald Geyerac216aa2013-12-01 15:08:00 +0000246What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_raw
247KernelVersion: 3.14
248Contact: linux-iio@vger.kernel.org
249Description:
250 Raw humidity measurement of air. Units after application of
251 scale and offset are milli percent.
252
253What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_input
254KernelVersion: 3.14
255Contact: linux-iio@vger.kernel.org
256Description:
257 Scaled humidity measurement in milli percent.
258
Sebastian Reichelc0a6b7e2014-10-03 17:25:00 +0100259What: /sys/bus/iio/devices/iio:deviceX/in_X_mean_raw
260KernelVersion: 3.5
261Contact: linux-iio@vger.kernel.org
262Description:
263 Averaged raw measurement from channel X. The number of values
264 used for averaging is device specific. The converting rules for
265 normal raw values also applies to the averaged raw values.
266
Jonathan Camerona37b5492011-09-02 17:14:35 +0100267What: /sys/bus/iio/devices/iio:deviceX/in_accel_offset
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100268What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
269What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
270What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
271What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
272What: /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200273What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_offset
274What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_offset
275What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_offset
276What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_offset
Adam Thomson7f1c2cb2014-11-25 18:25:39 +0000277What: /sys/bus/iio/devices/iio:deviceX/in_currentY_offset
278What: /sys/bus/iio/devices/iio:deviceX/in_current_offset
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200279What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_offset
280What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_offset
281What: /sys/bus/iio/devices/iio:deviceX/in_current_q_offset
282What: /sys/bus/iio/devices/iio:deviceX/in_current_i_offset
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100283What: /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
Jonathan Camerona37b5492011-09-02 17:14:35 +0100284What: /sys/bus/iio/devices/iio:deviceX/in_temp_offset
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000285What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_offset
286What: /sys/bus/iio/devices/iio:deviceX/in_pressure_offset
Roberta Dobrescu4d5ce6b2014-10-23 12:44:00 +0100287What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_offset
Darshana Padmadasd5d7c4a2015-03-13 21:06:58 +0530288What: /sys/bus/iio/devices/iio:deviceX/in_magn_offset
Haneen Mohammed8ea06892015-03-28 03:02:39 +0300289What: /sys/bus/iio/devices/iio:deviceX/in_rot_offset
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100290KernelVersion: 2.6.35
291Contact: linux-iio@vger.kernel.org
292Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000293 If known for a device, offset to be added to <type>[Y]_raw prior
294 to scaling by <type>[Y]_scale in order to obtain value in the
Peter Meerwald8b417d72012-06-12 15:31:27 +0200295 <type> units as specified in <type>[Y]_raw documentation.
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100296 Not present if the offset is always 0 or unknown. If Y or
297 axis <x|y|z> is not present, then the offset applies to all
298 in channels of <type>.
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000299 May be writable if a variable offset can be applied on the
300 device. Note that this is different to calibbias which
301 is for devices (or drivers) that apply offsets to compensate
302 for variation between different instances of the part, typically
303 adjusted by using some hardware supported calibration procedure.
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100304 Calibbias is applied internally, offset is applied in userspace
305 to the _raw output.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100306
Jonathan Camerona37b5492011-09-02 17:14:35 +0100307What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200308What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_scale
309What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_scale
Jonathan Camerona37b5492011-09-02 17:14:35 +0100310What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
311What: /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200312What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_scale
313What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_scale
Darshana Padmadas4e4cd142014-11-05 21:48:11 +0530314What: /sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_scale
Jonathan Camerona37b5492011-09-02 17:14:35 +0100315What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
Michael Hennerichd802bf62012-05-21 14:30:31 +0200316What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale
Adam Thomson7f1c2cb2014-11-25 18:25:39 +0000317What: /sys/bus/iio/devices/iio:deviceX/in_currentY_scale
318What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_scale
319What: /sys/bus/iio/devices/iio:deviceX/in_current_scale
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200320What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_scale
321What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_scale
322What: /sys/bus/iio/devices/iio:deviceX/in_current_i_scale
323What: /sys/bus/iio/devices/iio:deviceX/in_current_q_scale
Jonathan Camerona37b5492011-09-02 17:14:35 +0100324What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale
325What: /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100326What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale
Irina Tirdea72c66642015-01-11 21:10:07 +0200327What: /sys/bus/iio/devices/iio:deviceX/in_energy_scale
Irina Tirdeacc3c9ee2015-01-11 21:10:08 +0200328What: /sys/bus/iio/devices/iio:deviceX/in_distance_scale
Jonathan Camerona37b5492011-09-02 17:14:35 +0100329What: /sys/bus/iio/devices/iio:deviceX/in_magn_scale
330What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
331What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
332What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
Reyad Attiyatb531db82014-07-17 19:18:00 +0100333What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_scale
334What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_scale
335What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_scale
336What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_scale
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000337What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_scale
338What: /sys/bus/iio/devices/iio:deviceX/in_pressure_scale
Roberta Dobrescu4d5ce6b2014-10-23 12:44:00 +0100339What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_scale
Irina Tirdea5a1a9322015-01-11 21:10:09 +0200340What: /sys/bus/iio/devices/iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_scale
Darshana Padmadas7cf78db2015-03-16 17:18:20 +0530341What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_scale
William Breathitt Gray1a8f3242016-09-28 13:59:49 -0400342What: /sys/bus/iio/devices/iio:deviceX/in_countY_scale
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100343KernelVersion: 2.6.35
344Contact: linux-iio@vger.kernel.org
345Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000346 If known for a device, scale to be applied to <type>Y[_name]_raw
347 post addition of <type>[Y][_name]_offset in order to obtain the
348 measured value in <type> units as specified in
Jonathan Cameron68284a12012-04-25 15:54:57 +0100349 <type>[Y][_name]_raw documentation. If shared across all in
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100350 channels then Y and <x|y|z> are not present and the value is
351 called <type>[Y][_name]_scale. The peak modifier means this
352 value is applied to <type>Y[_name]_peak_raw values.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100353
Jonathan Camerona37b5492011-09-02 17:14:35 +0100354What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
355What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
356What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100357What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias
358What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
359What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
Jon Brenner3c97c082012-04-24 11:56:49 -0500360What: /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
361What: /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000362What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibbias
363What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibbias
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000364KernelVersion: 2.6.35
365Contact: linux-iio@vger.kernel.org
366Description:
Peter Meerwald8b417d72012-06-12 15:31:27 +0200367 Hardware applied calibration offset (assumed to fix production
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100368 inaccuracies).
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100369
Jonathan Camerona37b5492011-09-02 17:14:35 +0100370What /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
371What /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200372What /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_calibscale
373What /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_calibscale
374What /sys/bus/iio/devices/iio:deviceX/in_voltage_i_calibscale
375What /sys/bus/iio/devices/iio:deviceX/in_voltage_q_calibscale
Jonathan Camerona37b5492011-09-02 17:14:35 +0100376What /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
377What /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
378What /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
379What /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100380What /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
381What /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
382What /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
Jon Brenner3c97c082012-04-24 11:56:49 -0500383what /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
384what /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000385What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibscale
386What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibscale
Darshana Padmadas7cf78db2015-03-16 17:18:20 +0530387What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_calibscale
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000388KernelVersion: 2.6.35
389Contact: linux-iio@vger.kernel.org
390Description:
Peter Meerwald8b417d72012-06-12 15:31:27 +0200391 Hardware applied calibration scale factor (assumed to fix
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000392 production inaccuracies). If shared across all channels,
393 <type>_calibscale is used.
394
Irina Tirdea40cb7612015-01-29 18:45:10 +0000395What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender
396What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender
397What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender
398What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender
Irina Tirdeae0631a32015-03-30 14:22:13 +0300399KernelVersion: 4.0
Irina Tirdea40cb7612015-01-29 18:45:10 +0000400Contact: linux-iio@vger.kernel.org
401Description:
402 Gender of the user (e.g.: male, female) used by some pedometers
403 to compute the stride length, distance, speed and activity
404 type.
405
406What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender_available
407What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender_available
408What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender_available
409What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender_available
Irina Tirdeae0631a32015-03-30 14:22:13 +0300410KernelVersion: 4.0
Irina Tirdea40cb7612015-01-29 18:45:10 +0000411Contact: linux-iio@vger.kernel.org
412Description:
413 Lists all available gender values (e.g.: male, female).
414
415What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibheight
416What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibheight
417What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibheight
418What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibheight
Irina Tirdeabcdf28f2014-11-10 14:45:33 +0200419KernelVersion: 3.19
420Contact: linux-iio@vger.kernel.org
421Description:
Irina Tirdea81110932015-01-27 20:41:53 +0200422 Height of the user (in meters) used by some pedometers
Irina Tirdeabcdf28f2014-11-10 14:45:33 +0200423 to compute the stride length, distance, speed and activity
424 type.
425
Irina Tirdead37f6832015-01-11 21:10:10 +0200426What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibweight
Irina Tirdeae0631a32015-03-30 14:22:13 +0300427KernelVersion: 4.0
Irina Tirdead37f6832015-01-11 21:10:10 +0200428Contact: linux-iio@vger.kernel.org
429Description:
430 Weight of the user (in kg). It is needed by some pedometers
431 to compute the calories burnt by the user.
432
Jonathan Camerona37b5492011-09-02 17:14:35 +0100433What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
Adriana Reusad376162015-06-12 19:01:07 +0300434What: /sys/.../iio:deviceX/in_anglvel_scale_available
435What: /sys/.../iio:deviceX/in_magn_scale_available
436What: /sys/.../iio:deviceX/in_illuminance_scale_available
437What: /sys/.../iio:deviceX/in_intensity_scale_available
438What: /sys/.../iio:deviceX/in_proximity_scale_available
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100439What: /sys/.../iio:deviceX/in_voltageX_scale_available
440What: /sys/.../iio:deviceX/in_voltage-voltage_scale_available
441What: /sys/.../iio:deviceX/out_voltageX_scale_available
Michael Hennerichd802bf62012-05-21 14:30:31 +0200442What: /sys/.../iio:deviceX/out_altvoltageX_scale_available
Jonathan Cameron0baf29d2011-09-21 11:15:52 +0100443What: /sys/.../iio:deviceX/in_capacitance_scale_available
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000444What: /sys/.../iio:deviceX/in_pressure_scale_available
445What: /sys/.../iio:deviceX/in_pressureY_scale_available
Peter Meerwaldcf09fe92012-07-01 12:20:11 +0200446KernelVersion: 2.6.35
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000447Contact: linux-iio@vger.kernel.org
448Description:
Peter Meerwald8b417d72012-06-12 15:31:27 +0200449 If a discrete set of scale values is available, they
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000450 are listed in this attribute.
451
Michael Hennerichb65d6212012-05-11 11:36:53 +0200452What /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
Roberta Dobrescued563302014-10-24 22:41:00 +0100453What: /sys/bus/iio/devices/iio:deviceX/in_intensity_red_hardwaregain
454What: /sys/bus/iio/devices/iio:deviceX/in_intensity_green_hardwaregain
455What: /sys/bus/iio/devices/iio:deviceX/in_intensity_blue_hardwaregain
456What: /sys/bus/iio/devices/iio:deviceX/in_intensity_clear_hardwaregain
Michael Hennerichb65d6212012-05-11 11:36:53 +0200457KernelVersion: 2.6.35
458Contact: linux-iio@vger.kernel.org
459Description:
460 Hardware applied gain factor. If shared across all channels,
461 <type>_hardwaregain is used.
462
Jonathan Cameron0c22db4392011-11-27 11:39:14 +0000463What: /sys/.../in_accel_filter_low_pass_3db_frequency
464What: /sys/.../in_magn_filter_low_pass_3db_frequency
465What: /sys/.../in_anglvel_filter_low_pass_3db_frequency
466KernelVersion: 3.2
467Contact: linux-iio@vger.kernel.org
468Description:
469 If a known or controllable low pass filter is applied
470 to the underlying data channel, then this parameter
471 gives the 3dB frequency of the filter in Hz.
472
Martin Fuzzey3f7f6422015-05-13 12:26:42 +0200473What: /sys/.../in_accel_filter_high_pass_3db_frequency
474What: /sys/.../in_anglvel_filter_high_pass_3db_frequency
475What: /sys/.../in_magn_filter_high_pass_3db_frequency
476KernelVersion: 4.2
477Contact: linux-iio@vger.kernel.org
478Description:
479 If a known or controllable high pass filter is applied
480 to the underlying data channel, then this parameter
481 gives the 3dB frequency of the filter in Hz.
482
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100483What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
Michael Hennerichd802bf62012-05-21 14:30:31 +0200484What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw
Roland Stigge98069c32011-01-13 17:43:29 +0100485KernelVersion: 2.6.37
486Contact: linux-iio@vger.kernel.org
487Description:
488 Raw (unscaled, no bias etc.) output voltage for
489 channel Y. The number must always be specified and
490 unique if the output corresponds to a single channel.
Michael Hennerichd802bf62012-05-21 14:30:31 +0200491 While DAC like devices typically use out_voltage,
492 a continuous frequency generating device, such as
493 a DDS or PLL should use out_altvoltage.
Roland Stigge98069c32011-01-13 17:43:29 +0100494
Jonathan Camerona37b5492011-09-02 17:14:35 +0100495What: /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
Michael Hennerichd802bf62012-05-21 14:30:31 +0200496What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw
Roland Stigge98069c32011-01-13 17:43:29 +0100497KernelVersion: 2.6.37
498Contact: linux-iio@vger.kernel.org
499Description:
500 Raw (unscaled, no bias etc.) output voltage for an aggregate of
501 channel Y, channel Z, etc. This interface is available in cases
502 where a single output sets the value for multiple channels
503 simultaneously.
504
Jonathan Camerona37b5492011-09-02 17:14:35 +0100505What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
506What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
Michael Hennerichd802bf62012-05-21 14:30:31 +0200507What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode
508What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode
Michael Hennerich14f88f12011-03-09 16:01:45 +0100509KernelVersion: 2.6.38
510Contact: linux-iio@vger.kernel.org
511Description:
512 Specifies the output powerdown mode.
513 DAC output stage is disconnected from the amplifier and
Vladimir Barinovbdb25b02015-07-29 15:57:41 +0300514 1kohm_to_gnd: connected to ground via an 1kOhm resistor,
Peter Meerwald8b417d72012-06-12 15:31:27 +0200515 6kohm_to_gnd: connected to ground via a 6kOhm resistor,
516 20kohm_to_gnd: connected to ground via a 20kOhm resistor,
Marc Andre8d144c92016-02-08 18:01:47 +0100517 90kohm_to_gnd: connected to ground via a 90kOhm resistor,
Peter Meerwald8b417d72012-06-12 15:31:27 +0200518 100kohm_to_gnd: connected to ground via an 100kOhm resistor,
Akinobu Mita35f73962015-12-26 21:17:22 +0900519 125kohm_to_gnd: connected to ground via an 125kOhm resistor,
Peter Meerwaldbd53a412013-06-23 22:30:00 +0100520 500kohm_to_gnd: connected to ground via a 500kOhm resistor,
Akinobu Mita35f73962015-12-26 21:17:22 +0900521 640kohm_to_gnd: connected to ground via a 640kOhm resistor,
Peter Meerwald8b417d72012-06-12 15:31:27 +0200522 three_state: left floating.
Michael Hennerich14f88f12011-03-09 16:01:45 +0100523 For a list of available output power down options read
524 outX_powerdown_mode_available. If Y is not present the
525 mode is shared across all outputs.
526
Vladimir Barinovbdb25b02015-07-29 15:57:41 +0300527What: /sys/.../iio:deviceX/out_voltageY_powerdown_mode_available
Jonathan Camerona37b5492011-09-02 17:14:35 +0100528What: /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
Vladimir Barinovbdb25b02015-07-29 15:57:41 +0300529What: /sys/.../iio:deviceX/out_altvoltageY_powerdown_mode_available
Michael Hennerichd802bf62012-05-21 14:30:31 +0200530What: /sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available
Michael Hennerich14f88f12011-03-09 16:01:45 +0100531KernelVersion: 2.6.38
532Contact: linux-iio@vger.kernel.org
533Description:
534 Lists all available output power down modes.
535 If Y is not present the mode is shared across all outputs.
536
Jonathan Camerona37b5492011-09-02 17:14:35 +0100537What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
538What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
Michael Hennerichd802bf62012-05-21 14:30:31 +0200539What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
540What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown
Michael Hennerich14f88f12011-03-09 16:01:45 +0100541KernelVersion: 2.6.38
542Contact: linux-iio@vger.kernel.org
543Description:
544 Writing 1 causes output Y to enter the power down mode specified
Peter Meerwald8b417d72012-06-12 15:31:27 +0200545 by the corresponding outY_powerdown_mode. DAC output stage is
546 disconnected from the amplifier. Clearing returns to normal
547 operation. Y may be suppressed if all outputs are controlled
548 together.
Michael Hennerich14f88f12011-03-09 16:01:45 +0100549
Michael Hennerichd802bf62012-05-21 14:30:31 +0200550What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency
551KernelVersion: 3.4.0
552Contact: linux-iio@vger.kernel.org
553Description:
554 Output frequency for channel Y in Hz. The number must always be
555 specified and unique if the output corresponds to a single
556 channel.
557
558What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase
559KernelVersion: 3.4.0
560Contact: linux-iio@vger.kernel.org
561Description:
562 Phase in radians of one frequency/clock output Y
563 (out_altvoltageY) relative to another frequency/clock output
564 (out_altvoltageZ) of the device X. The number must always be
565 specified and unique if the output corresponds to a single
566 channel.
567
Jonathan Cameronb3874062011-08-30 12:32:49 +0100568What: /sys/bus/iio/devices/iio:deviceX/events
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000569KernelVersion: 2.6.35
570Contact: linux-iio@vger.kernel.org
571Description:
572 Configuration of which hardware generated events are passed up
573 to user-space.
574
Jonathan Camerona37b5492011-09-02 17:14:35 +0100575What: /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
576What: /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
577What: /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
578What: /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
579What: /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
580What: /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100581What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
582What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
583What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
584What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
585What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
586What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
Jonathan Camerona37b5492011-09-02 17:14:35 +0100587What: /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
588What: /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
589What: /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
590What: /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
591What: /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
592What: /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
Reyad Attiyatb531db82014-07-17 19:18:00 +0100593What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_rising_en
594What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_falling_en
595What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_rising_en
596What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_falling_en
597What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_en
598What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_en
599What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_rising_en
600What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_falling_en
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100601What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
602What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
603What: /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
604What: /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
Vladimir Barinov72aa29c2015-08-28 17:27:52 +0300605What: /sys/.../iio:deviceX/events/in_voltageY_thresh_either_en
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100606What: /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
607What: /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100608KernelVersion: 2.6.37
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100609Contact: linux-iio@vger.kernel.org
610Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000611 Event generated when channel passes a threshold in the specified
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100612 (_rising|_falling) direction. If the direction is not specified,
613 then either the device will report an event which ever direction
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100614 a single threshold value is passed in (e.g.
615 <type>[Y][_name]_<raw|input>_thresh_value) or
616 <type>[Y][_name]_<raw|input>_thresh_rising_value and
617 <type>[Y][_name]_<raw|input>_thresh_falling_value may take
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000618 different values, but the device can only enable both thresholds
619 or neither.
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100620 Note the driver will assume the last p events requested are
Peter Meerwald8b417d72012-06-12 15:31:27 +0200621 to be enabled where p is how many it supports (which may vary
622 depending on the exact set requested. So if you want to be
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100623 sure you have set what you think you have, check the contents of
624 these attributes after everything is configured. Drivers may
625 have to buffer any parameters so that they are consistent when
Peter Meerwald8b417d72012-06-12 15:31:27 +0200626 a given event type is enabled at a future point (and not those for
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100627 whatever event was previously enabled).
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100628
Jonathan Camerona37b5492011-09-02 17:14:35 +0100629What: /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
630What: /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
631What: /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
632What: /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
633What: /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
634What: /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100635What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
636What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
637What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
638What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
639What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
640What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
Jonathan Camerona37b5492011-09-02 17:14:35 +0100641What: /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
642What: /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
643What: /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
644What: /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
645What: /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
646What: /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
Reyad Attiyatb531db82014-07-17 19:18:00 +0100647What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_rising_en
648What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_falling_en
649What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_rising_en
650What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_falling_en
651What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_rising_en
652What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_falling_en
653What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_rising_en
654What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_falling_en
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100655What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
656What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
657What: /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
658What: /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
659What: /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
660What: /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000661KernelVersion: 2.6.37
662Contact: linux-iio@vger.kernel.org
663Description:
664 Event generated when channel passes a threshold on the rate of
665 change (1st differential) in the specified (_rising|_falling)
666 direction. If the direction is not specified, then either the
667 device will report an event which ever direction a single
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100668 threshold value is passed in (e.g.
669 <type>[Y][_name]_<raw|input>_roc_value) or
670 <type>[Y][_name]_<raw|input>_roc_rising_value and
671 <type>[Y][_name]_<raw|input>_roc_falling_value may take
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000672 different values, but the device can only enable both rate of
673 change thresholds or neither.
674 Note the driver will assume the last p events requested are
675 to be enabled where p is however many it supports (which may
676 vary depending on the exact set requested. So if you want to be
677 sure you have set what you think you have, check the contents of
678 these attributes after everything is configured. Drivers may
679 have to buffer any parameters so that they are consistent when
680 a given event type is enabled a future point (and not those for
681 whatever event was previously enabled).
682
Haneen Mohammed40dbbfb2015-03-12 21:26:00 +0300683What: /sys/.../events/in_accel_thresh_rising_value
684What: /sys/.../events/in_accel_thresh_falling_value
Jonathan Camerona37b5492011-09-02 17:14:35 +0100685What: /sys/.../events/in_accel_x_raw_thresh_rising_value
686What: /sys/.../events/in_accel_x_raw_thresh_falling_value
687What: /sys/.../events/in_accel_y_raw_thresh_rising_value
688What: /sys/.../events/in_accel_y_raw_thresh_falling_value
689What: /sys/.../events/in_accel_z_raw_thresh_rising_value
690What: /sys/.../events/in_accel_z_raw_thresh_falling_value
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100691What: /sys/.../events/in_anglvel_x_raw_thresh_rising_value
692What: /sys/.../events/in_anglvel_x_raw_thresh_falling_value
693What: /sys/.../events/in_anglvel_y_raw_thresh_rising_value
694What: /sys/.../events/in_anglvel_y_raw_thresh_falling_value
695What: /sys/.../events/in_anglvel_z_raw_thresh_rising_value
696What: /sys/.../events/in_anglvel_z_raw_thresh_falling_value
Jonathan Camerona37b5492011-09-02 17:14:35 +0100697What: /sys/.../events/in_magn_x_raw_thresh_rising_value
698What: /sys/.../events/in_magn_x_raw_thresh_falling_value
699What: /sys/.../events/in_magn_y_raw_thresh_rising_value
700What: /sys/.../events/in_magn_y_raw_thresh_falling_value
701What: /sys/.../events/in_magn_z_raw_thresh_rising_value
702What: /sys/.../events/in_magn_z_raw_thresh_falling_value
Reyad Attiyatb531db82014-07-17 19:18:00 +0100703What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_rising_value
704What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_falling_value
705What: /sys/.../events/in_rot_from_north_true_raw_thresh_rising_value
706What: /sys/.../events/in_rot_from_north_true_raw_thresh_falling_value
707What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_rising_value
708What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_falling_value
709What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_rising_value
710What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_falling_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100711What: /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
712What: /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
Jonathan Camerona7322fc2012-04-13 10:24:19 +0100713What: /sys/.../events/in_voltageY_raw_thresh_rising_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100714What: /sys/.../events/in_voltageY_raw_thresh_falling_value
Jonathan Camerona7322fc2012-04-13 10:24:19 +0100715What: /sys/.../events/in_tempY_raw_thresh_rising_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100716What: /sys/.../events/in_tempY_raw_thresh_falling_value
Jon Brenner3c97c082012-04-24 11:56:49 -0500717What: /sys/.../events/in_illuminance0_thresh_falling_value
718what: /sys/.../events/in_illuminance0_thresh_rising_value
719what: /sys/.../events/in_proximity0_thresh_falling_value
720what: /sys/.../events/in_proximity0_thresh_rising_value
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100721KernelVersion: 2.6.37
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100722Contact: linux-iio@vger.kernel.org
723Description:
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100724 Specifies the value of threshold that the device is comparing
725 against for the events enabled by
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100726 <type>Y[_name]_thresh[_rising|falling]_en.
727 If separate attributes exist for the two directions, but
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000728 direction is not specified for this attribute, then a single
729 threshold value applies to both directions.
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100730 The raw or input element of the name indicates whether the
731 value is in raw device units or in processed units (as _raw
732 and _input do on sysfs direct channel read attributes).
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100733
Martin Fuzzeyd1bd4862015-02-19 15:16:04 +0100734What: /sys/.../events/in_accel_scale
735What: /sys/.../events/in_accel_peak_scale
736What: /sys/.../events/in_anglvel_scale
737What: /sys/.../events/in_magn_scale
738What: /sys/.../events/in_rot_from_north_magnetic_scale
739What: /sys/.../events/in_rot_from_north_true_scale
740What: /sys/.../events/in_voltage_scale
741What: /sys/.../events/in_voltage_supply_scale
742What: /sys/.../events/in_temp_scale
743What: /sys/.../events/in_illuminance_scale
744What: /sys/.../events/in_proximity_scale
745KernelVersion: 3.21
746Contact: linux-iio@vger.kernel.org
747Description:
748 Specifies the conversion factor from the standard units
749 to device specific units used to set the event trigger
750 threshold.
751
Lars-Peter Clausenec6670a2013-10-07 15:11:00 +0100752What: /sys/.../events/in_accel_x_thresh_rising_hysteresis
753What: /sys/.../events/in_accel_x_thresh_falling_hysteresis
754What: /sys/.../events/in_accel_x_thresh_either_hysteresis
755What: /sys/.../events/in_accel_y_thresh_rising_hysteresis
756What: /sys/.../events/in_accel_y_thresh_falling_hysteresis
757What: /sys/.../events/in_accel_y_thresh_either_hysteresis
758What: /sys/.../events/in_accel_z_thresh_rising_hysteresis
759What: /sys/.../events/in_accel_z_thresh_falling_hysteresis
760What: /sys/.../events/in_accel_z_thresh_either_hysteresis
761What: /sys/.../events/in_anglvel_x_thresh_rising_hysteresis
762What: /sys/.../events/in_anglvel_x_thresh_falling_hysteresis
763What: /sys/.../events/in_anglvel_x_thresh_either_hysteresis
764What: /sys/.../events/in_anglvel_y_thresh_rising_hysteresis
765What: /sys/.../events/in_anglvel_y_thresh_falling_hysteresis
766What: /sys/.../events/in_anglvel_y_thresh_either_hysteresis
767What: /sys/.../events/in_anglvel_z_thresh_rising_hysteresis
768What: /sys/.../events/in_anglvel_z_thresh_falling_hysteresis
769What: /sys/.../events/in_anglvel_z_thresh_either_hysteresis
770What: /sys/.../events/in_magn_x_thresh_rising_hysteresis
771What: /sys/.../events/in_magn_x_thresh_falling_hysteresis
772What: /sys/.../events/in_magn_x_thresh_either_hysteresis
773What: /sys/.../events/in_magn_y_thresh_rising_hysteresis
774What: /sys/.../events/in_magn_y_thresh_falling_hysteresis
775What: /sys/.../events/in_magn_y_thresh_either_hysteresis
776What: /sys/.../events/in_magn_z_thresh_rising_hysteresis
777What: /sys/.../events/in_magn_z_thresh_falling_hysteresis
778What: /sys/.../events/in_magn_z_thresh_either_hysteresis
Reyad Attiyatb531db82014-07-17 19:18:00 +0100779What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_hysteresis
780What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_hysteresis
781What: /sys/.../events/in_rot_from_north_magnetic_thresh_either_hysteresis
782What: /sys/.../events/in_rot_from_north_true_thresh_rising_hysteresis
783What: /sys/.../events/in_rot_from_north_true_thresh_falling_hysteresis
784What: /sys/.../events/in_rot_from_north_true_thresh_either_hysteresis
785What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_hysteresis
786What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_hysteresis
787What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_either_hysteresis
788What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_hysteresis
789What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_hysteresis
790What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_either_hysteresis
Lars-Peter Clausenec6670a2013-10-07 15:11:00 +0100791What: /sys/.../events/in_voltageY_thresh_rising_hysteresis
792What: /sys/.../events/in_voltageY_thresh_falling_hysteresis
793What: /sys/.../events/in_voltageY_thresh_either_hysteresis
794What: /sys/.../events/in_tempY_thresh_rising_hysteresis
795What: /sys/.../events/in_tempY_thresh_falling_hysteresis
796What: /sys/.../events/in_tempY_thresh_either_hysteresis
797What: /sys/.../events/in_illuminance0_thresh_falling_hysteresis
798what: /sys/.../events/in_illuminance0_thresh_rising_hysteresis
799what: /sys/.../events/in_illuminance0_thresh_either_hysteresis
800what: /sys/.../events/in_proximity0_thresh_falling_hysteresis
801what: /sys/.../events/in_proximity0_thresh_rising_hysteresis
802what: /sys/.../events/in_proximity0_thresh_either_hysteresis
803KernelVersion: 3.13
804Contact: linux-iio@vger.kernel.org
805Description:
806 Specifies the hysteresis of threshold that the device is comparing
807 against for the events enabled by
808 <type>Y[_name]_thresh[_(rising|falling)]_hysteresis.
809 If separate attributes exist for the two directions, but
810 direction is not specified for this attribute, then a single
811 hysteresis value applies to both directions.
812 For falling events the hysteresis is added to the _value attribute for
813 this event to get the upper threshold for when the event goes back to
814 normal, for rising events the hysteresis is subtracted from the _value
815 attribute. E.g. if in_voltage0_raw_thresh_rising_value is set to 1200
816 and in_voltage0_raw_thresh_rising_hysteresis is set to 50. The event
817 will get activated once in_voltage0_raw goes above 1200 and will become
Colin Ian Kingf792e352016-12-28 17:40:23 +0000818 deactivated again once the value falls below 1150.
Lars-Peter Clausenec6670a2013-10-07 15:11:00 +0100819
Jonathan Camerona37b5492011-09-02 17:14:35 +0100820What: /sys/.../events/in_accel_x_raw_roc_rising_value
821What: /sys/.../events/in_accel_x_raw_roc_falling_value
822What: /sys/.../events/in_accel_y_raw_roc_rising_value
823What: /sys/.../events/in_accel_y_raw_roc_falling_value
824What: /sys/.../events/in_accel_z_raw_roc_rising_value
825What: /sys/.../events/in_accel_z_raw_roc_falling_value
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100826What: /sys/.../events/in_anglvel_x_raw_roc_rising_value
827What: /sys/.../events/in_anglvel_x_raw_roc_falling_value
828What: /sys/.../events/in_anglvel_y_raw_roc_rising_value
829What: /sys/.../events/in_anglvel_y_raw_roc_falling_value
830What: /sys/.../events/in_anglvel_z_raw_roc_rising_value
831What: /sys/.../events/in_anglvel_z_raw_roc_falling_value
Jonathan Camerona37b5492011-09-02 17:14:35 +0100832What: /sys/.../events/in_magn_x_raw_roc_rising_value
833What: /sys/.../events/in_magn_x_raw_roc_falling_value
834What: /sys/.../events/in_magn_y_raw_roc_rising_value
835What: /sys/.../events/in_magn_y_raw_roc_falling_value
836What: /sys/.../events/in_magn_z_raw_roc_rising_value
837What: /sys/.../events/in_magn_z_raw_roc_falling_value
Reyad Attiyatb531db82014-07-17 19:18:00 +0100838What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_rising_value
839What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_falling_value
840What: /sys/.../events/in_rot_from_north_true_raw_roc_rising_value
841What: /sys/.../events/in_rot_from_north_true_raw_roc_falling_value
842What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_rising_value
843What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_falling_value
844What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_rising_value
845What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_falling_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100846What: /sys/.../events/in_voltageY_supply_raw_roc_rising_value
847What: /sys/.../events/in_voltageY_supply_raw_roc_falling_value
Jonathan Camerona7322fc2012-04-13 10:24:19 +0100848What: /sys/.../events/in_voltageY_raw_roc_rising_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100849What: /sys/.../events/in_voltageY_raw_roc_falling_value
Jonathan Camerona7322fc2012-04-13 10:24:19 +0100850What: /sys/.../events/in_tempY_raw_roc_rising_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100851What: /sys/.../events/in_tempY_raw_roc_falling_value
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100852KernelVersion: 2.6.37
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100853Contact: linux-iio@vger.kernel.org
854Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000855 Specifies the value of rate of change threshold that the
856 device is comparing against for the events enabled by
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100857 <type>[Y][_name]_roc[_rising|falling]_en.
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000858 If separate attributes exist for the two directions,
859 but direction is not specified for this attribute,
860 then a single threshold value applies to both directions.
861 The raw or input element of the name indicates whether the
862 value is in raw device units or in processed units (as _raw
863 and _input do on sysfs direct channel read attributes).
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100864
Jonathan Camerona37b5492011-09-02 17:14:35 +0100865What: /sys/.../events/in_accel_x_thresh_rising_period
866What: /sys/.../events/in_accel_x_thresh_falling_period
Martin Kepplinger5798cd22015-03-29 01:59:49 +0100867What: /sys/.../events/in_accel_x_roc_rising_period
Jonathan Camerona37b5492011-09-02 17:14:35 +0100868What: /sys/.../events/in_accel_x_roc_falling_period
869What: /sys/.../events/in_accel_y_thresh_rising_period
870What: /sys/.../events/in_accel_y_thresh_falling_period
871What: /sys/.../events/in_accel_y_roc_rising_period
872What: /sys/.../events/in_accel_y_roc_falling_period
873What: /sys/.../events/in_accel_z_thresh_rising_period
874What: /sys/.../events/in_accel_z_thresh_falling_period
875What: /sys/.../events/in_accel_z_roc_rising_period
876What: /sys/.../events/in_accel_z_roc_falling_period
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100877What: /sys/.../events/in_anglvel_x_thresh_rising_period
878What: /sys/.../events/in_anglvel_x_thresh_falling_period
879What: /sys/.../events/in_anglvel_x_roc_rising_period
880What: /sys/.../events/in_anglvel_x_roc_falling_period
881What: /sys/.../events/in_anglvel_y_thresh_rising_period
882What: /sys/.../events/in_anglvel_y_thresh_falling_period
883What: /sys/.../events/in_anglvel_y_roc_rising_period
884What: /sys/.../events/in_anglvel_y_roc_falling_period
885What: /sys/.../events/in_anglvel_z_thresh_rising_period
886What: /sys/.../events/in_anglvel_z_thresh_falling_period
887What: /sys/.../events/in_anglvel_z_roc_rising_period
888What: /sys/.../events/in_anglvel_z_roc_falling_period
Jonathan Camerona37b5492011-09-02 17:14:35 +0100889What: /sys/.../events/in_magn_x_thresh_rising_period
890What: /sys/.../events/in_magn_x_thresh_falling_period
891What: /sys/.../events/in_magn_x_roc_rising_period
892What: /sys/.../events/in_magn_x_roc_falling_period
893What: /sys/.../events/in_magn_y_thresh_rising_period
894What: /sys/.../events/in_magn_y_thresh_falling_period
895What: /sys/.../events/in_magn_y_roc_rising_period
896What: /sys/.../events/in_magn_y_roc_falling_period
897What: /sys/.../events/in_magn_z_thresh_rising_period
898What: /sys/.../events/in_magn_z_thresh_falling_period
899What: /sys/.../events/in_magn_z_roc_rising_period
900What: /sys/.../events/in_magn_z_roc_falling_period
Reyad Attiyatb531db82014-07-17 19:18:00 +0100901What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_period
902What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_period
903What: /sys/.../events/in_rot_from_north_magnetic_roc_rising_period
904What: /sys/.../events/in_rot_from_north_magnetic_roc_falling_period
905What: /sys/.../events/in_rot_from_north_true_thresh_rising_period
906What: /sys/.../events/in_rot_from_north_true_thresh_falling_period
907What: /sys/.../events/in_rot_from_north_true_roc_rising_period
908What: /sys/.../events/in_rot_from_north_true_roc_falling_period
909What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_period
910What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_period
911What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_rising_period
912What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_falling_period
913What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_period
914What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_period
915What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_rising_period
916What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_falling_period
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100917What: /sys/.../events/in_voltageY_supply_thresh_rising_period
918What: /sys/.../events/in_voltageY_supply_thresh_falling_period
919What: /sys/.../events/in_voltageY_supply_roc_rising_period
920What: /sys/.../events/in_voltageY_supply_roc_falling_period
921What: /sys/.../events/in_voltageY_thresh_rising_period
922What: /sys/.../events/in_voltageY_thresh_falling_period
923What: /sys/.../events/in_voltageY_roc_rising_period
924What: /sys/.../events/in_voltageY_roc_falling_period
925What: /sys/.../events/in_tempY_thresh_rising_period
926What: /sys/.../events/in_tempY_thresh_falling_period
927What: /sys/.../events/in_tempY_roc_rising_period
928What: /sys/.../events/in_tempY_roc_falling_period
Jonathan Camerona37b5492011-09-02 17:14:35 +0100929What: /sys/.../events/in_accel_x&y&z_mag_falling_period
Jon Brenner3c97c082012-04-24 11:56:49 -0500930What: /sys/.../events/in_intensity0_thresh_period
931What: /sys/.../events/in_proximity0_thresh_period
Irina Tirdea40cb7612015-01-29 18:45:10 +0000932What: /sys/.../events/in_activity_still_thresh_rising_period
933What: /sys/.../events/in_activity_still_thresh_falling_period
934What: /sys/.../events/in_activity_walking_thresh_rising_period
935What: /sys/.../events/in_activity_walking_thresh_falling_period
936What: /sys/.../events/in_activity_jogging_thresh_rising_period
937What: /sys/.../events/in_activity_jogging_thresh_falling_period
938What: /sys/.../events/in_activity_running_thresh_rising_period
939What: /sys/.../events/in_activity_running_thresh_falling_period
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100940KernelVersion: 2.6.37
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100941Contact: linux-iio@vger.kernel.org
942Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000943 Period of time (in seconds) for which the condition must be
944 met before an event is generated. If direction is not
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100945 specified then this period applies to both directions.
946
Martin Fuzzey3f7f6422015-05-13 12:26:42 +0200947What: /sys/.../events/in_accel_thresh_rising_low_pass_filter_3db
948What: /sys/.../events/in_anglvel_thresh_rising_low_pass_filter_3db
949What: /sys/.../events/in_magn_thresh_rising_low_pass_filter_3db
950KernelVersion: 4.2
951Contact: linux-iio@vger.kernel.org
952Description:
953 If a low pass filter can be applied to the event generation
954 this property gives its 3db frequency in Hz.
955 A value of zero disables the filter.
956
957What: /sys/.../events/in_accel_thresh_rising_high_pass_filter_3db
958What: /sys/.../events/in_anglvel_thresh_rising_high_pass_filter_3db
959What: /sys/.../events/in_magn_thresh_rising_high_pass_filter_3db
960KernelVersion: 4.2
961Contact: linux-iio@vger.kernel.org
962Description:
963 If a high pass filter can be applied to the event generation
964 this property gives its 3db frequency in Hz.
965 A value of zero disables the filter.
966
Daniel Baluta55aebeb2014-11-10 14:45:30 +0200967What: /sys/.../events/in_activity_still_thresh_rising_en
968What: /sys/.../events/in_activity_still_thresh_falling_en
969What: /sys/.../events/in_activity_walking_thresh_rising_en
970What: /sys/.../events/in_activity_walking_thresh_falling_en
971What: /sys/.../events/in_activity_jogging_thresh_rising_en
972What: /sys/.../events/in_activity_jogging_thresh_falling_en
973What: /sys/.../events/in_activity_running_thresh_rising_en
974What: /sys/.../events/in_activity_running_thresh_falling_en
975KernelVersion: 3.19
976Contact: linux-iio@vger.kernel.org
977Description:
978 Enables or disables activitity events. Depending on direction
979 an event is generated when sensor ENTERS or LEAVES a given state.
980
981What: /sys/.../events/in_activity_still_thresh_rising_value
982What: /sys/.../events/in_activity_still_thresh_falling_value
983What: /sys/.../events/in_activity_walking_thresh_rising_value
984What: /sys/.../events/in_activity_walking_thresh_falling_value
985What: /sys/.../events/in_activity_jogging_thresh_rising_value
986What: /sys/.../events/in_activity_jogging_thresh_falling_value
987What: /sys/.../events/in_activity_running_thresh_rising_value
988What: /sys/.../events/in_activity_running_thresh_falling_value
989KernelVersion: 3.19
990Contact: linux-iio@vger.kernel.org
991Description:
992 Confidence value (in units as percentage) to be used
993 for deciding when an event should be generated. E.g for
994 running: If the confidence value reported by the sensor
995 is greater than in_activity_running_thresh_rising_value
996 then the sensor ENTERS running state. Conversely, if the
997 confidence value reported by the sensor is lower than
998 in_activity_running_thresh_falling_value then the sensor
999 is LEAVING running state.
1000
Jonathan Camerona37b5492011-09-02 17:14:35 +01001001What: /sys/.../iio:deviceX/events/in_accel_mag_en
1002What: /sys/.../iio:deviceX/events/in_accel_mag_rising_en
1003What: /sys/.../iio:deviceX/events/in_accel_mag_falling_en
1004What: /sys/.../iio:deviceX/events/in_accel_x_mag_en
1005What: /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
1006What: /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
1007What: /sys/.../iio:deviceX/events/in_accel_y_mag_en
1008What: /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
1009What: /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
1010What: /sys/.../iio:deviceX/events/in_accel_z_mag_en
1011What: /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
1012What: /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
1013What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
1014What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
Jonathan Cameron2f3cc662010-10-08 12:14:12 +01001015KernelVersion: 2.6.37
1016Contact: linux-iio@vger.kernel.org
1017Description:
Jonathan Camerona37b5492011-09-02 17:14:35 +01001018 Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
Jonathan Cameron2f3cc662010-10-08 12:14:12 +01001019 magnitude of the channel is compared to the threshold, not its
1020 signed value.
1021
Jonathan Camerona37b5492011-09-02 17:14:35 +01001022What: /sys/.../events/in_accel_raw_mag_value
1023What: /sys/.../events/in_accel_x_raw_mag_rising_value
1024What: /sys/.../events/in_accel_y_raw_mag_rising_value
1025What: /sys/.../events/in_accel_z_raw_mag_rising_value
Jonathan Cameron2f3cc662010-10-08 12:14:12 +01001026KernelVersion: 2.6.37
1027Contact: linux-iio@vger.kernel.org
1028Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001029 The value to which the magnitude of the channel is compared. If
1030 number or direction is not specified, applies to all channels of
1031 this type.
Jonathan Cameron2f3cc662010-10-08 12:14:12 +01001032
Irina Tirdea27be8422015-01-11 21:10:11 +02001033What: /sys/.../events/in_steps_change_en
Irina Tirdeae0631a32015-03-30 14:22:13 +03001034KernelVersion: 4.0
Irina Tirdeaa88bfe72014-11-10 14:45:32 +02001035Contact: linux-iio@vger.kernel.org
1036Description:
Irina Tirdea27be8422015-01-11 21:10:11 +02001037 Event generated when channel passes a threshold on the absolute
1038 change in value. E.g. for steps: a step change event is
1039 generated each time the user takes N steps, where N is set using
1040 in_steps_change_value.
1041
1042What: /sys/.../events/in_steps_change_value
Irina Tirdeae0631a32015-03-30 14:22:13 +03001043KernelVersion: 4.0
Irina Tirdea27be8422015-01-11 21:10:11 +02001044Contact: linux-iio@vger.kernel.org
1045Description:
1046 Specifies the value of change threshold that the
1047 device is comparing against for the events enabled by
1048 <type>[Y][_name]_roc[_rising|falling|]_en. E.g. for steps:
1049 if set to 3, a step change event will be generated every 3
1050 steps.
Irina Tirdeaa88bfe72014-11-10 14:45:32 +02001051
Jonathan Cameronb3874062011-08-30 12:32:49 +01001052What: /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
Jonathan Camerone34d2c52010-05-04 14:43:05 +01001053KernelVersion: 2.6.35
1054Contact: linux-iio@vger.kernel.org
1055Description:
1056 The name of the trigger source being used, as per string given
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001057 in /sys/class/iio/triggerY/name.
Jonathan Camerone34d2c52010-05-04 14:43:05 +01001058
Jonathan Cameronb3874062011-08-30 12:32:49 +01001059What: /sys/bus/iio/devices/iio:deviceX/buffer/length
Jonathan Camerone34d2c52010-05-04 14:43:05 +01001060KernelVersion: 2.6.35
1061Contact: linux-iio@vger.kernel.org
1062Description:
1063 Number of scans contained by the buffer.
1064
Jonathan Cameronb3874062011-08-30 12:32:49 +01001065What: /sys/bus/iio/devices/iio:deviceX/buffer/enable
Jonathan Camerone34d2c52010-05-04 14:43:05 +01001066KernelVersion: 2.6.35
1067Contact: linux-iio@vger.kernel.org
1068Description:
1069 Actually start the buffer capture up. Will start trigger
1070 if first device and appropriate.
1071
Alexandre Relangeab52a952013-06-11 15:52:00 +01001072What: /sys/bus/iio/devices/iio:deviceX/scan_elements
Manuel Stahl5770b8f2010-08-31 11:32:53 +02001073KernelVersion: 2.6.37
1074Contact: linux-iio@vger.kernel.org
1075Description:
Jonathan Cameron2f3cc662010-10-08 12:14:12 +01001076 Directory containing interfaces for elements that will be
1077 captured for a single triggered sample set in the buffer.
Manuel Stahl5770b8f2010-08-31 11:32:53 +02001078
Alexandre Relangeab52a952013-06-11 15:52:00 +01001079What: /sys/.../iio:deviceX/scan_elements/in_accel_x_en
1080What: /sys/.../iio:deviceX/scan_elements/in_accel_y_en
1081What: /sys/.../iio:deviceX/scan_elements/in_accel_z_en
1082What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_en
1083What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_en
1084What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_en
1085What: /sys/.../iio:deviceX/scan_elements/in_magn_x_en
1086What: /sys/.../iio:deviceX/scan_elements/in_magn_y_en
1087What: /sys/.../iio:deviceX/scan_elements/in_magn_z_en
Reyad Attiyatb531db82014-07-17 19:18:00 +01001088What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_en
1089What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_en
1090What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_en
1091What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_en
Alexandre Relangeab52a952013-06-11 15:52:00 +01001092What: /sys/.../iio:deviceX/scan_elements/in_timestamp_en
1093What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_en
1094What: /sys/.../iio:deviceX/scan_elements/in_voltageY_en
1095What: /sys/.../iio:deviceX/scan_elements/in_voltageY-voltageZ_en
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +02001096What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_en
1097What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_en
1098What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_en
1099What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_en
Alexandre Relangeab52a952013-06-11 15:52:00 +01001100What: /sys/.../iio:deviceX/scan_elements/in_incli_x_en
1101What: /sys/.../iio:deviceX/scan_elements/in_incli_y_en
1102What: /sys/.../iio:deviceX/scan_elements/in_pressureY_en
1103What: /sys/.../iio:deviceX/scan_elements/in_pressure_en
Srinivas Pandruvadab4a2d472014-04-29 00:51:00 +01001104What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_en
Haneen Mohammed1fad0342015-03-12 18:52:50 +03001105What: /sys/.../iio:deviceX/scan_elements/in_proximity_en
Manuel Stahl5770b8f2010-08-31 11:32:53 +02001106KernelVersion: 2.6.37
1107Contact: linux-iio@vger.kernel.org
1108Description:
Jonathan Cameron10ba8ea2010-09-21 14:41:08 +01001109 Scan element control for triggered data capture.
Manuel Stahl5770b8f2010-08-31 11:32:53 +02001110
Alexandre Relangeab52a952013-06-11 15:52:00 +01001111What: /sys/.../iio:deviceX/scan_elements/in_accel_type
1112What: /sys/.../iio:deviceX/scan_elements/in_anglvel_type
1113What: /sys/.../iio:deviceX/scan_elements/in_magn_type
1114What: /sys/.../iio:deviceX/scan_elements/in_incli_type
1115What: /sys/.../iio:deviceX/scan_elements/in_voltageY_type
1116What: /sys/.../iio:deviceX/scan_elements/in_voltage_type
1117What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_type
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +02001118What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_type
1119What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_type
1120What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_type
1121What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_type
Alexandre Relangeab52a952013-06-11 15:52:00 +01001122What: /sys/.../iio:deviceX/scan_elements/in_timestamp_type
1123What: /sys/.../iio:deviceX/scan_elements/in_pressureY_type
1124What: /sys/.../iio:deviceX/scan_elements/in_pressure_type
Srinivas Pandruvadab4a2d472014-04-29 00:51:00 +01001125What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_type
Haneen Mohammed1fad0342015-03-12 18:52:50 +03001126What: /sys/.../iio:deviceX/scan_elements/in_proximity_type
Manuel Stahl5770b8f2010-08-31 11:32:53 +02001127KernelVersion: 2.6.37
1128Contact: linux-iio@vger.kernel.org
1129Description:
Jonathan Cameron10ba8ea2010-09-21 14:41:08 +01001130 Description of the scan element data storage within the buffer
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001131 and hence the form in which it is read from user-space.
Jonathan Cameron15739cd2011-09-21 11:15:51 +01001132 Form is [be|le]:[s|u]bits/storagebits[>>shift].
1133 be or le specifies big or little endian. s or u specifies if
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001134 signed (2's complement) or unsigned. bits is the number of bits
1135 of data and storagebits is the space (after padding) that it
1136 occupies in the buffer. shift if specified, is the shift that
1137 needs to be applied prior to masking out unused bits. Some
1138 devices put their data in the middle of the transferred elements
1139 with additional information on both sides. Note that some
1140 devices will have additional information in the unused bits
1141 so to get a clean value, the bits value must be used to mask
1142 the buffer output value appropriately. The storagebits value
1143 also specifies the data alignment. So s48/64>>2 will be a
1144 signed 48 bit integer stored in a 64 bit location aligned to
Peter Meerwald8b417d72012-06-12 15:31:27 +02001145 a 64 bit boundary. To obtain the clean value, shift right 2
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001146 and apply a mask to zero the top 16 bits of the result.
Jonathan Cameron10ba8ea2010-09-21 14:41:08 +01001147 For other storage combinations this attribute will be extended
1148 appropriately.
1149
Alexandre Relangeab52a952013-06-11 15:52:00 +01001150What: /sys/.../iio:deviceX/scan_elements/in_accel_type_available
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001151KernelVersion: 2.6.37
1152Contact: linux-iio@vger.kernel.org
1153Description:
1154 If the type parameter can take one of a small set of values,
1155 this attribute lists them.
1156
Alexandre Relangeab52a952013-06-11 15:52:00 +01001157What: /sys/.../iio:deviceX/scan_elements/in_voltageY_index
1158What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_index
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +02001159What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_index
1160What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_index
1161What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_index
1162What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_index
Alexandre Relangeab52a952013-06-11 15:52:00 +01001163What: /sys/.../iio:deviceX/scan_elements/in_accel_x_index
1164What: /sys/.../iio:deviceX/scan_elements/in_accel_y_index
1165What: /sys/.../iio:deviceX/scan_elements/in_accel_z_index
1166What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_index
1167What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_index
1168What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_index
1169What: /sys/.../iio:deviceX/scan_elements/in_magn_x_index
1170What: /sys/.../iio:deviceX/scan_elements/in_magn_y_index
1171What: /sys/.../iio:deviceX/scan_elements/in_magn_z_index
Reyad Attiyatb531db82014-07-17 19:18:00 +01001172What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_index
1173What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_index
1174What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_index
1175What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_index
Alexandre Relangeab52a952013-06-11 15:52:00 +01001176What: /sys/.../iio:deviceX/scan_elements/in_incli_x_index
1177What: /sys/.../iio:deviceX/scan_elements/in_incli_y_index
1178What: /sys/.../iio:deviceX/scan_elements/in_timestamp_index
1179What: /sys/.../iio:deviceX/scan_elements/in_pressureY_index
1180What: /sys/.../iio:deviceX/scan_elements/in_pressure_index
Srinivas Pandruvadab4a2d472014-04-29 00:51:00 +01001181What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_index
Haneen Mohammed1fad0342015-03-12 18:52:50 +03001182What: /sys/.../iio:deviceX/scan_elements/in_proximity_index
Jonathan Cameron10ba8ea2010-09-21 14:41:08 +01001183KernelVersion: 2.6.37
1184Contact: linux-iio@vger.kernel.org
1185Description:
1186 A single positive integer specifying the position of this
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001187 scan element in the buffer. Note these are not dependent on
1188 what is enabled and may not be contiguous. Thus for user-space
Jonathan Cameron10ba8ea2010-09-21 14:41:08 +01001189 to establish the full layout these must be used in conjunction
1190 with all _en attributes to establish which channels are present,
1191 and the relevant _type attributes to establish the data storage
1192 format.
Michael Hennerichd4894632011-04-06 11:42:48 +02001193
Daniel Baluta55aebeb2014-11-10 14:45:30 +02001194What: /sys/.../iio:deviceX/in_activity_still_input
1195What: /sys/.../iio:deviceX/in_activity_walking_input
1196What: /sys/.../iio:deviceX/in_activity_jogging_input
1197What: /sys/.../iio:deviceX/in_activity_running_input
1198KernelVersion: 3.19
1199Contact: linux-iio@vger.kernel.org
1200Description:
1201 This attribute is used to read the confidence for an activity
1202 expressed in units as percentage.
1203
Jonathan Camerond4c926f2011-10-05 15:28:00 +01001204What: /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
Michael Hennerichd4894632011-04-06 11:42:48 +02001205KernelVersion: 2.6.38
Jonathan Camerona37b5492011-09-02 17:14:35 +01001206Contact: linux-iio@vger.kernel.org
Michael Hennerichd4894632011-04-06 11:42:48 +02001207Description:
1208 This attribute is used to read the amount of quadrature error
1209 present in the device at a given time.
Peter Meerwaldf7883d12013-06-23 22:30:00 +01001210
Oleksandr Kravchenko63fa65d2013-08-28 12:01:00 +01001211What: /sys/.../iio:deviceX/in_accelX_power_mode
1212KernelVersion: 3.11
1213Contact: linux-iio@vger.kernel.org
1214Description:
1215 Specifies the chip power mode.
1216 low_noise: reduce noise level from ADC,
1217 low_power: enable low current consumption.
1218 For a list of available output power modes read
1219 in_accel_power_mode_available.
1220
Irina Tirdea72c66642015-01-11 21:10:07 +02001221What: /sys/.../iio:deviceX/in_energy_input
1222What: /sys/.../iio:deviceX/in_energy_raw
Irina Tirdeae0631a32015-03-30 14:22:13 +03001223KernelVersion: 4.0
Irina Tirdea72c66642015-01-11 21:10:07 +02001224Contact: linux-iio@vger.kernel.org
1225Description:
1226 This attribute is used to read the energy value reported by the
1227 device (e.g.: human activity sensors report energy burnt by the
1228 user). Units after application of scale are Joules.
1229
Irina Tirdeacc3c9ee2015-01-11 21:10:08 +02001230What: /sys/.../iio:deviceX/in_distance_input
1231What: /sys/.../iio:deviceX/in_distance_raw
Irina Tirdeae0631a32015-03-30 14:22:13 +03001232KernelVersion: 4.0
Irina Tirdeacc3c9ee2015-01-11 21:10:08 +02001233Contact: linux-iio@vger.kernel.org
1234Description:
1235 This attribute is used to read the distance covered by the user
1236 since the last reboot while activated. Units after application
1237 of scale are meters.
1238
Peter Meerwaldf7883d12013-06-23 22:30:00 +01001239What: /sys/bus/iio/devices/iio:deviceX/store_eeprom
1240KernelVersion: 3.4.0
1241Contact: linux-iio@vger.kernel.org
1242Description:
1243 Writing '1' stores the current device configuration into
1244 on-chip EEPROM. After power-up or chip reset the device will
1245 automatically load the saved configuration.
Peter Meerwald899d90b2013-09-08 16:20:00 +01001246
Peter Meerwald6c0690e2014-03-05 11:57:00 +00001247What: /sys/.../iio:deviceX/in_proximity_raw
1248What: /sys/.../iio:deviceX/in_proximity_input
1249What: /sys/.../iio:deviceX/in_proximityY_raw
1250KernelVersion: 3.4
1251Contact: linux-iio@vger.kernel.org
1252Description:
1253 Proximity measurement indicating that some
Peter Meerwald4fbcfa02016-03-13 16:02:22 +01001254 object is near the sensor, usually by observing
Peter Meerwald6c0690e2014-03-05 11:57:00 +00001255 reflectivity of infrared or ultrasound emitted.
1256 Often these sensors are unit less and as such conversion
Daniel Balutabdc10d52015-06-11 18:49:33 +03001257 to SI units is not possible. Higher proximity measurements
Enric Balletbo i Serraa9c99c72017-01-11 16:51:38 +01001258 indicate closer objects, and vice versa. Units after
1259 application of scale and offset are meters.
Peter Meerwald6c0690e2014-03-05 11:57:00 +00001260
Darshana Padmadas7cf78db2015-03-16 17:18:20 +05301261What: /sys/.../iio:deviceX/in_illuminance_input
1262What: /sys/.../iio:deviceX/in_illuminance_raw
Peter Meerwald994265f2014-02-05 16:54:00 +00001263What: /sys/.../iio:deviceX/in_illuminanceY_input
1264What: /sys/.../iio:deviceX/in_illuminanceY_raw
1265What: /sys/.../iio:deviceX/in_illuminanceY_mean_raw
Darshana Padmadas7cf78db2015-03-16 17:18:20 +05301266What: /sys/.../iio:deviceX/in_illuminance_ir_raw
1267What: /sys/.../iio:deviceX/in_illuminance_clear_raw
Peter Meerwald994265f2014-02-05 16:54:00 +00001268KernelVersion: 3.4
1269Contact: linux-iio@vger.kernel.org
1270Description:
1271 Illuminance measurement, units after application of scale
1272 and offset are lux.
1273
Peter Meerwald065b0552014-02-05 16:54:00 +00001274What: /sys/.../iio:deviceX/in_intensityY_raw
1275What: /sys/.../iio:deviceX/in_intensityY_ir_raw
1276What: /sys/.../iio:deviceX/in_intensityY_both_raw
Peter Meerwald-Stadler2c5ff1f2016-03-20 16:20:22 +01001277What: /sys/.../iio:deviceX/in_intensityY_uv_raw
Peter Meerwald065b0552014-02-05 16:54:00 +00001278KernelVersion: 3.4
1279Contact: linux-iio@vger.kernel.org
1280Description:
1281 Unit-less light intensity. Modifiers both and ir indicate
1282 that measurements contains visible and infrared light
Peter Meerwald-Stadler2c5ff1f2016-03-20 16:20:22 +01001283 components or just infrared light, respectively. Modifier uv indicates
1284 that measurements contain ultraviolet light components.
Peter Meerwald065b0552014-02-05 16:54:00 +00001285
Peter Meerwald-Stadlerd4094042016-03-20 16:20:23 +01001286What: /sys/.../iio:deviceX/in_uvindex_input
1287KernelVersion: 4.6
1288Contact: linux-iio@vger.kernel.org
1289Description:
1290 UV light intensity index measuring the human skin's response to
1291 different wavelength of sunlight weighted according to the
1292 standardised CIE Erythemal Action Spectrum. UV index values range
1293 from 0 (low) to >=11 (extreme).
1294
Peter Meerwald899d90b2013-09-08 16:20:00 +01001295What: /sys/.../iio:deviceX/in_intensity_red_integration_time
1296What: /sys/.../iio:deviceX/in_intensity_green_integration_time
1297What: /sys/.../iio:deviceX/in_intensity_blue_integration_time
1298What: /sys/.../iio:deviceX/in_intensity_clear_integration_time
1299What: /sys/.../iio:deviceX/in_illuminance_integration_time
1300KernelVersion: 3.12
1301Contact: linux-iio@vger.kernel.org
1302Description:
1303 This attribute is used to get/set the integration time in
1304 seconds.
Srinivas Pandruvadab4a2d472014-04-29 00:51:00 +01001305
Irina Tirdea40cb7612015-01-29 18:45:10 +00001306What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_integration_time
Irina Tirdeae0631a32015-03-30 14:22:13 +03001307KernelVersion: 4.0
Irina Tirdea40cb7612015-01-29 18:45:10 +00001308Contact: linux-iio@vger.kernel.org
1309Description:
1310 Number of seconds in which to compute speed.
1311
Srinivas Pandruvadab4a2d472014-04-29 00:51:00 +01001312What: /sys/bus/iio/devices/iio:deviceX/in_rot_quaternion_raw
1313KernelVersion: 3.15
1314Contact: linux-iio@vger.kernel.org
1315Description:
1316 Raw value of quaternion components using a format
1317 x y z w. Here x, y, and z component represents the axis about
1318 which a rotation will occur and w component represents the
1319 amount of rotation.
Reyad Attiyatb531db82014-07-17 19:18:00 +01001320
1321What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_raw
1322What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_raw
1323What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_raw
1324What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_raw
1325KernelVersion: 3.15
1326Contact: linux-iio@vger.kernel.org
1327Description:
1328 Raw value of rotation from true/magnetic north measured with
1329 or without compensation from tilt sensors.
Jacob Panc20d4df2014-09-17 01:11:00 +01001330
1331What: /sys/bus/iio/devices/iio:deviceX/in_currentX_raw
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +02001332What: /sys/bus/iio/devices/iio:deviceX/in_currentX_i_raw
1333What: /sys/bus/iio/devices/iio:deviceX/in_currentX_q_raw
Jacob Panc20d4df2014-09-17 01:11:00 +01001334KernelVersion: 3.18
1335Contact: linux-iio@vger.kernel.org
1336Description:
1337 Raw current measurement from channel X. Units are in milliamps
1338 after application of scale and offset. If no offset or scale is
1339 present, output should be considered as processed with the
1340 unit in milliamps.
Irina Tirdeaa88bfe72014-11-10 14:45:32 +02001341
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +02001342 Channels with 'i' and 'q' modifiers always exist in pairs and both
1343 channels refer to the same signal. The 'i' channel contains the in-phase
1344 component of the signal while the 'q' channel contains the quadrature
1345 component.
1346
Irina Tirdea40cb7612015-01-29 18:45:10 +00001347What: /sys/.../iio:deviceX/in_energy_en
1348What: /sys/.../iio:deviceX/in_distance_en
1349What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_en
Irina Tirdeaa88bfe72014-11-10 14:45:32 +02001350What: /sys/.../iio:deviceX/in_steps_en
1351KernelVersion: 3.19
1352Contact: linux-iio@vger.kernel.org
1353Description:
Irina Tirdea40cb7612015-01-29 18:45:10 +00001354 Activates a device feature that runs in firmware/hardware.
1355 E.g. for steps: the pedometer saves power while not used;
1356 when activated, it will count the steps taken by the user in
1357 firmware and export them through in_steps_input.
Irina Tirdeaa88bfe72014-11-10 14:45:32 +02001358
1359What: /sys/.../iio:deviceX/in_steps_input
1360KernelVersion: 3.19
1361Contact: linux-iio@vger.kernel.org
1362Description:
1363 This attribute is used to read the number of steps taken by the user
1364 since the last reboot while activated.
Irina Tirdea5a1a9322015-01-11 21:10:09 +02001365
1366What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_input
1367What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_raw
1368KernelVersion: 3.19
1369Contact: linux-iio@vger.kernel.org
1370Description:
1371 This attribute is used to read the current speed value of the
1372 user (which is the norm or magnitude of the velocity vector).
1373 Units after application of scale are m/s.
Irina Tirdea2f0ecb72015-01-27 20:41:52 +02001374
1375What: /sys/.../iio:deviceX/in_steps_debounce_count
Irina Tirdeae0631a32015-03-30 14:22:13 +03001376KernelVersion: 4.0
Irina Tirdea2f0ecb72015-01-27 20:41:52 +02001377Contact: linux-iio@vger.kernel.org
1378Description:
1379 Specifies the number of steps that must occur within
1380 in_steps_filter_debounce_time for the pedometer to decide the
1381 consumer is making steps.
1382
1383What: /sys/.../iio:deviceX/in_steps_debounce_time
Irina Tirdeae0631a32015-03-30 14:22:13 +03001384KernelVersion: 4.0
Irina Tirdea2f0ecb72015-01-27 20:41:52 +02001385Contact: linux-iio@vger.kernel.org
1386Description:
1387 Specifies number of seconds in which we compute the steps
1388 that occur in order to decide if the consumer is making steps.
Josselin Costanzi37d34552015-03-22 20:33:38 +02001389
1390What: /sys/bus/iio/devices/iio:deviceX/buffer/watermark
1391KernelVersion: 4.2
1392Contact: linux-iio@vger.kernel.org
1393Description:
1394 A single positive integer specifying the maximum number of scan
1395 elements to wait for.
1396 Poll will block until the watermark is reached.
1397 Blocking read will wait until the minimum between the requested
1398 read amount or the low water mark is available.
1399 Non-blocking read will retrieve the available samples from the
1400 buffer even if there are less samples then watermark level. This
1401 allows the application to block on poll with a timeout and read
1402 the available samples after the timeout expires and thus have a
1403 maximum delay guarantee.
Octavian Purdilaf4f46732015-03-22 20:33:39 +02001404
1405What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_enabled
1406KernelVersion: 4.2
1407Contact: linux-iio@vger.kernel.org
1408Description:
1409 A read-only boolean value that indicates if the hardware fifo is
1410 currently enabled or disabled. If the device does not have a
1411 hardware fifo this entry is not present.
1412 The hardware fifo is enabled when the buffer is enabled if the
1413 current hardware fifo watermark level is set and other current
1414 device settings allows it (e.g. if a trigger is set that samples
1415 data differently that the hardware fifo does then hardware fifo
1416 will not enabled).
1417 If the hardware fifo is enabled and the level of the hardware
1418 fifo reaches the hardware fifo watermark level the device will
1419 flush its hardware fifo to the device buffer. Doing a non
1420 blocking read on the device when no samples are present in the
1421 device buffer will also force a flush.
1422 When the hardware fifo is enabled there is no need to use a
1423 trigger to use buffer mode since the watermark settings
1424 guarantees that the hardware fifo is flushed to the device
1425 buffer.
1426
1427What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark
1428KernelVersion: 4.2
1429Contact: linux-iio@vger.kernel.org
1430Description:
1431 Read-only entry that contains a single integer specifying the
1432 current watermark level for the hardware fifo. If the device
1433 does not have a hardware fifo this entry is not present.
1434 The watermark level for the hardware fifo is set by the driver
1435 based on the value set by the user in buffer/watermark but
1436 taking into account hardware limitations (e.g. most hardware
1437 buffers are limited to 32-64 samples, some hardware buffers
1438 watermarks are fixed or have minimum levels). A value of 0
1439 means that the hardware watermark is unset.
1440
1441What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_min
1442KernelVersion: 4.2
1443Contact: linux-iio@vger.kernel.org
1444Description:
1445 A single positive integer specifying the minimum watermark level
1446 for the hardware fifo of this device. If the device does not
1447 have a hardware fifo this entry is not present.
1448 If the user sets buffer/watermark to a value less than this one,
1449 then the hardware watermark will remain unset.
1450
1451What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_max
1452KernelVersion: 4.2
1453Contact: linux-iio@vger.kernel.org
1454Description:
1455 A single positive integer specifying the maximum watermark level
1456 for the hardware fifo of this device. If the device does not
1457 have a hardware fifo this entry is not present.
1458 If the user sets buffer/watermark to a value greater than this
1459 one, then the hardware watermark will be capped at this value.
1460
1461What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_available
1462KernelVersion: 4.2
1463Contact: linux-iio@vger.kernel.org
1464Description:
1465 A list of positive integers specifying the available watermark
1466 levels for the hardware fifo. This entry is optional and if it
1467 is not present it means that all the values between
1468 hwfifo_watermark_min and hwfifo_watermark_max are supported.
1469 If the user sets buffer/watermark to a value greater than
1470 hwfifo_watermak_min but not equal to any of the values in this
1471 list, the driver will chose an appropriate value for the
1472 hardware fifo watermark level.
Vianney le Clément de Saint-Marcqc8a85852015-03-30 10:34:58 +02001473
1474What: /sys/bus/iio/devices/iio:deviceX/in_temp_calibemissivity
1475What: /sys/bus/iio/devices/iio:deviceX/in_tempX_calibemissivity
1476What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_calibemissivity
1477What: /sys/bus/iio/devices/iio:deviceX/in_tempX_object_calibemissivity
1478KernelVersion: 4.1
1479Contact: linux-iio@vger.kernel.org
1480Description:
1481 The emissivity ratio of the surface in the field of view of the
1482 contactless temperature sensor. Emissivity varies from 0 to 1,
1483 with 1 being the emissivity of a black body.
Irina Tirdeafaaa4492015-04-29 21:16:39 +03001484
1485What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_oversampling_ratio
1486What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_oversampling_ratio
1487What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_oversampling_ratio
1488KernelVersion: 4.2
1489Contact: linux-iio@vger.kernel.org
1490Description:
1491 Hardware applied number of measurements for acquiring one
1492 data point. The HW will do <type>[_name]_oversampling_ratio
1493 measurements and return the average value as output data. Each
1494 value resulted from <type>[_name]_oversampling_ratio measurements
1495 is considered as one sample for <type>[_name]_sampling_frequency.
Matt Ranostay8ff6b3b2015-09-13 20:26:11 -07001496
1497What: /sys/bus/iio/devices/iio:deviceX/in_concentration_raw
1498What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_raw
1499What: /sys/bus/iio/devices/iio:deviceX/in_concentration_co2_raw
1500What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_co2_raw
1501What: /sys/bus/iio/devices/iio:deviceX/in_concentration_voc_raw
1502What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_voc_raw
1503KernelVersion: 4.3
1504Contact: linux-iio@vger.kernel.org
1505Description:
1506 Raw (unscaled no offset etc.) percentage reading of a substance.
Matt Ranostayd38d5462015-09-13 20:26:12 -07001507
1508What: /sys/bus/iio/devices/iio:deviceX/in_resistance_raw
1509What: /sys/bus/iio/devices/iio:deviceX/in_resistanceX_raw
Peter Rosinb15aef82015-09-23 16:26:22 +02001510What: /sys/bus/iio/devices/iio:deviceX/out_resistance_raw
1511What: /sys/bus/iio/devices/iio:deviceX/out_resistanceX_raw
Matt Ranostayd38d5462015-09-13 20:26:12 -07001512KernelVersion: 4.3
1513Contact: linux-iio@vger.kernel.org
1514Description:
1515 Raw (unscaled no offset etc.) resistance reading that can be processed
1516 into an ohm value.
Ludovic Tancerel2b5c53d2015-10-01 16:13:39 +02001517
1518What: /sys/bus/iio/devices/iio:deviceX/heater_enable
1519KernelVersion: 4.1.0
1520Contact: linux-iio@vger.kernel.org
1521Description:
1522 '1' (enable) or '0' (disable) specifying the enable
1523 of heater function. Same reading values apply
1524 This ABI is especially applicable for humidity sensors
1525 to heatup the device and get rid of any condensation
1526 in some humidity environment
Matt Ranostayecb3a7c2016-01-26 18:34:30 -08001527
1528What: /sys/bus/iio/devices/iio:deviceX/in_ph_raw
1529KernelVersion: 4.5
1530Contact: linux-iio@vger.kernel.org
1531Description:
1532 Raw (unscaled no offset etc.) pH reading of a substance as a negative
1533 base-10 logarithm of hydrodium ions in a litre of water.
Gregor Boiriedfc57732016-04-20 19:23:43 +02001534
1535What: /sys/bus/iio/devices/iio:deviceX/mount_matrix
1536What: /sys/bus/iio/devices/iio:deviceX/in_mount_matrix
1537What: /sys/bus/iio/devices/iio:deviceX/out_mount_matrix
Gregor Boirieeb379842016-04-20 19:23:45 +02001538What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_mount_matrix
1539What: /sys/bus/iio/devices/iio:deviceX/in_accel_mount_matrix
Gregor Boiriedfc57732016-04-20 19:23:43 +02001540KernelVersion: 4.6
1541Contact: linux-iio@vger.kernel.org
1542Description:
1543 Mounting matrix for IIO sensors. This is a rotation matrix which
1544 informs userspace about sensor chip's placement relative to the
1545 main hardware it is mounted on.
1546 Main hardware placement is defined according to the local
1547 reference frame related to the physical quantity the sensor
1548 measures.
1549 Given that the rotation matrix is defined in a board specific
1550 way (platform data and / or device-tree), the main hardware
1551 reference frame definition is left to the implementor's choice
1552 (see below for a magnetometer example).
1553 Applications should apply this rotation matrix to samples so
1554 that when main hardware reference frame is aligned onto local
1555 reference frame, then sensor chip reference frame is also
1556 perfectly aligned with it.
1557 Matrix is a 3x3 unitary matrix and typically looks like
1558 [0, 1, 0; 1, 0, 0; 0, 0, -1]. Identity matrix
1559 [1, 0, 0; 0, 1, 0; 0, 0, 1] means sensor chip and main hardware
1560 are perfectly aligned with each other.
1561
1562 For example, a mounting matrix for a magnetometer sensor informs
1563 userspace about sensor chip's ORIENTATION relative to the main
1564 hardware.
1565 More specifically, main hardware orientation is defined with
1566 respect to the LOCAL EARTH GEOMAGNETIC REFERENCE FRAME where :
1567 * Y is in the ground plane and positive towards magnetic North ;
1568 * X is in the ground plane, perpendicular to the North axis and
1569 positive towards the East ;
1570 * Z is perpendicular to the ground plane and positive upwards.
1571
1572 An implementor might consider that for a hand-held device, a
1573 'natural' orientation would be 'front facing camera at the top'.
1574 The main hardware reference frame could then be described as :
1575 * Y is in the plane of the screen and is positive towards the
1576 top of the screen ;
1577 * X is in the plane of the screen, perpendicular to Y axis, and
1578 positive towards the right hand side of the screen ;
1579 * Z is perpendicular to the screen plane and positive out of the
1580 screen.
1581 Another example for a quadrotor UAV might be :
1582 * Y is in the plane of the propellers and positive towards the
1583 front-view camera;
1584 * X is in the plane of the propellers, perpendicular to Y axis,
1585 and positive towards the starboard side of the UAV ;
1586 * Z is perpendicular to propellers plane and positive upwards.
Matt Ranostay4b9d2092016-05-24 21:29:19 -07001587
1588What: /sys/bus/iio/devices/iio:deviceX/in_electricalconductivity_raw
1589KernelVersion: 4.8
1590Contact: linux-iio@vger.kernel.org
1591Description:
1592 Raw (unscaled no offset etc.) electric conductivity reading that
1593 can be processed to siemens per meter.
William Breathitt Gray1a8f3242016-09-28 13:59:49 -04001594
1595What: /sys/bus/iio/devices/iio:deviceX/in_countY_raw
1596KernelVersion: 4.9
1597Contact: linux-iio@vger.kernel.org
1598Description:
1599 Raw counter device counts from channel Y. For quadrature
1600 counters, multiplication by an available [Y]_scale results in
1601 the counts of a single quadrature signal phase from channel Y.
1602
1603What: /sys/bus/iio/devices/iio:deviceX/in_indexY_raw
1604KernelVersion: 4.9
1605Contact: linux-iio@vger.kernel.org
1606Description:
1607 Raw counter device index value from channel Y. This attribute
1608 provides an absolute positional reference (e.g. a pulse once per
1609 revolution) which may be used to home positional systems as
1610 required.