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