Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/nab/target...
[firefly-linux-kernel-4.4.55.git] / Documentation / ABI / testing / 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 data ready 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                 If 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 Celsius.
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_anglvel_x_raw
145 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw
146 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_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). Has all the equivalent parameters as per voltageY.
152                 Units after application of scale and offset are radians per
153                 second.
154
155 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
156 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
157 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
158 KernelVersion:  2.6.35
159 Contact:        linux-iio@vger.kernel.org
160 Description:
161                 Inclination raw reading about axis x, y or z (may be
162                 arbitrarily assigned). Data converted by application of offset
163                 and scale to degrees.
164
165 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
166 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
167 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
168 KernelVersion:  2.6.35
169 Contact:        linux-iio@vger.kernel.org
170 Description:
171                 Magnetic field along axis x, y or z (may be arbitrarily
172                 assigned).  Data converted by application of offset
173                 then scale to Gauss.
174
175 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
176 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
177 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
178 KernelVersion:  2.6.36
179 Contact:        linux-iio@vger.kernel.org
180 Description:
181                 Highest value since some reset condition.  These
182                 attributes allow access to this and are otherwise
183                 the direct equivalent of the <type>Y[_name]_raw attributes.
184
185 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
186 KernelVersion:  2.6.36
187 Contact:        linux-iio@vger.kernel.org
188 Description:
189                 A computed peak value based on the sum squared magnitude of
190                 the underlying value in the specified directions.
191
192 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_offset
193 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
194 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
195 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
196 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
197 What:           /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
198 What:           /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
199 What:           /sys/bus/iio/devices/iio:deviceX/in_temp_offset
200 KernelVersion:  2.6.35
201 Contact:        linux-iio@vger.kernel.org
202 Description:
203                 If known for a device, offset to be added to <type>[Y]_raw prior
204                 to scaling by <type>[Y]_scale in order to obtain value in the
205                 <type> units as specified in <type>[Y]_raw documentation.
206                 Not present if the offset is always 0 or unknown. If Y or
207                 axis <x|y|z> is not present, then the offset applies to all
208                 in channels of <type>.
209                 May be writable if a variable offset can be applied on the
210                 device. Note that this is different to calibbias which
211                 is for devices (or drivers) that apply offsets to compensate
212                 for variation between different instances of the part, typically
213                 adjusted by using some hardware supported calibration procedure.
214                 Calibbias is applied internally, offset is applied in userspace
215                 to the _raw output.
216
217 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
218 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
219 What:           /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
220 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
221 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_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_anglvel_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_anglvel_x_calibbias
244 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
245 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
246 What:           /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
247 What:           /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
248 KernelVersion:  2.6.35
249 Contact:        linux-iio@vger.kernel.org
250 Description:
251                 Hardware applied calibration offset (assumed to fix production
252                 inaccuracies).
253
254 What            /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
255 What            /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
256 What            /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
257 What            /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
258 What            /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
259 What            /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
260 What            /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
261 What            /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
262 What            /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
263 what            /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
264 what            /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
265 KernelVersion:  2.6.35
266 Contact:        linux-iio@vger.kernel.org
267 Description:
268                 Hardware applied calibration scale factor (assumed to fix
269                 production inaccuracies).  If shared across all channels,
270                 <type>_calibscale is used.
271
272 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
273 What:           /sys/.../iio:deviceX/in_voltageX_scale_available
274 What:           /sys/.../iio:deviceX/in_voltage-voltage_scale_available
275 What:           /sys/.../iio:deviceX/out_voltageX_scale_available
276 What:           /sys/.../iio:deviceX/out_altvoltageX_scale_available
277 What:           /sys/.../iio:deviceX/in_capacitance_scale_available
278 KernelVersion:  2.6.35
279 Contact:        linux-iio@vger.kernel.org
280 Description:
281                 If a discrete set of scale values is available, they
282                 are listed in this attribute.
283
284 What            /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
285 KernelVersion:  2.6.35
286 Contact:        linux-iio@vger.kernel.org
287 Description:
288                 Hardware applied gain factor. If shared across all channels,
289                 <type>_hardwaregain is used.
290
291 What:           /sys/.../in_accel_filter_low_pass_3db_frequency
292 What:           /sys/.../in_magn_filter_low_pass_3db_frequency
293 What:           /sys/.../in_anglvel_filter_low_pass_3db_frequency
294 KernelVersion:  3.2
295 Contact:        linux-iio@vger.kernel.org
296 Description:
297                 If a known or controllable low pass filter is applied
298                 to the underlying data channel, then this parameter
299                 gives the 3dB frequency of the filter in Hz.
300
301 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
302 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw
303 KernelVersion:  2.6.37
304 Contact:        linux-iio@vger.kernel.org
305 Description:
306                 Raw (unscaled, no bias etc.) output voltage for
307                 channel Y.  The number must always be specified and
308                 unique if the output corresponds to a single channel.
309                 While DAC like devices typically use out_voltage,
310                 a continuous frequency generating device, such as
311                 a DDS or PLL should use out_altvoltage.
312
313 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
314 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw
315 KernelVersion:  2.6.37
316 Contact:        linux-iio@vger.kernel.org
317 Description:
318                 Raw (unscaled, no bias etc.) output voltage for an aggregate of
319                 channel Y, channel Z, etc.  This interface is available in cases
320                 where a single output sets the value for multiple channels
321                 simultaneously.
322
323 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
324 What:           /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
325 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode
326 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode
327 KernelVersion:  2.6.38
328 Contact:        linux-iio@vger.kernel.org
329 Description:
330                 Specifies the output powerdown mode.
331                 DAC output stage is disconnected from the amplifier and
332                 1kohm_to_gnd: connected to ground via an 1kOhm resistor,
333                 6kohm_to_gnd: connected to ground via a 6kOhm resistor,
334                 20kohm_to_gnd: connected to ground via a 20kOhm resistor,
335                 100kohm_to_gnd: connected to ground via an 100kOhm resistor,
336                 three_state: left floating.
337                 For a list of available output power down options read
338                 outX_powerdown_mode_available. If Y is not present the
339                 mode is shared across all outputs.
340
341 What:           /sys/.../iio:deviceX/out_votlageY_powerdown_mode_available
342 What:           /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
343 What:           /sys/.../iio:deviceX/out_altvotlageY_powerdown_mode_available
344 What:           /sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available
345 KernelVersion:  2.6.38
346 Contact:        linux-iio@vger.kernel.org
347 Description:
348                 Lists all available output power down modes.
349                 If Y is not present the mode is shared across all outputs.
350
351 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
352 What:           /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
353 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
354 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown
355 KernelVersion:  2.6.38
356 Contact:        linux-iio@vger.kernel.org
357 Description:
358                 Writing 1 causes output Y to enter the power down mode specified
359                 by the corresponding outY_powerdown_mode. DAC output stage is
360                 disconnected from the amplifier. Clearing returns to normal
361                 operation. Y may be suppressed if all outputs are controlled
362                 together.
363
364 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency
365 KernelVersion:  3.4.0
366 Contact:        linux-iio@vger.kernel.org
367 Description:
368                 Output frequency for channel Y in Hz. The number must always be
369                 specified and unique if the output corresponds to a single
370                 channel.
371
372 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase
373 KernelVersion:  3.4.0
374 Contact:        linux-iio@vger.kernel.org
375 Description:
376                 Phase in radians of one frequency/clock output Y
377                 (out_altvoltageY) relative to another frequency/clock output
378                 (out_altvoltageZ) of the device X. The number must always be
379                 specified and unique if the output corresponds to a single
380                 channel.
381
382 What:           /sys/bus/iio/devices/iio:deviceX/events
383 KernelVersion:  2.6.35
384 Contact:        linux-iio@vger.kernel.org
385 Description:
386                 Configuration of which hardware generated events are passed up
387                 to user-space.
388
389 What:           /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
390 What:           /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
391 What:           /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
392 What:           /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
393 What:           /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
394 What:           /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
395 What:           /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
396 What:           /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
397 What:           /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
398 What:           /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
399 What:           /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
400 What:           /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
401 What:           /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
402 What:           /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
403 What:           /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
404 What:           /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
405 What:           /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
406 What:           /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
407 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
408 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
409 What:           /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
410 What:           /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
411 What:           /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
412 What:           /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
413 KernelVersion:  2.6.37
414 Contact:        linux-iio@vger.kernel.org
415 Description:
416                 Event generated when channel passes a threshold in the specified
417                 (_rising|_falling) direction. If the direction is not specified,
418                 then either the device will report an event which ever direction
419                 a single threshold value is passed in (e.g.
420                 <type>[Y][_name]_<raw|input>_thresh_value) or
421                 <type>[Y][_name]_<raw|input>_thresh_rising_value and
422                 <type>[Y][_name]_<raw|input>_thresh_falling_value may take
423                 different values, but the device can only enable both thresholds
424                 or neither.
425                 Note the driver will assume the last p events requested are
426                 to be enabled where p is how many it supports (which may vary
427                 depending on the exact set requested. So if you want to be
428                 sure you have set what you think you have, check the contents of
429                 these attributes after everything is configured. Drivers may
430                 have to buffer any parameters so that they are consistent when
431                 a given event type is enabled at a future point (and not those for
432                 whatever event was previously enabled).
433
434 What:           /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
435 What:           /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
436 What:           /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
437 What:           /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
438 What:           /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
439 What:           /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
440 What:           /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
441 What:           /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
442 What:           /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
443 What:           /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
444 What:           /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
445 What:           /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
446 What:           /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
447 What:           /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
448 What:           /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
449 What:           /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
450 What:           /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
451 What:           /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
452 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
453 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
454 What:           /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
455 What:           /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
456 What:           /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
457 What:           /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
458 KernelVersion:  2.6.37
459 Contact:        linux-iio@vger.kernel.org
460 Description:
461                 Event generated when channel passes a threshold on the rate of
462                 change (1st differential) in the specified (_rising|_falling)
463                 direction. If the direction is not specified, then either the
464                 device will report an event which ever direction a single
465                 threshold value is passed in (e.g.
466                 <type>[Y][_name]_<raw|input>_roc_value) or
467                 <type>[Y][_name]_<raw|input>_roc_rising_value and
468                 <type>[Y][_name]_<raw|input>_roc_falling_value may take
469                 different values, but the device can only enable both rate of
470                 change thresholds or neither.
471                 Note the driver will assume the last p events requested are
472                 to be enabled where p is however many it supports (which may
473                 vary depending on the exact set requested. So if you want to be
474                 sure you have set what you think you have, check the contents of
475                 these attributes after everything is configured. Drivers may
476                 have to buffer any parameters so that they are consistent when
477                 a given event type is enabled a future point (and not those for
478                 whatever event was previously enabled).
479
480 What:           /sys/.../events/in_accel_x_raw_thresh_rising_value
481 What:           /sys/.../events/in_accel_x_raw_thresh_falling_value
482 What:           /sys/.../events/in_accel_y_raw_thresh_rising_value
483 What:           /sys/.../events/in_accel_y_raw_thresh_falling_value
484 What:           /sys/.../events/in_accel_z_raw_thresh_rising_value
485 What:           /sys/.../events/in_accel_z_raw_thresh_falling_value
486 What:           /sys/.../events/in_anglvel_x_raw_thresh_rising_value
487 What:           /sys/.../events/in_anglvel_x_raw_thresh_falling_value
488 What:           /sys/.../events/in_anglvel_y_raw_thresh_rising_value
489 What:           /sys/.../events/in_anglvel_y_raw_thresh_falling_value
490 What:           /sys/.../events/in_anglvel_z_raw_thresh_rising_value
491 What:           /sys/.../events/in_anglvel_z_raw_thresh_falling_value
492 What:           /sys/.../events/in_magn_x_raw_thresh_rising_value
493 What:           /sys/.../events/in_magn_x_raw_thresh_falling_value
494 What:           /sys/.../events/in_magn_y_raw_thresh_rising_value
495 What:           /sys/.../events/in_magn_y_raw_thresh_falling_value
496 What:           /sys/.../events/in_magn_z_raw_thresh_rising_value
497 What:           /sys/.../events/in_magn_z_raw_thresh_falling_value
498 What:           /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
499 What:           /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
500 What:           /sys/.../events/in_voltageY_raw_thresh_rising_value
501 What:           /sys/.../events/in_voltageY_raw_thresh_falling_value
502 What:           /sys/.../events/in_tempY_raw_thresh_rising_value
503 What:           /sys/.../events/in_tempY_raw_thresh_falling_value
504 What:           /sys/.../events/in_illuminance0_thresh_falling_value
505 what:           /sys/.../events/in_illuminance0_thresh_rising_value
506 what:           /sys/.../events/in_proximity0_thresh_falling_value
507 what:           /sys/.../events/in_proximity0_thresh_rising_value
508 KernelVersion:  2.6.37
509 Contact:        linux-iio@vger.kernel.org
510 Description:
511                 Specifies the value of threshold that the device is comparing
512                 against for the events enabled by
513                 <type>Y[_name]_thresh[_rising|falling]_en.
514                 If separate attributes exist for the two directions, but
515                 direction is not specified for this attribute, then a single
516                 threshold value applies to both directions.
517                 The raw or input element of the name indicates whether the
518                 value is in raw device units or in processed units (as _raw
519                 and _input do on sysfs direct channel read attributes).
520
521 What:           /sys/.../events/in_accel_x_raw_roc_rising_value
522 What:           /sys/.../events/in_accel_x_raw_roc_falling_value
523 What:           /sys/.../events/in_accel_y_raw_roc_rising_value
524 What:           /sys/.../events/in_accel_y_raw_roc_falling_value
525 What:           /sys/.../events/in_accel_z_raw_roc_rising_value
526 What:           /sys/.../events/in_accel_z_raw_roc_falling_value
527 What:           /sys/.../events/in_anglvel_x_raw_roc_rising_value
528 What:           /sys/.../events/in_anglvel_x_raw_roc_falling_value
529 What:           /sys/.../events/in_anglvel_y_raw_roc_rising_value
530 What:           /sys/.../events/in_anglvel_y_raw_roc_falling_value
531 What:           /sys/.../events/in_anglvel_z_raw_roc_rising_value
532 What:           /sys/.../events/in_anglvel_z_raw_roc_falling_value
533 What:           /sys/.../events/in_magn_x_raw_roc_rising_value
534 What:           /sys/.../events/in_magn_x_raw_roc_falling_value
535 What:           /sys/.../events/in_magn_y_raw_roc_rising_value
536 What:           /sys/.../events/in_magn_y_raw_roc_falling_value
537 What:           /sys/.../events/in_magn_z_raw_roc_rising_value
538 What:           /sys/.../events/in_magn_z_raw_roc_falling_value
539 What:           /sys/.../events/in_voltageY_supply_raw_roc_rising_value
540 What:           /sys/.../events/in_voltageY_supply_raw_roc_falling_value
541 What:           /sys/.../events/in_voltageY_raw_roc_rising_value
542 What:           /sys/.../events/in_voltageY_raw_roc_falling_value
543 What:           /sys/.../events/in_tempY_raw_roc_rising_value
544 What:           /sys/.../events/in_tempY_raw_roc_falling_value
545 KernelVersion:  2.6.37
546 Contact:        linux-iio@vger.kernel.org
547 Description:
548                 Specifies the value of rate of change threshold that the
549                 device is comparing against for the events enabled by
550                 <type>[Y][_name]_roc[_rising|falling]_en.
551                 If separate attributes exist for the two directions,
552                 but direction is not specified for this attribute,
553                 then a single threshold value applies to both directions.
554                 The raw or input element of the name indicates whether the
555                 value is in raw device units or in processed units (as _raw
556                 and _input do on sysfs direct channel read attributes).
557
558 What:           /sys/.../events/in_accel_x_thresh_rising_period
559 What:           /sys/.../events/in_accel_x_thresh_falling_period
560 hat:            /sys/.../events/in_accel_x_roc_rising_period
561 What:           /sys/.../events/in_accel_x_roc_falling_period
562 What:           /sys/.../events/in_accel_y_thresh_rising_period
563 What:           /sys/.../events/in_accel_y_thresh_falling_period
564 What:           /sys/.../events/in_accel_y_roc_rising_period
565 What:           /sys/.../events/in_accel_y_roc_falling_period
566 What:           /sys/.../events/in_accel_z_thresh_rising_period
567 What:           /sys/.../events/in_accel_z_thresh_falling_period
568 What:           /sys/.../events/in_accel_z_roc_rising_period
569 What:           /sys/.../events/in_accel_z_roc_falling_period
570 What:           /sys/.../events/in_anglvel_x_thresh_rising_period
571 What:           /sys/.../events/in_anglvel_x_thresh_falling_period
572 What:           /sys/.../events/in_anglvel_x_roc_rising_period
573 What:           /sys/.../events/in_anglvel_x_roc_falling_period
574 What:           /sys/.../events/in_anglvel_y_thresh_rising_period
575 What:           /sys/.../events/in_anglvel_y_thresh_falling_period
576 What:           /sys/.../events/in_anglvel_y_roc_rising_period
577 What:           /sys/.../events/in_anglvel_y_roc_falling_period
578 What:           /sys/.../events/in_anglvel_z_thresh_rising_period
579 What:           /sys/.../events/in_anglvel_z_thresh_falling_period
580 What:           /sys/.../events/in_anglvel_z_roc_rising_period
581 What:           /sys/.../events/in_anglvel_z_roc_falling_period
582 What:           /sys/.../events/in_magn_x_thresh_rising_period
583 What:           /sys/.../events/in_magn_x_thresh_falling_period
584 What:           /sys/.../events/in_magn_x_roc_rising_period
585 What:           /sys/.../events/in_magn_x_roc_falling_period
586 What:           /sys/.../events/in_magn_y_thresh_rising_period
587 What:           /sys/.../events/in_magn_y_thresh_falling_period
588 What:           /sys/.../events/in_magn_y_roc_rising_period
589 What:           /sys/.../events/in_magn_y_roc_falling_period
590 What:           /sys/.../events/in_magn_z_thresh_rising_period
591 What:           /sys/.../events/in_magn_z_thresh_falling_period
592 What:           /sys/.../events/in_magn_z_roc_rising_period
593 What:           /sys/.../events/in_magn_z_roc_falling_period
594 What:           /sys/.../events/in_voltageY_supply_thresh_rising_period
595 What:           /sys/.../events/in_voltageY_supply_thresh_falling_period
596 What:           /sys/.../events/in_voltageY_supply_roc_rising_period
597 What:           /sys/.../events/in_voltageY_supply_roc_falling_period
598 What:           /sys/.../events/in_voltageY_thresh_rising_period
599 What:           /sys/.../events/in_voltageY_thresh_falling_period
600 What:           /sys/.../events/in_voltageY_roc_rising_period
601 What:           /sys/.../events/in_voltageY_roc_falling_period
602 What:           /sys/.../events/in_tempY_thresh_rising_period
603 What:           /sys/.../events/in_tempY_thresh_falling_period
604 What:           /sys/.../events/in_tempY_roc_rising_period
605 What:           /sys/.../events/in_tempY_roc_falling_period
606 What:           /sys/.../events/in_accel_x&y&z_mag_falling_period
607 What:           /sys/.../events/in_intensity0_thresh_period
608 What:           /sys/.../events/in_proximity0_thresh_period
609 KernelVersion:  2.6.37
610 Contact:        linux-iio@vger.kernel.org
611 Description:
612                 Period of time (in seconds) for which the condition must be
613                 met before an event is generated. If direction is not
614                 specified then this period applies to both directions.
615
616 What:           /sys/.../iio:deviceX/events/in_accel_mag_en
617 What:           /sys/.../iio:deviceX/events/in_accel_mag_rising_en
618 What:           /sys/.../iio:deviceX/events/in_accel_mag_falling_en
619 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_en
620 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
621 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
622 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_en
623 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
624 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
625 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_en
626 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
627 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
628 What:           /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
629 What:           /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
630 KernelVersion:  2.6.37
631 Contact:        linux-iio@vger.kernel.org
632 Description:
633                 Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
634                 magnitude of the channel is compared to the threshold, not its
635                 signed value.
636
637 What:           /sys/.../events/in_accel_raw_mag_value
638 What:           /sys/.../events/in_accel_x_raw_mag_rising_value
639 What:           /sys/.../events/in_accel_y_raw_mag_rising_value
640 What:           /sys/.../events/in_accel_z_raw_mag_rising_value
641 KernelVersion:  2.6.37
642 Contact:        linux-iio@vger.kernel.org
643 Description:
644                 The value to which the magnitude of the channel is compared. If
645                 number or direction is not specified, applies to all channels of
646                 this type.
647
648 What:           /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
649 KernelVersion:  2.6.35
650 Contact:        linux-iio@vger.kernel.org
651 Description:
652                 The name of the trigger source being used, as per string given
653                 in /sys/class/iio/triggerY/name.
654
655 What:           /sys/bus/iio/devices/iio:deviceX/buffer/length
656 KernelVersion:  2.6.35
657 Contact:        linux-iio@vger.kernel.org
658 Description:
659                 Number of scans contained by the buffer.
660
661 What:           /sys/bus/iio/devices/iio:deviceX/buffer/bytes_per_datum
662 KernelVersion:  2.6.37
663 Contact:        linux-iio@vger.kernel.org
664 Description:
665                 Bytes per scan.  Due to alignment fun, the scan may be larger
666                 than implied directly by the scan_element parameters.
667
668 What:           /sys/bus/iio/devices/iio:deviceX/buffer/enable
669 KernelVersion:  2.6.35
670 Contact:        linux-iio@vger.kernel.org
671 Description:
672                 Actually start the buffer capture up.  Will start trigger
673                 if first device and appropriate.
674
675 What:           /sys/bus/iio/devices/iio:deviceX/buffer/scan_elements
676 KernelVersion:  2.6.37
677 Contact:        linux-iio@vger.kernel.org
678 Description:
679                 Directory containing interfaces for elements that will be
680                 captured for a single triggered sample set in the buffer.
681
682 What:           /sys/.../buffer/scan_elements/in_accel_x_en
683 What:           /sys/.../buffer/scan_elements/in_accel_y_en
684 What:           /sys/.../buffer/scan_elements/in_accel_z_en
685 What:           /sys/.../buffer/scan_elements/in_anglvel_x_en
686 What:           /sys/.../buffer/scan_elements/in_anglvel_y_en
687 What:           /sys/.../buffer/scan_elements/in_anglvel_z_en
688 What:           /sys/.../buffer/scan_elements/in_magn_x_en
689 What:           /sys/.../buffer/scan_elements/in_magn_y_en
690 What:           /sys/.../buffer/scan_elements/in_magn_z_en
691 What:           /sys/.../buffer/scan_elements/in_timestamp_en
692 What:           /sys/.../buffer/scan_elements/in_voltageY_supply_en
693 What:           /sys/.../buffer/scan_elements/in_voltageY_en
694 What:           /sys/.../buffer/scan_elements/in_voltageY-voltageZ_en
695 What:           /sys/.../buffer/scan_elements/in_incli_x_en
696 What:           /sys/.../buffer/scan_elements/in_incli_y_en
697 KernelVersion:  2.6.37
698 Contact:        linux-iio@vger.kernel.org
699 Description:
700                 Scan element control for triggered data capture.
701
702 What:           /sys/.../buffer/scan_elements/in_accel_type
703 What:           /sys/.../buffer/scan_elements/in_anglvel_type
704 What:           /sys/.../buffer/scan_elements/in_magn_type
705 What:           /sys/.../buffer/scan_elements/in_incli_type
706 What:           /sys/.../buffer/scan_elements/in_voltageY_type
707 What:           /sys/.../buffer/scan_elements/in_voltage_type
708 What:           /sys/.../buffer/scan_elements/in_voltageY_supply_type
709 What:           /sys/.../buffer/scan_elements/in_timestamp_type
710 KernelVersion:  2.6.37
711 Contact:        linux-iio@vger.kernel.org
712 Description:
713                 Description of the scan element data storage within the buffer
714                 and hence the form in which it is read from user-space.
715                 Form is [be|le]:[s|u]bits/storagebits[>>shift].
716                 be or le specifies big or little endian. s or u specifies if
717                 signed (2's complement) or unsigned. bits is the number of bits
718                 of data and storagebits is the space (after padding) that it
719                 occupies in the buffer. shift if specified, is the shift that
720                 needs to be applied prior to masking out unused bits. Some
721                 devices put their data in the middle of the transferred elements
722                 with additional information on both sides.  Note that some
723                 devices will have additional information in the unused bits
724                 so to get a clean value, the bits value must be used to mask
725                 the buffer output value appropriately.  The storagebits value
726                 also specifies the data alignment.  So s48/64>>2 will be a
727                 signed 48 bit integer stored in a 64 bit location aligned to
728                 a 64 bit boundary. To obtain the clean value, shift right 2
729                 and apply a mask to zero the top 16 bits of the result.
730                 For other storage combinations this attribute will be extended
731                 appropriately.
732
733 What:           /sys/.../buffer/scan_elements/in_accel_type_available
734 KernelVersion:  2.6.37
735 Contact:        linux-iio@vger.kernel.org
736 Description:
737                 If the type parameter can take one of a small set of values,
738                 this attribute lists them.
739
740 What:           /sys/.../buffer/scan_elements/in_voltageY_index
741 What:           /sys/.../buffer/scan_elements/in_voltageY_supply_index
742 What:           /sys/.../buffer/scan_elements/in_accel_x_index
743 What:           /sys/.../buffer/scan_elements/in_accel_y_index
744 What:           /sys/.../buffer/scan_elements/in_accel_z_index
745 What:           /sys/.../buffer/scan_elements/in_anglvel_x_index
746 What:           /sys/.../buffer/scan_elements/in_anglvel_y_index
747 What:           /sys/.../buffer/scan_elements/in_anglvel_z_index
748 What:           /sys/.../buffer/scan_elements/in_magn_x_index
749 What:           /sys/.../buffer/scan_elements/in_magn_y_index
750 What:           /sys/.../buffer/scan_elements/in_magn_z_index
751 What:           /sys/.../buffer/scan_elements/in_incli_x_index
752 What:           /sys/.../buffer/scan_elements/in_incli_y_index
753 What:           /sys/.../buffer/scan_elements/in_timestamp_index
754 KernelVersion:  2.6.37
755 Contact:        linux-iio@vger.kernel.org
756 Description:
757                 A single positive integer specifying the position of this
758                 scan element in the buffer. Note these are not dependent on
759                 what is enabled and may not be contiguous. Thus for user-space
760                 to establish the full layout these must be used in conjunction
761                 with all _en attributes to establish which channels are present,
762                 and the relevant _type attributes to establish the data storage
763                 format.
764
765 What:           /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
766 KernelVersion:  2.6.38
767 Contact:        linux-iio@vger.kernel.org
768 Description:
769                 This attribute is used to read the amount of quadrature error
770                 present in the device at a given time.