]> git.proxmox.com Git - mirror_ubuntu-zesty-kernel.git/blame - Documentation/ABI/testing/sysfs-bus-iio
UBUNTU: Ubuntu-4.10.0-37.41
[mirror_ubuntu-zesty-kernel.git] / Documentation / ABI / testing / sysfs-bus-iio
CommitLineData
b3874069 1What: /sys/bus/iio/devices/iio:deviceX
e34d2c5f
JC
2KernelVersion: 2.6.35
3Contact: linux-iio@vger.kernel.org
4Description:
de1874b7 5 Hardware chip or device accessed by one communication port.
f386caa3
JC
6 Corresponds to a grouping of sensor channels. X is the IIO
7 index of the device.
e34d2c5f 8
f386caa3 9What: /sys/bus/iio/devices/triggerX
e34d2c5f
JC
10KernelVersion: 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.
f386caa3 17 periodic timer, GPIO or high resolution timer).
e34d2c5f
JC
18 Contains trigger type specific elements. These do not
19 generalize well and hence are not documented in this file.
f386caa3 20 X is the IIO index of the trigger.
e34d2c5f 21
b3874069 22What: /sys/bus/iio/devices/iio:deviceX/buffer
e34d2c5f
JC
23KernelVersion: 2.6.35
24Contact: linux-iio@vger.kernel.org
25Description:
b3874069 26 Directory of attributes relating to the buffer for the device.
e34d2c5f 27
b3874069 28What: /sys/bus/iio/devices/iio:deviceX/name
e34d2c5f
JC
29KernelVersion: 2.6.35
30Contact: linux-iio@vger.kernel.org
31Description:
f386caa3
JC
32 Description of the physical chip / device for device X.
33 Typically a part number.
e34d2c5f 34
bc2b7dab
GB
35What: /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
b3874069 42What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency
15739cd2
JC
43What: /sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency
44What: /sys/bus/iio/devices/triggerX/sampling_frequency
e34d2c5f
JC
45KernelVersion: 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
8b417d78 50 parameter has an effect on input filters etc. rather than
e34d2c5f 51 simply controlling when the input is sampled. As this
8b417d78 52 effects data ready triggers, hardware buffers and the sysfs
e34d2c5f
JC
53 direct access interfaces, it may be found in any of the
54 relevant directories. If it effects all of the above
15739cd2 55 then it is to be found in the base device directory.
e34d2c5f 56
b3874069 57What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency_available
15739cd2
JC
58What: /sys/.../iio:deviceX/buffer/sampling_frequency_available
59What: /sys/bus/iio/devices/triggerX/sampling_frequency_available
e34d2c5f
JC
60KernelVersion: 2.6.35
61Contact: linux-iio@vger.kernel.org
62Description:
63 When the internal sampling clock can only take a small
f386caa3 64 discrete set of values, this file lists those available.
e34d2c5f 65
b3874069 66What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio
b9618c0c
MH
67KernelVersion: 2.6.38
68Contact: linux-iio@vger.kernel.org
69Description:
70 Hardware dependent ADC oversampling. Controls the sampling ratio
71 of the digital filter if available.
72
b3874069 73What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available
b9618c0c
MH
74KernelVersion: 2.6.38
75Contact: linux-iio@vger.kernel.org
76Description:
77 Hardware dependent values supported by the oversampling filter.
78
a37b549e
JC
79What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
80What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
1ce87f21
LPC
81What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_raw
82What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_raw
e34d2c5f
JC
83KernelVersion: 2.6.35
84Contact: linux-iio@vger.kernel.org
85Description:
8b417d78 86 Raw (unscaled no bias removal etc.) voltage measurement from
f386caa3
JC
87 channel Y. In special cases where the channel does not
88 correspond to externally available input one of the named
89 versions may be used. The number must always be specified and
15739cd2 90 unique to allow association with event codes. Units after
c2b2db71 91 application of scale and offset are millivolts.
f386caa3 92
1ce87f21
LPC
93 Channels with 'i' and 'q' modifiers always exist in pairs and both
94 channels refer to the same signal. The 'i' channel contains the in-phase
95 component of the signal while the 'q' channel contains the quadrature
96 component.
97
a37b549e 98What: /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw
e34d2c5f
JC
99KernelVersion: 2.6.35
100Contact: linux-iio@vger.kernel.org
101Description:
f386caa3
JC
102 Raw (unscaled) differential voltage measurement equivalent to
103 channel Y - channel Z where these channel numbers apply to the
104 physically equivalent inputs when non differential readings are
105 separately available. In differential only parts, then all that
15739cd2 106 is required is a consistent labeling. Units after application
c2b2db71 107 of scale and offset are millivolts.
e34d2c5f 108
7f1c2cbb
AT
109What: /sys/bus/iio/devices/iio:deviceX/in_currentY_raw
110What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_raw
111KernelVersion: 3.17
112Contact: linux-iio@vger.kernel.org
113Description:
114 Raw (unscaled no bias removal etc.) current measurement from
115 channel Y. In special cases where the channel does not
116 correspond to externally available input one of the named
117 versions may be used. The number must always be specified and
118 unique to allow association with event codes. Units after
119 application of scale and offset are milliamps.
120
0baf29d6
JC
121What: /sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw
122KernelVersion: 3.2
123Contact: linux-iio@vger.kernel.org
124Description:
125 Raw capacitance measurement from channel Y. Units after
126 application of scale and offset are nanofarads.
127
128What: /sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw
129KernelVersion: 3.2
130Contact: linux-iio@vger.kernel.org
131Description:
132 Raw differential capacitance measurement equivalent to
133 channel Y - channel Z where these channel numbers apply to the
134 physically equivalent inputs when non differential readings are
135 separately available. In differential only parts, then all that
136 is required is a consistent labeling. Units after application
68284a12 137 of scale and offset are nanofarads.
0baf29d6 138
a37b549e 139What: /sys/bus/iio/devices/iio:deviceX/in_temp_raw
15739cd2 140What: /sys/bus/iio/devices/iio:deviceX/in_tempX_raw
a37b549e
JC
141What: /sys/bus/iio/devices/iio:deviceX/in_temp_x_raw
142What: /sys/bus/iio/devices/iio:deviceX/in_temp_y_raw
888c9c73
PM
143What: /sys/bus/iio/devices/iio:deviceX/in_temp_ambient_raw
144What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_raw
e34d2c5f
JC
145KernelVersion: 2.6.35
146Contact: linux-iio@vger.kernel.org
147Description:
8b417d78 148 Raw (unscaled no bias removal etc.) temperature measurement.
68284a12 149 If an axis is specified it generally means that the temperature
f386caa3 150 sensor is associated with one part of a compound device (e.g.
888c9c73
PM
151 a gyroscope axis). The ambient and object modifiers distinguish
152 between ambient (reference) and distant temperature for contact-
153 less measurements. Units after application of scale and offset
cf655d2d 154 are milli degrees Celsius.
e34d2c5f 155
a37b549e 156What: /sys/bus/iio/devices/iio:deviceX/in_tempX_input
7c31b984
MH
157KernelVersion: 2.6.38
158Contact: linux-iio@vger.kernel.org
159Description:
160 Scaled temperature measurement in milli degrees Celsius.
161
a37b549e
JC
162What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw
163What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_raw
164What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_raw
e34d2c5f
JC
165KernelVersion: 2.6.35
166Contact: linux-iio@vger.kernel.org
167Description:
f386caa3 168 Acceleration in direction x, y or z (may be arbitrarily assigned
15739cd2
JC
169 but should match other such assignments on device).
170 Has all of the equivalent parameters as per voltageY. Units
171 after application of scale and offset are m/s^2.
e34d2c5f 172
d4c926f2
JC
173What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw
174What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw
175What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw
e34d2c5f
JC
176KernelVersion: 2.6.35
177Contact: linux-iio@vger.kernel.org
178Description:
f386caa3 179 Angular velocity about axis x, y or z (may be arbitrarily
8b417d78
PM
180 assigned). Has all the equivalent parameters as per voltageY.
181 Units after application of scale and offset are radians per
182 second.
e34d2c5f 183
a37b549e
JC
184What: /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
185What: /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
186What: /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
e34d2c5f
JC
187KernelVersion: 2.6.35
188Contact: linux-iio@vger.kernel.org
189Description:
f386caa3
JC
190 Inclination raw reading about axis x, y or z (may be
191 arbitrarily assigned). Data converted by application of offset
8b417d78 192 and scale to degrees.
e34d2c5f 193
a37b549e
JC
194What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
195What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
196What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
e34d2c5f
JC
197KernelVersion: 2.6.35
198Contact: linux-iio@vger.kernel.org
199Description:
f386caa3 200 Magnetic field along axis x, y or z (may be arbitrarily
15739cd2
JC
201 assigned). Data converted by application of offset
202 then scale to Gauss.
e34d2c5f 203
a37b549e
JC
204What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
205What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
206What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
f386caa3 207KernelVersion: 2.6.36
e34d2c5f
JC
208Contact: linux-iio@vger.kernel.org
209Description:
15739cd2
JC
210 Highest value since some reset condition. These
211 attributes allow access to this and are otherwise
212 the direct equivalent of the <type>Y[_name]_raw attributes.
e34d2c5f 213
a37b549e 214What: /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
f386caa3 215KernelVersion: 2.6.36
e34d2c5f
JC
216Contact: linux-iio@vger.kernel.org
217Description:
f386caa3
JC
218 A computed peak value based on the sum squared magnitude of
219 the underlying value in the specified directions.
e34d2c5f 220
c4f0c693
LPC
221What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_raw
222What: /sys/bus/iio/devices/iio:deviceX/in_pressure_raw
223KernelVersion: 3.8
224Contact: linux-iio@vger.kernel.org
225Description:
226 Raw pressure measurement from channel Y. Units after
227 application of scale and offset are kilopascal.
228
c22e15f3
VD
229What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_input
230What: /sys/bus/iio/devices/iio:deviceX/in_pressure_input
231KernelVersion: 3.8
232Contact: linux-iio@vger.kernel.org
233Description:
234 Scaled pressure measurement from channel Y, in kilopascal.
235
ac216aa2
HG
236What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_raw
237KernelVersion: 3.14
238Contact: linux-iio@vger.kernel.org
239Description:
240 Raw humidity measurement of air. Units after application of
241 scale and offset are milli percent.
242
243What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_input
244KernelVersion: 3.14
245Contact: linux-iio@vger.kernel.org
246Description:
247 Scaled humidity measurement in milli percent.
248
c0a6b7ee
SR
249What: /sys/bus/iio/devices/iio:deviceX/in_X_mean_raw
250KernelVersion: 3.5
251Contact: linux-iio@vger.kernel.org
252Description:
253 Averaged raw measurement from channel X. The number of values
254 used for averaging is device specific. The converting rules for
255 normal raw values also applies to the averaged raw values.
256
a37b549e 257What: /sys/bus/iio/devices/iio:deviceX/in_accel_offset
15739cd2
JC
258What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
259What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
260What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
261What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
262What: /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
1ce87f21
LPC
263What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_offset
264What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_offset
265What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_offset
266What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_offset
7f1c2cbb
AT
267What: /sys/bus/iio/devices/iio:deviceX/in_currentY_offset
268What: /sys/bus/iio/devices/iio:deviceX/in_current_offset
1ce87f21
LPC
269What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_offset
270What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_offset
271What: /sys/bus/iio/devices/iio:deviceX/in_current_q_offset
272What: /sys/bus/iio/devices/iio:deviceX/in_current_i_offset
15739cd2 273What: /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
a37b549e 274What: /sys/bus/iio/devices/iio:deviceX/in_temp_offset
c4f0c693
LPC
275What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_offset
276What: /sys/bus/iio/devices/iio:deviceX/in_pressure_offset
4d5ce6bb 277What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_offset
d5d7c4af 278What: /sys/bus/iio/devices/iio:deviceX/in_magn_offset
8ea06893 279What: /sys/bus/iio/devices/iio:deviceX/in_rot_offset
e34d2c5f
JC
280KernelVersion: 2.6.35
281Contact: linux-iio@vger.kernel.org
282Description:
f386caa3
JC
283 If known for a device, offset to be added to <type>[Y]_raw prior
284 to scaling by <type>[Y]_scale in order to obtain value in the
8b417d78 285 <type> units as specified in <type>[Y]_raw documentation.
15739cd2
JC
286 Not present if the offset is always 0 or unknown. If Y or
287 axis <x|y|z> is not present, then the offset applies to all
288 in channels of <type>.
f386caa3
JC
289 May be writable if a variable offset can be applied on the
290 device. Note that this is different to calibbias which
291 is for devices (or drivers) that apply offsets to compensate
292 for variation between different instances of the part, typically
293 adjusted by using some hardware supported calibration procedure.
15739cd2
JC
294 Calibbias is applied internally, offset is applied in userspace
295 to the _raw output.
f386caa3 296
a37b549e 297What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
1ce87f21
LPC
298What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_scale
299What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_scale
a37b549e
JC
300What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
301What: /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
1ce87f21
LPC
302What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_scale
303What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_scale
4e4cd14e 304What: /sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_scale
a37b549e 305What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
d802bf6f 306What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale
7f1c2cbb
AT
307What: /sys/bus/iio/devices/iio:deviceX/in_currentY_scale
308What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_scale
309What: /sys/bus/iio/devices/iio:deviceX/in_current_scale
1ce87f21
LPC
310What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_scale
311What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_scale
312What: /sys/bus/iio/devices/iio:deviceX/in_current_i_scale
313What: /sys/bus/iio/devices/iio:deviceX/in_current_q_scale
a37b549e
JC
314What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale
315What: /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
d4c926f2 316What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale
72c66644 317What: /sys/bus/iio/devices/iio:deviceX/in_energy_scale
cc3c9eec 318What: /sys/bus/iio/devices/iio:deviceX/in_distance_scale
a37b549e
JC
319What: /sys/bus/iio/devices/iio:deviceX/in_magn_scale
320What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
321What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
322What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
b531db84
RA
323What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_scale
324What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_scale
325What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_scale
326What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_scale
c4f0c693
LPC
327What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_scale
328What: /sys/bus/iio/devices/iio:deviceX/in_pressure_scale
4d5ce6bb 329What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_scale
5a1a9329 330What: /sys/bus/iio/devices/iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_scale
7cf78db5 331What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_scale
1a8f324a 332What: /sys/bus/iio/devices/iio:deviceX/in_countY_scale
e5107fb8
JC
333KernelVersion: 2.6.35
334Contact: linux-iio@vger.kernel.org
335Description:
f386caa3
JC
336 If known for a device, scale to be applied to <type>Y[_name]_raw
337 post addition of <type>[Y][_name]_offset in order to obtain the
338 measured value in <type> units as specified in
68284a12 339 <type>[Y][_name]_raw documentation. If shared across all in
15739cd2
JC
340 channels then Y and <x|y|z> are not present and the value is
341 called <type>[Y][_name]_scale. The peak modifier means this
342 value is applied to <type>Y[_name]_peak_raw values.
f386caa3 343
a37b549e
JC
344What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
345What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
346What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
d4c926f2
JC
347What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias
348What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
349What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
3c97c08b
JB
350What: /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
351What: /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
c4f0c693
LPC
352What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibbias
353What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibbias
e34d2c5f
JC
354KernelVersion: 2.6.35
355Contact: linux-iio@vger.kernel.org
356Description:
8b417d78 357 Hardware applied calibration offset (assumed to fix production
15739cd2 358 inaccuracies).
f386caa3 359
a37b549e
JC
360What /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
361What /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
1ce87f21
LPC
362What /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_calibscale
363What /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_calibscale
364What /sys/bus/iio/devices/iio:deviceX/in_voltage_i_calibscale
365What /sys/bus/iio/devices/iio:deviceX/in_voltage_q_calibscale
a37b549e
JC
366What /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
367What /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
368What /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
369What /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
d4c926f2
JC
370What /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
371What /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
372What /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
3c97c08b
JB
373what /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
374what /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
c4f0c693
LPC
375What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibscale
376What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibscale
7cf78db5 377What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_calibscale
e34d2c5f
JC
378KernelVersion: 2.6.35
379Contact: linux-iio@vger.kernel.org
380Description:
8b417d78 381 Hardware applied calibration scale factor (assumed to fix
f386caa3
JC
382 production inaccuracies). If shared across all channels,
383 <type>_calibscale is used.
e34d2c5f 384
40cb7613
IT
385What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender
386What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender
387What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender
388What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender
e0631a31 389KernelVersion: 4.0
40cb7613
IT
390Contact: linux-iio@vger.kernel.org
391Description:
392 Gender of the user (e.g.: male, female) used by some pedometers
393 to compute the stride length, distance, speed and activity
394 type.
395
396What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender_available
397What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender_available
398What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender_available
399What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender_available
e0631a31 400KernelVersion: 4.0
40cb7613
IT
401Contact: linux-iio@vger.kernel.org
402Description:
403 Lists all available gender values (e.g.: male, female).
404
405What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibheight
406What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibheight
407What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibheight
408What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibheight
bcdf28fb
IT
409KernelVersion: 3.19
410Contact: linux-iio@vger.kernel.org
411Description:
81110933 412 Height of the user (in meters) used by some pedometers
bcdf28fb
IT
413 to compute the stride length, distance, speed and activity
414 type.
415
d37f6836 416What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibweight
e0631a31 417KernelVersion: 4.0
d37f6836
IT
418Contact: linux-iio@vger.kernel.org
419Description:
420 Weight of the user (in kg). It is needed by some pedometers
421 to compute the calories burnt by the user.
422
a37b549e 423What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
ad37616e
AR
424What: /sys/.../iio:deviceX/in_anglvel_scale_available
425What: /sys/.../iio:deviceX/in_magn_scale_available
426What: /sys/.../iio:deviceX/in_illuminance_scale_available
427What: /sys/.../iio:deviceX/in_intensity_scale_available
428What: /sys/.../iio:deviceX/in_proximity_scale_available
15739cd2
JC
429What: /sys/.../iio:deviceX/in_voltageX_scale_available
430What: /sys/.../iio:deviceX/in_voltage-voltage_scale_available
431What: /sys/.../iio:deviceX/out_voltageX_scale_available
d802bf6f 432What: /sys/.../iio:deviceX/out_altvoltageX_scale_available
0baf29d6 433What: /sys/.../iio:deviceX/in_capacitance_scale_available
c4f0c693
LPC
434What: /sys/.../iio:deviceX/in_pressure_scale_available
435What: /sys/.../iio:deviceX/in_pressureY_scale_available
cf09fe9c 436KernelVersion: 2.6.35
e34d2c5f
JC
437Contact: linux-iio@vger.kernel.org
438Description:
8b417d78 439 If a discrete set of scale values is available, they
f386caa3 440 are listed in this attribute.
e34d2c5f 441
b65d6212 442What /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
ed56330d
RD
443What: /sys/bus/iio/devices/iio:deviceX/in_intensity_red_hardwaregain
444What: /sys/bus/iio/devices/iio:deviceX/in_intensity_green_hardwaregain
445What: /sys/bus/iio/devices/iio:deviceX/in_intensity_blue_hardwaregain
446What: /sys/bus/iio/devices/iio:deviceX/in_intensity_clear_hardwaregain
b65d6212
MH
447KernelVersion: 2.6.35
448Contact: linux-iio@vger.kernel.org
449Description:
450 Hardware applied gain factor. If shared across all channels,
451 <type>_hardwaregain is used.
452
0c22db43
JC
453What: /sys/.../in_accel_filter_low_pass_3db_frequency
454What: /sys/.../in_magn_filter_low_pass_3db_frequency
455What: /sys/.../in_anglvel_filter_low_pass_3db_frequency
456KernelVersion: 3.2
457Contact: linux-iio@vger.kernel.org
458Description:
459 If a known or controllable low pass filter is applied
460 to the underlying data channel, then this parameter
461 gives the 3dB frequency of the filter in Hz.
462
3f7f642b
MF
463What: /sys/.../in_accel_filter_high_pass_3db_frequency
464What: /sys/.../in_anglvel_filter_high_pass_3db_frequency
465What: /sys/.../in_magn_filter_high_pass_3db_frequency
466KernelVersion: 4.2
467Contact: linux-iio@vger.kernel.org
468Description:
469 If a known or controllable high pass filter is applied
470 to the underlying data channel, then this parameter
471 gives the 3dB frequency of the filter in Hz.
472
15739cd2 473What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
d802bf6f 474What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw
98069c3f
RS
475KernelVersion: 2.6.37
476Contact: linux-iio@vger.kernel.org
477Description:
478 Raw (unscaled, no bias etc.) output voltage for
479 channel Y. The number must always be specified and
480 unique if the output corresponds to a single channel.
d802bf6f
MH
481 While DAC like devices typically use out_voltage,
482 a continuous frequency generating device, such as
483 a DDS or PLL should use out_altvoltage.
98069c3f 484
a37b549e 485What: /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
d802bf6f 486What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw
98069c3f
RS
487KernelVersion: 2.6.37
488Contact: linux-iio@vger.kernel.org
489Description:
490 Raw (unscaled, no bias etc.) output voltage for an aggregate of
491 channel Y, channel Z, etc. This interface is available in cases
492 where a single output sets the value for multiple channels
493 simultaneously.
494
a37b549e
JC
495What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
496What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
d802bf6f
MH
497What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode
498What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode
14f88f1b
MH
499KernelVersion: 2.6.38
500Contact: linux-iio@vger.kernel.org
501Description:
502 Specifies the output powerdown mode.
503 DAC output stage is disconnected from the amplifier and
bdb25b0a 504 1kohm_to_gnd: connected to ground via an 1kOhm resistor,
8b417d78
PM
505 6kohm_to_gnd: connected to ground via a 6kOhm resistor,
506 20kohm_to_gnd: connected to ground via a 20kOhm resistor,
8d144c96 507 90kohm_to_gnd: connected to ground via a 90kOhm resistor,
8b417d78 508 100kohm_to_gnd: connected to ground via an 100kOhm resistor,
35f73967 509 125kohm_to_gnd: connected to ground via an 125kOhm resistor,
bd53a414 510 500kohm_to_gnd: connected to ground via a 500kOhm resistor,
35f73967 511 640kohm_to_gnd: connected to ground via a 640kOhm resistor,
8b417d78 512 three_state: left floating.
14f88f1b
MH
513 For a list of available output power down options read
514 outX_powerdown_mode_available. If Y is not present the
515 mode is shared across all outputs.
516
bdb25b0a 517What: /sys/.../iio:deviceX/out_voltageY_powerdown_mode_available
a37b549e 518What: /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
bdb25b0a 519What: /sys/.../iio:deviceX/out_altvoltageY_powerdown_mode_available
d802bf6f 520What: /sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available
14f88f1b
MH
521KernelVersion: 2.6.38
522Contact: linux-iio@vger.kernel.org
523Description:
524 Lists all available output power down modes.
525 If Y is not present the mode is shared across all outputs.
526
a37b549e
JC
527What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
528What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
d802bf6f
MH
529What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
530What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown
14f88f1b
MH
531KernelVersion: 2.6.38
532Contact: linux-iio@vger.kernel.org
533Description:
534 Writing 1 causes output Y to enter the power down mode specified
8b417d78
PM
535 by the corresponding outY_powerdown_mode. DAC output stage is
536 disconnected from the amplifier. Clearing returns to normal
537 operation. Y may be suppressed if all outputs are controlled
538 together.
14f88f1b 539
d802bf6f
MH
540What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency
541KernelVersion: 3.4.0
542Contact: linux-iio@vger.kernel.org
543Description:
544 Output frequency for channel Y in Hz. The number must always be
545 specified and unique if the output corresponds to a single
546 channel.
547
548What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase
549KernelVersion: 3.4.0
550Contact: linux-iio@vger.kernel.org
551Description:
552 Phase in radians of one frequency/clock output Y
553 (out_altvoltageY) relative to another frequency/clock output
554 (out_altvoltageZ) of the device X. The number must always be
555 specified and unique if the output corresponds to a single
556 channel.
557
b3874069 558What: /sys/bus/iio/devices/iio:deviceX/events
f386caa3
JC
559KernelVersion: 2.6.35
560Contact: linux-iio@vger.kernel.org
561Description:
562 Configuration of which hardware generated events are passed up
563 to user-space.
e34d2c5f 564
a37b549e
JC
565What: /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
566What: /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
567What: /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
568What: /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
569What: /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
570What: /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
d4c926f2
JC
571What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
572What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
573What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
574What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
575What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
576What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
a37b549e
JC
577What: /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
578What: /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
579What: /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
580What: /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
581What: /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
582What: /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
b531db84
RA
583What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_rising_en
584What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_falling_en
585What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_rising_en
586What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_falling_en
587What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_en
588What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_en
589What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_rising_en
590What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_falling_en
15739cd2
JC
591What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
592What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
593What: /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
594What: /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
72aa29ce 595What: /sys/.../iio:deviceX/events/in_voltageY_thresh_either_en
15739cd2
JC
596What: /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
597What: /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
2f3cc667
JC
598KernelVersion: 2.6.37
599Contact: linux-iio@vger.kernel.org
600Description:
f386caa3 601 Event generated when channel passes a threshold in the specified
2f3cc667
JC
602 (_rising|_falling) direction. If the direction is not specified,
603 then either the device will report an event which ever direction
15739cd2
JC
604 a single threshold value is passed in (e.g.
605 <type>[Y][_name]_<raw|input>_thresh_value) or
606 <type>[Y][_name]_<raw|input>_thresh_rising_value and
607 <type>[Y][_name]_<raw|input>_thresh_falling_value may take
f386caa3
JC
608 different values, but the device can only enable both thresholds
609 or neither.
2f3cc667 610 Note the driver will assume the last p events requested are
8b417d78
PM
611 to be enabled where p is how many it supports (which may vary
612 depending on the exact set requested. So if you want to be
2f3cc667
JC
613 sure you have set what you think you have, check the contents of
614 these attributes after everything is configured. Drivers may
615 have to buffer any parameters so that they are consistent when
8b417d78 616 a given event type is enabled at a future point (and not those for
2f3cc667
JC
617 whatever event was previously enabled).
618
a37b549e
JC
619What: /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
620What: /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
621What: /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
622What: /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
623What: /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
624What: /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
d4c926f2
JC
625What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
626What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
627What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
628What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
629What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
630What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
a37b549e
JC
631What: /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
632What: /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
633What: /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
634What: /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
635What: /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
636What: /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
b531db84
RA
637What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_rising_en
638What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_falling_en
639What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_rising_en
640What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_falling_en
641What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_rising_en
642What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_falling_en
643What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_rising_en
644What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_falling_en
15739cd2
JC
645What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
646What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
647What: /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
648What: /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
649What: /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
650What: /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
f386caa3
JC
651KernelVersion: 2.6.37
652Contact: linux-iio@vger.kernel.org
653Description:
654 Event generated when channel passes a threshold on the rate of
655 change (1st differential) in the specified (_rising|_falling)
656 direction. If the direction is not specified, then either the
657 device will report an event which ever direction a single
15739cd2
JC
658 threshold value is passed in (e.g.
659 <type>[Y][_name]_<raw|input>_roc_value) or
660 <type>[Y][_name]_<raw|input>_roc_rising_value and
661 <type>[Y][_name]_<raw|input>_roc_falling_value may take
f386caa3
JC
662 different values, but the device can only enable both rate of
663 change thresholds or neither.
664 Note the driver will assume the last p events requested are
665 to be enabled where p is however many it supports (which may
666 vary depending on the exact set requested. So if you want to be
667 sure you have set what you think you have, check the contents of
668 these attributes after everything is configured. Drivers may
669 have to buffer any parameters so that they are consistent when
670 a given event type is enabled a future point (and not those for
671 whatever event was previously enabled).
672
40dbbfb5
HM
673What: /sys/.../events/in_accel_thresh_rising_value
674What: /sys/.../events/in_accel_thresh_falling_value
a37b549e
JC
675What: /sys/.../events/in_accel_x_raw_thresh_rising_value
676What: /sys/.../events/in_accel_x_raw_thresh_falling_value
677What: /sys/.../events/in_accel_y_raw_thresh_rising_value
678What: /sys/.../events/in_accel_y_raw_thresh_falling_value
679What: /sys/.../events/in_accel_z_raw_thresh_rising_value
680What: /sys/.../events/in_accel_z_raw_thresh_falling_value
d4c926f2
JC
681What: /sys/.../events/in_anglvel_x_raw_thresh_rising_value
682What: /sys/.../events/in_anglvel_x_raw_thresh_falling_value
683What: /sys/.../events/in_anglvel_y_raw_thresh_rising_value
684What: /sys/.../events/in_anglvel_y_raw_thresh_falling_value
685What: /sys/.../events/in_anglvel_z_raw_thresh_rising_value
686What: /sys/.../events/in_anglvel_z_raw_thresh_falling_value
a37b549e
JC
687What: /sys/.../events/in_magn_x_raw_thresh_rising_value
688What: /sys/.../events/in_magn_x_raw_thresh_falling_value
689What: /sys/.../events/in_magn_y_raw_thresh_rising_value
690What: /sys/.../events/in_magn_y_raw_thresh_falling_value
691What: /sys/.../events/in_magn_z_raw_thresh_rising_value
692What: /sys/.../events/in_magn_z_raw_thresh_falling_value
b531db84
RA
693What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_rising_value
694What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_falling_value
695What: /sys/.../events/in_rot_from_north_true_raw_thresh_rising_value
696What: /sys/.../events/in_rot_from_north_true_raw_thresh_falling_value
697What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_rising_value
698What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_falling_value
699What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_rising_value
700What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_falling_value
15739cd2
JC
701What: /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
702What: /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
a7322fc2 703What: /sys/.../events/in_voltageY_raw_thresh_rising_value
15739cd2 704What: /sys/.../events/in_voltageY_raw_thresh_falling_value
a7322fc2 705What: /sys/.../events/in_tempY_raw_thresh_rising_value
15739cd2 706What: /sys/.../events/in_tempY_raw_thresh_falling_value
3c97c08b
JB
707What: /sys/.../events/in_illuminance0_thresh_falling_value
708what: /sys/.../events/in_illuminance0_thresh_rising_value
709what: /sys/.../events/in_proximity0_thresh_falling_value
710what: /sys/.../events/in_proximity0_thresh_rising_value
2f3cc667 711KernelVersion: 2.6.37
e34d2c5f
JC
712Contact: linux-iio@vger.kernel.org
713Description:
2f3cc667
JC
714 Specifies the value of threshold that the device is comparing
715 against for the events enabled by
15739cd2
JC
716 <type>Y[_name]_thresh[_rising|falling]_en.
717 If separate attributes exist for the two directions, but
f386caa3
JC
718 direction is not specified for this attribute, then a single
719 threshold value applies to both directions.
2f3cc667
JC
720 The raw or input element of the name indicates whether the
721 value is in raw device units or in processed units (as _raw
722 and _input do on sysfs direct channel read attributes).
e34d2c5f 723
d1bd4867
MF
724What: /sys/.../events/in_accel_scale
725What: /sys/.../events/in_accel_peak_scale
726What: /sys/.../events/in_anglvel_scale
727What: /sys/.../events/in_magn_scale
728What: /sys/.../events/in_rot_from_north_magnetic_scale
729What: /sys/.../events/in_rot_from_north_true_scale
730What: /sys/.../events/in_voltage_scale
731What: /sys/.../events/in_voltage_supply_scale
732What: /sys/.../events/in_temp_scale
733What: /sys/.../events/in_illuminance_scale
734What: /sys/.../events/in_proximity_scale
735KernelVersion: 3.21
736Contact: linux-iio@vger.kernel.org
737Description:
738 Specifies the conversion factor from the standard units
739 to device specific units used to set the event trigger
740 threshold.
741
ec6670ae
LPC
742What: /sys/.../events/in_accel_x_thresh_rising_hysteresis
743What: /sys/.../events/in_accel_x_thresh_falling_hysteresis
744What: /sys/.../events/in_accel_x_thresh_either_hysteresis
745What: /sys/.../events/in_accel_y_thresh_rising_hysteresis
746What: /sys/.../events/in_accel_y_thresh_falling_hysteresis
747What: /sys/.../events/in_accel_y_thresh_either_hysteresis
748What: /sys/.../events/in_accel_z_thresh_rising_hysteresis
749What: /sys/.../events/in_accel_z_thresh_falling_hysteresis
750What: /sys/.../events/in_accel_z_thresh_either_hysteresis
751What: /sys/.../events/in_anglvel_x_thresh_rising_hysteresis
752What: /sys/.../events/in_anglvel_x_thresh_falling_hysteresis
753What: /sys/.../events/in_anglvel_x_thresh_either_hysteresis
754What: /sys/.../events/in_anglvel_y_thresh_rising_hysteresis
755What: /sys/.../events/in_anglvel_y_thresh_falling_hysteresis
756What: /sys/.../events/in_anglvel_y_thresh_either_hysteresis
757What: /sys/.../events/in_anglvel_z_thresh_rising_hysteresis
758What: /sys/.../events/in_anglvel_z_thresh_falling_hysteresis
759What: /sys/.../events/in_anglvel_z_thresh_either_hysteresis
760What: /sys/.../events/in_magn_x_thresh_rising_hysteresis
761What: /sys/.../events/in_magn_x_thresh_falling_hysteresis
762What: /sys/.../events/in_magn_x_thresh_either_hysteresis
763What: /sys/.../events/in_magn_y_thresh_rising_hysteresis
764What: /sys/.../events/in_magn_y_thresh_falling_hysteresis
765What: /sys/.../events/in_magn_y_thresh_either_hysteresis
766What: /sys/.../events/in_magn_z_thresh_rising_hysteresis
767What: /sys/.../events/in_magn_z_thresh_falling_hysteresis
768What: /sys/.../events/in_magn_z_thresh_either_hysteresis
b531db84
RA
769What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_hysteresis
770What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_hysteresis
771What: /sys/.../events/in_rot_from_north_magnetic_thresh_either_hysteresis
772What: /sys/.../events/in_rot_from_north_true_thresh_rising_hysteresis
773What: /sys/.../events/in_rot_from_north_true_thresh_falling_hysteresis
774What: /sys/.../events/in_rot_from_north_true_thresh_either_hysteresis
775What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_hysteresis
776What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_hysteresis
777What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_either_hysteresis
778What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_hysteresis
779What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_hysteresis
780What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_either_hysteresis
ec6670ae
LPC
781What: /sys/.../events/in_voltageY_thresh_rising_hysteresis
782What: /sys/.../events/in_voltageY_thresh_falling_hysteresis
783What: /sys/.../events/in_voltageY_thresh_either_hysteresis
784What: /sys/.../events/in_tempY_thresh_rising_hysteresis
785What: /sys/.../events/in_tempY_thresh_falling_hysteresis
786What: /sys/.../events/in_tempY_thresh_either_hysteresis
787What: /sys/.../events/in_illuminance0_thresh_falling_hysteresis
788what: /sys/.../events/in_illuminance0_thresh_rising_hysteresis
789what: /sys/.../events/in_illuminance0_thresh_either_hysteresis
790what: /sys/.../events/in_proximity0_thresh_falling_hysteresis
791what: /sys/.../events/in_proximity0_thresh_rising_hysteresis
792what: /sys/.../events/in_proximity0_thresh_either_hysteresis
793KernelVersion: 3.13
794Contact: linux-iio@vger.kernel.org
795Description:
796 Specifies the hysteresis of threshold that the device is comparing
797 against for the events enabled by
798 <type>Y[_name]_thresh[_(rising|falling)]_hysteresis.
799 If separate attributes exist for the two directions, but
800 direction is not specified for this attribute, then a single
801 hysteresis value applies to both directions.
802 For falling events the hysteresis is added to the _value attribute for
803 this event to get the upper threshold for when the event goes back to
804 normal, for rising events the hysteresis is subtracted from the _value
805 attribute. E.g. if in_voltage0_raw_thresh_rising_value is set to 1200
806 and in_voltage0_raw_thresh_rising_hysteresis is set to 50. The event
807 will get activated once in_voltage0_raw goes above 1200 and will become
808 deactived again once the value falls below 1150.
809
a37b549e
JC
810What: /sys/.../events/in_accel_x_raw_roc_rising_value
811What: /sys/.../events/in_accel_x_raw_roc_falling_value
812What: /sys/.../events/in_accel_y_raw_roc_rising_value
813What: /sys/.../events/in_accel_y_raw_roc_falling_value
814What: /sys/.../events/in_accel_z_raw_roc_rising_value
815What: /sys/.../events/in_accel_z_raw_roc_falling_value
d4c926f2
JC
816What: /sys/.../events/in_anglvel_x_raw_roc_rising_value
817What: /sys/.../events/in_anglvel_x_raw_roc_falling_value
818What: /sys/.../events/in_anglvel_y_raw_roc_rising_value
819What: /sys/.../events/in_anglvel_y_raw_roc_falling_value
820What: /sys/.../events/in_anglvel_z_raw_roc_rising_value
821What: /sys/.../events/in_anglvel_z_raw_roc_falling_value
a37b549e
JC
822What: /sys/.../events/in_magn_x_raw_roc_rising_value
823What: /sys/.../events/in_magn_x_raw_roc_falling_value
824What: /sys/.../events/in_magn_y_raw_roc_rising_value
825What: /sys/.../events/in_magn_y_raw_roc_falling_value
826What: /sys/.../events/in_magn_z_raw_roc_rising_value
827What: /sys/.../events/in_magn_z_raw_roc_falling_value
b531db84
RA
828What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_rising_value
829What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_falling_value
830What: /sys/.../events/in_rot_from_north_true_raw_roc_rising_value
831What: /sys/.../events/in_rot_from_north_true_raw_roc_falling_value
832What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_rising_value
833What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_falling_value
834What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_rising_value
835What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_falling_value
15739cd2
JC
836What: /sys/.../events/in_voltageY_supply_raw_roc_rising_value
837What: /sys/.../events/in_voltageY_supply_raw_roc_falling_value
a7322fc2 838What: /sys/.../events/in_voltageY_raw_roc_rising_value
15739cd2 839What: /sys/.../events/in_voltageY_raw_roc_falling_value
a7322fc2 840What: /sys/.../events/in_tempY_raw_roc_rising_value
15739cd2 841What: /sys/.../events/in_tempY_raw_roc_falling_value
2f3cc667
JC
842KernelVersion: 2.6.37
843Contact: linux-iio@vger.kernel.org
844Description:
f386caa3
JC
845 Specifies the value of rate of change threshold that the
846 device is comparing against for the events enabled by
15739cd2 847 <type>[Y][_name]_roc[_rising|falling]_en.
f386caa3
JC
848 If separate attributes exist for the two directions,
849 but direction is not specified for this attribute,
850 then a single threshold value applies to both directions.
851 The raw or input element of the name indicates whether the
852 value is in raw device units or in processed units (as _raw
853 and _input do on sysfs direct channel read attributes).
2f3cc667 854
a37b549e
JC
855What: /sys/.../events/in_accel_x_thresh_rising_period
856What: /sys/.../events/in_accel_x_thresh_falling_period
5798cd23 857What: /sys/.../events/in_accel_x_roc_rising_period
a37b549e
JC
858What: /sys/.../events/in_accel_x_roc_falling_period
859What: /sys/.../events/in_accel_y_thresh_rising_period
860What: /sys/.../events/in_accel_y_thresh_falling_period
861What: /sys/.../events/in_accel_y_roc_rising_period
862What: /sys/.../events/in_accel_y_roc_falling_period
863What: /sys/.../events/in_accel_z_thresh_rising_period
864What: /sys/.../events/in_accel_z_thresh_falling_period
865What: /sys/.../events/in_accel_z_roc_rising_period
866What: /sys/.../events/in_accel_z_roc_falling_period
d4c926f2
JC
867What: /sys/.../events/in_anglvel_x_thresh_rising_period
868What: /sys/.../events/in_anglvel_x_thresh_falling_period
869What: /sys/.../events/in_anglvel_x_roc_rising_period
870What: /sys/.../events/in_anglvel_x_roc_falling_period
871What: /sys/.../events/in_anglvel_y_thresh_rising_period
872What: /sys/.../events/in_anglvel_y_thresh_falling_period
873What: /sys/.../events/in_anglvel_y_roc_rising_period
874What: /sys/.../events/in_anglvel_y_roc_falling_period
875What: /sys/.../events/in_anglvel_z_thresh_rising_period
876What: /sys/.../events/in_anglvel_z_thresh_falling_period
877What: /sys/.../events/in_anglvel_z_roc_rising_period
878What: /sys/.../events/in_anglvel_z_roc_falling_period
a37b549e
JC
879What: /sys/.../events/in_magn_x_thresh_rising_period
880What: /sys/.../events/in_magn_x_thresh_falling_period
881What: /sys/.../events/in_magn_x_roc_rising_period
882What: /sys/.../events/in_magn_x_roc_falling_period
883What: /sys/.../events/in_magn_y_thresh_rising_period
884What: /sys/.../events/in_magn_y_thresh_falling_period
885What: /sys/.../events/in_magn_y_roc_rising_period
886What: /sys/.../events/in_magn_y_roc_falling_period
887What: /sys/.../events/in_magn_z_thresh_rising_period
888What: /sys/.../events/in_magn_z_thresh_falling_period
889What: /sys/.../events/in_magn_z_roc_rising_period
890What: /sys/.../events/in_magn_z_roc_falling_period
b531db84
RA
891What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_period
892What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_period
893What: /sys/.../events/in_rot_from_north_magnetic_roc_rising_period
894What: /sys/.../events/in_rot_from_north_magnetic_roc_falling_period
895What: /sys/.../events/in_rot_from_north_true_thresh_rising_period
896What: /sys/.../events/in_rot_from_north_true_thresh_falling_period
897What: /sys/.../events/in_rot_from_north_true_roc_rising_period
898What: /sys/.../events/in_rot_from_north_true_roc_falling_period
899What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_period
900What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_period
901What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_rising_period
902What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_falling_period
903What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_period
904What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_period
905What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_rising_period
906What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_falling_period
15739cd2
JC
907What: /sys/.../events/in_voltageY_supply_thresh_rising_period
908What: /sys/.../events/in_voltageY_supply_thresh_falling_period
909What: /sys/.../events/in_voltageY_supply_roc_rising_period
910What: /sys/.../events/in_voltageY_supply_roc_falling_period
911What: /sys/.../events/in_voltageY_thresh_rising_period
912What: /sys/.../events/in_voltageY_thresh_falling_period
913What: /sys/.../events/in_voltageY_roc_rising_period
914What: /sys/.../events/in_voltageY_roc_falling_period
915What: /sys/.../events/in_tempY_thresh_rising_period
916What: /sys/.../events/in_tempY_thresh_falling_period
917What: /sys/.../events/in_tempY_roc_rising_period
918What: /sys/.../events/in_tempY_roc_falling_period
a37b549e 919What: /sys/.../events/in_accel_x&y&z_mag_falling_period
3c97c08b
JB
920What: /sys/.../events/in_intensity0_thresh_period
921What: /sys/.../events/in_proximity0_thresh_period
40cb7613
IT
922What: /sys/.../events/in_activity_still_thresh_rising_period
923What: /sys/.../events/in_activity_still_thresh_falling_period
924What: /sys/.../events/in_activity_walking_thresh_rising_period
925What: /sys/.../events/in_activity_walking_thresh_falling_period
926What: /sys/.../events/in_activity_jogging_thresh_rising_period
927What: /sys/.../events/in_activity_jogging_thresh_falling_period
928What: /sys/.../events/in_activity_running_thresh_rising_period
929What: /sys/.../events/in_activity_running_thresh_falling_period
2f3cc667 930KernelVersion: 2.6.37
e34d2c5f
JC
931Contact: linux-iio@vger.kernel.org
932Description:
f386caa3
JC
933 Period of time (in seconds) for which the condition must be
934 met before an event is generated. If direction is not
2f3cc667 935 specified then this period applies to both directions.
e34d2c5f 936
3f7f642b
MF
937What: /sys/.../events/in_accel_thresh_rising_low_pass_filter_3db
938What: /sys/.../events/in_anglvel_thresh_rising_low_pass_filter_3db
939What: /sys/.../events/in_magn_thresh_rising_low_pass_filter_3db
940KernelVersion: 4.2
941Contact: linux-iio@vger.kernel.org
942Description:
943 If a low pass filter can be applied to the event generation
944 this property gives its 3db frequency in Hz.
945 A value of zero disables the filter.
946
947What: /sys/.../events/in_accel_thresh_rising_high_pass_filter_3db
948What: /sys/.../events/in_anglvel_thresh_rising_high_pass_filter_3db
949What: /sys/.../events/in_magn_thresh_rising_high_pass_filter_3db
950KernelVersion: 4.2
951Contact: linux-iio@vger.kernel.org
952Description:
953 If a high pass filter can be applied to the event generation
954 this property gives its 3db frequency in Hz.
955 A value of zero disables the filter.
956
55aebeb9
DB
957What: /sys/.../events/in_activity_still_thresh_rising_en
958What: /sys/.../events/in_activity_still_thresh_falling_en
959What: /sys/.../events/in_activity_walking_thresh_rising_en
960What: /sys/.../events/in_activity_walking_thresh_falling_en
961What: /sys/.../events/in_activity_jogging_thresh_rising_en
962What: /sys/.../events/in_activity_jogging_thresh_falling_en
963What: /sys/.../events/in_activity_running_thresh_rising_en
964What: /sys/.../events/in_activity_running_thresh_falling_en
965KernelVersion: 3.19
966Contact: linux-iio@vger.kernel.org
967Description:
968 Enables or disables activitity events. Depending on direction
969 an event is generated when sensor ENTERS or LEAVES a given state.
970
971What: /sys/.../events/in_activity_still_thresh_rising_value
972What: /sys/.../events/in_activity_still_thresh_falling_value
973What: /sys/.../events/in_activity_walking_thresh_rising_value
974What: /sys/.../events/in_activity_walking_thresh_falling_value
975What: /sys/.../events/in_activity_jogging_thresh_rising_value
976What: /sys/.../events/in_activity_jogging_thresh_falling_value
977What: /sys/.../events/in_activity_running_thresh_rising_value
978What: /sys/.../events/in_activity_running_thresh_falling_value
979KernelVersion: 3.19
980Contact: linux-iio@vger.kernel.org
981Description:
982 Confidence value (in units as percentage) to be used
983 for deciding when an event should be generated. E.g for
984 running: If the confidence value reported by the sensor
985 is greater than in_activity_running_thresh_rising_value
986 then the sensor ENTERS running state. Conversely, if the
987 confidence value reported by the sensor is lower than
988 in_activity_running_thresh_falling_value then the sensor
989 is LEAVING running state.
990
a37b549e
JC
991What: /sys/.../iio:deviceX/events/in_accel_mag_en
992What: /sys/.../iio:deviceX/events/in_accel_mag_rising_en
993What: /sys/.../iio:deviceX/events/in_accel_mag_falling_en
994What: /sys/.../iio:deviceX/events/in_accel_x_mag_en
995What: /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
996What: /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
997What: /sys/.../iio:deviceX/events/in_accel_y_mag_en
998What: /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
999What: /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
1000What: /sys/.../iio:deviceX/events/in_accel_z_mag_en
1001What: /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
1002What: /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
1003What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
1004What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
2f3cc667
JC
1005KernelVersion: 2.6.37
1006Contact: linux-iio@vger.kernel.org
1007Description:
a37b549e 1008 Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
2f3cc667
JC
1009 magnitude of the channel is compared to the threshold, not its
1010 signed value.
e34d2c5f 1011
a37b549e
JC
1012What: /sys/.../events/in_accel_raw_mag_value
1013What: /sys/.../events/in_accel_x_raw_mag_rising_value
1014What: /sys/.../events/in_accel_y_raw_mag_rising_value
1015What: /sys/.../events/in_accel_z_raw_mag_rising_value
2f3cc667
JC
1016KernelVersion: 2.6.37
1017Contact: linux-iio@vger.kernel.org
1018Description:
f386caa3
JC
1019 The value to which the magnitude of the channel is compared. If
1020 number or direction is not specified, applies to all channels of
1021 this type.
2f3cc667 1022
27be8423 1023What: /sys/.../events/in_steps_change_en
e0631a31 1024KernelVersion: 4.0
a88bfe78
IT
1025Contact: linux-iio@vger.kernel.org
1026Description:
27be8423
IT
1027 Event generated when channel passes a threshold on the absolute
1028 change in value. E.g. for steps: a step change event is
1029 generated each time the user takes N steps, where N is set using
1030 in_steps_change_value.
1031
1032What: /sys/.../events/in_steps_change_value
e0631a31 1033KernelVersion: 4.0
27be8423
IT
1034Contact: linux-iio@vger.kernel.org
1035Description:
1036 Specifies the value of change threshold that the
1037 device is comparing against for the events enabled by
1038 <type>[Y][_name]_roc[_rising|falling|]_en. E.g. for steps:
1039 if set to 3, a step change event will be generated every 3
1040 steps.
a88bfe78 1041
b3874069 1042What: /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
e34d2c5f
JC
1043KernelVersion: 2.6.35
1044Contact: linux-iio@vger.kernel.org
1045Description:
1046 The name of the trigger source being used, as per string given
f386caa3 1047 in /sys/class/iio/triggerY/name.
e34d2c5f 1048
b3874069 1049What: /sys/bus/iio/devices/iio:deviceX/buffer/length
e34d2c5f
JC
1050KernelVersion: 2.6.35
1051Contact: linux-iio@vger.kernel.org
1052Description:
1053 Number of scans contained by the buffer.
1054
b3874069 1055What: /sys/bus/iio/devices/iio:deviceX/buffer/enable
e34d2c5f
JC
1056KernelVersion: 2.6.35
1057Contact: linux-iio@vger.kernel.org
1058Description:
1059 Actually start the buffer capture up. Will start trigger
1060 if first device and appropriate.
1061
ab52a958 1062What: /sys/bus/iio/devices/iio:deviceX/scan_elements
5770b8ff
MS
1063KernelVersion: 2.6.37
1064Contact: linux-iio@vger.kernel.org
1065Description:
2f3cc667
JC
1066 Directory containing interfaces for elements that will be
1067 captured for a single triggered sample set in the buffer.
5770b8ff 1068
ab52a958
AR
1069What: /sys/.../iio:deviceX/scan_elements/in_accel_x_en
1070What: /sys/.../iio:deviceX/scan_elements/in_accel_y_en
1071What: /sys/.../iio:deviceX/scan_elements/in_accel_z_en
1072What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_en
1073What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_en
1074What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_en
1075What: /sys/.../iio:deviceX/scan_elements/in_magn_x_en
1076What: /sys/.../iio:deviceX/scan_elements/in_magn_y_en
1077What: /sys/.../iio:deviceX/scan_elements/in_magn_z_en
b531db84
RA
1078What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_en
1079What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_en
1080What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_en
1081What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_en
ab52a958
AR
1082What: /sys/.../iio:deviceX/scan_elements/in_timestamp_en
1083What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_en
1084What: /sys/.../iio:deviceX/scan_elements/in_voltageY_en
1085What: /sys/.../iio:deviceX/scan_elements/in_voltageY-voltageZ_en
1ce87f21
LPC
1086What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_en
1087What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_en
1088What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_en
1089What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_en
ab52a958
AR
1090What: /sys/.../iio:deviceX/scan_elements/in_incli_x_en
1091What: /sys/.../iio:deviceX/scan_elements/in_incli_y_en
1092What: /sys/.../iio:deviceX/scan_elements/in_pressureY_en
1093What: /sys/.../iio:deviceX/scan_elements/in_pressure_en
b4a2d475 1094What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_en
1fad034c 1095What: /sys/.../iio:deviceX/scan_elements/in_proximity_en
5770b8ff
MS
1096KernelVersion: 2.6.37
1097Contact: linux-iio@vger.kernel.org
1098Description:
10ba8ea9 1099 Scan element control for triggered data capture.
5770b8ff 1100
ab52a958
AR
1101What: /sys/.../iio:deviceX/scan_elements/in_accel_type
1102What: /sys/.../iio:deviceX/scan_elements/in_anglvel_type
1103What: /sys/.../iio:deviceX/scan_elements/in_magn_type
1104What: /sys/.../iio:deviceX/scan_elements/in_incli_type
1105What: /sys/.../iio:deviceX/scan_elements/in_voltageY_type
1106What: /sys/.../iio:deviceX/scan_elements/in_voltage_type
1107What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_type
1ce87f21
LPC
1108What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_type
1109What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_type
1110What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_type
1111What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_type
ab52a958
AR
1112What: /sys/.../iio:deviceX/scan_elements/in_timestamp_type
1113What: /sys/.../iio:deviceX/scan_elements/in_pressureY_type
1114What: /sys/.../iio:deviceX/scan_elements/in_pressure_type
b4a2d475 1115What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_type
1fad034c 1116What: /sys/.../iio:deviceX/scan_elements/in_proximity_type
5770b8ff
MS
1117KernelVersion: 2.6.37
1118Contact: linux-iio@vger.kernel.org
1119Description:
10ba8ea9 1120 Description of the scan element data storage within the buffer
f386caa3 1121 and hence the form in which it is read from user-space.
15739cd2
JC
1122 Form is [be|le]:[s|u]bits/storagebits[>>shift].
1123 be or le specifies big or little endian. s or u specifies if
f386caa3
JC
1124 signed (2's complement) or unsigned. bits is the number of bits
1125 of data and storagebits is the space (after padding) that it
1126 occupies in the buffer. shift if specified, is the shift that
1127 needs to be applied prior to masking out unused bits. Some
1128 devices put their data in the middle of the transferred elements
1129 with additional information on both sides. Note that some
1130 devices will have additional information in the unused bits
1131 so to get a clean value, the bits value must be used to mask
1132 the buffer output value appropriately. The storagebits value
1133 also specifies the data alignment. So s48/64>>2 will be a
1134 signed 48 bit integer stored in a 64 bit location aligned to
8b417d78 1135 a 64 bit boundary. To obtain the clean value, shift right 2
f386caa3 1136 and apply a mask to zero the top 16 bits of the result.
10ba8ea9
JC
1137 For other storage combinations this attribute will be extended
1138 appropriately.
1139
ab52a958 1140What: /sys/.../iio:deviceX/scan_elements/in_accel_type_available
f386caa3
JC
1141KernelVersion: 2.6.37
1142Contact: linux-iio@vger.kernel.org
1143Description:
1144 If the type parameter can take one of a small set of values,
1145 this attribute lists them.
1146
ab52a958
AR
1147What: /sys/.../iio:deviceX/scan_elements/in_voltageY_index
1148What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_index
1ce87f21
LPC
1149What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_index
1150What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_index
1151What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_index
1152What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_index
ab52a958
AR
1153What: /sys/.../iio:deviceX/scan_elements/in_accel_x_index
1154What: /sys/.../iio:deviceX/scan_elements/in_accel_y_index
1155What: /sys/.../iio:deviceX/scan_elements/in_accel_z_index
1156What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_index
1157What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_index
1158What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_index
1159What: /sys/.../iio:deviceX/scan_elements/in_magn_x_index
1160What: /sys/.../iio:deviceX/scan_elements/in_magn_y_index
1161What: /sys/.../iio:deviceX/scan_elements/in_magn_z_index
b531db84
RA
1162What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_index
1163What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_index
1164What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_index
1165What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_index
ab52a958
AR
1166What: /sys/.../iio:deviceX/scan_elements/in_incli_x_index
1167What: /sys/.../iio:deviceX/scan_elements/in_incli_y_index
1168What: /sys/.../iio:deviceX/scan_elements/in_timestamp_index
1169What: /sys/.../iio:deviceX/scan_elements/in_pressureY_index
1170What: /sys/.../iio:deviceX/scan_elements/in_pressure_index
b4a2d475 1171What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_index
1fad034c 1172What: /sys/.../iio:deviceX/scan_elements/in_proximity_index
10ba8ea9
JC
1173KernelVersion: 2.6.37
1174Contact: linux-iio@vger.kernel.org
1175Description:
1176 A single positive integer specifying the position of this
f386caa3
JC
1177 scan element in the buffer. Note these are not dependent on
1178 what is enabled and may not be contiguous. Thus for user-space
10ba8ea9
JC
1179 to establish the full layout these must be used in conjunction
1180 with all _en attributes to establish which channels are present,
1181 and the relevant _type attributes to establish the data storage
1182 format.
d4894635 1183
55aebeb9
DB
1184What: /sys/.../iio:deviceX/in_activity_still_input
1185What: /sys/.../iio:deviceX/in_activity_walking_input
1186What: /sys/.../iio:deviceX/in_activity_jogging_input
1187What: /sys/.../iio:deviceX/in_activity_running_input
1188KernelVersion: 3.19
1189Contact: linux-iio@vger.kernel.org
1190Description:
1191 This attribute is used to read the confidence for an activity
1192 expressed in units as percentage.
1193
d4c926f2 1194What: /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
d4894635 1195KernelVersion: 2.6.38
a37b549e 1196Contact: linux-iio@vger.kernel.org
d4894635
MH
1197Description:
1198 This attribute is used to read the amount of quadrature error
1199 present in the device at a given time.
f7883d12 1200
63fa65d3
OK
1201What: /sys/.../iio:deviceX/in_accelX_power_mode
1202KernelVersion: 3.11
1203Contact: linux-iio@vger.kernel.org
1204Description:
1205 Specifies the chip power mode.
1206 low_noise: reduce noise level from ADC,
1207 low_power: enable low current consumption.
1208 For a list of available output power modes read
1209 in_accel_power_mode_available.
1210
72c66644
IT
1211What: /sys/.../iio:deviceX/in_energy_input
1212What: /sys/.../iio:deviceX/in_energy_raw
e0631a31 1213KernelVersion: 4.0
72c66644
IT
1214Contact: linux-iio@vger.kernel.org
1215Description:
1216 This attribute is used to read the energy value reported by the
1217 device (e.g.: human activity sensors report energy burnt by the
1218 user). Units after application of scale are Joules.
1219
cc3c9eec
IT
1220What: /sys/.../iio:deviceX/in_distance_input
1221What: /sys/.../iio:deviceX/in_distance_raw
e0631a31 1222KernelVersion: 4.0
cc3c9eec
IT
1223Contact: linux-iio@vger.kernel.org
1224Description:
1225 This attribute is used to read the distance covered by the user
1226 since the last reboot while activated. Units after application
1227 of scale are meters.
1228
f7883d12
PM
1229What: /sys/bus/iio/devices/iio:deviceX/store_eeprom
1230KernelVersion: 3.4.0
1231Contact: linux-iio@vger.kernel.org
1232Description:
1233 Writing '1' stores the current device configuration into
1234 on-chip EEPROM. After power-up or chip reset the device will
1235 automatically load the saved configuration.
899d90bd 1236
6c0690ec
PM
1237What: /sys/.../iio:deviceX/in_proximity_raw
1238What: /sys/.../iio:deviceX/in_proximity_input
1239What: /sys/.../iio:deviceX/in_proximityY_raw
1240KernelVersion: 3.4
1241Contact: linux-iio@vger.kernel.org
1242Description:
1243 Proximity measurement indicating that some
4fbcfa09 1244 object is near the sensor, usually by observing
6c0690ec
PM
1245 reflectivity of infrared or ultrasound emitted.
1246 Often these sensors are unit less and as such conversion
bdc10d57
DB
1247 to SI units is not possible. Higher proximity measurements
1248 indicate closer objects, and vice versa.
6c0690ec 1249
7cf78db5
DP
1250What: /sys/.../iio:deviceX/in_illuminance_input
1251What: /sys/.../iio:deviceX/in_illuminance_raw
994265f1
PM
1252What: /sys/.../iio:deviceX/in_illuminanceY_input
1253What: /sys/.../iio:deviceX/in_illuminanceY_raw
1254What: /sys/.../iio:deviceX/in_illuminanceY_mean_raw
7cf78db5
DP
1255What: /sys/.../iio:deviceX/in_illuminance_ir_raw
1256What: /sys/.../iio:deviceX/in_illuminance_clear_raw
994265f1
PM
1257KernelVersion: 3.4
1258Contact: linux-iio@vger.kernel.org
1259Description:
1260 Illuminance measurement, units after application of scale
1261 and offset are lux.
1262
065b055d
PM
1263What: /sys/.../iio:deviceX/in_intensityY_raw
1264What: /sys/.../iio:deviceX/in_intensityY_ir_raw
1265What: /sys/.../iio:deviceX/in_intensityY_both_raw
2c5ff1f9 1266What: /sys/.../iio:deviceX/in_intensityY_uv_raw
065b055d
PM
1267KernelVersion: 3.4
1268Contact: linux-iio@vger.kernel.org
1269Description:
1270 Unit-less light intensity. Modifiers both and ir indicate
1271 that measurements contains visible and infrared light
2c5ff1f9
PMS
1272 components or just infrared light, respectively. Modifier uv indicates
1273 that measurements contain ultraviolet light components.
065b055d 1274
d409404c
PMS
1275What: /sys/.../iio:deviceX/in_uvindex_input
1276KernelVersion: 4.6
1277Contact: linux-iio@vger.kernel.org
1278Description:
1279 UV light intensity index measuring the human skin's response to
1280 different wavelength of sunlight weighted according to the
1281 standardised CIE Erythemal Action Spectrum. UV index values range
1282 from 0 (low) to >=11 (extreme).
1283
899d90bd
PM
1284What: /sys/.../iio:deviceX/in_intensity_red_integration_time
1285What: /sys/.../iio:deviceX/in_intensity_green_integration_time
1286What: /sys/.../iio:deviceX/in_intensity_blue_integration_time
1287What: /sys/.../iio:deviceX/in_intensity_clear_integration_time
1288What: /sys/.../iio:deviceX/in_illuminance_integration_time
1289KernelVersion: 3.12
1290Contact: linux-iio@vger.kernel.org
1291Description:
1292 This attribute is used to get/set the integration time in
1293 seconds.
b4a2d475 1294
40cb7613 1295What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_integration_time
e0631a31 1296KernelVersion: 4.0
40cb7613
IT
1297Contact: linux-iio@vger.kernel.org
1298Description:
1299 Number of seconds in which to compute speed.
1300
b4a2d475
SP
1301What: /sys/bus/iio/devices/iio:deviceX/in_rot_quaternion_raw
1302KernelVersion: 3.15
1303Contact: linux-iio@vger.kernel.org
1304Description:
1305 Raw value of quaternion components using a format
1306 x y z w. Here x, y, and z component represents the axis about
1307 which a rotation will occur and w component represents the
1308 amount of rotation.
b531db84
RA
1309
1310What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_raw
1311What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_raw
1312What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_raw
1313What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_raw
1314KernelVersion: 3.15
1315Contact: linux-iio@vger.kernel.org
1316Description:
1317 Raw value of rotation from true/magnetic north measured with
1318 or without compensation from tilt sensors.
c20d4dff
JP
1319
1320What: /sys/bus/iio/devices/iio:deviceX/in_currentX_raw
1ce87f21
LPC
1321What: /sys/bus/iio/devices/iio:deviceX/in_currentX_i_raw
1322What: /sys/bus/iio/devices/iio:deviceX/in_currentX_q_raw
c20d4dff
JP
1323KernelVersion: 3.18
1324Contact: linux-iio@vger.kernel.org
1325Description:
1326 Raw current measurement from channel X. Units are in milliamps
1327 after application of scale and offset. If no offset or scale is
1328 present, output should be considered as processed with the
1329 unit in milliamps.
a88bfe78 1330
1ce87f21
LPC
1331 Channels with 'i' and 'q' modifiers always exist in pairs and both
1332 channels refer to the same signal. The 'i' channel contains the in-phase
1333 component of the signal while the 'q' channel contains the quadrature
1334 component.
1335
40cb7613
IT
1336What: /sys/.../iio:deviceX/in_energy_en
1337What: /sys/.../iio:deviceX/in_distance_en
1338What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_en
a88bfe78
IT
1339What: /sys/.../iio:deviceX/in_steps_en
1340KernelVersion: 3.19
1341Contact: linux-iio@vger.kernel.org
1342Description:
40cb7613
IT
1343 Activates a device feature that runs in firmware/hardware.
1344 E.g. for steps: the pedometer saves power while not used;
1345 when activated, it will count the steps taken by the user in
1346 firmware and export them through in_steps_input.
a88bfe78
IT
1347
1348What: /sys/.../iio:deviceX/in_steps_input
1349KernelVersion: 3.19
1350Contact: linux-iio@vger.kernel.org
1351Description:
1352 This attribute is used to read the number of steps taken by the user
1353 since the last reboot while activated.
5a1a9329
IT
1354
1355What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_input
1356What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_raw
1357KernelVersion: 3.19
1358Contact: linux-iio@vger.kernel.org
1359Description:
1360 This attribute is used to read the current speed value of the
1361 user (which is the norm or magnitude of the velocity vector).
1362 Units after application of scale are m/s.
2f0ecb7c
IT
1363
1364What: /sys/.../iio:deviceX/in_steps_debounce_count
e0631a31 1365KernelVersion: 4.0
2f0ecb7c
IT
1366Contact: linux-iio@vger.kernel.org
1367Description:
1368 Specifies the number of steps that must occur within
1369 in_steps_filter_debounce_time for the pedometer to decide the
1370 consumer is making steps.
1371
1372What: /sys/.../iio:deviceX/in_steps_debounce_time
e0631a31 1373KernelVersion: 4.0
2f0ecb7c
IT
1374Contact: linux-iio@vger.kernel.org
1375Description:
1376 Specifies number of seconds in which we compute the steps
1377 that occur in order to decide if the consumer is making steps.
37d34556
JC
1378
1379What: /sys/bus/iio/devices/iio:deviceX/buffer/watermark
1380KernelVersion: 4.2
1381Contact: linux-iio@vger.kernel.org
1382Description:
1383 A single positive integer specifying the maximum number of scan
1384 elements to wait for.
1385 Poll will block until the watermark is reached.
1386 Blocking read will wait until the minimum between the requested
1387 read amount or the low water mark is available.
1388 Non-blocking read will retrieve the available samples from the
1389 buffer even if there are less samples then watermark level. This
1390 allows the application to block on poll with a timeout and read
1391 the available samples after the timeout expires and thus have a
1392 maximum delay guarantee.
f4f4673b
OP
1393
1394What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_enabled
1395KernelVersion: 4.2
1396Contact: linux-iio@vger.kernel.org
1397Description:
1398 A read-only boolean value that indicates if the hardware fifo is
1399 currently enabled or disabled. If the device does not have a
1400 hardware fifo this entry is not present.
1401 The hardware fifo is enabled when the buffer is enabled if the
1402 current hardware fifo watermark level is set and other current
1403 device settings allows it (e.g. if a trigger is set that samples
1404 data differently that the hardware fifo does then hardware fifo
1405 will not enabled).
1406 If the hardware fifo is enabled and the level of the hardware
1407 fifo reaches the hardware fifo watermark level the device will
1408 flush its hardware fifo to the device buffer. Doing a non
1409 blocking read on the device when no samples are present in the
1410 device buffer will also force a flush.
1411 When the hardware fifo is enabled there is no need to use a
1412 trigger to use buffer mode since the watermark settings
1413 guarantees that the hardware fifo is flushed to the device
1414 buffer.
1415
1416What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark
1417KernelVersion: 4.2
1418Contact: linux-iio@vger.kernel.org
1419Description:
1420 Read-only entry that contains a single integer specifying the
1421 current watermark level for the hardware fifo. If the device
1422 does not have a hardware fifo this entry is not present.
1423 The watermark level for the hardware fifo is set by the driver
1424 based on the value set by the user in buffer/watermark but
1425 taking into account hardware limitations (e.g. most hardware
1426 buffers are limited to 32-64 samples, some hardware buffers
1427 watermarks are fixed or have minimum levels). A value of 0
1428 means that the hardware watermark is unset.
1429
1430What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_min
1431KernelVersion: 4.2
1432Contact: linux-iio@vger.kernel.org
1433Description:
1434 A single positive integer specifying the minimum watermark level
1435 for the hardware fifo of this device. If the device does not
1436 have a hardware fifo this entry is not present.
1437 If the user sets buffer/watermark to a value less than this one,
1438 then the hardware watermark will remain unset.
1439
1440What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_max
1441KernelVersion: 4.2
1442Contact: linux-iio@vger.kernel.org
1443Description:
1444 A single positive integer specifying the maximum watermark level
1445 for the hardware fifo of this device. If the device does not
1446 have a hardware fifo this entry is not present.
1447 If the user sets buffer/watermark to a value greater than this
1448 one, then the hardware watermark will be capped at this value.
1449
1450What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_available
1451KernelVersion: 4.2
1452Contact: linux-iio@vger.kernel.org
1453Description:
1454 A list of positive integers specifying the available watermark
1455 levels for the hardware fifo. This entry is optional and if it
1456 is not present it means that all the values between
1457 hwfifo_watermark_min and hwfifo_watermark_max are supported.
1458 If the user sets buffer/watermark to a value greater than
1459 hwfifo_watermak_min but not equal to any of the values in this
1460 list, the driver will chose an appropriate value for the
1461 hardware fifo watermark level.
c8a85854
VCSM
1462
1463What: /sys/bus/iio/devices/iio:deviceX/in_temp_calibemissivity
1464What: /sys/bus/iio/devices/iio:deviceX/in_tempX_calibemissivity
1465What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_calibemissivity
1466What: /sys/bus/iio/devices/iio:deviceX/in_tempX_object_calibemissivity
1467KernelVersion: 4.1
1468Contact: linux-iio@vger.kernel.org
1469Description:
1470 The emissivity ratio of the surface in the field of view of the
1471 contactless temperature sensor. Emissivity varies from 0 to 1,
1472 with 1 being the emissivity of a black body.
faaa4495
IT
1473
1474What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_oversampling_ratio
1475What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_oversampling_ratio
1476What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_oversampling_ratio
1477KernelVersion: 4.2
1478Contact: linux-iio@vger.kernel.org
1479Description:
1480 Hardware applied number of measurements for acquiring one
1481 data point. The HW will do <type>[_name]_oversampling_ratio
1482 measurements and return the average value as output data. Each
1483 value resulted from <type>[_name]_oversampling_ratio measurements
1484 is considered as one sample for <type>[_name]_sampling_frequency.
8ff6b3bc
MR
1485
1486What: /sys/bus/iio/devices/iio:deviceX/in_concentration_raw
1487What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_raw
1488What: /sys/bus/iio/devices/iio:deviceX/in_concentration_co2_raw
1489What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_co2_raw
1490What: /sys/bus/iio/devices/iio:deviceX/in_concentration_voc_raw
1491What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_voc_raw
1492KernelVersion: 4.3
1493Contact: linux-iio@vger.kernel.org
1494Description:
1495 Raw (unscaled no offset etc.) percentage reading of a substance.
d38d5469
MR
1496
1497What: /sys/bus/iio/devices/iio:deviceX/in_resistance_raw
1498What: /sys/bus/iio/devices/iio:deviceX/in_resistanceX_raw
b15aef8d
PR
1499What: /sys/bus/iio/devices/iio:deviceX/out_resistance_raw
1500What: /sys/bus/iio/devices/iio:deviceX/out_resistanceX_raw
d38d5469
MR
1501KernelVersion: 4.3
1502Contact: linux-iio@vger.kernel.org
1503Description:
1504 Raw (unscaled no offset etc.) resistance reading that can be processed
1505 into an ohm value.
2b5c53d2
LT
1506
1507What: /sys/bus/iio/devices/iio:deviceX/heater_enable
1508KernelVersion: 4.1.0
1509Contact: linux-iio@vger.kernel.org
1510Description:
1511 '1' (enable) or '0' (disable) specifying the enable
1512 of heater function. Same reading values apply
1513 This ABI is especially applicable for humidity sensors
1514 to heatup the device and get rid of any condensation
1515 in some humidity environment
ecb3a7cc
MR
1516
1517What: /sys/bus/iio/devices/iio:deviceX/in_ph_raw
1518KernelVersion: 4.5
1519Contact: linux-iio@vger.kernel.org
1520Description:
1521 Raw (unscaled no offset etc.) pH reading of a substance as a negative
1522 base-10 logarithm of hydrodium ions in a litre of water.
dfc57732
GB
1523
1524What: /sys/bus/iio/devices/iio:deviceX/mount_matrix
1525What: /sys/bus/iio/devices/iio:deviceX/in_mount_matrix
1526What: /sys/bus/iio/devices/iio:deviceX/out_mount_matrix
eb379846
GB
1527What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_mount_matrix
1528What: /sys/bus/iio/devices/iio:deviceX/in_accel_mount_matrix
dfc57732
GB
1529KernelVersion: 4.6
1530Contact: linux-iio@vger.kernel.org
1531Description:
1532 Mounting matrix for IIO sensors. This is a rotation matrix which
1533 informs userspace about sensor chip's placement relative to the
1534 main hardware it is mounted on.
1535 Main hardware placement is defined according to the local
1536 reference frame related to the physical quantity the sensor
1537 measures.
1538 Given that the rotation matrix is defined in a board specific
1539 way (platform data and / or device-tree), the main hardware
1540 reference frame definition is left to the implementor's choice
1541 (see below for a magnetometer example).
1542 Applications should apply this rotation matrix to samples so
1543 that when main hardware reference frame is aligned onto local
1544 reference frame, then sensor chip reference frame is also
1545 perfectly aligned with it.
1546 Matrix is a 3x3 unitary matrix and typically looks like
1547 [0, 1, 0; 1, 0, 0; 0, 0, -1]. Identity matrix
1548 [1, 0, 0; 0, 1, 0; 0, 0, 1] means sensor chip and main hardware
1549 are perfectly aligned with each other.
1550
1551 For example, a mounting matrix for a magnetometer sensor informs
1552 userspace about sensor chip's ORIENTATION relative to the main
1553 hardware.
1554 More specifically, main hardware orientation is defined with
1555 respect to the LOCAL EARTH GEOMAGNETIC REFERENCE FRAME where :
1556 * Y is in the ground plane and positive towards magnetic North ;
1557 * X is in the ground plane, perpendicular to the North axis and
1558 positive towards the East ;
1559 * Z is perpendicular to the ground plane and positive upwards.
1560
1561 An implementor might consider that for a hand-held device, a
1562 'natural' orientation would be 'front facing camera at the top'.
1563 The main hardware reference frame could then be described as :
1564 * Y is in the plane of the screen and is positive towards the
1565 top of the screen ;
1566 * X is in the plane of the screen, perpendicular to Y axis, and
1567 positive towards the right hand side of the screen ;
1568 * Z is perpendicular to the screen plane and positive out of the
1569 screen.
1570 Another example for a quadrotor UAV might be :
1571 * Y is in the plane of the propellers and positive towards the
1572 front-view camera;
1573 * X is in the plane of the propellers, perpendicular to Y axis,
1574 and positive towards the starboard side of the UAV ;
1575 * Z is perpendicular to propellers plane and positive upwards.
4b9d2090
MR
1576
1577What: /sys/bus/iio/devices/iio:deviceX/in_electricalconductivity_raw
1578KernelVersion: 4.8
1579Contact: linux-iio@vger.kernel.org
1580Description:
1581 Raw (unscaled no offset etc.) electric conductivity reading that
1582 can be processed to siemens per meter.
1a8f324a
WBG
1583
1584What: /sys/bus/iio/devices/iio:deviceX/in_countY_raw
1585KernelVersion: 4.9
1586Contact: linux-iio@vger.kernel.org
1587Description:
1588 Raw counter device counts from channel Y. For quadrature
1589 counters, multiplication by an available [Y]_scale results in
1590 the counts of a single quadrature signal phase from channel Y.
1591
1592What: /sys/bus/iio/devices/iio:deviceX/in_indexY_raw
1593KernelVersion: 4.9
1594Contact: linux-iio@vger.kernel.org
1595Description:
1596 Raw counter device index value from channel Y. This attribute
1597 provides an absolute positional reference (e.g. a pulse once per
1598 revolution) which may be used to home positional systems as
1599 required.