staging:iio:documentation Add abi docs for capacitance adcs.
[pandora-kernel.git] / drivers / staging / iio / Documentation / sysfs-bus-iio
1 What:           /sys/bus/iio/devices/iio:deviceX
2 KernelVersion:  2.6.35
3 Contact:        linux-iio@vger.kernel.org
4 Description:
5                 Hardware chip or device accessed by one communication port.
6                 Corresponds to a grouping of sensor channels. X is the IIO
7                 index of the device.
8
9 What:           /sys/bus/iio/devices/triggerX
10 KernelVersion:  2.6.35
11 Contact:        linux-iio@vger.kernel.org
12 Description:
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.
17                 periodic timer, GPIO or high resolution timer).
18                 Contains trigger type specific elements. These do not
19                 generalize well and hence are not documented in this file.
20                 X is the IIO index of the trigger.
21
22 What:           /sys/bus/iio/devices/iio:deviceX/buffer
23 KernelVersion:  2.6.35
24 Contact:        linux-iio@vger.kernel.org
25 Description:
26                 Directory of attributes relating to the buffer for the device.
27
28 What:           /sys/bus/iio/devices/iio:deviceX/name
29 KernelVersion:  2.6.35
30 Contact:        linux-iio@vger.kernel.org
31 Description:
32                 Description of the physical chip / device for device X.
33                 Typically a part number.
34
35 What:           /sys/bus/iio/devices/iio:deviceX/sampling_frequency
36 What:           /sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency
37 What:           /sys/bus/iio/devices/triggerX/sampling_frequency
38 KernelVersion:  2.6.35
39 Contact:        linux-iio@vger.kernel.org
40 Description:
41                 Some devices have internal clocks.  This parameter sets the
42                 resulting sampling frequency.  In many devices this
43                 parameter has an effect on input filters etc rather than
44                 simply controlling when the input is sampled.  As this
45                 effects datardy triggers, hardware buffers and the sysfs
46                 direct access interfaces, it may be found in any of the
47                 relevant directories.  If it effects all of the above
48                 then it is to be found in the base device directory.
49
50 What:           /sys/bus/iio/devices/iio:deviceX/sampling_frequency_available
51 What:           /sys/.../iio:deviceX/buffer/sampling_frequency_available
52 What:           /sys/bus/iio/devices/triggerX/sampling_frequency_available
53 KernelVersion:  2.6.35
54 Contact:        linux-iio@vger.kernel.org
55 Description:
56                 When the internal sampling clock can only take a small
57                 discrete set of values, this file lists those available.
58
59 What:           /sys/bus/iio/devices/iio:deviceX/oversampling_ratio
60 KernelVersion:  2.6.38
61 Contact:        linux-iio@vger.kernel.org
62 Description:
63                 Hardware dependent ADC oversampling. Controls the sampling ratio
64                 of the digital filter if available.
65
66 What:           /sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available
67 KernelVersion:  2.6.38
68 Contact:        linux-iio@vger.kernel.org
69 Description:
70                 Hardware dependent values supported by the oversampling filter.
71
72 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
73 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
74 KernelVersion:  2.6.35
75 Contact:        linux-iio@vger.kernel.org
76 Description:
77                 Raw (unscaled no bias removal etc) voltage measurement from
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
81                 unique to allow association with event codes. Units after
82                 application of scale and offset are microvolts.
83
84 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw
85 KernelVersion:  2.6.35
86 Contact:        linux-iio@vger.kernel.org
87 Description:
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
92                 is required is a consistent labeling.  Units after application
93                 of scale and offset are microvolts.
94
95 What:           /sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw
96 KernelVersion:  3.2
97 Contact:        linux-iio@vger.kernel.org
98 Description:
99                 Raw capacitance measurement from channel Y. Units after
100                 application of scale and offset are nanofarads.
101
102 What:           /sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw
103 KernelVersion:  3.2
104 Contact:        linux-iio@vger.kernel.org
105 Description:
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
111                 of scale and offset are nanofarads..
112
113 What:           /sys/bus/iio/devices/iio:deviceX/in_temp_raw
114 What:           /sys/bus/iio/devices/iio:deviceX/in_tempX_raw
115 What:           /sys/bus/iio/devices/iio:deviceX/in_temp_x_raw
116 What:           /sys/bus/iio/devices/iio:deviceX/in_temp_y_raw
117 What:           /sys/bus/iio/devices/iio:deviceX/in_temp_z_raw
118 KernelVersion:  2.6.35
119 Contact:        linux-iio@vger.kernel.org
120 Description:
121                 Raw (unscaled no bias removal etc) temperature measurement.
122                 It an axis is specified it generally means that the temperature
123                 sensor is associated with one part of a compound device (e.g.
124                 a gyroscope axis). Units after application of scale and offset
125                 are milli degrees Celsuis.
126
127 What:           /sys/bus/iio/devices/iio:deviceX/in_tempX_input
128 KernelVersion:  2.6.38
129 Contact:        linux-iio@vger.kernel.org
130 Description:
131                 Scaled temperature measurement in milli degrees Celsius.
132
133 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw
134 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_raw
135 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_raw
136 KernelVersion:  2.6.35
137 Contact:        linux-iio@vger.kernel.org
138 Description:
139                 Acceleration in direction x, y or z (may be arbitrarily assigned
140                 but should match other such assignments on device).
141                 Has all of the equivalent parameters as per voltageY. Units
142                 after application of scale and offset are m/s^2.
143
144 What:           /sys/bus/iio/devices/iio:deviceX/in_gyro_x_raw
145 What:           /sys/bus/iio/devices/iio:deviceX/in_gyro_y_raw
146 What:           /sys/bus/iio/devices/iio:deviceX/in_gyro_z_raw
147 KernelVersion:  2.6.35
148 Contact:        linux-iio@vger.kernel.org
149 Description:
150                 Angular velocity about axis x, y or z (may be arbitrarily
151                 assigned) Data converted by application of offset then scale to
152                 radians per second. Has all the equivalent parameters as
153                 per voltageY. Units after application of scale and offset are
154                 radians per second.
155
156 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
157 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
158 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
159 KernelVersion:  2.6.35
160 Contact:        linux-iio@vger.kernel.org
161 Description:
162                 Inclination raw reading about axis x, y or z (may be
163                 arbitrarily assigned). Data converted by application of offset
164                 and scale to Degrees.
165
166 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
167 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
168 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
169 KernelVersion:  2.6.35
170 Contact:        linux-iio@vger.kernel.org
171 Description:
172                 Magnetic field along axis x, y or z (may be arbitrarily
173                 assigned).  Data converted by application of offset
174                 then scale to Gauss.
175
176 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
177 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
178 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
179 KernelVersion:  2.6.36
180 Contact:        linux-iio@vger.kernel.org
181 Description:
182                 Highest value since some reset condition.  These
183                 attributes allow access to this and are otherwise
184                 the direct equivalent of the <type>Y[_name]_raw attributes.
185
186 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
187 KernelVersion:  2.6.36
188 Contact:        linux-iio@vger.kernel.org
189 Description:
190                 A computed peak value based on the sum squared magnitude of
191                 the underlying value in the specified directions.
192
193 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_offset
194 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
195 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
196 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
197 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
198 What:           /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
199 What:           /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
200 What:           /sys/bus/iio/devices/iio:deviceX/in_temp_offset
201 KernelVersion:  2.6.35
202 Contact:        linux-iio@vger.kernel.org
203 Description:
204                 If known for a device, offset to be added to <type>[Y]_raw prior
205                 to scaling by <type>[Y]_scale in order to obtain value in the
206                 <type> units as specified in <type>[y]_raw documentation.
207                 Not present if the offset is always 0 or unknown. If Y or
208                 axis <x|y|z> is not present, then the offset applies to all
209                 in channels of <type>.
210                 May be writable if a variable offset can be applied on the
211                 device. Note that this is different to calibbias which
212                 is for devices (or drivers) that apply offsets to compensate
213                 for variation between different instances of the part, typically
214                 adjusted by using some hardware supported calibration procedure.
215                 Calibbias is applied internally, offset is applied in userspace
216                 to the _raw output.
217
218 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
219 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
220 What:           /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
221 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
222 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_scale
223 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
224 What:           /sys/bus/iio/devices/iio:deviceX/in_gyro_scale
225 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_scale
226 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
227 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
228 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
229 KernelVersion:  2.6.35
230 Contact:        linux-iio@vger.kernel.org
231 Description:
232                 If known for a device, scale to be applied to <type>Y[_name]_raw
233                 post addition of <type>[Y][_name]_offset in order to obtain the
234                 measured value in <type> units as specified in
235                 <type>[Y][_name]_raw documentation..  If shared across all in
236                 channels then Y and <x|y|z> are not present and the value is
237                 called <type>[Y][_name]_scale. The peak modifier means this
238                 value is applied to <type>Y[_name]_peak_raw values.
239
240 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
241 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
242 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
243 What:           /sys/bus/iio/devices/iio:deviceX/in_gyro_x_calibbias
244 What:           /sys/bus/iio/devices/iio:deviceX/in_gyro_y_calibbias
245 What:           /sys/bus/iio/devices/iio:deviceX/in_gyro_z_calibbias
246 KernelVersion:  2.6.35
247 Contact:        linux-iio@vger.kernel.org
248 Description:
249                 Hardware applied calibration offset. (assumed to fix production
250                 inaccuracies).
251
252 What            /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
253 What            /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
254 What            /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
255 What            /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
256 What            /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
257 What            /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
258 What            /sys/bus/iio/devices/iio:deviceX/in_gyro_x_calibscale
259 What            /sys/bus/iio/devices/iio:deviceX/in_gyro_y_calibscale
260 What            /sys/bus/iio/devices/iio:deviceX/in_gyro_z_calibscale
261 KernelVersion:  2.6.35
262 Contact:        linux-iio@vger.kernel.org
263 Description:
264                 Hardware applied calibration scale factor. (assumed to fix
265                 production inaccuracies).  If shared across all channels,
266                 <type>_calibscale is used.
267
268 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
269 What:           /sys/.../iio:deviceX/in_voltageX_scale_available
270 What:           /sys/.../iio:deviceX/in_voltage-voltage_scale_available
271 What:           /sys/.../iio:deviceX/out_voltageX_scale_available
272 What:           /sys/.../iio:deviceX/in_capacitance_scale_available
273 KernelVersion:  2.635
274 Contact:        linux-iio@vger.kernel.org
275 Description:
276                 If a discrete set of scale values are available, they
277                 are listed in this attribute.
278
279 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
280 KernelVersion:  2.6.37
281 Contact:        linux-iio@vger.kernel.org
282 Description:
283                 Raw (unscaled, no bias etc.) output voltage for
284                 channel Y.  The number must always be specified and
285                 unique if the output corresponds to a single channel.
286
287 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
288 KernelVersion:  2.6.37
289 Contact:        linux-iio@vger.kernel.org
290 Description:
291                 Raw (unscaled, no bias etc.) output voltage for an aggregate of
292                 channel Y, channel Z, etc.  This interface is available in cases
293                 where a single output sets the value for multiple channels
294                 simultaneously.
295
296 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
297 What:           /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
298 KernelVersion:  2.6.38
299 Contact:        linux-iio@vger.kernel.org
300 Description:
301                 Specifies the output powerdown mode.
302                 DAC output stage is disconnected from the amplifier and
303                 1kohm_to_gnd: connected to ground via an 1kOhm resistor
304                 100kohm_to_gnd: connected to ground via an 100kOhm resistor
305                 three_state: left floating
306                 For a list of available output power down options read
307                 outX_powerdown_mode_available. If Y is not present the
308                 mode is shared across all outputs.
309
310 What:           /sys/.../iio:deviceX/out_votlageY_powerdown_mode_available
311 What:           /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
312 KernelVersion:  2.6.38
313 Contact:        linux-iio@vger.kernel.org
314 Description:
315                 Lists all available output power down modes.
316                 If Y is not present the mode is shared across all outputs.
317
318 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
319 What:           /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
320 KernelVersion:  2.6.38
321 Contact:        linux-iio@vger.kernel.org
322 Description:
323                 Writing 1 causes output Y to enter the power down mode specified
324                 by the corresponding outY_powerdown_mode. Clearing returns to
325                 normal operation. Y may be suppressed if all outputs are
326                 controlled together.
327
328 What:           /sys/bus/iio/devices/iio:deviceX/events
329 KernelVersion:  2.6.35
330 Contact:        linux-iio@vger.kernel.org
331 Description:
332                 Configuration of which hardware generated events are passed up
333                 to user-space.
334
335 What:           /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
336 What:           /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
337 What:           /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
338 What:           /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
339 What:           /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
340 What:           /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
341 What:           /sys/.../iio:deviceX/events/in_gyro_x_thresh_rising_en
342 What:           /sys/.../iio:deviceX/events/in_gyro_x_thresh_falling_en
343 What:           /sys/.../iio:deviceX/events/in_gyro_y_thresh_rising_en
344 What:           /sys/.../iio:deviceX/events/in_gyro_y_thresh_falling_en
345 What:           /sys/.../iio:deviceX/events/in_gyro_z_thresh_rising_en
346 What:           /sys/.../iio:deviceX/events/in_gyro_z_thresh_falling_en
347 What:           /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
348 What:           /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
349 What:           /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
350 What:           /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
351 What:           /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
352 What:           /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
353 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
354 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
355 What:           /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
356 What:           /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
357 What:           /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
358 What:           /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
359 KernelVersion:  2.6.37
360 Contact:        linux-iio@vger.kernel.org
361 Description:
362                 Event generated when channel passes a threshold in the specified
363                 (_rising|_falling) direction. If the direction is not specified,
364                 then either the device will report an event which ever direction
365                 a single threshold value is passed in (e.g.
366                 <type>[Y][_name]_<raw|input>_thresh_value) or
367                 <type>[Y][_name]_<raw|input>_thresh_rising_value and
368                 <type>[Y][_name]_<raw|input>_thresh_falling_value may take
369                 different values, but the device can only enable both thresholds
370                 or neither.
371                 Note the driver will assume the last p events requested are
372                 to be enabled where p is however many it supports (which may
373                 vary depending on the exact set requested. So if you want to be
374                 sure you have set what you think you have, check the contents of
375                 these attributes after everything is configured. Drivers may
376                 have to buffer any parameters so that they are consistent when
377                 a given event type is enabled a future point (and not those for
378                 whatever event was previously enabled).
379
380 What:           /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
381 What:           /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
382 What:           /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
383 What:           /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
384 What:           /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
385 What:           /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
386 What:           /sys/.../iio:deviceX/events/in_gyro_x_roc_rising_en
387 What:           /sys/.../iio:deviceX/events/in_gyro_x_roc_falling_en
388 What:           /sys/.../iio:deviceX/events/in_gyro_y_roc_rising_en
389 What:           /sys/.../iio:deviceX/events/in_gyro_y_roc_falling_en
390 What:           /sys/.../iio:deviceX/events/in_gyro_z_roc_rising_en
391 What:           /sys/.../iio:deviceX/events/in_gyro_z_roc_falling_en
392 What:           /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
393 What:           /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
394 What:           /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
395 What:           /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
396 What:           /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
397 What:           /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
398 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
399 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
400 What:           /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
401 What:           /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
402 What:           /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
403 What:           /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
404 KernelVersion:  2.6.37
405 Contact:        linux-iio@vger.kernel.org
406 Description:
407                 Event generated when channel passes a threshold on the rate of
408                 change (1st differential) in the specified (_rising|_falling)
409                 direction. If the direction is not specified, then either the
410                 device will report an event which ever direction a single
411                 threshold value is passed in (e.g.
412                 <type>[Y][_name]_<raw|input>_roc_value) or
413                 <type>[Y][_name]_<raw|input>_roc_rising_value and
414                 <type>[Y][_name]_<raw|input>_roc_falling_value may take
415                 different values, but the device can only enable both rate of
416                 change thresholds or neither.
417                 Note the driver will assume the last p events requested are
418                 to be enabled where p is however many it supports (which may
419                 vary depending on the exact set requested. So if you want to be
420                 sure you have set what you think you have, check the contents of
421                 these attributes after everything is configured. Drivers may
422                 have to buffer any parameters so that they are consistent when
423                 a given event type is enabled a future point (and not those for
424                 whatever event was previously enabled).
425
426 What:           /sys/.../events/in_accel_x_raw_thresh_rising_value
427 What:           /sys/.../events/in_accel_x_raw_thresh_falling_value
428 What:           /sys/.../events/in_accel_y_raw_thresh_rising_value
429 What:           /sys/.../events/in_accel_y_raw_thresh_falling_value
430 What:           /sys/.../events/in_accel_z_raw_thresh_rising_value
431 What:           /sys/.../events/in_accel_z_raw_thresh_falling_value
432 What:           /sys/.../events/in_gyro_x_raw_thresh_rising_value
433 What:           /sys/.../events/in_gyro_x_raw_thresh_falling_value
434 What:           /sys/.../events/in_gyro_y_raw_thresh_rising_value
435 What:           /sys/.../events/in_gyro_y_raw_thresh_falling_value
436 What:           /sys/.../events/in_gyro_z_raw_thresh_rising_value
437 What:           /sys/.../events/in_gyro_z_raw_thresh_falling_value
438 What:           /sys/.../events/in_magn_x_raw_thresh_rising_value
439 What:           /sys/.../events/in_magn_x_raw_thresh_falling_value
440 What:           /sys/.../events/in_magn_y_raw_thresh_rising_value
441 What:           /sys/.../events/in_magn_y_raw_thresh_falling_value
442 What:           /sys/.../events/in_magn_z_raw_thresh_rising_value
443 What:           /sys/.../events/in_magn_z_raw_thresh_falling_value
444 What:           /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
445 What:           /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
446 What:           /sys/.../events/in_voltageY_raw_thresh_falling_value
447 What:           /sys/.../events/in_voltageY_raw_thresh_falling_value
448 What:           /sys/.../events/in_tempY_raw_thresh_falling_value
449 What:           /sys/.../events/in_tempY_raw_thresh_falling_value
450 KernelVersion:  2.6.37
451 Contact:        linux-iio@vger.kernel.org
452 Description:
453                 Specifies the value of threshold that the device is comparing
454                 against for the events enabled by
455                 <type>Y[_name]_thresh[_rising|falling]_en.
456                 If separate attributes exist for the two directions, but
457                 direction is not specified for this attribute, then a single
458                 threshold value applies to both directions.
459                 The raw or input element of the name indicates whether the
460                 value is in raw device units or in processed units (as _raw
461                 and _input do on sysfs direct channel read attributes).
462
463 What:           /sys/.../events/in_accel_x_raw_roc_rising_value
464 What:           /sys/.../events/in_accel_x_raw_roc_falling_value
465 What:           /sys/.../events/in_accel_y_raw_roc_rising_value
466 What:           /sys/.../events/in_accel_y_raw_roc_falling_value
467 What:           /sys/.../events/in_accel_z_raw_roc_rising_value
468 What:           /sys/.../events/in_accel_z_raw_roc_falling_value
469 What:           /sys/.../events/in_gyro_x_raw_roc_rising_value
470 What:           /sys/.../events/in_gyro_x_raw_roc_falling_value
471 What:           /sys/.../events/in_gyro_y_raw_roc_rising_value
472 What:           /sys/.../events/in_gyro_y_raw_roc_falling_value
473 What:           /sys/.../events/in_gyro_z_raw_roc_rising_value
474 What:           /sys/.../events/in_gyro_z_raw_roc_falling_value
475 What:           /sys/.../events/in_magn_x_raw_roc_rising_value
476 What:           /sys/.../events/in_magn_x_raw_roc_falling_value
477 What:           /sys/.../events/in_magn_y_raw_roc_rising_value
478 What:           /sys/.../events/in_magn_y_raw_roc_falling_value
479 What:           /sys/.../events/in_magn_z_raw_roc_rising_value
480 What:           /sys/.../events/in_magn_z_raw_roc_falling_value
481 What:           /sys/.../events/in_voltageY_supply_raw_roc_rising_value
482 What:           /sys/.../events/in_voltageY_supply_raw_roc_falling_value
483 What:           /sys/.../events/in_voltageY_raw_roc_falling_value
484 What:           /sys/.../events/in_voltageY_raw_roc_falling_value
485 What:           /sys/.../events/in_tempY_raw_roc_falling_value
486 What:           /sys/.../events/in_tempY_raw_roc_falling_value
487 KernelVersion:  2.6.37
488 Contact:        linux-iio@vger.kernel.org
489 Description:
490                 Specifies the value of rate of change threshold that the
491                 device is comparing against for the events enabled by
492                 <type>[Y][_name]_roc[_rising|falling]_en.
493                 If separate attributes exist for the two directions,
494                 but direction is not specified for this attribute,
495                 then a single threshold value applies to both directions.
496                 The raw or input element of the name indicates whether the
497                 value is in raw device units or in processed units (as _raw
498                 and _input do on sysfs direct channel read attributes).
499
500 What:           /sys/.../events/in_accel_x_thresh_rising_period
501 What:           /sys/.../events/in_accel_x_thresh_falling_period
502 hat:            /sys/.../events/in_accel_x_roc_rising_period
503 What:           /sys/.../events/in_accel_x_roc_falling_period
504 What:           /sys/.../events/in_accel_y_thresh_rising_period
505 What:           /sys/.../events/in_accel_y_thresh_falling_period
506 What:           /sys/.../events/in_accel_y_roc_rising_period
507 What:           /sys/.../events/in_accel_y_roc_falling_period
508 What:           /sys/.../events/in_accel_z_thresh_rising_period
509 What:           /sys/.../events/in_accel_z_thresh_falling_period
510 What:           /sys/.../events/in_accel_z_roc_rising_period
511 What:           /sys/.../events/in_accel_z_roc_falling_period
512 What:           /sys/.../events/in_gyro_x_thresh_rising_period
513 What:           /sys/.../events/in_gyro_x_thresh_falling_period
514 What:           /sys/.../events/in_gyro_x_roc_rising_period
515 What:           /sys/.../events/in_gyro_x_roc_falling_period
516 What:           /sys/.../events/in_gyro_y_thresh_rising_period
517 What:           /sys/.../events/in_gyro_y_thresh_falling_period
518 What:           /sys/.../events/in_gyro_y_roc_rising_period
519 What:           /sys/.../events/in_gyro_y_roc_falling_period
520 What:           /sys/.../events/in_gyro_z_thresh_rising_period
521 What:           /sys/.../events/in_gyro_z_thresh_falling_period
522 What:           /sys/.../events/in_gyro_z_roc_rising_period
523 What:           /sys/.../events/in_gyro_z_roc_falling_period
524 What:           /sys/.../events/in_magn_x_thresh_rising_period
525 What:           /sys/.../events/in_magn_x_thresh_falling_period
526 What:           /sys/.../events/in_magn_x_roc_rising_period
527 What:           /sys/.../events/in_magn_x_roc_falling_period
528 What:           /sys/.../events/in_magn_y_thresh_rising_period
529 What:           /sys/.../events/in_magn_y_thresh_falling_period
530 What:           /sys/.../events/in_magn_y_roc_rising_period
531 What:           /sys/.../events/in_magn_y_roc_falling_period
532 What:           /sys/.../events/in_magn_z_thresh_rising_period
533 What:           /sys/.../events/in_magn_z_thresh_falling_period
534 What:           /sys/.../events/in_magn_z_roc_rising_period
535 What:           /sys/.../events/in_magn_z_roc_falling_period
536 What:           /sys/.../events/in_voltageY_supply_thresh_rising_period
537 What:           /sys/.../events/in_voltageY_supply_thresh_falling_period
538 What:           /sys/.../events/in_voltageY_supply_roc_rising_period
539 What:           /sys/.../events/in_voltageY_supply_roc_falling_period
540 What:           /sys/.../events/in_voltageY_thresh_rising_period
541 What:           /sys/.../events/in_voltageY_thresh_falling_period
542 What:           /sys/.../events/in_voltageY_roc_rising_period
543 What:           /sys/.../events/in_voltageY_roc_falling_period
544 What:           /sys/.../events/in_tempY_thresh_rising_period
545 What:           /sys/.../events/in_tempY_thresh_falling_period
546 What:           /sys/.../events/in_tempY_roc_rising_period
547 What:           /sys/.../events/in_tempY_roc_falling_period
548 What:           /sys/.../events/in_accel_x&y&z_mag_falling_period
549 KernelVersion:  2.6.37
550 Contact:        linux-iio@vger.kernel.org
551 Description:
552                 Period of time (in seconds) for which the condition must be
553                 met before an event is generated. If direction is not
554                 specified then this period applies to both directions.
555
556 What:           /sys/.../iio:deviceX/events/in_accel_mag_en
557 What:           /sys/.../iio:deviceX/events/in_accel_mag_rising_en
558 What:           /sys/.../iio:deviceX/events/in_accel_mag_falling_en
559 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_en
560 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
561 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
562 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_en
563 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
564 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
565 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_en
566 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
567 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
568 What:           /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
569 What:           /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
570 KernelVersion:  2.6.37
571 Contact:        linux-iio@vger.kernel.org
572 Description:
573                 Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
574                 magnitude of the channel is compared to the threshold, not its
575                 signed value.
576
577 What:           /sys/.../events/in_accel_raw_mag_value
578 What:           /sys/.../events/in_accel_x_raw_mag_rising_value
579 What:           /sys/.../events/in_accel_y_raw_mag_rising_value
580 What:           /sys/.../events/in_accel_z_raw_mag_rising_value
581 KernelVersion:  2.6.37
582 Contact:        linux-iio@vger.kernel.org
583 Description:
584                 The value to which the magnitude of the channel is compared. If
585                 number or direction is not specified, applies to all channels of
586                 this type.
587
588 What:           /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
589 KernelVersion:  2.6.35
590 Contact:        linux-iio@vger.kernel.org
591 Description:
592                 The name of the trigger source being used, as per string given
593                 in /sys/class/iio/triggerY/name.
594
595 What:           /sys/bus/iio/devices/iio:deviceX/buffer/length
596 KernelVersion:  2.6.35
597 Contact:        linux-iio@vger.kernel.org
598 Description:
599                 Number of scans contained by the buffer.
600
601 What:           /sys/bus/iio/devices/iio:deviceX/buffer/bytes_per_datum
602 KernelVersion:  2.6.37
603 Contact:        linux-iio@vger.kernel.org
604 Description:
605                 Bytes per scan.  Due to alignment fun, the scan may be larger
606                 than implied directly by the scan_element parameters.
607
608 What:           /sys/bus/iio/devices/iio:deviceX/buffer/enable
609 KernelVersion:  2.6.35
610 Contact:        linux-iio@vger.kernel.org
611 Description:
612                 Actually start the buffer capture up.  Will start trigger
613                 if first device and appropriate.
614
615 What:           /sys/bus/iio/devices/iio:deviceX/buffer/scan_elements
616 KernelVersion:  2.6.37
617 Contact:        linux-iio@vger.kernel.org
618 Description:
619                 Directory containing interfaces for elements that will be
620                 captured for a single triggered sample set in the buffer.
621
622 What:           /sys/.../buffer/scan_elements/in_accel_x_en
623 What:           /sys/.../buffer/scan_elements/in_accel_y_en
624 What:           /sys/.../buffer/scan_elements/in_accel_z_en
625 What:           /sys/.../buffer/scan_elements/in_gyro_x_en
626 What:           /sys/.../buffer/scan_elements/in_gyro_y_en
627 What:           /sys/.../buffer/scan_elements/in_gyro_z_en
628 What:           /sys/.../buffer/scan_elements/in_magn_x_en
629 What:           /sys/.../buffer/scan_elements/in_magn_y_en
630 What:           /sys/.../buffer/scan_elements/in_magn_z_en
631 What:           /sys/.../buffer/scan_elements/in_timestamp_en
632 What:           /sys/.../buffer/scan_elements/in_voltageY_supply_en
633 What:           /sys/.../buffer/scan_elements/in_voltageY_en
634 What:           /sys/.../buffer/scan_elements/in_voltageY-voltageZ_en
635 What:           /sys/.../buffer/scan_elements/in_incli_x_en
636 What:           /sys/.../buffer/scan_elements/in_incli_y_en
637 KernelVersion:  2.6.37
638 Contact:        linux-iio@vger.kernel.org
639 Description:
640                 Scan element control for triggered data capture.
641
642 What:           /sys/.../buffer/scan_elements/in_accel_type
643 What:           /sys/.../buffer/scan_elements/in_gyro_type
644 What:           /sys/.../buffer/scan_elements/in_magn_type
645 What:           /sys/.../buffer/scan_elements/in_incli_type
646 What:           /sys/.../buffer/scan_elements/in_voltageY_type
647 What:           /sys/.../buffer/scan_elements/in_voltage-in_type
648 What:           /sys/.../buffer/scan_elements/in_voltageY_supply_type
649 What:           /sys/.../buffer/scan_elements/in_timestamp_type
650 KernelVersion:  2.6.37
651 Contact:        linux-iio@vger.kernel.org
652 Description:
653                 Description of the scan element data storage within the buffer
654                 and hence the form in which it is read from user-space.
655                 Form is [be|le]:[s|u]bits/storagebits[>>shift].
656                 be or le specifies big or little endian. s or u specifies if
657                 signed (2's complement) or unsigned. bits is the number of bits
658                 of data and storagebits is the space (after padding) that it
659                 occupies in the buffer. shift if specified, is the shift that
660                 needs to be applied prior to masking out unused bits. Some
661                 devices put their data in the middle of the transferred elements
662                 with additional information on both sides.  Note that some
663                 devices will have additional information in the unused bits
664                 so to get a clean value, the bits value must be used to mask
665                 the buffer output value appropriately.  The storagebits value
666                 also specifies the data alignment.  So s48/64>>2 will be a
667                 signed 48 bit integer stored in a 64 bit location aligned to
668                 a a64 bit boundary. To obtain the clean value, shift right 2
669                 and apply a mask to zero the top 16 bits of the result.
670                 For other storage combinations this attribute will be extended
671                 appropriately.
672
673 What:           /sys/.../buffer/scan_elements/in_accel_type_available
674 KernelVersion:  2.6.37
675 Contact:        linux-iio@vger.kernel.org
676 Description:
677                 If the type parameter can take one of a small set of values,
678                 this attribute lists them.
679
680 What:           /sys/.../buffer/scan_elements/in_voltageY_index
681 What:           /sys/.../buffer/scan_elements/in_voltageY_supply_index
682 What:           /sys/.../buffer/scan_elements/in_accel_x_index
683 What:           /sys/.../buffer/scan_elements/in_accel_y_index
684 What:           /sys/.../buffer/scan_elements/in_accel_z_index
685 What:           /sys/.../buffer/scan_elements/in_gyro_x_index
686 What:           /sys/.../buffer/scan_elements/in_gyro_y_index
687 What:           /sys/.../buffer/scan_elements/in_gyro_z_index
688 What:           /sys/.../buffer/scan_elements/in_magn_x_index
689 What:           /sys/.../buffer/scan_elements/in_magn_y_index
690 What:           /sys/.../buffer/scan_elements/in_magn_z_index
691 What:           /sys/.../buffer/scan_elements/in_incli_x_index
692 What:           /sys/.../buffer/scan_elements/in_incli_y_index
693 What:           /sys/.../buffer/scan_elements/in_timestamp_index
694 KernelVersion:  2.6.37
695 Contact:        linux-iio@vger.kernel.org
696 Description:
697                 A single positive integer specifying the position of this
698                 scan element in the buffer. Note these are not dependent on
699                 what is enabled and may not be contiguous. Thus for user-space
700                 to establish the full layout these must be used in conjunction
701                 with all _en attributes to establish which channels are present,
702                 and the relevant _type attributes to establish the data storage
703                 format.
704
705 What:           /sys/.../iio:deviceX/in_gyro_z_quadrature_correction_raw
706 KernelVersion:  2.6.38
707 Contact:        linux-iio@vger.kernel.org
708 Description:
709                 This attribute is used to read the amount of quadrature error
710                 present in the device at a given time.
711
712 What:           /sys/.../iio:deviceX/ac_excitation_en
713 KernelVersion:  3.1.0
714 Contact:        linux-iio@vger.kernel.org
715 Description:
716                 This attribute, if available, is used to enable the AC
717                 excitation mode found on some converters. In ac excitation mode,
718                 the polarity of the excitation voltage is reversed on
719                 alternate cycles, to eliminate DC errors.
720
721 What:           /sys/.../iio:deviceX/bridge_switch_en
722 KernelVersion:  3.1.0
723 Contact:        linux-iio@vger.kernel.org
724 Description:
725                 This attribute, if available, is used to close or open the
726                 bridge power down switch found on some converters.
727                 In bridge applications, such as strain gauges and load cells,
728                 the bridge itself consumes the majority of the current in the
729                 system. To minimize the current consumption of the system,
730                 the bridge can be disconnected (when it is not being used
731                 using the bridge_switch_en attribute.