blob: 2db2cdf42d5417fc218ea29763274503467e7d01 [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
Brian Masneya18ac952017-02-08 20:54:30 -050058What: /sys/bus/iio/devices/iio:deviceX/in_proximity_sampling_frequency_available
Jonathan Cameron15739cd2011-09-21 11:15:51 +010059What: /sys/.../iio:deviceX/buffer/sampling_frequency_available
60What: /sys/bus/iio/devices/triggerX/sampling_frequency_available
Jonathan Camerone34d2c52010-05-04 14:43:05 +010061KernelVersion: 2.6.35
62Contact: linux-iio@vger.kernel.org
63Description:
64 When the internal sampling clock can only take a small
Jonathan Cameronf386caa2010-11-22 23:31:16 +000065 discrete set of values, this file lists those available.
Jonathan Camerone34d2c52010-05-04 14:43:05 +010066
Jonathan Cameronb3874062011-08-30 12:32:49 +010067What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio
Michael Hennerichb9618c02011-02-22 21:46:18 +010068KernelVersion: 2.6.38
69Contact: linux-iio@vger.kernel.org
70Description:
71 Hardware dependent ADC oversampling. Controls the sampling ratio
72 of the digital filter if available.
73
Jonathan Cameronb3874062011-08-30 12:32:49 +010074What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available
Michael Hennerichb9618c02011-02-22 21:46:18 +010075KernelVersion: 2.6.38
76Contact: linux-iio@vger.kernel.org
77Description:
78 Hardware dependent values supported by the oversampling filter.
79
Jonathan Camerona37b5492011-09-02 17:14:35 +010080What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
81What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +020082What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_raw
83What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_raw
Jonathan Camerone34d2c52010-05-04 14:43:05 +010084KernelVersion: 2.6.35
85Contact: linux-iio@vger.kernel.org
86Description:
Peter Meerwald8b417d72012-06-12 15:31:27 +020087 Raw (unscaled no bias removal etc.) voltage measurement from
Jonathan Cameronf386caa2010-11-22 23:31:16 +000088 channel Y. In special cases where the channel does not
89 correspond to externally available input one of the named
90 versions may be used. The number must always be specified and
Jonathan Cameron15739cd2011-09-21 11:15:51 +010091 unique to allow association with event codes. Units after
Lars-Peter Clausenc2b2db72013-09-28 10:31:00 +010092 application of scale and offset are millivolts.
Jonathan Camerone34d2c52010-05-04 14:43:05 +010093
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +020094 Channels with 'i' and 'q' modifiers always exist in pairs and both
95 channels refer to the same signal. The 'i' channel contains the in-phase
96 component of the signal while the 'q' channel contains the quadrature
97 component.
98
Jonathan Camerona37b5492011-09-02 17:14:35 +010099What: /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100100KernelVersion: 2.6.35
101Contact: linux-iio@vger.kernel.org
102Description:
103 Raw (unscaled) differential voltage measurement equivalent to
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000104 channel Y - channel Z where these channel numbers apply to the
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100105 physically equivalent inputs when non differential readings are
106 separately available. In differential only parts, then all that
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100107 is required is a consistent labeling. Units after application
Lars-Peter Clausenc2b2db72013-09-28 10:31:00 +0100108 of scale and offset are millivolts.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100109
Adam Thomson7f1c2cb2014-11-25 18:25:39 +0000110What: /sys/bus/iio/devices/iio:deviceX/in_currentY_raw
111What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_raw
112KernelVersion: 3.17
113Contact: linux-iio@vger.kernel.org
114Description:
115 Raw (unscaled no bias removal etc.) current measurement from
116 channel Y. In special cases where the channel does not
117 correspond to externally available input one of the named
118 versions may be used. The number must always be specified and
119 unique to allow association with event codes. Units after
120 application of scale and offset are milliamps.
121
Jonathan Cameron0baf29d2011-09-21 11:15:52 +0100122What: /sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw
123KernelVersion: 3.2
124Contact: linux-iio@vger.kernel.org
125Description:
126 Raw capacitance measurement from channel Y. Units after
127 application of scale and offset are nanofarads.
128
129What: /sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw
130KernelVersion: 3.2
131Contact: linux-iio@vger.kernel.org
132Description:
133 Raw differential capacitance measurement equivalent to
134 channel Y - channel Z where these channel numbers apply to the
135 physically equivalent inputs when non differential readings are
136 separately available. In differential only parts, then all that
137 is required is a consistent labeling. Units after application
Jonathan Cameron68284a12012-04-25 15:54:57 +0100138 of scale and offset are nanofarads.
Jonathan Cameron0baf29d2011-09-21 11:15:52 +0100139
Jonathan Camerona37b5492011-09-02 17:14:35 +0100140What: /sys/bus/iio/devices/iio:deviceX/in_temp_raw
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100141What: /sys/bus/iio/devices/iio:deviceX/in_tempX_raw
Jonathan Camerona37b5492011-09-02 17:14:35 +0100142What: /sys/bus/iio/devices/iio:deviceX/in_temp_x_raw
143What: /sys/bus/iio/devices/iio:deviceX/in_temp_y_raw
Peter Meerwald888c9c72014-02-05 16:57:00 +0000144What: /sys/bus/iio/devices/iio:deviceX/in_temp_ambient_raw
145What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_raw
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000146KernelVersion: 2.6.35
147Contact: linux-iio@vger.kernel.org
148Description:
Peter Meerwald8b417d72012-06-12 15:31:27 +0200149 Raw (unscaled no bias removal etc.) temperature measurement.
Jonathan Cameron68284a12012-04-25 15:54:57 +0100150 If an axis is specified it generally means that the temperature
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000151 sensor is associated with one part of a compound device (e.g.
Peter Meerwald888c9c72014-02-05 16:57:00 +0000152 a gyroscope axis). The ambient and object modifiers distinguish
153 between ambient (reference) and distant temperature for contact-
154 less measurements. Units after application of scale and offset
Peter Meerwaldcf655d22012-06-15 19:25:23 +0200155 are milli degrees Celsius.
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000156
Jonathan Camerona37b5492011-09-02 17:14:35 +0100157What: /sys/bus/iio/devices/iio:deviceX/in_tempX_input
Michael Hennerich7c31b982011-02-24 12:32:45 +0100158KernelVersion: 2.6.38
159Contact: linux-iio@vger.kernel.org
160Description:
161 Scaled temperature measurement in milli degrees Celsius.
162
Jonathan Camerona37b5492011-09-02 17:14:35 +0100163What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw
164What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_raw
165What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_raw
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100166KernelVersion: 2.6.35
167Contact: linux-iio@vger.kernel.org
168Description:
169 Acceleration in direction x, y or z (may be arbitrarily assigned
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100170 but should match other such assignments on device).
171 Has all of the equivalent parameters as per voltageY. Units
172 after application of scale and offset are m/s^2.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100173
Song Hongyan571299d2017-01-05 18:24:03 +0800174What: /sys/bus/iio/devices/iio:deviceX/in_gravity_x_raw
175What: /sys/bus/iio/devices/iio:deviceX/in_gravity_y_raw
176What: /sys/bus/iio/devices/iio:deviceX/in_gravity_z_raw
177KernelVersion: 4.11
178Contact: linux-iio@vger.kernel.org
179Description:
180 Gravity in direction x, y or z (may be arbitrarily assigned
181 but should match other such assignments on device).
182 Units after application of scale and offset are m/s^2.
183
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100184What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw
185What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw
186What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100187KernelVersion: 2.6.35
188Contact: linux-iio@vger.kernel.org
189Description:
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100190 Angular velocity about axis x, y or z (may be arbitrarily
Peter Meerwald8b417d72012-06-12 15:31:27 +0200191 assigned). Has all the equivalent parameters as per voltageY.
192 Units after application of scale and offset are radians per
193 second.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100194
Jonathan Camerona37b5492011-09-02 17:14:35 +0100195What: /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
196What: /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
197What: /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
Jonathan Camerone5107fb2010-05-07 15:38:57 +0100198KernelVersion: 2.6.35
199Contact: linux-iio@vger.kernel.org
200Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000201 Inclination raw reading about axis x, y or z (may be
202 arbitrarily assigned). Data converted by application of offset
Peter Meerwald8b417d72012-06-12 15:31:27 +0200203 and scale to degrees.
Jonathan Camerone5107fb2010-05-07 15:38:57 +0100204
Jonathan Camerona37b5492011-09-02 17:14:35 +0100205What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
206What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
207What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100208KernelVersion: 2.6.35
209Contact: linux-iio@vger.kernel.org
210Description:
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100211 Magnetic field along axis x, y or z (may be arbitrarily
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100212 assigned). Data converted by application of offset
213 then scale to Gauss.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100214
Jonathan Camerona37b5492011-09-02 17:14:35 +0100215What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
216What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
217What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000218KernelVersion: 2.6.36
219Contact: linux-iio@vger.kernel.org
220Description:
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100221 Highest value since some reset condition. These
222 attributes allow access to this and are otherwise
223 the direct equivalent of the <type>Y[_name]_raw attributes.
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000224
Jonathan Camerona37b5492011-09-02 17:14:35 +0100225What: /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000226KernelVersion: 2.6.36
227Contact: linux-iio@vger.kernel.org
228Description:
229 A computed peak value based on the sum squared magnitude of
230 the underlying value in the specified directions.
231
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000232What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_raw
233What: /sys/bus/iio/devices/iio:deviceX/in_pressure_raw
234KernelVersion: 3.8
235Contact: linux-iio@vger.kernel.org
236Description:
237 Raw pressure measurement from channel Y. Units after
238 application of scale and offset are kilopascal.
239
Vlad Dogaruc22e15f2014-10-13 14:53:00 +0100240What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_input
241What: /sys/bus/iio/devices/iio:deviceX/in_pressure_input
242KernelVersion: 3.8
243Contact: linux-iio@vger.kernel.org
244Description:
245 Scaled pressure measurement from channel Y, in kilopascal.
246
Harald Geyerac216aa2013-12-01 15:08:00 +0000247What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_raw
248KernelVersion: 3.14
249Contact: linux-iio@vger.kernel.org
250Description:
251 Raw humidity measurement of air. Units after application of
252 scale and offset are milli percent.
253
254What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_input
255KernelVersion: 3.14
256Contact: linux-iio@vger.kernel.org
257Description:
258 Scaled humidity measurement in milli percent.
259
Sebastian Reichelc0a6b7e2014-10-03 17:25:00 +0100260What: /sys/bus/iio/devices/iio:deviceX/in_X_mean_raw
261KernelVersion: 3.5
262Contact: linux-iio@vger.kernel.org
263Description:
264 Averaged raw measurement from channel X. The number of values
265 used for averaging is device specific. The converting rules for
266 normal raw values also applies to the averaged raw values.
267
Jonathan Camerona37b5492011-09-02 17:14:35 +0100268What: /sys/bus/iio/devices/iio:deviceX/in_accel_offset
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100269What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
270What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
271What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
272What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
273What: /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200274What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_offset
275What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_offset
276What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_offset
277What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_offset
Adam Thomson7f1c2cb2014-11-25 18:25:39 +0000278What: /sys/bus/iio/devices/iio:deviceX/in_currentY_offset
279What: /sys/bus/iio/devices/iio:deviceX/in_current_offset
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200280What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_offset
281What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_offset
282What: /sys/bus/iio/devices/iio:deviceX/in_current_q_offset
283What: /sys/bus/iio/devices/iio:deviceX/in_current_i_offset
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100284What: /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
Jonathan Camerona37b5492011-09-02 17:14:35 +0100285What: /sys/bus/iio/devices/iio:deviceX/in_temp_offset
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000286What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_offset
287What: /sys/bus/iio/devices/iio:deviceX/in_pressure_offset
Roberta Dobrescu4d5ce6b2014-10-23 12:44:00 +0100288What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_offset
Darshana Padmadasd5d7c4a2015-03-13 21:06:58 +0530289What: /sys/bus/iio/devices/iio:deviceX/in_magn_offset
Haneen Mohammed8ea06892015-03-28 03:02:39 +0300290What: /sys/bus/iio/devices/iio:deviceX/in_rot_offset
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100291KernelVersion: 2.6.35
292Contact: linux-iio@vger.kernel.org
293Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000294 If known for a device, offset to be added to <type>[Y]_raw prior
295 to scaling by <type>[Y]_scale in order to obtain value in the
Peter Meerwald8b417d72012-06-12 15:31:27 +0200296 <type> units as specified in <type>[Y]_raw documentation.
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100297 Not present if the offset is always 0 or unknown. If Y or
298 axis <x|y|z> is not present, then the offset applies to all
299 in channels of <type>.
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000300 May be writable if a variable offset can be applied on the
301 device. Note that this is different to calibbias which
302 is for devices (or drivers) that apply offsets to compensate
303 for variation between different instances of the part, typically
304 adjusted by using some hardware supported calibration procedure.
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100305 Calibbias is applied internally, offset is applied in userspace
306 to the _raw output.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100307
Jonathan Camerona37b5492011-09-02 17:14:35 +0100308What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200309What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_scale
310What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_scale
Jonathan Camerona37b5492011-09-02 17:14:35 +0100311What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
312What: /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200313What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_scale
314What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_scale
Darshana Padmadas4e4cd142014-11-05 21:48:11 +0530315What: /sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_scale
Jonathan Camerona37b5492011-09-02 17:14:35 +0100316What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
Michael Hennerichd802bf62012-05-21 14:30:31 +0200317What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale
Adam Thomson7f1c2cb2014-11-25 18:25:39 +0000318What: /sys/bus/iio/devices/iio:deviceX/in_currentY_scale
319What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_scale
320What: /sys/bus/iio/devices/iio:deviceX/in_current_scale
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200321What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_scale
322What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_scale
323What: /sys/bus/iio/devices/iio:deviceX/in_current_i_scale
324What: /sys/bus/iio/devices/iio:deviceX/in_current_q_scale
Jonathan Camerona37b5492011-09-02 17:14:35 +0100325What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale
326What: /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100327What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale
Irina Tirdea72c66642015-01-11 21:10:07 +0200328What: /sys/bus/iio/devices/iio:deviceX/in_energy_scale
Irina Tirdeacc3c9ee2015-01-11 21:10:08 +0200329What: /sys/bus/iio/devices/iio:deviceX/in_distance_scale
Jonathan Camerona37b5492011-09-02 17:14:35 +0100330What: /sys/bus/iio/devices/iio:deviceX/in_magn_scale
331What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
332What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
333What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
Reyad Attiyatb531db82014-07-17 19:18:00 +0100334What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_scale
335What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_scale
336What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_scale
337What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_scale
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000338What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_scale
339What: /sys/bus/iio/devices/iio:deviceX/in_pressure_scale
Roberta Dobrescu4d5ce6b2014-10-23 12:44:00 +0100340What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_scale
Irina Tirdea5a1a9322015-01-11 21:10:09 +0200341What: /sys/bus/iio/devices/iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_scale
Darshana Padmadas7cf78db2015-03-16 17:18:20 +0530342What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_scale
William Breathitt Gray1a8f3242016-09-28 13:59:49 -0400343What: /sys/bus/iio/devices/iio:deviceX/in_countY_scale
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100344KernelVersion: 2.6.35
345Contact: linux-iio@vger.kernel.org
346Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000347 If known for a device, scale to be applied to <type>Y[_name]_raw
348 post addition of <type>[Y][_name]_offset in order to obtain the
349 measured value in <type> units as specified in
Jonathan Cameron68284a12012-04-25 15:54:57 +0100350 <type>[Y][_name]_raw documentation. If shared across all in
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100351 channels then Y and <x|y|z> are not present and the value is
352 called <type>[Y][_name]_scale. The peak modifier means this
353 value is applied to <type>Y[_name]_peak_raw values.
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100354
Jonathan Camerona37b5492011-09-02 17:14:35 +0100355What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
356What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
357What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100358What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias
359What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
360What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
Jon Brenner3c97c082012-04-24 11:56:49 -0500361What: /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
362What: /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000363What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibbias
364What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibbias
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000365KernelVersion: 2.6.35
366Contact: linux-iio@vger.kernel.org
367Description:
Peter Meerwald8b417d72012-06-12 15:31:27 +0200368 Hardware applied calibration offset (assumed to fix production
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100369 inaccuracies).
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100370
Jonathan Camerona37b5492011-09-02 17:14:35 +0100371What /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
372What /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +0200373What /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_calibscale
374What /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_calibscale
375What /sys/bus/iio/devices/iio:deviceX/in_voltage_i_calibscale
376What /sys/bus/iio/devices/iio:deviceX/in_voltage_q_calibscale
Jonathan Camerona37b5492011-09-02 17:14:35 +0100377What /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
378What /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
379What /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
380What /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100381What /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
382What /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
383What /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
Jon Brenner3c97c082012-04-24 11:56:49 -0500384what /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
385what /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000386What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibscale
387What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibscale
Darshana Padmadas7cf78db2015-03-16 17:18:20 +0530388What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_calibscale
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000389KernelVersion: 2.6.35
390Contact: linux-iio@vger.kernel.org
391Description:
Peter Meerwald8b417d72012-06-12 15:31:27 +0200392 Hardware applied calibration scale factor (assumed to fix
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000393 production inaccuracies). If shared across all channels,
394 <type>_calibscale is used.
395
Irina Tirdea40cb7612015-01-29 18:45:10 +0000396What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender
397What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender
398What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender
399What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender
Irina Tirdeae0631a32015-03-30 14:22:13 +0300400KernelVersion: 4.0
Irina Tirdea40cb7612015-01-29 18:45:10 +0000401Contact: linux-iio@vger.kernel.org
402Description:
403 Gender of the user (e.g.: male, female) used by some pedometers
404 to compute the stride length, distance, speed and activity
405 type.
406
407What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender_available
408What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender_available
409What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender_available
410What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender_available
Irina Tirdeae0631a32015-03-30 14:22:13 +0300411KernelVersion: 4.0
Irina Tirdea40cb7612015-01-29 18:45:10 +0000412Contact: linux-iio@vger.kernel.org
413Description:
414 Lists all available gender values (e.g.: male, female).
415
416What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibheight
417What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibheight
418What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibheight
419What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibheight
Irina Tirdeabcdf28f2014-11-10 14:45:33 +0200420KernelVersion: 3.19
421Contact: linux-iio@vger.kernel.org
422Description:
Irina Tirdea81110932015-01-27 20:41:53 +0200423 Height of the user (in meters) used by some pedometers
Irina Tirdeabcdf28f2014-11-10 14:45:33 +0200424 to compute the stride length, distance, speed and activity
425 type.
426
Irina Tirdead37f6832015-01-11 21:10:10 +0200427What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibweight
Irina Tirdeae0631a32015-03-30 14:22:13 +0300428KernelVersion: 4.0
Irina Tirdead37f6832015-01-11 21:10:10 +0200429Contact: linux-iio@vger.kernel.org
430Description:
431 Weight of the user (in kg). It is needed by some pedometers
432 to compute the calories burnt by the user.
433
Jonathan Camerona37b5492011-09-02 17:14:35 +0100434What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
Adriana Reusad376162015-06-12 19:01:07 +0300435What: /sys/.../iio:deviceX/in_anglvel_scale_available
436What: /sys/.../iio:deviceX/in_magn_scale_available
437What: /sys/.../iio:deviceX/in_illuminance_scale_available
438What: /sys/.../iio:deviceX/in_intensity_scale_available
439What: /sys/.../iio:deviceX/in_proximity_scale_available
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100440What: /sys/.../iio:deviceX/in_voltageX_scale_available
441What: /sys/.../iio:deviceX/in_voltage-voltage_scale_available
442What: /sys/.../iio:deviceX/out_voltageX_scale_available
Michael Hennerichd802bf62012-05-21 14:30:31 +0200443What: /sys/.../iio:deviceX/out_altvoltageX_scale_available
Jonathan Cameron0baf29d2011-09-21 11:15:52 +0100444What: /sys/.../iio:deviceX/in_capacitance_scale_available
Lars-Peter Clausenc4f0c692012-11-20 13:36:00 +0000445What: /sys/.../iio:deviceX/in_pressure_scale_available
446What: /sys/.../iio:deviceX/in_pressureY_scale_available
Peter Meerwaldcf09fe92012-07-01 12:20:11 +0200447KernelVersion: 2.6.35
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000448Contact: linux-iio@vger.kernel.org
449Description:
Peter Meerwald8b417d72012-06-12 15:31:27 +0200450 If a discrete set of scale values is available, they
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000451 are listed in this attribute.
452
Michael Hennerichb65d6212012-05-11 11:36:53 +0200453What /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
Roberta Dobrescued563302014-10-24 22:41:00 +0100454What: /sys/bus/iio/devices/iio:deviceX/in_intensity_red_hardwaregain
455What: /sys/bus/iio/devices/iio:deviceX/in_intensity_green_hardwaregain
456What: /sys/bus/iio/devices/iio:deviceX/in_intensity_blue_hardwaregain
457What: /sys/bus/iio/devices/iio:deviceX/in_intensity_clear_hardwaregain
Michael Hennerichb65d6212012-05-11 11:36:53 +0200458KernelVersion: 2.6.35
459Contact: linux-iio@vger.kernel.org
460Description:
461 Hardware applied gain factor. If shared across all channels,
462 <type>_hardwaregain is used.
463
Jonathan Cameron0c22db4392011-11-27 11:39:14 +0000464What: /sys/.../in_accel_filter_low_pass_3db_frequency
465What: /sys/.../in_magn_filter_low_pass_3db_frequency
466What: /sys/.../in_anglvel_filter_low_pass_3db_frequency
467KernelVersion: 3.2
468Contact: linux-iio@vger.kernel.org
469Description:
470 If a known or controllable low pass filter is applied
471 to the underlying data channel, then this parameter
472 gives the 3dB frequency of the filter in Hz.
473
Martin Fuzzey3f7f6422015-05-13 12:26:42 +0200474What: /sys/.../in_accel_filter_high_pass_3db_frequency
475What: /sys/.../in_anglvel_filter_high_pass_3db_frequency
476What: /sys/.../in_magn_filter_high_pass_3db_frequency
477KernelVersion: 4.2
478Contact: linux-iio@vger.kernel.org
479Description:
480 If a known or controllable high pass filter is applied
481 to the underlying data channel, then this parameter
482 gives the 3dB frequency of the filter in Hz.
483
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100484What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
Michael Hennerichd802bf62012-05-21 14:30:31 +0200485What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw
Roland Stigge98069c32011-01-13 17:43:29 +0100486KernelVersion: 2.6.37
487Contact: linux-iio@vger.kernel.org
488Description:
489 Raw (unscaled, no bias etc.) output voltage for
490 channel Y. The number must always be specified and
491 unique if the output corresponds to a single channel.
Michael Hennerichd802bf62012-05-21 14:30:31 +0200492 While DAC like devices typically use out_voltage,
493 a continuous frequency generating device, such as
494 a DDS or PLL should use out_altvoltage.
Roland Stigge98069c32011-01-13 17:43:29 +0100495
Jonathan Camerona37b5492011-09-02 17:14:35 +0100496What: /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
Michael Hennerichd802bf62012-05-21 14:30:31 +0200497What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw
Roland Stigge98069c32011-01-13 17:43:29 +0100498KernelVersion: 2.6.37
499Contact: linux-iio@vger.kernel.org
500Description:
501 Raw (unscaled, no bias etc.) output voltage for an aggregate of
502 channel Y, channel Z, etc. This interface is available in cases
503 where a single output sets the value for multiple channels
504 simultaneously.
505
Jonathan Camerona37b5492011-09-02 17:14:35 +0100506What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
507What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
Michael Hennerichd802bf62012-05-21 14:30:31 +0200508What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode
509What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode
Michael Hennerich14f88f12011-03-09 16:01:45 +0100510KernelVersion: 2.6.38
511Contact: linux-iio@vger.kernel.org
512Description:
513 Specifies the output powerdown mode.
514 DAC output stage is disconnected from the amplifier and
Vladimir Barinovbdb25b02015-07-29 15:57:41 +0300515 1kohm_to_gnd: connected to ground via an 1kOhm resistor,
Peter Meerwald8b417d72012-06-12 15:31:27 +0200516 6kohm_to_gnd: connected to ground via a 6kOhm resistor,
517 20kohm_to_gnd: connected to ground via a 20kOhm resistor,
Marc Andre8d144c92016-02-08 18:01:47 +0100518 90kohm_to_gnd: connected to ground via a 90kOhm resistor,
Peter Meerwald8b417d72012-06-12 15:31:27 +0200519 100kohm_to_gnd: connected to ground via an 100kOhm resistor,
Akinobu Mita35f73962015-12-26 21:17:22 +0900520 125kohm_to_gnd: connected to ground via an 125kOhm resistor,
Peter Meerwaldbd53a412013-06-23 22:30:00 +0100521 500kohm_to_gnd: connected to ground via a 500kOhm resistor,
Akinobu Mita35f73962015-12-26 21:17:22 +0900522 640kohm_to_gnd: connected to ground via a 640kOhm resistor,
Peter Meerwald8b417d72012-06-12 15:31:27 +0200523 three_state: left floating.
Michael Hennerich14f88f12011-03-09 16:01:45 +0100524 For a list of available output power down options read
525 outX_powerdown_mode_available. If Y is not present the
526 mode is shared across all outputs.
527
Vladimir Barinovbdb25b02015-07-29 15:57:41 +0300528What: /sys/.../iio:deviceX/out_voltageY_powerdown_mode_available
Jonathan Camerona37b5492011-09-02 17:14:35 +0100529What: /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
Vladimir Barinovbdb25b02015-07-29 15:57:41 +0300530What: /sys/.../iio:deviceX/out_altvoltageY_powerdown_mode_available
Michael Hennerichd802bf62012-05-21 14:30:31 +0200531What: /sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available
Michael Hennerich14f88f12011-03-09 16:01:45 +0100532KernelVersion: 2.6.38
533Contact: linux-iio@vger.kernel.org
534Description:
535 Lists all available output power down modes.
536 If Y is not present the mode is shared across all outputs.
537
Jonathan Camerona37b5492011-09-02 17:14:35 +0100538What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
539What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
Michael Hennerichd802bf62012-05-21 14:30:31 +0200540What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
541What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown
Michael Hennerich14f88f12011-03-09 16:01:45 +0100542KernelVersion: 2.6.38
543Contact: linux-iio@vger.kernel.org
544Description:
545 Writing 1 causes output Y to enter the power down mode specified
Peter Meerwald8b417d72012-06-12 15:31:27 +0200546 by the corresponding outY_powerdown_mode. DAC output stage is
547 disconnected from the amplifier. Clearing returns to normal
548 operation. Y may be suppressed if all outputs are controlled
549 together.
Michael Hennerich14f88f12011-03-09 16:01:45 +0100550
Michael Hennerichd802bf62012-05-21 14:30:31 +0200551What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency
552KernelVersion: 3.4.0
553Contact: linux-iio@vger.kernel.org
554Description:
555 Output frequency for channel Y in Hz. The number must always be
556 specified and unique if the output corresponds to a single
557 channel.
558
559What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase
560KernelVersion: 3.4.0
561Contact: linux-iio@vger.kernel.org
562Description:
563 Phase in radians of one frequency/clock output Y
564 (out_altvoltageY) relative to another frequency/clock output
565 (out_altvoltageZ) of the device X. The number must always be
566 specified and unique if the output corresponds to a single
567 channel.
568
Jonathan Cameronb3874062011-08-30 12:32:49 +0100569What: /sys/bus/iio/devices/iio:deviceX/events
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000570KernelVersion: 2.6.35
571Contact: linux-iio@vger.kernel.org
572Description:
573 Configuration of which hardware generated events are passed up
574 to user-space.
575
Jonathan Camerona37b5492011-09-02 17:14:35 +0100576What: /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
577What: /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
578What: /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
579What: /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
580What: /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
581What: /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100582What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
583What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
584What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
585What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
586What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
587What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
Jonathan Camerona37b5492011-09-02 17:14:35 +0100588What: /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
589What: /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
590What: /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
591What: /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
592What: /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
593What: /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
Reyad Attiyatb531db82014-07-17 19:18:00 +0100594What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_rising_en
595What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_falling_en
596What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_rising_en
597What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_falling_en
598What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_en
599What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_en
600What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_rising_en
601What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_falling_en
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100602What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
603What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
604What: /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
605What: /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
Vladimir Barinov72aa29c2015-08-28 17:27:52 +0300606What: /sys/.../iio:deviceX/events/in_voltageY_thresh_either_en
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100607What: /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
608What: /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100609KernelVersion: 2.6.37
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100610Contact: linux-iio@vger.kernel.org
611Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000612 Event generated when channel passes a threshold in the specified
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100613 (_rising|_falling) direction. If the direction is not specified,
614 then either the device will report an event which ever direction
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100615 a single threshold value is passed in (e.g.
616 <type>[Y][_name]_<raw|input>_thresh_value) or
617 <type>[Y][_name]_<raw|input>_thresh_rising_value and
618 <type>[Y][_name]_<raw|input>_thresh_falling_value may take
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000619 different values, but the device can only enable both thresholds
620 or neither.
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100621 Note the driver will assume the last p events requested are
Peter Meerwald8b417d72012-06-12 15:31:27 +0200622 to be enabled where p is how many it supports (which may vary
623 depending on the exact set requested. So if you want to be
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100624 sure you have set what you think you have, check the contents of
625 these attributes after everything is configured. Drivers may
626 have to buffer any parameters so that they are consistent when
Peter Meerwald8b417d72012-06-12 15:31:27 +0200627 a given event type is enabled at a future point (and not those for
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100628 whatever event was previously enabled).
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100629
Jonathan Camerona37b5492011-09-02 17:14:35 +0100630What: /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
631What: /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
632What: /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
633What: /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
634What: /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
635What: /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100636What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
637What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
638What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
639What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
640What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
641What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
Jonathan Camerona37b5492011-09-02 17:14:35 +0100642What: /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
643What: /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
644What: /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
645What: /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
646What: /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
647What: /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
Reyad Attiyatb531db82014-07-17 19:18:00 +0100648What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_rising_en
649What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_falling_en
650What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_rising_en
651What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_falling_en
652What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_rising_en
653What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_falling_en
654What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_rising_en
655What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_falling_en
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100656What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
657What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
658What: /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
659What: /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
660What: /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
661What: /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000662KernelVersion: 2.6.37
663Contact: linux-iio@vger.kernel.org
664Description:
665 Event generated when channel passes a threshold on the rate of
666 change (1st differential) in the specified (_rising|_falling)
667 direction. If the direction is not specified, then either the
668 device will report an event which ever direction a single
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100669 threshold value is passed in (e.g.
670 <type>[Y][_name]_<raw|input>_roc_value) or
671 <type>[Y][_name]_<raw|input>_roc_rising_value and
672 <type>[Y][_name]_<raw|input>_roc_falling_value may take
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000673 different values, but the device can only enable both rate of
674 change thresholds or neither.
675 Note the driver will assume the last p events requested are
676 to be enabled where p is however many it supports (which may
677 vary depending on the exact set requested. So if you want to be
678 sure you have set what you think you have, check the contents of
679 these attributes after everything is configured. Drivers may
680 have to buffer any parameters so that they are consistent when
681 a given event type is enabled a future point (and not those for
682 whatever event was previously enabled).
683
Haneen Mohammed40dbbfb2015-03-12 21:26:00 +0300684What: /sys/.../events/in_accel_thresh_rising_value
685What: /sys/.../events/in_accel_thresh_falling_value
Jonathan Camerona37b5492011-09-02 17:14:35 +0100686What: /sys/.../events/in_accel_x_raw_thresh_rising_value
687What: /sys/.../events/in_accel_x_raw_thresh_falling_value
688What: /sys/.../events/in_accel_y_raw_thresh_rising_value
689What: /sys/.../events/in_accel_y_raw_thresh_falling_value
690What: /sys/.../events/in_accel_z_raw_thresh_rising_value
691What: /sys/.../events/in_accel_z_raw_thresh_falling_value
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100692What: /sys/.../events/in_anglvel_x_raw_thresh_rising_value
693What: /sys/.../events/in_anglvel_x_raw_thresh_falling_value
694What: /sys/.../events/in_anglvel_y_raw_thresh_rising_value
695What: /sys/.../events/in_anglvel_y_raw_thresh_falling_value
696What: /sys/.../events/in_anglvel_z_raw_thresh_rising_value
697What: /sys/.../events/in_anglvel_z_raw_thresh_falling_value
Jonathan Camerona37b5492011-09-02 17:14:35 +0100698What: /sys/.../events/in_magn_x_raw_thresh_rising_value
699What: /sys/.../events/in_magn_x_raw_thresh_falling_value
700What: /sys/.../events/in_magn_y_raw_thresh_rising_value
701What: /sys/.../events/in_magn_y_raw_thresh_falling_value
702What: /sys/.../events/in_magn_z_raw_thresh_rising_value
703What: /sys/.../events/in_magn_z_raw_thresh_falling_value
Reyad Attiyatb531db82014-07-17 19:18:00 +0100704What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_rising_value
705What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_falling_value
706What: /sys/.../events/in_rot_from_north_true_raw_thresh_rising_value
707What: /sys/.../events/in_rot_from_north_true_raw_thresh_falling_value
708What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_rising_value
709What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_falling_value
710What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_rising_value
711What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_falling_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100712What: /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
713What: /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
Jonathan Camerona7322fc2012-04-13 10:24:19 +0100714What: /sys/.../events/in_voltageY_raw_thresh_rising_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100715What: /sys/.../events/in_voltageY_raw_thresh_falling_value
Jonathan Camerona7322fc2012-04-13 10:24:19 +0100716What: /sys/.../events/in_tempY_raw_thresh_rising_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100717What: /sys/.../events/in_tempY_raw_thresh_falling_value
Jon Brenner3c97c082012-04-24 11:56:49 -0500718What: /sys/.../events/in_illuminance0_thresh_falling_value
719what: /sys/.../events/in_illuminance0_thresh_rising_value
720what: /sys/.../events/in_proximity0_thresh_falling_value
721what: /sys/.../events/in_proximity0_thresh_rising_value
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100722KernelVersion: 2.6.37
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100723Contact: linux-iio@vger.kernel.org
724Description:
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100725 Specifies the value of threshold that the device is comparing
726 against for the events enabled by
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100727 <type>Y[_name]_thresh[_rising|falling]_en.
728 If separate attributes exist for the two directions, but
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000729 direction is not specified for this attribute, then a single
730 threshold value applies to both directions.
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100731 The raw or input element of the name indicates whether the
732 value is in raw device units or in processed units (as _raw
733 and _input do on sysfs direct channel read attributes).
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100734
Martin Fuzzeyd1bd4862015-02-19 15:16:04 +0100735What: /sys/.../events/in_accel_scale
736What: /sys/.../events/in_accel_peak_scale
737What: /sys/.../events/in_anglvel_scale
738What: /sys/.../events/in_magn_scale
739What: /sys/.../events/in_rot_from_north_magnetic_scale
740What: /sys/.../events/in_rot_from_north_true_scale
741What: /sys/.../events/in_voltage_scale
742What: /sys/.../events/in_voltage_supply_scale
743What: /sys/.../events/in_temp_scale
744What: /sys/.../events/in_illuminance_scale
745What: /sys/.../events/in_proximity_scale
746KernelVersion: 3.21
747Contact: linux-iio@vger.kernel.org
748Description:
749 Specifies the conversion factor from the standard units
750 to device specific units used to set the event trigger
751 threshold.
752
Lars-Peter Clausenec6670a2013-10-07 15:11:00 +0100753What: /sys/.../events/in_accel_x_thresh_rising_hysteresis
754What: /sys/.../events/in_accel_x_thresh_falling_hysteresis
755What: /sys/.../events/in_accel_x_thresh_either_hysteresis
756What: /sys/.../events/in_accel_y_thresh_rising_hysteresis
757What: /sys/.../events/in_accel_y_thresh_falling_hysteresis
758What: /sys/.../events/in_accel_y_thresh_either_hysteresis
759What: /sys/.../events/in_accel_z_thresh_rising_hysteresis
760What: /sys/.../events/in_accel_z_thresh_falling_hysteresis
761What: /sys/.../events/in_accel_z_thresh_either_hysteresis
762What: /sys/.../events/in_anglvel_x_thresh_rising_hysteresis
763What: /sys/.../events/in_anglvel_x_thresh_falling_hysteresis
764What: /sys/.../events/in_anglvel_x_thresh_either_hysteresis
765What: /sys/.../events/in_anglvel_y_thresh_rising_hysteresis
766What: /sys/.../events/in_anglvel_y_thresh_falling_hysteresis
767What: /sys/.../events/in_anglvel_y_thresh_either_hysteresis
768What: /sys/.../events/in_anglvel_z_thresh_rising_hysteresis
769What: /sys/.../events/in_anglvel_z_thresh_falling_hysteresis
770What: /sys/.../events/in_anglvel_z_thresh_either_hysteresis
771What: /sys/.../events/in_magn_x_thresh_rising_hysteresis
772What: /sys/.../events/in_magn_x_thresh_falling_hysteresis
773What: /sys/.../events/in_magn_x_thresh_either_hysteresis
774What: /sys/.../events/in_magn_y_thresh_rising_hysteresis
775What: /sys/.../events/in_magn_y_thresh_falling_hysteresis
776What: /sys/.../events/in_magn_y_thresh_either_hysteresis
777What: /sys/.../events/in_magn_z_thresh_rising_hysteresis
778What: /sys/.../events/in_magn_z_thresh_falling_hysteresis
779What: /sys/.../events/in_magn_z_thresh_either_hysteresis
Reyad Attiyatb531db82014-07-17 19:18:00 +0100780What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_hysteresis
781What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_hysteresis
782What: /sys/.../events/in_rot_from_north_magnetic_thresh_either_hysteresis
783What: /sys/.../events/in_rot_from_north_true_thresh_rising_hysteresis
784What: /sys/.../events/in_rot_from_north_true_thresh_falling_hysteresis
785What: /sys/.../events/in_rot_from_north_true_thresh_either_hysteresis
786What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_hysteresis
787What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_hysteresis
788What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_either_hysteresis
789What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_hysteresis
790What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_hysteresis
791What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_either_hysteresis
Lars-Peter Clausenec6670a2013-10-07 15:11:00 +0100792What: /sys/.../events/in_voltageY_thresh_rising_hysteresis
793What: /sys/.../events/in_voltageY_thresh_falling_hysteresis
794What: /sys/.../events/in_voltageY_thresh_either_hysteresis
795What: /sys/.../events/in_tempY_thresh_rising_hysteresis
796What: /sys/.../events/in_tempY_thresh_falling_hysteresis
797What: /sys/.../events/in_tempY_thresh_either_hysteresis
798What: /sys/.../events/in_illuminance0_thresh_falling_hysteresis
799what: /sys/.../events/in_illuminance0_thresh_rising_hysteresis
800what: /sys/.../events/in_illuminance0_thresh_either_hysteresis
801what: /sys/.../events/in_proximity0_thresh_falling_hysteresis
802what: /sys/.../events/in_proximity0_thresh_rising_hysteresis
803what: /sys/.../events/in_proximity0_thresh_either_hysteresis
804KernelVersion: 3.13
805Contact: linux-iio@vger.kernel.org
806Description:
807 Specifies the hysteresis of threshold that the device is comparing
808 against for the events enabled by
809 <type>Y[_name]_thresh[_(rising|falling)]_hysteresis.
810 If separate attributes exist for the two directions, but
811 direction is not specified for this attribute, then a single
812 hysteresis value applies to both directions.
813 For falling events the hysteresis is added to the _value attribute for
814 this event to get the upper threshold for when the event goes back to
815 normal, for rising events the hysteresis is subtracted from the _value
816 attribute. E.g. if in_voltage0_raw_thresh_rising_value is set to 1200
817 and in_voltage0_raw_thresh_rising_hysteresis is set to 50. The event
818 will get activated once in_voltage0_raw goes above 1200 and will become
Colin Ian Kingf792e352016-12-28 17:40:23 +0000819 deactivated again once the value falls below 1150.
Lars-Peter Clausenec6670a2013-10-07 15:11:00 +0100820
Jonathan Camerona37b5492011-09-02 17:14:35 +0100821What: /sys/.../events/in_accel_x_raw_roc_rising_value
822What: /sys/.../events/in_accel_x_raw_roc_falling_value
823What: /sys/.../events/in_accel_y_raw_roc_rising_value
824What: /sys/.../events/in_accel_y_raw_roc_falling_value
825What: /sys/.../events/in_accel_z_raw_roc_rising_value
826What: /sys/.../events/in_accel_z_raw_roc_falling_value
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100827What: /sys/.../events/in_anglvel_x_raw_roc_rising_value
828What: /sys/.../events/in_anglvel_x_raw_roc_falling_value
829What: /sys/.../events/in_anglvel_y_raw_roc_rising_value
830What: /sys/.../events/in_anglvel_y_raw_roc_falling_value
831What: /sys/.../events/in_anglvel_z_raw_roc_rising_value
832What: /sys/.../events/in_anglvel_z_raw_roc_falling_value
Jonathan Camerona37b5492011-09-02 17:14:35 +0100833What: /sys/.../events/in_magn_x_raw_roc_rising_value
834What: /sys/.../events/in_magn_x_raw_roc_falling_value
835What: /sys/.../events/in_magn_y_raw_roc_rising_value
836What: /sys/.../events/in_magn_y_raw_roc_falling_value
837What: /sys/.../events/in_magn_z_raw_roc_rising_value
838What: /sys/.../events/in_magn_z_raw_roc_falling_value
Reyad Attiyatb531db82014-07-17 19:18:00 +0100839What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_rising_value
840What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_falling_value
841What: /sys/.../events/in_rot_from_north_true_raw_roc_rising_value
842What: /sys/.../events/in_rot_from_north_true_raw_roc_falling_value
843What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_rising_value
844What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_falling_value
845What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_rising_value
846What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_falling_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100847What: /sys/.../events/in_voltageY_supply_raw_roc_rising_value
848What: /sys/.../events/in_voltageY_supply_raw_roc_falling_value
Jonathan Camerona7322fc2012-04-13 10:24:19 +0100849What: /sys/.../events/in_voltageY_raw_roc_rising_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100850What: /sys/.../events/in_voltageY_raw_roc_falling_value
Jonathan Camerona7322fc2012-04-13 10:24:19 +0100851What: /sys/.../events/in_tempY_raw_roc_rising_value
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100852What: /sys/.../events/in_tempY_raw_roc_falling_value
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100853KernelVersion: 2.6.37
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100854Contact: linux-iio@vger.kernel.org
855Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000856 Specifies the value of rate of change threshold that the
857 device is comparing against for the events enabled by
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100858 <type>[Y][_name]_roc[_rising|falling]_en.
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000859 If separate attributes exist for the two directions,
860 but direction is not specified for this attribute,
861 then a single threshold value applies to both directions.
862 The raw or input element of the name indicates whether the
863 value is in raw device units or in processed units (as _raw
864 and _input do on sysfs direct channel read attributes).
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100865
Jonathan Camerona37b5492011-09-02 17:14:35 +0100866What: /sys/.../events/in_accel_x_thresh_rising_period
867What: /sys/.../events/in_accel_x_thresh_falling_period
Martin Kepplinger5798cd22015-03-29 01:59:49 +0100868What: /sys/.../events/in_accel_x_roc_rising_period
Jonathan Camerona37b5492011-09-02 17:14:35 +0100869What: /sys/.../events/in_accel_x_roc_falling_period
870What: /sys/.../events/in_accel_y_thresh_rising_period
871What: /sys/.../events/in_accel_y_thresh_falling_period
872What: /sys/.../events/in_accel_y_roc_rising_period
873What: /sys/.../events/in_accel_y_roc_falling_period
874What: /sys/.../events/in_accel_z_thresh_rising_period
875What: /sys/.../events/in_accel_z_thresh_falling_period
876What: /sys/.../events/in_accel_z_roc_rising_period
877What: /sys/.../events/in_accel_z_roc_falling_period
Jonathan Camerond4c926f2011-10-05 15:28:00 +0100878What: /sys/.../events/in_anglvel_x_thresh_rising_period
879What: /sys/.../events/in_anglvel_x_thresh_falling_period
880What: /sys/.../events/in_anglvel_x_roc_rising_period
881What: /sys/.../events/in_anglvel_x_roc_falling_period
882What: /sys/.../events/in_anglvel_y_thresh_rising_period
883What: /sys/.../events/in_anglvel_y_thresh_falling_period
884What: /sys/.../events/in_anglvel_y_roc_rising_period
885What: /sys/.../events/in_anglvel_y_roc_falling_period
886What: /sys/.../events/in_anglvel_z_thresh_rising_period
887What: /sys/.../events/in_anglvel_z_thresh_falling_period
888What: /sys/.../events/in_anglvel_z_roc_rising_period
889What: /sys/.../events/in_anglvel_z_roc_falling_period
Jonathan Camerona37b5492011-09-02 17:14:35 +0100890What: /sys/.../events/in_magn_x_thresh_rising_period
891What: /sys/.../events/in_magn_x_thresh_falling_period
892What: /sys/.../events/in_magn_x_roc_rising_period
893What: /sys/.../events/in_magn_x_roc_falling_period
894What: /sys/.../events/in_magn_y_thresh_rising_period
895What: /sys/.../events/in_magn_y_thresh_falling_period
896What: /sys/.../events/in_magn_y_roc_rising_period
897What: /sys/.../events/in_magn_y_roc_falling_period
898What: /sys/.../events/in_magn_z_thresh_rising_period
899What: /sys/.../events/in_magn_z_thresh_falling_period
900What: /sys/.../events/in_magn_z_roc_rising_period
901What: /sys/.../events/in_magn_z_roc_falling_period
Reyad Attiyatb531db82014-07-17 19:18:00 +0100902What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_period
903What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_period
904What: /sys/.../events/in_rot_from_north_magnetic_roc_rising_period
905What: /sys/.../events/in_rot_from_north_magnetic_roc_falling_period
906What: /sys/.../events/in_rot_from_north_true_thresh_rising_period
907What: /sys/.../events/in_rot_from_north_true_thresh_falling_period
908What: /sys/.../events/in_rot_from_north_true_roc_rising_period
909What: /sys/.../events/in_rot_from_north_true_roc_falling_period
910What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_period
911What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_period
912What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_rising_period
913What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_falling_period
914What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_period
915What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_period
916What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_rising_period
917What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_falling_period
Jonathan Cameron15739cd2011-09-21 11:15:51 +0100918What: /sys/.../events/in_voltageY_supply_thresh_rising_period
919What: /sys/.../events/in_voltageY_supply_thresh_falling_period
920What: /sys/.../events/in_voltageY_supply_roc_rising_period
921What: /sys/.../events/in_voltageY_supply_roc_falling_period
922What: /sys/.../events/in_voltageY_thresh_rising_period
923What: /sys/.../events/in_voltageY_thresh_falling_period
924What: /sys/.../events/in_voltageY_roc_rising_period
925What: /sys/.../events/in_voltageY_roc_falling_period
926What: /sys/.../events/in_tempY_thresh_rising_period
927What: /sys/.../events/in_tempY_thresh_falling_period
928What: /sys/.../events/in_tempY_roc_rising_period
929What: /sys/.../events/in_tempY_roc_falling_period
Jonathan Camerona37b5492011-09-02 17:14:35 +0100930What: /sys/.../events/in_accel_x&y&z_mag_falling_period
Jon Brenner3c97c082012-04-24 11:56:49 -0500931What: /sys/.../events/in_intensity0_thresh_period
932What: /sys/.../events/in_proximity0_thresh_period
Irina Tirdea40cb7612015-01-29 18:45:10 +0000933What: /sys/.../events/in_activity_still_thresh_rising_period
934What: /sys/.../events/in_activity_still_thresh_falling_period
935What: /sys/.../events/in_activity_walking_thresh_rising_period
936What: /sys/.../events/in_activity_walking_thresh_falling_period
937What: /sys/.../events/in_activity_jogging_thresh_rising_period
938What: /sys/.../events/in_activity_jogging_thresh_falling_period
939What: /sys/.../events/in_activity_running_thresh_rising_period
940What: /sys/.../events/in_activity_running_thresh_falling_period
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100941KernelVersion: 2.6.37
Jonathan Camerone34d2c52010-05-04 14:43:05 +0100942Contact: linux-iio@vger.kernel.org
943Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +0000944 Period of time (in seconds) for which the condition must be
945 met before an event is generated. If direction is not
Jonathan Cameron2f3cc662010-10-08 12:14:12 +0100946 specified then this period applies to both directions.
947
Martin Fuzzey3f7f6422015-05-13 12:26:42 +0200948What: /sys/.../events/in_accel_thresh_rising_low_pass_filter_3db
949What: /sys/.../events/in_anglvel_thresh_rising_low_pass_filter_3db
950What: /sys/.../events/in_magn_thresh_rising_low_pass_filter_3db
951KernelVersion: 4.2
952Contact: linux-iio@vger.kernel.org
953Description:
954 If a low pass filter can be applied to the event generation
955 this property gives its 3db frequency in Hz.
956 A value of zero disables the filter.
957
958What: /sys/.../events/in_accel_thresh_rising_high_pass_filter_3db
959What: /sys/.../events/in_anglvel_thresh_rising_high_pass_filter_3db
960What: /sys/.../events/in_magn_thresh_rising_high_pass_filter_3db
961KernelVersion: 4.2
962Contact: linux-iio@vger.kernel.org
963Description:
964 If a high pass filter can be applied to the event generation
965 this property gives its 3db frequency in Hz.
966 A value of zero disables the filter.
967
Daniel Baluta55aebeb2014-11-10 14:45:30 +0200968What: /sys/.../events/in_activity_still_thresh_rising_en
969What: /sys/.../events/in_activity_still_thresh_falling_en
970What: /sys/.../events/in_activity_walking_thresh_rising_en
971What: /sys/.../events/in_activity_walking_thresh_falling_en
972What: /sys/.../events/in_activity_jogging_thresh_rising_en
973What: /sys/.../events/in_activity_jogging_thresh_falling_en
974What: /sys/.../events/in_activity_running_thresh_rising_en
975What: /sys/.../events/in_activity_running_thresh_falling_en
976KernelVersion: 3.19
977Contact: linux-iio@vger.kernel.org
978Description:
979 Enables or disables activitity events. Depending on direction
980 an event is generated when sensor ENTERS or LEAVES a given state.
981
982What: /sys/.../events/in_activity_still_thresh_rising_value
983What: /sys/.../events/in_activity_still_thresh_falling_value
984What: /sys/.../events/in_activity_walking_thresh_rising_value
985What: /sys/.../events/in_activity_walking_thresh_falling_value
986What: /sys/.../events/in_activity_jogging_thresh_rising_value
987What: /sys/.../events/in_activity_jogging_thresh_falling_value
988What: /sys/.../events/in_activity_running_thresh_rising_value
989What: /sys/.../events/in_activity_running_thresh_falling_value
990KernelVersion: 3.19
991Contact: linux-iio@vger.kernel.org
992Description:
993 Confidence value (in units as percentage) to be used
994 for deciding when an event should be generated. E.g for
995 running: If the confidence value reported by the sensor
996 is greater than in_activity_running_thresh_rising_value
997 then the sensor ENTERS running state. Conversely, if the
998 confidence value reported by the sensor is lower than
999 in_activity_running_thresh_falling_value then the sensor
1000 is LEAVING running state.
1001
Jonathan Camerona37b5492011-09-02 17:14:35 +01001002What: /sys/.../iio:deviceX/events/in_accel_mag_en
1003What: /sys/.../iio:deviceX/events/in_accel_mag_rising_en
1004What: /sys/.../iio:deviceX/events/in_accel_mag_falling_en
1005What: /sys/.../iio:deviceX/events/in_accel_x_mag_en
1006What: /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
1007What: /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
1008What: /sys/.../iio:deviceX/events/in_accel_y_mag_en
1009What: /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
1010What: /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
1011What: /sys/.../iio:deviceX/events/in_accel_z_mag_en
1012What: /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
1013What: /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
1014What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
1015What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
Jonathan Cameron2f3cc662010-10-08 12:14:12 +01001016KernelVersion: 2.6.37
1017Contact: linux-iio@vger.kernel.org
1018Description:
Jonathan Camerona37b5492011-09-02 17:14:35 +01001019 Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
Jonathan Cameron2f3cc662010-10-08 12:14:12 +01001020 magnitude of the channel is compared to the threshold, not its
1021 signed value.
1022
Jonathan Camerona37b5492011-09-02 17:14:35 +01001023What: /sys/.../events/in_accel_raw_mag_value
1024What: /sys/.../events/in_accel_x_raw_mag_rising_value
1025What: /sys/.../events/in_accel_y_raw_mag_rising_value
1026What: /sys/.../events/in_accel_z_raw_mag_rising_value
Jonathan Cameron2f3cc662010-10-08 12:14:12 +01001027KernelVersion: 2.6.37
1028Contact: linux-iio@vger.kernel.org
1029Description:
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001030 The value to which the magnitude of the channel is compared. If
1031 number or direction is not specified, applies to all channels of
1032 this type.
Jonathan Cameron2f3cc662010-10-08 12:14:12 +01001033
Irina Tirdea27be8422015-01-11 21:10:11 +02001034What: /sys/.../events/in_steps_change_en
Irina Tirdeae0631a32015-03-30 14:22:13 +03001035KernelVersion: 4.0
Irina Tirdeaa88bfe72014-11-10 14:45:32 +02001036Contact: linux-iio@vger.kernel.org
1037Description:
Irina Tirdea27be8422015-01-11 21:10:11 +02001038 Event generated when channel passes a threshold on the absolute
1039 change in value. E.g. for steps: a step change event is
1040 generated each time the user takes N steps, where N is set using
1041 in_steps_change_value.
1042
1043What: /sys/.../events/in_steps_change_value
Irina Tirdeae0631a32015-03-30 14:22:13 +03001044KernelVersion: 4.0
Irina Tirdea27be8422015-01-11 21:10:11 +02001045Contact: linux-iio@vger.kernel.org
1046Description:
1047 Specifies the value of change threshold that the
1048 device is comparing against for the events enabled by
1049 <type>[Y][_name]_roc[_rising|falling|]_en. E.g. for steps:
1050 if set to 3, a step change event will be generated every 3
1051 steps.
Irina Tirdeaa88bfe72014-11-10 14:45:32 +02001052
Jonathan Cameronb3874062011-08-30 12:32:49 +01001053What: /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
Jonathan Camerone34d2c52010-05-04 14:43:05 +01001054KernelVersion: 2.6.35
1055Contact: linux-iio@vger.kernel.org
1056Description:
1057 The name of the trigger source being used, as per string given
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001058 in /sys/class/iio/triggerY/name.
Jonathan Camerone34d2c52010-05-04 14:43:05 +01001059
Jonathan Cameronb3874062011-08-30 12:32:49 +01001060What: /sys/bus/iio/devices/iio:deviceX/buffer/length
Jonathan Camerone34d2c52010-05-04 14:43:05 +01001061KernelVersion: 2.6.35
1062Contact: linux-iio@vger.kernel.org
1063Description:
1064 Number of scans contained by the buffer.
1065
Jonathan Cameronb3874062011-08-30 12:32:49 +01001066What: /sys/bus/iio/devices/iio:deviceX/buffer/enable
Jonathan Camerone34d2c52010-05-04 14:43:05 +01001067KernelVersion: 2.6.35
1068Contact: linux-iio@vger.kernel.org
1069Description:
1070 Actually start the buffer capture up. Will start trigger
1071 if first device and appropriate.
1072
Alexandre Relangeab52a952013-06-11 15:52:00 +01001073What: /sys/bus/iio/devices/iio:deviceX/scan_elements
Manuel Stahl5770b8f2010-08-31 11:32:53 +02001074KernelVersion: 2.6.37
1075Contact: linux-iio@vger.kernel.org
1076Description:
Jonathan Cameron2f3cc662010-10-08 12:14:12 +01001077 Directory containing interfaces for elements that will be
1078 captured for a single triggered sample set in the buffer.
Manuel Stahl5770b8f2010-08-31 11:32:53 +02001079
Alexandre Relangeab52a952013-06-11 15:52:00 +01001080What: /sys/.../iio:deviceX/scan_elements/in_accel_x_en
1081What: /sys/.../iio:deviceX/scan_elements/in_accel_y_en
1082What: /sys/.../iio:deviceX/scan_elements/in_accel_z_en
1083What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_en
1084What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_en
1085What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_en
1086What: /sys/.../iio:deviceX/scan_elements/in_magn_x_en
1087What: /sys/.../iio:deviceX/scan_elements/in_magn_y_en
1088What: /sys/.../iio:deviceX/scan_elements/in_magn_z_en
Reyad Attiyatb531db82014-07-17 19:18:00 +01001089What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_en
1090What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_en
1091What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_en
1092What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_en
Alexandre Relangeab52a952013-06-11 15:52:00 +01001093What: /sys/.../iio:deviceX/scan_elements/in_timestamp_en
1094What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_en
1095What: /sys/.../iio:deviceX/scan_elements/in_voltageY_en
1096What: /sys/.../iio:deviceX/scan_elements/in_voltageY-voltageZ_en
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +02001097What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_en
1098What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_en
1099What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_en
1100What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_en
Alexandre Relangeab52a952013-06-11 15:52:00 +01001101What: /sys/.../iio:deviceX/scan_elements/in_incli_x_en
1102What: /sys/.../iio:deviceX/scan_elements/in_incli_y_en
1103What: /sys/.../iio:deviceX/scan_elements/in_pressureY_en
1104What: /sys/.../iio:deviceX/scan_elements/in_pressure_en
Srinivas Pandruvadab4a2d472014-04-29 00:51:00 +01001105What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_en
Haneen Mohammed1fad0342015-03-12 18:52:50 +03001106What: /sys/.../iio:deviceX/scan_elements/in_proximity_en
Manuel Stahl5770b8f2010-08-31 11:32:53 +02001107KernelVersion: 2.6.37
1108Contact: linux-iio@vger.kernel.org
1109Description:
Jonathan Cameron10ba8ea2010-09-21 14:41:08 +01001110 Scan element control for triggered data capture.
Manuel Stahl5770b8f2010-08-31 11:32:53 +02001111
Alexandre Relangeab52a952013-06-11 15:52:00 +01001112What: /sys/.../iio:deviceX/scan_elements/in_accel_type
1113What: /sys/.../iio:deviceX/scan_elements/in_anglvel_type
1114What: /sys/.../iio:deviceX/scan_elements/in_magn_type
1115What: /sys/.../iio:deviceX/scan_elements/in_incli_type
1116What: /sys/.../iio:deviceX/scan_elements/in_voltageY_type
1117What: /sys/.../iio:deviceX/scan_elements/in_voltage_type
1118What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_type
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +02001119What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_type
1120What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_type
1121What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_type
1122What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_type
Alexandre Relangeab52a952013-06-11 15:52:00 +01001123What: /sys/.../iio:deviceX/scan_elements/in_timestamp_type
1124What: /sys/.../iio:deviceX/scan_elements/in_pressureY_type
1125What: /sys/.../iio:deviceX/scan_elements/in_pressure_type
Srinivas Pandruvadab4a2d472014-04-29 00:51:00 +01001126What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_type
Haneen Mohammed1fad0342015-03-12 18:52:50 +03001127What: /sys/.../iio:deviceX/scan_elements/in_proximity_type
Manuel Stahl5770b8f2010-08-31 11:32:53 +02001128KernelVersion: 2.6.37
1129Contact: linux-iio@vger.kernel.org
1130Description:
Jonathan Cameron10ba8ea2010-09-21 14:41:08 +01001131 Description of the scan element data storage within the buffer
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001132 and hence the form in which it is read from user-space.
Jonathan Cameron15739cd2011-09-21 11:15:51 +01001133 Form is [be|le]:[s|u]bits/storagebits[>>shift].
1134 be or le specifies big or little endian. s or u specifies if
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001135 signed (2's complement) or unsigned. bits is the number of bits
1136 of data and storagebits is the space (after padding) that it
1137 occupies in the buffer. shift if specified, is the shift that
1138 needs to be applied prior to masking out unused bits. Some
1139 devices put their data in the middle of the transferred elements
1140 with additional information on both sides. Note that some
1141 devices will have additional information in the unused bits
1142 so to get a clean value, the bits value must be used to mask
1143 the buffer output value appropriately. The storagebits value
1144 also specifies the data alignment. So s48/64>>2 will be a
1145 signed 48 bit integer stored in a 64 bit location aligned to
Peter Meerwald8b417d72012-06-12 15:31:27 +02001146 a 64 bit boundary. To obtain the clean value, shift right 2
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001147 and apply a mask to zero the top 16 bits of the result.
Jonathan Cameron10ba8ea2010-09-21 14:41:08 +01001148 For other storage combinations this attribute will be extended
1149 appropriately.
1150
Alexandre Relangeab52a952013-06-11 15:52:00 +01001151What: /sys/.../iio:deviceX/scan_elements/in_accel_type_available
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001152KernelVersion: 2.6.37
1153Contact: linux-iio@vger.kernel.org
1154Description:
1155 If the type parameter can take one of a small set of values,
1156 this attribute lists them.
1157
Alexandre Relangeab52a952013-06-11 15:52:00 +01001158What: /sys/.../iio:deviceX/scan_elements/in_voltageY_index
1159What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_index
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +02001160What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_index
1161What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_index
1162What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_index
1163What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_index
Alexandre Relangeab52a952013-06-11 15:52:00 +01001164What: /sys/.../iio:deviceX/scan_elements/in_accel_x_index
1165What: /sys/.../iio:deviceX/scan_elements/in_accel_y_index
1166What: /sys/.../iio:deviceX/scan_elements/in_accel_z_index
1167What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_index
1168What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_index
1169What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_index
1170What: /sys/.../iio:deviceX/scan_elements/in_magn_x_index
1171What: /sys/.../iio:deviceX/scan_elements/in_magn_y_index
1172What: /sys/.../iio:deviceX/scan_elements/in_magn_z_index
Reyad Attiyatb531db82014-07-17 19:18:00 +01001173What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_index
1174What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_index
1175What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_index
1176What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_index
Alexandre Relangeab52a952013-06-11 15:52:00 +01001177What: /sys/.../iio:deviceX/scan_elements/in_incli_x_index
1178What: /sys/.../iio:deviceX/scan_elements/in_incli_y_index
1179What: /sys/.../iio:deviceX/scan_elements/in_timestamp_index
1180What: /sys/.../iio:deviceX/scan_elements/in_pressureY_index
1181What: /sys/.../iio:deviceX/scan_elements/in_pressure_index
Srinivas Pandruvadab4a2d472014-04-29 00:51:00 +01001182What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_index
Haneen Mohammed1fad0342015-03-12 18:52:50 +03001183What: /sys/.../iio:deviceX/scan_elements/in_proximity_index
Jonathan Cameron10ba8ea2010-09-21 14:41:08 +01001184KernelVersion: 2.6.37
1185Contact: linux-iio@vger.kernel.org
1186Description:
1187 A single positive integer specifying the position of this
Jonathan Cameronf386caa2010-11-22 23:31:16 +00001188 scan element in the buffer. Note these are not dependent on
1189 what is enabled and may not be contiguous. Thus for user-space
Jonathan Cameron10ba8ea2010-09-21 14:41:08 +01001190 to establish the full layout these must be used in conjunction
1191 with all _en attributes to establish which channels are present,
1192 and the relevant _type attributes to establish the data storage
1193 format.
Michael Hennerichd4894632011-04-06 11:42:48 +02001194
Daniel Baluta55aebeb2014-11-10 14:45:30 +02001195What: /sys/.../iio:deviceX/in_activity_still_input
1196What: /sys/.../iio:deviceX/in_activity_walking_input
1197What: /sys/.../iio:deviceX/in_activity_jogging_input
1198What: /sys/.../iio:deviceX/in_activity_running_input
1199KernelVersion: 3.19
1200Contact: linux-iio@vger.kernel.org
1201Description:
1202 This attribute is used to read the confidence for an activity
1203 expressed in units as percentage.
1204
Jonathan Camerond4c926f2011-10-05 15:28:00 +01001205What: /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
Michael Hennerichd4894632011-04-06 11:42:48 +02001206KernelVersion: 2.6.38
Jonathan Camerona37b5492011-09-02 17:14:35 +01001207Contact: linux-iio@vger.kernel.org
Michael Hennerichd4894632011-04-06 11:42:48 +02001208Description:
1209 This attribute is used to read the amount of quadrature error
1210 present in the device at a given time.
Peter Meerwaldf7883d12013-06-23 22:30:00 +01001211
Oleksandr Kravchenko63fa65d2013-08-28 12:01:00 +01001212What: /sys/.../iio:deviceX/in_accelX_power_mode
1213KernelVersion: 3.11
1214Contact: linux-iio@vger.kernel.org
1215Description:
1216 Specifies the chip power mode.
1217 low_noise: reduce noise level from ADC,
1218 low_power: enable low current consumption.
1219 For a list of available output power modes read
1220 in_accel_power_mode_available.
1221
Irina Tirdea72c66642015-01-11 21:10:07 +02001222What: /sys/.../iio:deviceX/in_energy_input
1223What: /sys/.../iio:deviceX/in_energy_raw
Irina Tirdeae0631a32015-03-30 14:22:13 +03001224KernelVersion: 4.0
Irina Tirdea72c66642015-01-11 21:10:07 +02001225Contact: linux-iio@vger.kernel.org
1226Description:
1227 This attribute is used to read the energy value reported by the
1228 device (e.g.: human activity sensors report energy burnt by the
1229 user). Units after application of scale are Joules.
1230
Irina Tirdeacc3c9ee2015-01-11 21:10:08 +02001231What: /sys/.../iio:deviceX/in_distance_input
1232What: /sys/.../iio:deviceX/in_distance_raw
Irina Tirdeae0631a32015-03-30 14:22:13 +03001233KernelVersion: 4.0
Irina Tirdeacc3c9ee2015-01-11 21:10:08 +02001234Contact: linux-iio@vger.kernel.org
1235Description:
1236 This attribute is used to read the distance covered by the user
1237 since the last reboot while activated. Units after application
1238 of scale are meters.
1239
Peter Meerwaldf7883d12013-06-23 22:30:00 +01001240What: /sys/bus/iio/devices/iio:deviceX/store_eeprom
1241KernelVersion: 3.4.0
1242Contact: linux-iio@vger.kernel.org
1243Description:
1244 Writing '1' stores the current device configuration into
1245 on-chip EEPROM. After power-up or chip reset the device will
1246 automatically load the saved configuration.
Peter Meerwald899d90b2013-09-08 16:20:00 +01001247
Peter Meerwald6c0690e2014-03-05 11:57:00 +00001248What: /sys/.../iio:deviceX/in_proximity_raw
1249What: /sys/.../iio:deviceX/in_proximity_input
1250What: /sys/.../iio:deviceX/in_proximityY_raw
1251KernelVersion: 3.4
1252Contact: linux-iio@vger.kernel.org
1253Description:
1254 Proximity measurement indicating that some
Peter Meerwald4fbcfa02016-03-13 16:02:22 +01001255 object is near the sensor, usually by observing
Peter Meerwald6c0690e2014-03-05 11:57:00 +00001256 reflectivity of infrared or ultrasound emitted.
1257 Often these sensors are unit less and as such conversion
Daniel Balutabdc10d52015-06-11 18:49:33 +03001258 to SI units is not possible. Higher proximity measurements
Enric Balletbo i Serraa9c99c72017-01-11 16:51:38 +01001259 indicate closer objects, and vice versa. Units after
1260 application of scale and offset are meters.
Peter Meerwald6c0690e2014-03-05 11:57:00 +00001261
Darshana Padmadas7cf78db2015-03-16 17:18:20 +05301262What: /sys/.../iio:deviceX/in_illuminance_input
1263What: /sys/.../iio:deviceX/in_illuminance_raw
Peter Meerwald994265f2014-02-05 16:54:00 +00001264What: /sys/.../iio:deviceX/in_illuminanceY_input
1265What: /sys/.../iio:deviceX/in_illuminanceY_raw
1266What: /sys/.../iio:deviceX/in_illuminanceY_mean_raw
Darshana Padmadas7cf78db2015-03-16 17:18:20 +05301267What: /sys/.../iio:deviceX/in_illuminance_ir_raw
1268What: /sys/.../iio:deviceX/in_illuminance_clear_raw
Peter Meerwald994265f2014-02-05 16:54:00 +00001269KernelVersion: 3.4
1270Contact: linux-iio@vger.kernel.org
1271Description:
1272 Illuminance measurement, units after application of scale
1273 and offset are lux.
1274
Peter Meerwald065b0552014-02-05 16:54:00 +00001275What: /sys/.../iio:deviceX/in_intensityY_raw
1276What: /sys/.../iio:deviceX/in_intensityY_ir_raw
1277What: /sys/.../iio:deviceX/in_intensityY_both_raw
Peter Meerwald-Stadler2c5ff1f2016-03-20 16:20:22 +01001278What: /sys/.../iio:deviceX/in_intensityY_uv_raw
Peter Meerwald065b0552014-02-05 16:54:00 +00001279KernelVersion: 3.4
1280Contact: linux-iio@vger.kernel.org
1281Description:
1282 Unit-less light intensity. Modifiers both and ir indicate
1283 that measurements contains visible and infrared light
Peter Meerwald-Stadler2c5ff1f2016-03-20 16:20:22 +01001284 components or just infrared light, respectively. Modifier uv indicates
1285 that measurements contain ultraviolet light components.
Peter Meerwald065b0552014-02-05 16:54:00 +00001286
Peter Meerwald-Stadlerd4094042016-03-20 16:20:23 +01001287What: /sys/.../iio:deviceX/in_uvindex_input
1288KernelVersion: 4.6
1289Contact: linux-iio@vger.kernel.org
1290Description:
1291 UV light intensity index measuring the human skin's response to
1292 different wavelength of sunlight weighted according to the
1293 standardised CIE Erythemal Action Spectrum. UV index values range
1294 from 0 (low) to >=11 (extreme).
1295
Peter Meerwald899d90b2013-09-08 16:20:00 +01001296What: /sys/.../iio:deviceX/in_intensity_red_integration_time
1297What: /sys/.../iio:deviceX/in_intensity_green_integration_time
1298What: /sys/.../iio:deviceX/in_intensity_blue_integration_time
1299What: /sys/.../iio:deviceX/in_intensity_clear_integration_time
1300What: /sys/.../iio:deviceX/in_illuminance_integration_time
1301KernelVersion: 3.12
1302Contact: linux-iio@vger.kernel.org
1303Description:
1304 This attribute is used to get/set the integration time in
1305 seconds.
Srinivas Pandruvadab4a2d472014-04-29 00:51:00 +01001306
Irina Tirdea40cb7612015-01-29 18:45:10 +00001307What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_integration_time
Irina Tirdeae0631a32015-03-30 14:22:13 +03001308KernelVersion: 4.0
Irina Tirdea40cb7612015-01-29 18:45:10 +00001309Contact: linux-iio@vger.kernel.org
1310Description:
1311 Number of seconds in which to compute speed.
1312
Srinivas Pandruvadab4a2d472014-04-29 00:51:00 +01001313What: /sys/bus/iio/devices/iio:deviceX/in_rot_quaternion_raw
1314KernelVersion: 3.15
1315Contact: linux-iio@vger.kernel.org
1316Description:
1317 Raw value of quaternion components using a format
1318 x y z w. Here x, y, and z component represents the axis about
1319 which a rotation will occur and w component represents the
1320 amount of rotation.
Reyad Attiyatb531db82014-07-17 19:18:00 +01001321
1322What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_raw
1323What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_raw
1324What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_raw
1325What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_raw
1326KernelVersion: 3.15
1327Contact: linux-iio@vger.kernel.org
1328Description:
1329 Raw value of rotation from true/magnetic north measured with
1330 or without compensation from tilt sensors.
Jacob Panc20d4df2014-09-17 01:11:00 +01001331
1332What: /sys/bus/iio/devices/iio:deviceX/in_currentX_raw
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +02001333What: /sys/bus/iio/devices/iio:deviceX/in_currentX_i_raw
1334What: /sys/bus/iio/devices/iio:deviceX/in_currentX_q_raw
Jacob Panc20d4df2014-09-17 01:11:00 +01001335KernelVersion: 3.18
1336Contact: linux-iio@vger.kernel.org
1337Description:
1338 Raw current measurement from channel X. Units are in milliamps
1339 after application of scale and offset. If no offset or scale is
1340 present, output should be considered as processed with the
1341 unit in milliamps.
Irina Tirdeaa88bfe72014-11-10 14:45:32 +02001342
Lars-Peter Clausen1ce87f22015-05-22 18:17:38 +02001343 Channels with 'i' and 'q' modifiers always exist in pairs and both
1344 channels refer to the same signal. The 'i' channel contains the in-phase
1345 component of the signal while the 'q' channel contains the quadrature
1346 component.
1347
Irina Tirdea40cb7612015-01-29 18:45:10 +00001348What: /sys/.../iio:deviceX/in_energy_en
1349What: /sys/.../iio:deviceX/in_distance_en
1350What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_en
Irina Tirdeaa88bfe72014-11-10 14:45:32 +02001351What: /sys/.../iio:deviceX/in_steps_en
1352KernelVersion: 3.19
1353Contact: linux-iio@vger.kernel.org
1354Description:
Irina Tirdea40cb7612015-01-29 18:45:10 +00001355 Activates a device feature that runs in firmware/hardware.
1356 E.g. for steps: the pedometer saves power while not used;
1357 when activated, it will count the steps taken by the user in
1358 firmware and export them through in_steps_input.
Irina Tirdeaa88bfe72014-11-10 14:45:32 +02001359
1360What: /sys/.../iio:deviceX/in_steps_input
1361KernelVersion: 3.19
1362Contact: linux-iio@vger.kernel.org
1363Description:
1364 This attribute is used to read the number of steps taken by the user
1365 since the last reboot while activated.
Irina Tirdea5a1a9322015-01-11 21:10:09 +02001366
1367What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_input
1368What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_raw
1369KernelVersion: 3.19
1370Contact: linux-iio@vger.kernel.org
1371Description:
1372 This attribute is used to read the current speed value of the
1373 user (which is the norm or magnitude of the velocity vector).
1374 Units after application of scale are m/s.
Irina Tirdea2f0ecb72015-01-27 20:41:52 +02001375
1376What: /sys/.../iio:deviceX/in_steps_debounce_count
Irina Tirdeae0631a32015-03-30 14:22:13 +03001377KernelVersion: 4.0
Irina Tirdea2f0ecb72015-01-27 20:41:52 +02001378Contact: linux-iio@vger.kernel.org
1379Description:
1380 Specifies the number of steps that must occur within
1381 in_steps_filter_debounce_time for the pedometer to decide the
1382 consumer is making steps.
1383
1384What: /sys/.../iio:deviceX/in_steps_debounce_time
Irina Tirdeae0631a32015-03-30 14:22:13 +03001385KernelVersion: 4.0
Irina Tirdea2f0ecb72015-01-27 20:41:52 +02001386Contact: linux-iio@vger.kernel.org
1387Description:
1388 Specifies number of seconds in which we compute the steps
1389 that occur in order to decide if the consumer is making steps.
Josselin Costanzi37d34552015-03-22 20:33:38 +02001390
1391What: /sys/bus/iio/devices/iio:deviceX/buffer/watermark
1392KernelVersion: 4.2
1393Contact: linux-iio@vger.kernel.org
1394Description:
1395 A single positive integer specifying the maximum number of scan
1396 elements to wait for.
1397 Poll will block until the watermark is reached.
1398 Blocking read will wait until the minimum between the requested
1399 read amount or the low water mark is available.
1400 Non-blocking read will retrieve the available samples from the
1401 buffer even if there are less samples then watermark level. This
1402 allows the application to block on poll with a timeout and read
1403 the available samples after the timeout expires and thus have a
1404 maximum delay guarantee.
Octavian Purdilaf4f46732015-03-22 20:33:39 +02001405
1406What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_enabled
1407KernelVersion: 4.2
1408Contact: linux-iio@vger.kernel.org
1409Description:
1410 A read-only boolean value that indicates if the hardware fifo is
1411 currently enabled or disabled. If the device does not have a
1412 hardware fifo this entry is not present.
1413 The hardware fifo is enabled when the buffer is enabled if the
1414 current hardware fifo watermark level is set and other current
1415 device settings allows it (e.g. if a trigger is set that samples
1416 data differently that the hardware fifo does then hardware fifo
1417 will not enabled).
1418 If the hardware fifo is enabled and the level of the hardware
1419 fifo reaches the hardware fifo watermark level the device will
1420 flush its hardware fifo to the device buffer. Doing a non
1421 blocking read on the device when no samples are present in the
1422 device buffer will also force a flush.
1423 When the hardware fifo is enabled there is no need to use a
1424 trigger to use buffer mode since the watermark settings
1425 guarantees that the hardware fifo is flushed to the device
1426 buffer.
1427
Srinivas Pandruvada138bc792017-04-07 19:22:06 -07001428What: /sys/bus/iio/devices/iio:device*/buffer/hwfifo_timeout
1429KernelVersion: 4.12
1430Contact: linux-iio@vger.kernel.org
1431Description:
1432 A read/write property to provide capability to delay reporting of
1433 samples till a timeout is reached. This allows host processors to
1434 sleep, while the sensor is storing samples in its internal fifo.
1435 The maximum timeout in seconds can be specified by setting
1436 hwfifo_timeout.The current delay can be read by reading
1437 hwfifo_timeout. A value of 0 means that there is no timeout.
1438
Octavian Purdilaf4f46732015-03-22 20:33:39 +02001439What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark
1440KernelVersion: 4.2
1441Contact: linux-iio@vger.kernel.org
1442Description:
1443 Read-only entry that contains a single integer specifying the
1444 current watermark level for the hardware fifo. If the device
1445 does not have a hardware fifo this entry is not present.
1446 The watermark level for the hardware fifo is set by the driver
1447 based on the value set by the user in buffer/watermark but
1448 taking into account hardware limitations (e.g. most hardware
1449 buffers are limited to 32-64 samples, some hardware buffers
1450 watermarks are fixed or have minimum levels). A value of 0
1451 means that the hardware watermark is unset.
1452
1453What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_min
1454KernelVersion: 4.2
1455Contact: linux-iio@vger.kernel.org
1456Description:
1457 A single positive integer specifying the minimum watermark level
1458 for the hardware fifo of this device. If the device does not
1459 have a hardware fifo this entry is not present.
1460 If the user sets buffer/watermark to a value less than this one,
1461 then the hardware watermark will remain unset.
1462
1463What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_max
1464KernelVersion: 4.2
1465Contact: linux-iio@vger.kernel.org
1466Description:
1467 A single positive integer specifying the maximum watermark level
1468 for the hardware fifo of this device. If the device does not
1469 have a hardware fifo this entry is not present.
1470 If the user sets buffer/watermark to a value greater than this
1471 one, then the hardware watermark will be capped at this value.
1472
1473What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_available
1474KernelVersion: 4.2
1475Contact: linux-iio@vger.kernel.org
1476Description:
1477 A list of positive integers specifying the available watermark
1478 levels for the hardware fifo. This entry is optional and if it
1479 is not present it means that all the values between
1480 hwfifo_watermark_min and hwfifo_watermark_max are supported.
1481 If the user sets buffer/watermark to a value greater than
1482 hwfifo_watermak_min but not equal to any of the values in this
1483 list, the driver will chose an appropriate value for the
1484 hardware fifo watermark level.
Vianney le Clément de Saint-Marcqc8a85852015-03-30 10:34:58 +02001485
1486What: /sys/bus/iio/devices/iio:deviceX/in_temp_calibemissivity
1487What: /sys/bus/iio/devices/iio:deviceX/in_tempX_calibemissivity
1488What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_calibemissivity
1489What: /sys/bus/iio/devices/iio:deviceX/in_tempX_object_calibemissivity
1490KernelVersion: 4.1
1491Contact: linux-iio@vger.kernel.org
1492Description:
1493 The emissivity ratio of the surface in the field of view of the
1494 contactless temperature sensor. Emissivity varies from 0 to 1,
1495 with 1 being the emissivity of a black body.
Irina Tirdeafaaa4492015-04-29 21:16:39 +03001496
1497What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_oversampling_ratio
1498What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_oversampling_ratio
1499What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_oversampling_ratio
1500KernelVersion: 4.2
1501Contact: linux-iio@vger.kernel.org
1502Description:
1503 Hardware applied number of measurements for acquiring one
1504 data point. The HW will do <type>[_name]_oversampling_ratio
1505 measurements and return the average value as output data. Each
1506 value resulted from <type>[_name]_oversampling_ratio measurements
1507 is considered as one sample for <type>[_name]_sampling_frequency.
Matt Ranostay8ff6b3b2015-09-13 20:26:11 -07001508
1509What: /sys/bus/iio/devices/iio:deviceX/in_concentration_raw
1510What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_raw
1511What: /sys/bus/iio/devices/iio:deviceX/in_concentration_co2_raw
1512What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_co2_raw
1513What: /sys/bus/iio/devices/iio:deviceX/in_concentration_voc_raw
1514What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_voc_raw
1515KernelVersion: 4.3
1516Contact: linux-iio@vger.kernel.org
1517Description:
1518 Raw (unscaled no offset etc.) percentage reading of a substance.
Matt Ranostayd38d5462015-09-13 20:26:12 -07001519
1520What: /sys/bus/iio/devices/iio:deviceX/in_resistance_raw
1521What: /sys/bus/iio/devices/iio:deviceX/in_resistanceX_raw
Peter Rosinb15aef82015-09-23 16:26:22 +02001522What: /sys/bus/iio/devices/iio:deviceX/out_resistance_raw
1523What: /sys/bus/iio/devices/iio:deviceX/out_resistanceX_raw
Matt Ranostayd38d5462015-09-13 20:26:12 -07001524KernelVersion: 4.3
1525Contact: linux-iio@vger.kernel.org
1526Description:
1527 Raw (unscaled no offset etc.) resistance reading that can be processed
1528 into an ohm value.
Ludovic Tancerel2b5c53d2015-10-01 16:13:39 +02001529
1530What: /sys/bus/iio/devices/iio:deviceX/heater_enable
1531KernelVersion: 4.1.0
1532Contact: linux-iio@vger.kernel.org
1533Description:
1534 '1' (enable) or '0' (disable) specifying the enable
1535 of heater function. Same reading values apply
1536 This ABI is especially applicable for humidity sensors
1537 to heatup the device and get rid of any condensation
1538 in some humidity environment
Matt Ranostayecb3a7c2016-01-26 18:34:30 -08001539
1540What: /sys/bus/iio/devices/iio:deviceX/in_ph_raw
1541KernelVersion: 4.5
1542Contact: linux-iio@vger.kernel.org
1543Description:
1544 Raw (unscaled no offset etc.) pH reading of a substance as a negative
1545 base-10 logarithm of hydrodium ions in a litre of water.
Gregor Boiriedfc57732016-04-20 19:23:43 +02001546
1547What: /sys/bus/iio/devices/iio:deviceX/mount_matrix
1548What: /sys/bus/iio/devices/iio:deviceX/in_mount_matrix
1549What: /sys/bus/iio/devices/iio:deviceX/out_mount_matrix
Gregor Boirieeb379842016-04-20 19:23:45 +02001550What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_mount_matrix
1551What: /sys/bus/iio/devices/iio:deviceX/in_accel_mount_matrix
Gregor Boiriedfc57732016-04-20 19:23:43 +02001552KernelVersion: 4.6
1553Contact: linux-iio@vger.kernel.org
1554Description:
1555 Mounting matrix for IIO sensors. This is a rotation matrix which
1556 informs userspace about sensor chip's placement relative to the
1557 main hardware it is mounted on.
1558 Main hardware placement is defined according to the local
1559 reference frame related to the physical quantity the sensor
1560 measures.
1561 Given that the rotation matrix is defined in a board specific
1562 way (platform data and / or device-tree), the main hardware
1563 reference frame definition is left to the implementor's choice
1564 (see below for a magnetometer example).
1565 Applications should apply this rotation matrix to samples so
1566 that when main hardware reference frame is aligned onto local
1567 reference frame, then sensor chip reference frame is also
1568 perfectly aligned with it.
1569 Matrix is a 3x3 unitary matrix and typically looks like
1570 [0, 1, 0; 1, 0, 0; 0, 0, -1]. Identity matrix
1571 [1, 0, 0; 0, 1, 0; 0, 0, 1] means sensor chip and main hardware
1572 are perfectly aligned with each other.
1573
1574 For example, a mounting matrix for a magnetometer sensor informs
1575 userspace about sensor chip's ORIENTATION relative to the main
1576 hardware.
1577 More specifically, main hardware orientation is defined with
1578 respect to the LOCAL EARTH GEOMAGNETIC REFERENCE FRAME where :
1579 * Y is in the ground plane and positive towards magnetic North ;
1580 * X is in the ground plane, perpendicular to the North axis and
1581 positive towards the East ;
1582 * Z is perpendicular to the ground plane and positive upwards.
1583
1584 An implementor might consider that for a hand-held device, a
1585 'natural' orientation would be 'front facing camera at the top'.
1586 The main hardware reference frame could then be described as :
1587 * Y is in the plane of the screen and is positive towards the
1588 top of the screen ;
1589 * X is in the plane of the screen, perpendicular to Y axis, and
1590 positive towards the right hand side of the screen ;
1591 * Z is perpendicular to the screen plane and positive out of the
1592 screen.
1593 Another example for a quadrotor UAV might be :
1594 * Y is in the plane of the propellers and positive towards the
1595 front-view camera;
1596 * X is in the plane of the propellers, perpendicular to Y axis,
1597 and positive towards the starboard side of the UAV ;
1598 * Z is perpendicular to propellers plane and positive upwards.
Matt Ranostay4b9d2092016-05-24 21:29:19 -07001599
1600What: /sys/bus/iio/devices/iio:deviceX/in_electricalconductivity_raw
1601KernelVersion: 4.8
1602Contact: linux-iio@vger.kernel.org
1603Description:
1604 Raw (unscaled no offset etc.) electric conductivity reading that
1605 can be processed to siemens per meter.
William Breathitt Gray1a8f3242016-09-28 13:59:49 -04001606
1607What: /sys/bus/iio/devices/iio:deviceX/in_countY_raw
William Breathitt Gray7527a6e2017-02-08 09:01:35 -05001608KernelVersion: 4.10
William Breathitt Gray1a8f3242016-09-28 13:59:49 -04001609Contact: linux-iio@vger.kernel.org
1610Description:
1611 Raw counter device counts from channel Y. For quadrature
1612 counters, multiplication by an available [Y]_scale results in
1613 the counts of a single quadrature signal phase from channel Y.
1614
1615What: /sys/bus/iio/devices/iio:deviceX/in_indexY_raw
William Breathitt Gray7527a6e2017-02-08 09:01:35 -05001616KernelVersion: 4.10
William Breathitt Gray1a8f3242016-09-28 13:59:49 -04001617Contact: linux-iio@vger.kernel.org
1618Description:
1619 Raw counter device index value from channel Y. This attribute
1620 provides an absolute positional reference (e.g. a pulse once per
1621 revolution) which may be used to home positional systems as
1622 required.
Benjamin Gaignard521dbeb2017-03-01 15:45:05 +01001623
1624What: /sys/bus/iio/devices/iio:deviceX/in_count_count_direction_available
1625KernelVersion: 4.12
1626Contact: linux-iio@vger.kernel.org
1627Description:
1628 A list of possible counting directions which are:
1629 - "up" : counter device is increasing.
1630 - "down": counter device is decreasing.
1631
1632What: /sys/bus/iio/devices/iio:deviceX/in_countY_count_direction
1633KernelVersion: 4.12
1634Contact: linux-iio@vger.kernel.org
1635Description:
1636 Raw counter device counters direction for channel Y.