]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - Documentation/ABI/testing/sysfs-bus-iio
iio: core: Introduce IIO_ACTIVITY channel
[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
b3874069 35What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency
15739cd2
JC
36What: /sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency
37What: /sys/bus/iio/devices/triggerX/sampling_frequency
e34d2c5f
JC
38KernelVersion: 2.6.35
39Contact: linux-iio@vger.kernel.org
40Description:
41 Some devices have internal clocks. This parameter sets the
42 resulting sampling frequency. In many devices this
8b417d78 43 parameter has an effect on input filters etc. rather than
e34d2c5f 44 simply controlling when the input is sampled. As this
8b417d78 45 effects data ready triggers, hardware buffers and the sysfs
e34d2c5f
JC
46 direct access interfaces, it may be found in any of the
47 relevant directories. If it effects all of the above
15739cd2 48 then it is to be found in the base device directory.
e34d2c5f 49
b3874069 50What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency_available
15739cd2
JC
51What: /sys/.../iio:deviceX/buffer/sampling_frequency_available
52What: /sys/bus/iio/devices/triggerX/sampling_frequency_available
e34d2c5f
JC
53KernelVersion: 2.6.35
54Contact: linux-iio@vger.kernel.org
55Description:
56 When the internal sampling clock can only take a small
f386caa3 57 discrete set of values, this file lists those available.
e34d2c5f 58
b3874069 59What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio
b9618c0c
MH
60KernelVersion: 2.6.38
61Contact: linux-iio@vger.kernel.org
62Description:
63 Hardware dependent ADC oversampling. Controls the sampling ratio
64 of the digital filter if available.
65
b3874069 66What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available
b9618c0c
MH
67KernelVersion: 2.6.38
68Contact: linux-iio@vger.kernel.org
69Description:
70 Hardware dependent values supported by the oversampling filter.
71
a37b549e
JC
72What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
73What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
e34d2c5f
JC
74KernelVersion: 2.6.35
75Contact: linux-iio@vger.kernel.org
76Description:
8b417d78 77 Raw (unscaled no bias removal etc.) voltage measurement from
f386caa3
JC
78 channel Y. In special cases where the channel does not
79 correspond to externally available input one of the named
80 versions may be used. The number must always be specified and
15739cd2 81 unique to allow association with event codes. Units after
c2b2db71 82 application of scale and offset are millivolts.
f386caa3 83
a37b549e 84What: /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw
e34d2c5f
JC
85KernelVersion: 2.6.35
86Contact: linux-iio@vger.kernel.org
87Description:
f386caa3
JC
88 Raw (unscaled) differential voltage measurement equivalent to
89 channel Y - channel Z where these channel numbers apply to the
90 physically equivalent inputs when non differential readings are
91 separately available. In differential only parts, then all that
15739cd2 92 is required is a consistent labeling. Units after application
c2b2db71 93 of scale and offset are millivolts.
e34d2c5f 94
0baf29d6
JC
95What: /sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw
96KernelVersion: 3.2
97Contact: linux-iio@vger.kernel.org
98Description:
99 Raw capacitance measurement from channel Y. Units after
100 application of scale and offset are nanofarads.
101
102What: /sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw
103KernelVersion: 3.2
104Contact: linux-iio@vger.kernel.org
105Description:
106 Raw differential capacitance measurement equivalent to
107 channel Y - channel Z where these channel numbers apply to the
108 physically equivalent inputs when non differential readings are
109 separately available. In differential only parts, then all that
110 is required is a consistent labeling. Units after application
68284a12 111 of scale and offset are nanofarads.
0baf29d6 112
a37b549e 113What: /sys/bus/iio/devices/iio:deviceX/in_temp_raw
15739cd2 114What: /sys/bus/iio/devices/iio:deviceX/in_tempX_raw
a37b549e
JC
115What: /sys/bus/iio/devices/iio:deviceX/in_temp_x_raw
116What: /sys/bus/iio/devices/iio:deviceX/in_temp_y_raw
888c9c73
PM
117What: /sys/bus/iio/devices/iio:deviceX/in_temp_ambient_raw
118What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_raw
e34d2c5f
JC
119KernelVersion: 2.6.35
120Contact: linux-iio@vger.kernel.org
121Description:
8b417d78 122 Raw (unscaled no bias removal etc.) temperature measurement.
68284a12 123 If an axis is specified it generally means that the temperature
f386caa3 124 sensor is associated with one part of a compound device (e.g.
888c9c73
PM
125 a gyroscope axis). The ambient and object modifiers distinguish
126 between ambient (reference) and distant temperature for contact-
127 less measurements. Units after application of scale and offset
cf655d2d 128 are milli degrees Celsius.
e34d2c5f 129
a37b549e 130What: /sys/bus/iio/devices/iio:deviceX/in_tempX_input
7c31b984
MH
131KernelVersion: 2.6.38
132Contact: linux-iio@vger.kernel.org
133Description:
134 Scaled temperature measurement in milli degrees Celsius.
135
a37b549e
JC
136What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw
137What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_raw
138What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_raw
e34d2c5f
JC
139KernelVersion: 2.6.35
140Contact: linux-iio@vger.kernel.org
141Description:
f386caa3 142 Acceleration in direction x, y or z (may be arbitrarily assigned
15739cd2
JC
143 but should match other such assignments on device).
144 Has all of the equivalent parameters as per voltageY. Units
145 after application of scale and offset are m/s^2.
e34d2c5f 146
d4c926f2
JC
147What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw
148What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw
149What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw
e34d2c5f
JC
150KernelVersion: 2.6.35
151Contact: linux-iio@vger.kernel.org
152Description:
f386caa3 153 Angular velocity about axis x, y or z (may be arbitrarily
8b417d78
PM
154 assigned). Has all the equivalent parameters as per voltageY.
155 Units after application of scale and offset are radians per
156 second.
e34d2c5f 157
a37b549e
JC
158What: /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
159What: /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
160What: /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
e34d2c5f
JC
161KernelVersion: 2.6.35
162Contact: linux-iio@vger.kernel.org
163Description:
f386caa3
JC
164 Inclination raw reading about axis x, y or z (may be
165 arbitrarily assigned). Data converted by application of offset
8b417d78 166 and scale to degrees.
e34d2c5f 167
a37b549e
JC
168What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
169What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
170What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
e34d2c5f
JC
171KernelVersion: 2.6.35
172Contact: linux-iio@vger.kernel.org
173Description:
f386caa3 174 Magnetic field along axis x, y or z (may be arbitrarily
15739cd2
JC
175 assigned). Data converted by application of offset
176 then scale to Gauss.
e34d2c5f 177
a37b549e
JC
178What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
179What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
180What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
f386caa3 181KernelVersion: 2.6.36
e34d2c5f
JC
182Contact: linux-iio@vger.kernel.org
183Description:
15739cd2
JC
184 Highest value since some reset condition. These
185 attributes allow access to this and are otherwise
186 the direct equivalent of the <type>Y[_name]_raw attributes.
e34d2c5f 187
a37b549e 188What: /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
f386caa3 189KernelVersion: 2.6.36
e34d2c5f
JC
190Contact: linux-iio@vger.kernel.org
191Description:
f386caa3
JC
192 A computed peak value based on the sum squared magnitude of
193 the underlying value in the specified directions.
e34d2c5f 194
c4f0c693
LPC
195What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_raw
196What: /sys/bus/iio/devices/iio:deviceX/in_pressure_raw
197KernelVersion: 3.8
198Contact: linux-iio@vger.kernel.org
199Description:
200 Raw pressure measurement from channel Y. Units after
201 application of scale and offset are kilopascal.
202
c22e15f3
VD
203What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_input
204What: /sys/bus/iio/devices/iio:deviceX/in_pressure_input
205KernelVersion: 3.8
206Contact: linux-iio@vger.kernel.org
207Description:
208 Scaled pressure measurement from channel Y, in kilopascal.
209
ac216aa2
HG
210What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_raw
211KernelVersion: 3.14
212Contact: linux-iio@vger.kernel.org
213Description:
214 Raw humidity measurement of air. Units after application of
215 scale and offset are milli percent.
216
217What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_input
218KernelVersion: 3.14
219Contact: linux-iio@vger.kernel.org
220Description:
221 Scaled humidity measurement in milli percent.
222
c0a6b7ee
SR
223What: /sys/bus/iio/devices/iio:deviceX/in_X_mean_raw
224KernelVersion: 3.5
225Contact: linux-iio@vger.kernel.org
226Description:
227 Averaged raw measurement from channel X. The number of values
228 used for averaging is device specific. The converting rules for
229 normal raw values also applies to the averaged raw values.
230
a37b549e 231What: /sys/bus/iio/devices/iio:deviceX/in_accel_offset
15739cd2
JC
232What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
233What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
234What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
235What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
236What: /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
237What: /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
a37b549e 238What: /sys/bus/iio/devices/iio:deviceX/in_temp_offset
c4f0c693
LPC
239What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_offset
240What: /sys/bus/iio/devices/iio:deviceX/in_pressure_offset
4d5ce6bb 241What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_offset
e34d2c5f
JC
242KernelVersion: 2.6.35
243Contact: linux-iio@vger.kernel.org
244Description:
f386caa3
JC
245 If known for a device, offset to be added to <type>[Y]_raw prior
246 to scaling by <type>[Y]_scale in order to obtain value in the
8b417d78 247 <type> units as specified in <type>[Y]_raw documentation.
15739cd2
JC
248 Not present if the offset is always 0 or unknown. If Y or
249 axis <x|y|z> is not present, then the offset applies to all
250 in channels of <type>.
f386caa3
JC
251 May be writable if a variable offset can be applied on the
252 device. Note that this is different to calibbias which
253 is for devices (or drivers) that apply offsets to compensate
254 for variation between different instances of the part, typically
255 adjusted by using some hardware supported calibration procedure.
15739cd2
JC
256 Calibbias is applied internally, offset is applied in userspace
257 to the _raw output.
f386caa3 258
a37b549e
JC
259What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
260What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
261What: /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
4e4cd14e 262What: /sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_scale
a37b549e 263What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
d802bf6f 264What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale
a37b549e
JC
265What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale
266What: /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
d4c926f2 267What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale
a37b549e
JC
268What: /sys/bus/iio/devices/iio:deviceX/in_magn_scale
269What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
270What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
271What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
b531db84
RA
272What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_scale
273What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_scale
274What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_scale
275What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_scale
c4f0c693
LPC
276What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_scale
277What: /sys/bus/iio/devices/iio:deviceX/in_pressure_scale
4d5ce6bb 278What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_scale
e5107fb8
JC
279KernelVersion: 2.6.35
280Contact: linux-iio@vger.kernel.org
281Description:
f386caa3
JC
282 If known for a device, scale to be applied to <type>Y[_name]_raw
283 post addition of <type>[Y][_name]_offset in order to obtain the
284 measured value in <type> units as specified in
68284a12 285 <type>[Y][_name]_raw documentation. If shared across all in
15739cd2
JC
286 channels then Y and <x|y|z> are not present and the value is
287 called <type>[Y][_name]_scale. The peak modifier means this
288 value is applied to <type>Y[_name]_peak_raw values.
f386caa3 289
a37b549e
JC
290What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
291What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
292What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
d4c926f2
JC
293What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias
294What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
295What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
3c97c08b
JB
296What: /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
297What: /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
c4f0c693
LPC
298What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibbias
299What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibbias
e34d2c5f
JC
300KernelVersion: 2.6.35
301Contact: linux-iio@vger.kernel.org
302Description:
8b417d78 303 Hardware applied calibration offset (assumed to fix production
15739cd2 304 inaccuracies).
f386caa3 305
a37b549e
JC
306What /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
307What /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
308What /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
309What /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
310What /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
311What /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
d4c926f2
JC
312What /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
313What /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
314What /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
3c97c08b
JB
315what /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
316what /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
c4f0c693
LPC
317What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibscale
318What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibscale
e34d2c5f
JC
319KernelVersion: 2.6.35
320Contact: linux-iio@vger.kernel.org
321Description:
8b417d78 322 Hardware applied calibration scale factor (assumed to fix
f386caa3
JC
323 production inaccuracies). If shared across all channels,
324 <type>_calibscale is used.
e34d2c5f 325
a37b549e 326What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
15739cd2
JC
327What: /sys/.../iio:deviceX/in_voltageX_scale_available
328What: /sys/.../iio:deviceX/in_voltage-voltage_scale_available
329What: /sys/.../iio:deviceX/out_voltageX_scale_available
d802bf6f 330What: /sys/.../iio:deviceX/out_altvoltageX_scale_available
0baf29d6 331What: /sys/.../iio:deviceX/in_capacitance_scale_available
c4f0c693
LPC
332What: /sys/.../iio:deviceX/in_pressure_scale_available
333What: /sys/.../iio:deviceX/in_pressureY_scale_available
cf09fe9c 334KernelVersion: 2.6.35
e34d2c5f
JC
335Contact: linux-iio@vger.kernel.org
336Description:
8b417d78 337 If a discrete set of scale values is available, they
f386caa3 338 are listed in this attribute.
e34d2c5f 339
b65d6212 340What /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
ed56330d
RD
341What: /sys/bus/iio/devices/iio:deviceX/in_intensity_red_hardwaregain
342What: /sys/bus/iio/devices/iio:deviceX/in_intensity_green_hardwaregain
343What: /sys/bus/iio/devices/iio:deviceX/in_intensity_blue_hardwaregain
344What: /sys/bus/iio/devices/iio:deviceX/in_intensity_clear_hardwaregain
b65d6212
MH
345KernelVersion: 2.6.35
346Contact: linux-iio@vger.kernel.org
347Description:
348 Hardware applied gain factor. If shared across all channels,
349 <type>_hardwaregain is used.
350
0c22db43
JC
351What: /sys/.../in_accel_filter_low_pass_3db_frequency
352What: /sys/.../in_magn_filter_low_pass_3db_frequency
353What: /sys/.../in_anglvel_filter_low_pass_3db_frequency
354KernelVersion: 3.2
355Contact: linux-iio@vger.kernel.org
356Description:
357 If a known or controllable low pass filter is applied
358 to the underlying data channel, then this parameter
359 gives the 3dB frequency of the filter in Hz.
360
15739cd2 361What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
d802bf6f 362What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw
98069c3f
RS
363KernelVersion: 2.6.37
364Contact: linux-iio@vger.kernel.org
365Description:
366 Raw (unscaled, no bias etc.) output voltage for
367 channel Y. The number must always be specified and
368 unique if the output corresponds to a single channel.
d802bf6f
MH
369 While DAC like devices typically use out_voltage,
370 a continuous frequency generating device, such as
371 a DDS or PLL should use out_altvoltage.
98069c3f 372
a37b549e 373What: /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
d802bf6f 374What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw
98069c3f
RS
375KernelVersion: 2.6.37
376Contact: linux-iio@vger.kernel.org
377Description:
378 Raw (unscaled, no bias etc.) output voltage for an aggregate of
379 channel Y, channel Z, etc. This interface is available in cases
380 where a single output sets the value for multiple channels
381 simultaneously.
382
a37b549e
JC
383What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
384What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
d802bf6f
MH
385What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode
386What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode
14f88f1b
MH
387KernelVersion: 2.6.38
388Contact: linux-iio@vger.kernel.org
389Description:
390 Specifies the output powerdown mode.
391 DAC output stage is disconnected from the amplifier and
8b417d78
PM
392 1kohm_to_gnd: connected to ground via an 1kOhm resistor,
393 6kohm_to_gnd: connected to ground via a 6kOhm resistor,
394 20kohm_to_gnd: connected to ground via a 20kOhm resistor,
395 100kohm_to_gnd: connected to ground via an 100kOhm resistor,
bd53a414 396 500kohm_to_gnd: connected to ground via a 500kOhm resistor,
8b417d78 397 three_state: left floating.
14f88f1b
MH
398 For a list of available output power down options read
399 outX_powerdown_mode_available. If Y is not present the
400 mode is shared across all outputs.
401
a37b549e
JC
402What: /sys/.../iio:deviceX/out_votlageY_powerdown_mode_available
403What: /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
d802bf6f
MH
404What: /sys/.../iio:deviceX/out_altvotlageY_powerdown_mode_available
405What: /sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available
14f88f1b
MH
406KernelVersion: 2.6.38
407Contact: linux-iio@vger.kernel.org
408Description:
409 Lists all available output power down modes.
410 If Y is not present the mode is shared across all outputs.
411
a37b549e
JC
412What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
413What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
d802bf6f
MH
414What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
415What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown
14f88f1b
MH
416KernelVersion: 2.6.38
417Contact: linux-iio@vger.kernel.org
418Description:
419 Writing 1 causes output Y to enter the power down mode specified
8b417d78
PM
420 by the corresponding outY_powerdown_mode. DAC output stage is
421 disconnected from the amplifier. Clearing returns to normal
422 operation. Y may be suppressed if all outputs are controlled
423 together.
14f88f1b 424
d802bf6f
MH
425What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency
426KernelVersion: 3.4.0
427Contact: linux-iio@vger.kernel.org
428Description:
429 Output frequency for channel Y in Hz. The number must always be
430 specified and unique if the output corresponds to a single
431 channel.
432
433What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase
434KernelVersion: 3.4.0
435Contact: linux-iio@vger.kernel.org
436Description:
437 Phase in radians of one frequency/clock output Y
438 (out_altvoltageY) relative to another frequency/clock output
439 (out_altvoltageZ) of the device X. The number must always be
440 specified and unique if the output corresponds to a single
441 channel.
442
b3874069 443What: /sys/bus/iio/devices/iio:deviceX/events
f386caa3
JC
444KernelVersion: 2.6.35
445Contact: linux-iio@vger.kernel.org
446Description:
447 Configuration of which hardware generated events are passed up
448 to user-space.
e34d2c5f 449
a37b549e
JC
450What: /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
451What: /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
452What: /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
453What: /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
454What: /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
455What: /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
d4c926f2
JC
456What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
457What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
458What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
459What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
460What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
461What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
a37b549e
JC
462What: /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
463What: /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
464What: /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
465What: /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
466What: /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
467What: /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
b531db84
RA
468What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_rising_en
469What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_falling_en
470What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_rising_en
471What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_falling_en
472What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_en
473What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_en
474What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_rising_en
475What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_falling_en
15739cd2
JC
476What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
477What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
478What: /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
479What: /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
480What: /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
481What: /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
2f3cc667
JC
482KernelVersion: 2.6.37
483Contact: linux-iio@vger.kernel.org
484Description:
f386caa3 485 Event generated when channel passes a threshold in the specified
2f3cc667
JC
486 (_rising|_falling) direction. If the direction is not specified,
487 then either the device will report an event which ever direction
15739cd2
JC
488 a single threshold value is passed in (e.g.
489 <type>[Y][_name]_<raw|input>_thresh_value) or
490 <type>[Y][_name]_<raw|input>_thresh_rising_value and
491 <type>[Y][_name]_<raw|input>_thresh_falling_value may take
f386caa3
JC
492 different values, but the device can only enable both thresholds
493 or neither.
2f3cc667 494 Note the driver will assume the last p events requested are
8b417d78
PM
495 to be enabled where p is how many it supports (which may vary
496 depending on the exact set requested. So if you want to be
2f3cc667
JC
497 sure you have set what you think you have, check the contents of
498 these attributes after everything is configured. Drivers may
499 have to buffer any parameters so that they are consistent when
8b417d78 500 a given event type is enabled at a future point (and not those for
2f3cc667
JC
501 whatever event was previously enabled).
502
a37b549e
JC
503What: /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
504What: /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
505What: /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
506What: /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
507What: /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
508What: /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
d4c926f2
JC
509What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
510What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
511What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
512What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
513What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
514What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
a37b549e
JC
515What: /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
516What: /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
517What: /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
518What: /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
519What: /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
520What: /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
b531db84
RA
521What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_rising_en
522What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_falling_en
523What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_rising_en
524What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_falling_en
525What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_rising_en
526What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_falling_en
527What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_rising_en
528What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_falling_en
15739cd2
JC
529What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
530What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
531What: /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
532What: /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
533What: /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
534What: /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
f386caa3
JC
535KernelVersion: 2.6.37
536Contact: linux-iio@vger.kernel.org
537Description:
538 Event generated when channel passes a threshold on the rate of
539 change (1st differential) in the specified (_rising|_falling)
540 direction. If the direction is not specified, then either the
541 device will report an event which ever direction a single
15739cd2
JC
542 threshold value is passed in (e.g.
543 <type>[Y][_name]_<raw|input>_roc_value) or
544 <type>[Y][_name]_<raw|input>_roc_rising_value and
545 <type>[Y][_name]_<raw|input>_roc_falling_value may take
f386caa3
JC
546 different values, but the device can only enable both rate of
547 change thresholds or neither.
548 Note the driver will assume the last p events requested are
549 to be enabled where p is however many it supports (which may
550 vary depending on the exact set requested. So if you want to be
551 sure you have set what you think you have, check the contents of
552 these attributes after everything is configured. Drivers may
553 have to buffer any parameters so that they are consistent when
554 a given event type is enabled a future point (and not those for
555 whatever event was previously enabled).
556
a37b549e
JC
557What: /sys/.../events/in_accel_x_raw_thresh_rising_value
558What: /sys/.../events/in_accel_x_raw_thresh_falling_value
559What: /sys/.../events/in_accel_y_raw_thresh_rising_value
560What: /sys/.../events/in_accel_y_raw_thresh_falling_value
561What: /sys/.../events/in_accel_z_raw_thresh_rising_value
562What: /sys/.../events/in_accel_z_raw_thresh_falling_value
d4c926f2
JC
563What: /sys/.../events/in_anglvel_x_raw_thresh_rising_value
564What: /sys/.../events/in_anglvel_x_raw_thresh_falling_value
565What: /sys/.../events/in_anglvel_y_raw_thresh_rising_value
566What: /sys/.../events/in_anglvel_y_raw_thresh_falling_value
567What: /sys/.../events/in_anglvel_z_raw_thresh_rising_value
568What: /sys/.../events/in_anglvel_z_raw_thresh_falling_value
a37b549e
JC
569What: /sys/.../events/in_magn_x_raw_thresh_rising_value
570What: /sys/.../events/in_magn_x_raw_thresh_falling_value
571What: /sys/.../events/in_magn_y_raw_thresh_rising_value
572What: /sys/.../events/in_magn_y_raw_thresh_falling_value
573What: /sys/.../events/in_magn_z_raw_thresh_rising_value
574What: /sys/.../events/in_magn_z_raw_thresh_falling_value
b531db84
RA
575What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_rising_value
576What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_falling_value
577What: /sys/.../events/in_rot_from_north_true_raw_thresh_rising_value
578What: /sys/.../events/in_rot_from_north_true_raw_thresh_falling_value
579What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_rising_value
580What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_falling_value
581What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_rising_value
582What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_falling_value
15739cd2
JC
583What: /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
584What: /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
a7322fc2 585What: /sys/.../events/in_voltageY_raw_thresh_rising_value
15739cd2 586What: /sys/.../events/in_voltageY_raw_thresh_falling_value
a7322fc2 587What: /sys/.../events/in_tempY_raw_thresh_rising_value
15739cd2 588What: /sys/.../events/in_tempY_raw_thresh_falling_value
3c97c08b
JB
589What: /sys/.../events/in_illuminance0_thresh_falling_value
590what: /sys/.../events/in_illuminance0_thresh_rising_value
591what: /sys/.../events/in_proximity0_thresh_falling_value
592what: /sys/.../events/in_proximity0_thresh_rising_value
2f3cc667 593KernelVersion: 2.6.37
e34d2c5f
JC
594Contact: linux-iio@vger.kernel.org
595Description:
2f3cc667
JC
596 Specifies the value of threshold that the device is comparing
597 against for the events enabled by
15739cd2
JC
598 <type>Y[_name]_thresh[_rising|falling]_en.
599 If separate attributes exist for the two directions, but
f386caa3
JC
600 direction is not specified for this attribute, then a single
601 threshold value applies to both directions.
2f3cc667
JC
602 The raw or input element of the name indicates whether the
603 value is in raw device units or in processed units (as _raw
604 and _input do on sysfs direct channel read attributes).
e34d2c5f 605
ec6670ae
LPC
606What: /sys/.../events/in_accel_x_thresh_rising_hysteresis
607What: /sys/.../events/in_accel_x_thresh_falling_hysteresis
608What: /sys/.../events/in_accel_x_thresh_either_hysteresis
609What: /sys/.../events/in_accel_y_thresh_rising_hysteresis
610What: /sys/.../events/in_accel_y_thresh_falling_hysteresis
611What: /sys/.../events/in_accel_y_thresh_either_hysteresis
612What: /sys/.../events/in_accel_z_thresh_rising_hysteresis
613What: /sys/.../events/in_accel_z_thresh_falling_hysteresis
614What: /sys/.../events/in_accel_z_thresh_either_hysteresis
615What: /sys/.../events/in_anglvel_x_thresh_rising_hysteresis
616What: /sys/.../events/in_anglvel_x_thresh_falling_hysteresis
617What: /sys/.../events/in_anglvel_x_thresh_either_hysteresis
618What: /sys/.../events/in_anglvel_y_thresh_rising_hysteresis
619What: /sys/.../events/in_anglvel_y_thresh_falling_hysteresis
620What: /sys/.../events/in_anglvel_y_thresh_either_hysteresis
621What: /sys/.../events/in_anglvel_z_thresh_rising_hysteresis
622What: /sys/.../events/in_anglvel_z_thresh_falling_hysteresis
623What: /sys/.../events/in_anglvel_z_thresh_either_hysteresis
624What: /sys/.../events/in_magn_x_thresh_rising_hysteresis
625What: /sys/.../events/in_magn_x_thresh_falling_hysteresis
626What: /sys/.../events/in_magn_x_thresh_either_hysteresis
627What: /sys/.../events/in_magn_y_thresh_rising_hysteresis
628What: /sys/.../events/in_magn_y_thresh_falling_hysteresis
629What: /sys/.../events/in_magn_y_thresh_either_hysteresis
630What: /sys/.../events/in_magn_z_thresh_rising_hysteresis
631What: /sys/.../events/in_magn_z_thresh_falling_hysteresis
632What: /sys/.../events/in_magn_z_thresh_either_hysteresis
b531db84
RA
633What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_hysteresis
634What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_hysteresis
635What: /sys/.../events/in_rot_from_north_magnetic_thresh_either_hysteresis
636What: /sys/.../events/in_rot_from_north_true_thresh_rising_hysteresis
637What: /sys/.../events/in_rot_from_north_true_thresh_falling_hysteresis
638What: /sys/.../events/in_rot_from_north_true_thresh_either_hysteresis
639What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_hysteresis
640What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_hysteresis
641What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_either_hysteresis
642What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_hysteresis
643What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_hysteresis
644What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_either_hysteresis
ec6670ae
LPC
645What: /sys/.../events/in_voltageY_thresh_rising_hysteresis
646What: /sys/.../events/in_voltageY_thresh_falling_hysteresis
647What: /sys/.../events/in_voltageY_thresh_either_hysteresis
648What: /sys/.../events/in_tempY_thresh_rising_hysteresis
649What: /sys/.../events/in_tempY_thresh_falling_hysteresis
650What: /sys/.../events/in_tempY_thresh_either_hysteresis
651What: /sys/.../events/in_illuminance0_thresh_falling_hysteresis
652what: /sys/.../events/in_illuminance0_thresh_rising_hysteresis
653what: /sys/.../events/in_illuminance0_thresh_either_hysteresis
654what: /sys/.../events/in_proximity0_thresh_falling_hysteresis
655what: /sys/.../events/in_proximity0_thresh_rising_hysteresis
656what: /sys/.../events/in_proximity0_thresh_either_hysteresis
657KernelVersion: 3.13
658Contact: linux-iio@vger.kernel.org
659Description:
660 Specifies the hysteresis of threshold that the device is comparing
661 against for the events enabled by
662 <type>Y[_name]_thresh[_(rising|falling)]_hysteresis.
663 If separate attributes exist for the two directions, but
664 direction is not specified for this attribute, then a single
665 hysteresis value applies to both directions.
666 For falling events the hysteresis is added to the _value attribute for
667 this event to get the upper threshold for when the event goes back to
668 normal, for rising events the hysteresis is subtracted from the _value
669 attribute. E.g. if in_voltage0_raw_thresh_rising_value is set to 1200
670 and in_voltage0_raw_thresh_rising_hysteresis is set to 50. The event
671 will get activated once in_voltage0_raw goes above 1200 and will become
672 deactived again once the value falls below 1150.
673
a37b549e
JC
674What: /sys/.../events/in_accel_x_raw_roc_rising_value
675What: /sys/.../events/in_accel_x_raw_roc_falling_value
676What: /sys/.../events/in_accel_y_raw_roc_rising_value
677What: /sys/.../events/in_accel_y_raw_roc_falling_value
678What: /sys/.../events/in_accel_z_raw_roc_rising_value
679What: /sys/.../events/in_accel_z_raw_roc_falling_value
d4c926f2
JC
680What: /sys/.../events/in_anglvel_x_raw_roc_rising_value
681What: /sys/.../events/in_anglvel_x_raw_roc_falling_value
682What: /sys/.../events/in_anglvel_y_raw_roc_rising_value
683What: /sys/.../events/in_anglvel_y_raw_roc_falling_value
684What: /sys/.../events/in_anglvel_z_raw_roc_rising_value
685What: /sys/.../events/in_anglvel_z_raw_roc_falling_value
a37b549e
JC
686What: /sys/.../events/in_magn_x_raw_roc_rising_value
687What: /sys/.../events/in_magn_x_raw_roc_falling_value
688What: /sys/.../events/in_magn_y_raw_roc_rising_value
689What: /sys/.../events/in_magn_y_raw_roc_falling_value
690What: /sys/.../events/in_magn_z_raw_roc_rising_value
691What: /sys/.../events/in_magn_z_raw_roc_falling_value
b531db84
RA
692What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_rising_value
693What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_falling_value
694What: /sys/.../events/in_rot_from_north_true_raw_roc_rising_value
695What: /sys/.../events/in_rot_from_north_true_raw_roc_falling_value
696What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_rising_value
697What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_falling_value
698What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_rising_value
699What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_falling_value
15739cd2
JC
700What: /sys/.../events/in_voltageY_supply_raw_roc_rising_value
701What: /sys/.../events/in_voltageY_supply_raw_roc_falling_value
a7322fc2 702What: /sys/.../events/in_voltageY_raw_roc_rising_value
15739cd2 703What: /sys/.../events/in_voltageY_raw_roc_falling_value
a7322fc2 704What: /sys/.../events/in_tempY_raw_roc_rising_value
15739cd2 705What: /sys/.../events/in_tempY_raw_roc_falling_value
2f3cc667
JC
706KernelVersion: 2.6.37
707Contact: linux-iio@vger.kernel.org
708Description:
f386caa3
JC
709 Specifies the value of rate of change threshold that the
710 device is comparing against for the events enabled by
15739cd2 711 <type>[Y][_name]_roc[_rising|falling]_en.
f386caa3
JC
712 If separate attributes exist for the two directions,
713 but direction is not specified for this attribute,
714 then a single threshold value applies to both directions.
715 The raw or input element of the name indicates whether the
716 value is in raw device units or in processed units (as _raw
717 and _input do on sysfs direct channel read attributes).
2f3cc667 718
a37b549e
JC
719What: /sys/.../events/in_accel_x_thresh_rising_period
720What: /sys/.../events/in_accel_x_thresh_falling_period
721hat: /sys/.../events/in_accel_x_roc_rising_period
722What: /sys/.../events/in_accel_x_roc_falling_period
723What: /sys/.../events/in_accel_y_thresh_rising_period
724What: /sys/.../events/in_accel_y_thresh_falling_period
725What: /sys/.../events/in_accel_y_roc_rising_period
726What: /sys/.../events/in_accel_y_roc_falling_period
727What: /sys/.../events/in_accel_z_thresh_rising_period
728What: /sys/.../events/in_accel_z_thresh_falling_period
729What: /sys/.../events/in_accel_z_roc_rising_period
730What: /sys/.../events/in_accel_z_roc_falling_period
d4c926f2
JC
731What: /sys/.../events/in_anglvel_x_thresh_rising_period
732What: /sys/.../events/in_anglvel_x_thresh_falling_period
733What: /sys/.../events/in_anglvel_x_roc_rising_period
734What: /sys/.../events/in_anglvel_x_roc_falling_period
735What: /sys/.../events/in_anglvel_y_thresh_rising_period
736What: /sys/.../events/in_anglvel_y_thresh_falling_period
737What: /sys/.../events/in_anglvel_y_roc_rising_period
738What: /sys/.../events/in_anglvel_y_roc_falling_period
739What: /sys/.../events/in_anglvel_z_thresh_rising_period
740What: /sys/.../events/in_anglvel_z_thresh_falling_period
741What: /sys/.../events/in_anglvel_z_roc_rising_period
742What: /sys/.../events/in_anglvel_z_roc_falling_period
a37b549e
JC
743What: /sys/.../events/in_magn_x_thresh_rising_period
744What: /sys/.../events/in_magn_x_thresh_falling_period
745What: /sys/.../events/in_magn_x_roc_rising_period
746What: /sys/.../events/in_magn_x_roc_falling_period
747What: /sys/.../events/in_magn_y_thresh_rising_period
748What: /sys/.../events/in_magn_y_thresh_falling_period
749What: /sys/.../events/in_magn_y_roc_rising_period
750What: /sys/.../events/in_magn_y_roc_falling_period
751What: /sys/.../events/in_magn_z_thresh_rising_period
752What: /sys/.../events/in_magn_z_thresh_falling_period
753What: /sys/.../events/in_magn_z_roc_rising_period
754What: /sys/.../events/in_magn_z_roc_falling_period
b531db84
RA
755What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_period
756What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_period
757What: /sys/.../events/in_rot_from_north_magnetic_roc_rising_period
758What: /sys/.../events/in_rot_from_north_magnetic_roc_falling_period
759What: /sys/.../events/in_rot_from_north_true_thresh_rising_period
760What: /sys/.../events/in_rot_from_north_true_thresh_falling_period
761What: /sys/.../events/in_rot_from_north_true_roc_rising_period
762What: /sys/.../events/in_rot_from_north_true_roc_falling_period
763What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_period
764What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_period
765What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_rising_period
766What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_falling_period
767What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_period
768What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_period
769What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_rising_period
770What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_falling_period
15739cd2
JC
771What: /sys/.../events/in_voltageY_supply_thresh_rising_period
772What: /sys/.../events/in_voltageY_supply_thresh_falling_period
773What: /sys/.../events/in_voltageY_supply_roc_rising_period
774What: /sys/.../events/in_voltageY_supply_roc_falling_period
775What: /sys/.../events/in_voltageY_thresh_rising_period
776What: /sys/.../events/in_voltageY_thresh_falling_period
777What: /sys/.../events/in_voltageY_roc_rising_period
778What: /sys/.../events/in_voltageY_roc_falling_period
779What: /sys/.../events/in_tempY_thresh_rising_period
780What: /sys/.../events/in_tempY_thresh_falling_period
781What: /sys/.../events/in_tempY_roc_rising_period
782What: /sys/.../events/in_tempY_roc_falling_period
a37b549e 783What: /sys/.../events/in_accel_x&y&z_mag_falling_period
3c97c08b
JB
784What: /sys/.../events/in_intensity0_thresh_period
785What: /sys/.../events/in_proximity0_thresh_period
2f3cc667 786KernelVersion: 2.6.37
e34d2c5f
JC
787Contact: linux-iio@vger.kernel.org
788Description:
f386caa3
JC
789 Period of time (in seconds) for which the condition must be
790 met before an event is generated. If direction is not
2f3cc667 791 specified then this period applies to both directions.
e34d2c5f 792
55aebeb9
DB
793What: /sys/.../events/in_activity_still_thresh_rising_en
794What: /sys/.../events/in_activity_still_thresh_falling_en
795What: /sys/.../events/in_activity_walking_thresh_rising_en
796What: /sys/.../events/in_activity_walking_thresh_falling_en
797What: /sys/.../events/in_activity_jogging_thresh_rising_en
798What: /sys/.../events/in_activity_jogging_thresh_falling_en
799What: /sys/.../events/in_activity_running_thresh_rising_en
800What: /sys/.../events/in_activity_running_thresh_falling_en
801KernelVersion: 3.19
802Contact: linux-iio@vger.kernel.org
803Description:
804 Enables or disables activitity events. Depending on direction
805 an event is generated when sensor ENTERS or LEAVES a given state.
806
807What: /sys/.../events/in_activity_still_thresh_rising_value
808What: /sys/.../events/in_activity_still_thresh_falling_value
809What: /sys/.../events/in_activity_walking_thresh_rising_value
810What: /sys/.../events/in_activity_walking_thresh_falling_value
811What: /sys/.../events/in_activity_jogging_thresh_rising_value
812What: /sys/.../events/in_activity_jogging_thresh_falling_value
813What: /sys/.../events/in_activity_running_thresh_rising_value
814What: /sys/.../events/in_activity_running_thresh_falling_value
815KernelVersion: 3.19
816Contact: linux-iio@vger.kernel.org
817Description:
818 Confidence value (in units as percentage) to be used
819 for deciding when an event should be generated. E.g for
820 running: If the confidence value reported by the sensor
821 is greater than in_activity_running_thresh_rising_value
822 then the sensor ENTERS running state. Conversely, if the
823 confidence value reported by the sensor is lower than
824 in_activity_running_thresh_falling_value then the sensor
825 is LEAVING running state.
826
a37b549e
JC
827What: /sys/.../iio:deviceX/events/in_accel_mag_en
828What: /sys/.../iio:deviceX/events/in_accel_mag_rising_en
829What: /sys/.../iio:deviceX/events/in_accel_mag_falling_en
830What: /sys/.../iio:deviceX/events/in_accel_x_mag_en
831What: /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
832What: /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
833What: /sys/.../iio:deviceX/events/in_accel_y_mag_en
834What: /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
835What: /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
836What: /sys/.../iio:deviceX/events/in_accel_z_mag_en
837What: /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
838What: /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
839What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
840What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
2f3cc667
JC
841KernelVersion: 2.6.37
842Contact: linux-iio@vger.kernel.org
843Description:
a37b549e 844 Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
2f3cc667
JC
845 magnitude of the channel is compared to the threshold, not its
846 signed value.
e34d2c5f 847
a37b549e
JC
848What: /sys/.../events/in_accel_raw_mag_value
849What: /sys/.../events/in_accel_x_raw_mag_rising_value
850What: /sys/.../events/in_accel_y_raw_mag_rising_value
851What: /sys/.../events/in_accel_z_raw_mag_rising_value
2f3cc667
JC
852KernelVersion: 2.6.37
853Contact: linux-iio@vger.kernel.org
854Description:
f386caa3
JC
855 The value to which the magnitude of the channel is compared. If
856 number or direction is not specified, applies to all channels of
857 this type.
2f3cc667 858
b3874069 859What: /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
e34d2c5f
JC
860KernelVersion: 2.6.35
861Contact: linux-iio@vger.kernel.org
862Description:
863 The name of the trigger source being used, as per string given
f386caa3 864 in /sys/class/iio/triggerY/name.
e34d2c5f 865
b3874069 866What: /sys/bus/iio/devices/iio:deviceX/buffer/length
e34d2c5f
JC
867KernelVersion: 2.6.35
868Contact: linux-iio@vger.kernel.org
869Description:
870 Number of scans contained by the buffer.
871
b3874069 872What: /sys/bus/iio/devices/iio:deviceX/buffer/bytes_per_datum
5770b8ff 873KernelVersion: 2.6.37
e34d2c5f
JC
874Contact: linux-iio@vger.kernel.org
875Description:
876 Bytes per scan. Due to alignment fun, the scan may be larger
877 than implied directly by the scan_element parameters.
878
b3874069 879What: /sys/bus/iio/devices/iio:deviceX/buffer/enable
e34d2c5f
JC
880KernelVersion: 2.6.35
881Contact: linux-iio@vger.kernel.org
882Description:
883 Actually start the buffer capture up. Will start trigger
884 if first device and appropriate.
885
ab52a958 886What: /sys/bus/iio/devices/iio:deviceX/scan_elements
5770b8ff
MS
887KernelVersion: 2.6.37
888Contact: linux-iio@vger.kernel.org
889Description:
2f3cc667
JC
890 Directory containing interfaces for elements that will be
891 captured for a single triggered sample set in the buffer.
5770b8ff 892
ab52a958
AR
893What: /sys/.../iio:deviceX/scan_elements/in_accel_x_en
894What: /sys/.../iio:deviceX/scan_elements/in_accel_y_en
895What: /sys/.../iio:deviceX/scan_elements/in_accel_z_en
896What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_en
897What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_en
898What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_en
899What: /sys/.../iio:deviceX/scan_elements/in_magn_x_en
900What: /sys/.../iio:deviceX/scan_elements/in_magn_y_en
901What: /sys/.../iio:deviceX/scan_elements/in_magn_z_en
b531db84
RA
902What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_en
903What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_en
904What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_en
905What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_en
ab52a958
AR
906What: /sys/.../iio:deviceX/scan_elements/in_timestamp_en
907What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_en
908What: /sys/.../iio:deviceX/scan_elements/in_voltageY_en
909What: /sys/.../iio:deviceX/scan_elements/in_voltageY-voltageZ_en
910What: /sys/.../iio:deviceX/scan_elements/in_incli_x_en
911What: /sys/.../iio:deviceX/scan_elements/in_incli_y_en
912What: /sys/.../iio:deviceX/scan_elements/in_pressureY_en
913What: /sys/.../iio:deviceX/scan_elements/in_pressure_en
b4a2d475 914What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_en
5770b8ff
MS
915KernelVersion: 2.6.37
916Contact: linux-iio@vger.kernel.org
917Description:
10ba8ea9 918 Scan element control for triggered data capture.
5770b8ff 919
ab52a958
AR
920What: /sys/.../iio:deviceX/scan_elements/in_accel_type
921What: /sys/.../iio:deviceX/scan_elements/in_anglvel_type
922What: /sys/.../iio:deviceX/scan_elements/in_magn_type
923What: /sys/.../iio:deviceX/scan_elements/in_incli_type
924What: /sys/.../iio:deviceX/scan_elements/in_voltageY_type
925What: /sys/.../iio:deviceX/scan_elements/in_voltage_type
926What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_type
927What: /sys/.../iio:deviceX/scan_elements/in_timestamp_type
928What: /sys/.../iio:deviceX/scan_elements/in_pressureY_type
929What: /sys/.../iio:deviceX/scan_elements/in_pressure_type
b4a2d475 930What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_type
5770b8ff
MS
931KernelVersion: 2.6.37
932Contact: linux-iio@vger.kernel.org
933Description:
10ba8ea9 934 Description of the scan element data storage within the buffer
f386caa3 935 and hence the form in which it is read from user-space.
15739cd2
JC
936 Form is [be|le]:[s|u]bits/storagebits[>>shift].
937 be or le specifies big or little endian. s or u specifies if
f386caa3
JC
938 signed (2's complement) or unsigned. bits is the number of bits
939 of data and storagebits is the space (after padding) that it
940 occupies in the buffer. shift if specified, is the shift that
941 needs to be applied prior to masking out unused bits. Some
942 devices put their data in the middle of the transferred elements
943 with additional information on both sides. Note that some
944 devices will have additional information in the unused bits
945 so to get a clean value, the bits value must be used to mask
946 the buffer output value appropriately. The storagebits value
947 also specifies the data alignment. So s48/64>>2 will be a
948 signed 48 bit integer stored in a 64 bit location aligned to
8b417d78 949 a 64 bit boundary. To obtain the clean value, shift right 2
f386caa3 950 and apply a mask to zero the top 16 bits of the result.
10ba8ea9
JC
951 For other storage combinations this attribute will be extended
952 appropriately.
953
ab52a958 954What: /sys/.../iio:deviceX/scan_elements/in_accel_type_available
f386caa3
JC
955KernelVersion: 2.6.37
956Contact: linux-iio@vger.kernel.org
957Description:
958 If the type parameter can take one of a small set of values,
959 this attribute lists them.
960
ab52a958
AR
961What: /sys/.../iio:deviceX/scan_elements/in_voltageY_index
962What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_index
963What: /sys/.../iio:deviceX/scan_elements/in_accel_x_index
964What: /sys/.../iio:deviceX/scan_elements/in_accel_y_index
965What: /sys/.../iio:deviceX/scan_elements/in_accel_z_index
966What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_index
967What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_index
968What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_index
969What: /sys/.../iio:deviceX/scan_elements/in_magn_x_index
970What: /sys/.../iio:deviceX/scan_elements/in_magn_y_index
971What: /sys/.../iio:deviceX/scan_elements/in_magn_z_index
b531db84
RA
972What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_index
973What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_index
974What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_index
975What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_index
ab52a958
AR
976What: /sys/.../iio:deviceX/scan_elements/in_incli_x_index
977What: /sys/.../iio:deviceX/scan_elements/in_incli_y_index
978What: /sys/.../iio:deviceX/scan_elements/in_timestamp_index
979What: /sys/.../iio:deviceX/scan_elements/in_pressureY_index
980What: /sys/.../iio:deviceX/scan_elements/in_pressure_index
b4a2d475 981What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_index
10ba8ea9
JC
982KernelVersion: 2.6.37
983Contact: linux-iio@vger.kernel.org
984Description:
985 A single positive integer specifying the position of this
f386caa3
JC
986 scan element in the buffer. Note these are not dependent on
987 what is enabled and may not be contiguous. Thus for user-space
10ba8ea9
JC
988 to establish the full layout these must be used in conjunction
989 with all _en attributes to establish which channels are present,
990 and the relevant _type attributes to establish the data storage
991 format.
d4894635 992
55aebeb9
DB
993What: /sys/.../iio:deviceX/in_activity_still_input
994What: /sys/.../iio:deviceX/in_activity_walking_input
995What: /sys/.../iio:deviceX/in_activity_jogging_input
996What: /sys/.../iio:deviceX/in_activity_running_input
997KernelVersion: 3.19
998Contact: linux-iio@vger.kernel.org
999Description:
1000 This attribute is used to read the confidence for an activity
1001 expressed in units as percentage.
1002
d4c926f2 1003What: /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
d4894635 1004KernelVersion: 2.6.38
a37b549e 1005Contact: linux-iio@vger.kernel.org
d4894635
MH
1006Description:
1007 This attribute is used to read the amount of quadrature error
1008 present in the device at a given time.
f7883d12 1009
63fa65d3
OK
1010What: /sys/.../iio:deviceX/in_accelX_power_mode
1011KernelVersion: 3.11
1012Contact: linux-iio@vger.kernel.org
1013Description:
1014 Specifies the chip power mode.
1015 low_noise: reduce noise level from ADC,
1016 low_power: enable low current consumption.
1017 For a list of available output power modes read
1018 in_accel_power_mode_available.
1019
f7883d12
PM
1020What: /sys/bus/iio/devices/iio:deviceX/store_eeprom
1021KernelVersion: 3.4.0
1022Contact: linux-iio@vger.kernel.org
1023Description:
1024 Writing '1' stores the current device configuration into
1025 on-chip EEPROM. After power-up or chip reset the device will
1026 automatically load the saved configuration.
899d90bd 1027
6c0690ec
PM
1028What: /sys/.../iio:deviceX/in_proximity_raw
1029What: /sys/.../iio:deviceX/in_proximity_input
1030What: /sys/.../iio:deviceX/in_proximityY_raw
1031KernelVersion: 3.4
1032Contact: linux-iio@vger.kernel.org
1033Description:
1034 Proximity measurement indicating that some
1035 object is near the sensor, usually be observing
1036 reflectivity of infrared or ultrasound emitted.
1037 Often these sensors are unit less and as such conversion
1038 to SI units is not possible. Where it is, the units should
1039 be meters.
1040
994265f1
PM
1041What: /sys/.../iio:deviceX/in_illuminanceY_input
1042What: /sys/.../iio:deviceX/in_illuminanceY_raw
1043What: /sys/.../iio:deviceX/in_illuminanceY_mean_raw
1044KernelVersion: 3.4
1045Contact: linux-iio@vger.kernel.org
1046Description:
1047 Illuminance measurement, units after application of scale
1048 and offset are lux.
1049
065b055d
PM
1050What: /sys/.../iio:deviceX/in_intensityY_raw
1051What: /sys/.../iio:deviceX/in_intensityY_ir_raw
1052What: /sys/.../iio:deviceX/in_intensityY_both_raw
1053KernelVersion: 3.4
1054Contact: linux-iio@vger.kernel.org
1055Description:
1056 Unit-less light intensity. Modifiers both and ir indicate
1057 that measurements contains visible and infrared light
1058 components or just infrared light, respectively.
1059
899d90bd
PM
1060What: /sys/.../iio:deviceX/in_intensity_red_integration_time
1061What: /sys/.../iio:deviceX/in_intensity_green_integration_time
1062What: /sys/.../iio:deviceX/in_intensity_blue_integration_time
1063What: /sys/.../iio:deviceX/in_intensity_clear_integration_time
1064What: /sys/.../iio:deviceX/in_illuminance_integration_time
1065KernelVersion: 3.12
1066Contact: linux-iio@vger.kernel.org
1067Description:
1068 This attribute is used to get/set the integration time in
1069 seconds.
b4a2d475
SP
1070
1071What: /sys/bus/iio/devices/iio:deviceX/in_rot_quaternion_raw
1072KernelVersion: 3.15
1073Contact: linux-iio@vger.kernel.org
1074Description:
1075 Raw value of quaternion components using a format
1076 x y z w. Here x, y, and z component represents the axis about
1077 which a rotation will occur and w component represents the
1078 amount of rotation.
b531db84
RA
1079
1080What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_raw
1081What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_raw
1082What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_raw
1083What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_raw
1084KernelVersion: 3.15
1085Contact: linux-iio@vger.kernel.org
1086Description:
1087 Raw value of rotation from true/magnetic north measured with
1088 or without compensation from tilt sensors.
c20d4dff
JP
1089
1090What: /sys/bus/iio/devices/iio:deviceX/in_currentX_raw
1091KernelVersion: 3.18
1092Contact: linux-iio@vger.kernel.org
1093Description:
1094 Raw current measurement from channel X. Units are in milliamps
1095 after application of scale and offset. If no offset or scale is
1096 present, output should be considered as processed with the
1097 unit in milliamps.