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