1 What: /sys/bus/iio/devices/iio:deviceX
3 Contact: linux-iio@vger.kernel.org
5 Hardware chip or device accessed by one communication port.
6 Corresponds to a grouping of sensor channels. X is the IIO
9 What: /sys/bus/iio/devices/triggerX
11 Contact: linux-iio@vger.kernel.org
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.
22 What: /sys/bus/iio/devices/iio:deviceX/buffer
24 Contact: linux-iio@vger.kernel.org
26 Directory of attributes relating to the buffer for the device.
28 What: /sys/bus/iio/devices/iio:deviceX/name
30 Contact: linux-iio@vger.kernel.org
32 Description of the physical chip / device for device X.
33 Typically a part number.
35 What: /sys/bus/iio/devices/iio:deviceX/current_timestamp_clock
37 Contact: linux-iio@vger.kernel.org
39 String identifying current posix clock used to timestamp
40 buffered samples and events for device X.
42 What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency
43 What: /sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency
44 What: /sys/bus/iio/devices/triggerX/sampling_frequency
46 Contact: linux-iio@vger.kernel.org
48 Some devices have internal clocks. This parameter sets the
49 resulting sampling frequency. In many devices this
50 parameter has an effect on input filters etc. rather than
51 simply controlling when the input is sampled. As this
52 effects data ready triggers, hardware buffers and the sysfs
53 direct access interfaces, it may be found in any of the
54 relevant directories. If it effects all of the above
55 then it is to be found in the base device directory.
57 What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency_available
58 What: /sys/bus/iio/devices/iio:deviceX/in_proximity_sampling_frequency_available
59 What: /sys/.../iio:deviceX/buffer/sampling_frequency_available
60 What: /sys/bus/iio/devices/triggerX/sampling_frequency_available
62 Contact: linux-iio@vger.kernel.org
64 When the internal sampling clock can only take a small
65 discrete set of values, this file lists those available.
67 What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio
69 Contact: linux-iio@vger.kernel.org
71 Hardware dependent ADC oversampling. Controls the sampling ratio
72 of the digital filter if available.
74 What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available
76 Contact: linux-iio@vger.kernel.org
78 Hardware dependent values supported by the oversampling filter.
80 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
81 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
82 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_raw
83 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_raw
85 Contact: linux-iio@vger.kernel.org
87 Raw (unscaled no bias removal etc.) voltage measurement from
88 channel Y. In special cases where the channel does not
89 correspond to externally available input one of the named
90 versions may be used. The number must always be specified and
91 unique to allow association with event codes. Units after
92 application of scale and offset are millivolts.
94 Channels with 'i' and 'q' modifiers always exist in pairs and both
95 channels refer to the same signal. The 'i' channel contains the in-phase
96 component of the signal while the 'q' channel contains the quadrature
99 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw
100 KernelVersion: 2.6.35
101 Contact: linux-iio@vger.kernel.org
103 Raw (unscaled) differential voltage measurement equivalent to
104 channel Y - channel Z where these channel numbers apply to the
105 physically equivalent inputs when non differential readings are
106 separately available. In differential only parts, then all that
107 is required is a consistent labeling. Units after application
108 of scale and offset are millivolts.
110 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_raw
111 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_raw
113 Contact: linux-iio@vger.kernel.org
115 Raw (unscaled no bias removal etc.) current measurement from
116 channel Y. In special cases where the channel does not
117 correspond to externally available input one of the named
118 versions may be used. The number must always be specified and
119 unique to allow association with event codes. Units after
120 application of scale and offset are milliamps.
122 What: /sys/bus/iio/devices/iio:deviceX/in_powerY_raw
124 Contact: linux-iio@vger.kernel.org
126 Raw (unscaled no bias removal etc.) power measurement from
127 channel Y. The number must always be specified and
128 unique to allow association with event codes. Units after
129 application of scale and offset are milliwatts.
131 What: /sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw
133 Contact: linux-iio@vger.kernel.org
135 Raw capacitance measurement from channel Y. Units after
136 application of scale and offset are nanofarads.
138 What: /sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw
140 Contact: linux-iio@vger.kernel.org
142 Raw differential capacitance measurement equivalent to
143 channel Y - channel Z where these channel numbers apply to the
144 physically equivalent inputs when non differential readings are
145 separately available. In differential only parts, then all that
146 is required is a consistent labeling. Units after application
147 of scale and offset are nanofarads.
149 What: /sys/bus/iio/devices/iio:deviceX/in_temp_raw
150 What: /sys/bus/iio/devices/iio:deviceX/in_tempX_raw
151 What: /sys/bus/iio/devices/iio:deviceX/in_temp_x_raw
152 What: /sys/bus/iio/devices/iio:deviceX/in_temp_y_raw
153 What: /sys/bus/iio/devices/iio:deviceX/in_temp_ambient_raw
154 What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_raw
155 KernelVersion: 2.6.35
156 Contact: linux-iio@vger.kernel.org
158 Raw (unscaled no bias removal etc.) temperature measurement.
159 If an axis is specified it generally means that the temperature
160 sensor is associated with one part of a compound device (e.g.
161 a gyroscope axis). The ambient and object modifiers distinguish
162 between ambient (reference) and distant temperature for contact-
163 less measurements. Units after application of scale and offset
164 are milli degrees Celsius.
166 What: /sys/bus/iio/devices/iio:deviceX/in_tempX_input
167 KernelVersion: 2.6.38
168 Contact: linux-iio@vger.kernel.org
170 Scaled temperature measurement in milli degrees Celsius.
172 What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw
173 What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_raw
174 What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_raw
175 KernelVersion: 2.6.35
176 Contact: linux-iio@vger.kernel.org
178 Acceleration in direction x, y or z (may be arbitrarily assigned
179 but should match other such assignments on device).
180 Has all of the equivalent parameters as per voltageY. Units
181 after application of scale and offset are m/s^2.
183 What: /sys/bus/iio/devices/iio:deviceX/in_gravity_x_raw
184 What: /sys/bus/iio/devices/iio:deviceX/in_gravity_y_raw
185 What: /sys/bus/iio/devices/iio:deviceX/in_gravity_z_raw
187 Contact: linux-iio@vger.kernel.org
189 Gravity in direction x, y or z (may be arbitrarily assigned
190 but should match other such assignments on device).
191 Units after application of scale and offset are m/s^2.
193 What: /sys/bus/iio/devices/iio:deviceX/in_angl_raw
195 Contact: linux-iio@vger.kernel.org
197 Angle of rotation. Units after application of scale and offset
200 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw
201 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw
202 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw
203 KernelVersion: 2.6.35
204 Contact: linux-iio@vger.kernel.org
206 Angular velocity about axis x, y or z (may be arbitrarily
207 assigned). Has all the equivalent parameters as per voltageY.
208 Units after application of scale and offset are radians per
211 What: /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
212 What: /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
213 What: /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
214 KernelVersion: 2.6.35
215 Contact: linux-iio@vger.kernel.org
217 Inclination raw reading about axis x, y or z (may be
218 arbitrarily assigned). Data converted by application of offset
219 and scale to degrees.
221 What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
222 What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
223 What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
224 KernelVersion: 2.6.35
225 Contact: linux-iio@vger.kernel.org
227 Magnetic field along axis x, y or z (may be arbitrarily
228 assigned). Data converted by application of offset
231 What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
232 What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
233 What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
234 KernelVersion: 2.6.36
235 Contact: linux-iio@vger.kernel.org
237 Highest value since some reset condition. These
238 attributes allow access to this and are otherwise
239 the direct equivalent of the <type>Y[_name]_raw attributes.
241 What: /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
242 KernelVersion: 2.6.36
243 Contact: linux-iio@vger.kernel.org
245 A computed peak value based on the sum squared magnitude of
246 the underlying value in the specified directions.
248 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_raw
249 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_raw
251 Contact: linux-iio@vger.kernel.org
253 Raw pressure measurement from channel Y. Units after
254 application of scale and offset are kilopascal.
256 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_input
257 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_input
259 Contact: linux-iio@vger.kernel.org
261 Scaled pressure measurement from channel Y, in kilopascal.
263 What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_raw
265 Contact: linux-iio@vger.kernel.org
267 Raw humidity measurement of air. Units after application of
268 scale and offset are milli percent.
270 What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_input
272 Contact: linux-iio@vger.kernel.org
274 Scaled humidity measurement in milli percent.
276 What: /sys/bus/iio/devices/iio:deviceX/in_X_mean_raw
278 Contact: linux-iio@vger.kernel.org
280 Averaged raw measurement from channel X. The number of values
281 used for averaging is device specific. The converting rules for
282 normal raw values also applies to the averaged raw values.
284 What: /sys/bus/iio/devices/iio:deviceX/in_accel_offset
285 What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
286 What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
287 What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
288 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
289 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
290 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_offset
291 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_offset
292 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_offset
293 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_offset
294 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_offset
295 What: /sys/bus/iio/devices/iio:deviceX/in_current_offset
296 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_offset
297 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_offset
298 What: /sys/bus/iio/devices/iio:deviceX/in_current_q_offset
299 What: /sys/bus/iio/devices/iio:deviceX/in_current_i_offset
300 What: /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
301 What: /sys/bus/iio/devices/iio:deviceX/in_temp_offset
302 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_offset
303 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_offset
304 What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_offset
305 What: /sys/bus/iio/devices/iio:deviceX/in_magn_offset
306 What: /sys/bus/iio/devices/iio:deviceX/in_rot_offset
307 What: /sys/bus/iio/devices/iio:deviceX/in_angl_offset
308 KernelVersion: 2.6.35
309 Contact: linux-iio@vger.kernel.org
311 If known for a device, offset to be added to <type>[Y]_raw prior
312 to scaling by <type>[Y]_scale in order to obtain value in the
313 <type> units as specified in <type>[Y]_raw documentation.
314 Not present if the offset is always 0 or unknown. If Y or
315 axis <x|y|z> is not present, then the offset applies to all
316 in channels of <type>.
317 May be writable if a variable offset can be applied on the
318 device. Note that this is different to calibbias which
319 is for devices (or drivers) that apply offsets to compensate
320 for variation between different instances of the part, typically
321 adjusted by using some hardware supported calibration procedure.
322 Calibbias is applied internally, offset is applied in userspace
325 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
326 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_scale
327 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_scale
328 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
329 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
330 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_scale
331 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_scale
332 What: /sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_scale
333 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
334 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale
335 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_scale
336 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_scale
337 What: /sys/bus/iio/devices/iio:deviceX/in_current_scale
338 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_scale
339 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_scale
340 What: /sys/bus/iio/devices/iio:deviceX/in_current_i_scale
341 What: /sys/bus/iio/devices/iio:deviceX/in_current_q_scale
342 What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale
343 What: /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
344 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale
345 What: /sys/bus/iio/devices/iio:deviceX/in_energy_scale
346 What: /sys/bus/iio/devices/iio:deviceX/in_distance_scale
347 What: /sys/bus/iio/devices/iio:deviceX/in_magn_scale
348 What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
349 What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
350 What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
351 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_scale
352 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_scale
353 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_scale
354 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_scale
355 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_scale
356 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_scale
357 What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_scale
358 What: /sys/bus/iio/devices/iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_scale
359 What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_scale
360 What: /sys/bus/iio/devices/iio:deviceX/in_countY_scale
361 What: /sys/bus/iio/devices/iio:deviceX/in_angl_scale
362 KernelVersion: 2.6.35
363 Contact: linux-iio@vger.kernel.org
365 If known for a device, scale to be applied to <type>Y[_name]_raw
366 post addition of <type>[Y][_name]_offset in order to obtain the
367 measured value in <type> units as specified in
368 <type>[Y][_name]_raw documentation. If shared across all in
369 channels then Y and <x|y|z> are not present and the value is
370 called <type>[Y][_name]_scale. The peak modifier means this
371 value is applied to <type>Y[_name]_peak_raw values.
373 What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
374 What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
375 What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
376 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias
377 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
378 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
379 What: /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
380 What: /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
381 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibbias
382 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibbias
383 KernelVersion: 2.6.35
384 Contact: linux-iio@vger.kernel.org
386 Hardware applied calibration offset (assumed to fix production
389 What /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
390 What /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
391 What /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_calibscale
392 What /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_calibscale
393 What /sys/bus/iio/devices/iio:deviceX/in_voltage_i_calibscale
394 What /sys/bus/iio/devices/iio:deviceX/in_voltage_q_calibscale
395 What /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
396 What /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
397 What /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
398 What /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
399 What /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
400 What /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
401 What /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
402 what /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
403 what /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
404 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibscale
405 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibscale
406 What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_calibscale
407 KernelVersion: 2.6.35
408 Contact: linux-iio@vger.kernel.org
410 Hardware applied calibration scale factor (assumed to fix
411 production inaccuracies). If shared across all channels,
412 <type>_calibscale is used.
414 What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender
415 What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender
416 What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender
417 What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender
419 Contact: linux-iio@vger.kernel.org
421 Gender of the user (e.g.: male, female) used by some pedometers
422 to compute the stride length, distance, speed and activity
425 What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender_available
426 What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender_available
427 What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender_available
428 What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender_available
430 Contact: linux-iio@vger.kernel.org
432 Lists all available gender values (e.g.: male, female).
434 What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibheight
435 What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibheight
436 What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibheight
437 What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibheight
439 Contact: linux-iio@vger.kernel.org
441 Height of the user (in meters) used by some pedometers
442 to compute the stride length, distance, speed and activity
445 What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibweight
447 Contact: linux-iio@vger.kernel.org
449 Weight of the user (in kg). It is needed by some pedometers
450 to compute the calories burnt by the user.
452 What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
453 What: /sys/.../iio:deviceX/in_anglvel_scale_available
454 What: /sys/.../iio:deviceX/in_magn_scale_available
455 What: /sys/.../iio:deviceX/in_illuminance_scale_available
456 What: /sys/.../iio:deviceX/in_intensity_scale_available
457 What: /sys/.../iio:deviceX/in_proximity_scale_available
458 What: /sys/.../iio:deviceX/in_voltageX_scale_available
459 What: /sys/.../iio:deviceX/in_voltage-voltage_scale_available
460 What: /sys/.../iio:deviceX/out_voltageX_scale_available
461 What: /sys/.../iio:deviceX/out_altvoltageX_scale_available
462 What: /sys/.../iio:deviceX/in_capacitance_scale_available
463 What: /sys/.../iio:deviceX/in_pressure_scale_available
464 What: /sys/.../iio:deviceX/in_pressureY_scale_available
465 KernelVersion: 2.6.35
466 Contact: linux-iio@vger.kernel.org
468 If a discrete set of scale values is available, they
469 are listed in this attribute.
471 What /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
472 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_red_hardwaregain
473 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_green_hardwaregain
474 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_blue_hardwaregain
475 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_clear_hardwaregain
476 KernelVersion: 2.6.35
477 Contact: linux-iio@vger.kernel.org
479 Hardware applied gain factor. If shared across all channels,
480 <type>_hardwaregain is used.
482 What: /sys/.../in_accel_filter_low_pass_3db_frequency
483 What: /sys/.../in_magn_filter_low_pass_3db_frequency
484 What: /sys/.../in_anglvel_filter_low_pass_3db_frequency
486 Contact: linux-iio@vger.kernel.org
488 If a known or controllable low pass filter is applied
489 to the underlying data channel, then this parameter
490 gives the 3dB frequency of the filter in Hz.
492 What: /sys/.../in_accel_filter_high_pass_3db_frequency
493 What: /sys/.../in_anglvel_filter_high_pass_3db_frequency
494 What: /sys/.../in_magn_filter_high_pass_3db_frequency
496 Contact: linux-iio@vger.kernel.org
498 If a known or controllable high pass filter is applied
499 to the underlying data channel, then this parameter
500 gives the 3dB frequency of the filter in Hz.
502 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
503 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw
504 KernelVersion: 2.6.37
505 Contact: linux-iio@vger.kernel.org
507 Raw (unscaled, no bias etc.) output voltage for
508 channel Y. The number must always be specified and
509 unique if the output corresponds to a single channel.
510 While DAC like devices typically use out_voltage,
511 a continuous frequency generating device, such as
512 a DDS or PLL should use out_altvoltage.
514 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
515 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw
516 KernelVersion: 2.6.37
517 Contact: linux-iio@vger.kernel.org
519 Raw (unscaled, no bias etc.) output voltage for an aggregate of
520 channel Y, channel Z, etc. This interface is available in cases
521 where a single output sets the value for multiple channels
524 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
525 What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
526 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode
527 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode
528 KernelVersion: 2.6.38
529 Contact: linux-iio@vger.kernel.org
531 Specifies the output powerdown mode.
532 DAC output stage is disconnected from the amplifier and
533 1kohm_to_gnd: connected to ground via an 1kOhm resistor,
534 2.5kohm_to_gnd: connected to ground via a 2.5kOhm resistor,
535 6kohm_to_gnd: connected to ground via a 6kOhm resistor,
536 20kohm_to_gnd: connected to ground via a 20kOhm resistor,
537 90kohm_to_gnd: connected to ground via a 90kOhm resistor,
538 100kohm_to_gnd: connected to ground via an 100kOhm resistor,
539 125kohm_to_gnd: connected to ground via an 125kOhm resistor,
540 500kohm_to_gnd: connected to ground via a 500kOhm resistor,
541 640kohm_to_gnd: connected to ground via a 640kOhm resistor,
542 three_state: left floating.
543 For a list of available output power down options read
544 outX_powerdown_mode_available. If Y is not present the
545 mode is shared across all outputs.
547 What: /sys/.../iio:deviceX/out_voltageY_powerdown_mode_available
548 What: /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
549 What: /sys/.../iio:deviceX/out_altvoltageY_powerdown_mode_available
550 What: /sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available
551 KernelVersion: 2.6.38
552 Contact: linux-iio@vger.kernel.org
554 Lists all available output power down modes.
555 If Y is not present the mode is shared across all outputs.
557 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
558 What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
559 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
560 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown
561 KernelVersion: 2.6.38
562 Contact: linux-iio@vger.kernel.org
564 Writing 1 causes output Y to enter the power down mode specified
565 by the corresponding outY_powerdown_mode. DAC output stage is
566 disconnected from the amplifier. Clearing returns to normal
567 operation. Y may be suppressed if all outputs are controlled
570 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency
572 Contact: linux-iio@vger.kernel.org
574 Output frequency for channel Y in Hz. The number must always be
575 specified and unique if the output corresponds to a single
578 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase
580 Contact: linux-iio@vger.kernel.org
582 Phase in radians of one frequency/clock output Y
583 (out_altvoltageY) relative to another frequency/clock output
584 (out_altvoltageZ) of the device X. The number must always be
585 specified and unique if the output corresponds to a single
588 What: /sys/bus/iio/devices/iio:deviceX/events
589 KernelVersion: 2.6.35
590 Contact: linux-iio@vger.kernel.org
592 Configuration of which hardware generated events are passed up
595 What: /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
596 What: /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
597 What: /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
598 What: /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
599 What: /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
600 What: /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
601 What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
602 What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
603 What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
604 What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
605 What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
606 What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
607 What: /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
608 What: /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
609 What: /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
610 What: /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
611 What: /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
612 What: /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
613 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_rising_en
614 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_falling_en
615 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_rising_en
616 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_falling_en
617 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_en
618 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_en
619 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_rising_en
620 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_falling_en
621 What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
622 What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
623 What: /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
624 What: /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
625 What: /sys/.../iio:deviceX/events/in_voltageY_thresh_either_en
626 What: /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
627 What: /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
628 KernelVersion: 2.6.37
629 Contact: linux-iio@vger.kernel.org
631 Event generated when channel passes a threshold in the specified
632 (_rising|_falling) direction. If the direction is not specified,
633 then either the device will report an event which ever direction
634 a single threshold value is passed in (e.g.
635 <type>[Y][_name]_<raw|input>_thresh_value) or
636 <type>[Y][_name]_<raw|input>_thresh_rising_value and
637 <type>[Y][_name]_<raw|input>_thresh_falling_value may take
638 different values, but the device can only enable both thresholds
640 Note the driver will assume the last p events requested are
641 to be enabled where p is how many it supports (which may vary
642 depending on the exact set requested. So if you want to be
643 sure you have set what you think you have, check the contents of
644 these attributes after everything is configured. Drivers may
645 have to buffer any parameters so that they are consistent when
646 a given event type is enabled at a future point (and not those for
647 whatever event was previously enabled).
649 What: /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
650 What: /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
651 What: /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
652 What: /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
653 What: /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
654 What: /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
655 What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
656 What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
657 What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
658 What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
659 What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
660 What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
661 What: /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
662 What: /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
663 What: /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
664 What: /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
665 What: /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
666 What: /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
667 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_rising_en
668 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_falling_en
669 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_rising_en
670 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_falling_en
671 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_rising_en
672 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_falling_en
673 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_rising_en
674 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_falling_en
675 What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
676 What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
677 What: /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
678 What: /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
679 What: /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
680 What: /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
681 KernelVersion: 2.6.37
682 Contact: linux-iio@vger.kernel.org
684 Event generated when channel passes a threshold on the rate of
685 change (1st differential) in the specified (_rising|_falling)
686 direction. If the direction is not specified, then either the
687 device will report an event which ever direction a single
688 threshold value is passed in (e.g.
689 <type>[Y][_name]_<raw|input>_roc_value) or
690 <type>[Y][_name]_<raw|input>_roc_rising_value and
691 <type>[Y][_name]_<raw|input>_roc_falling_value may take
692 different values, but the device can only enable both rate of
693 change thresholds or neither.
694 Note the driver will assume the last p events requested are
695 to be enabled where p is however many it supports (which may
696 vary depending on the exact set requested. So if you want to be
697 sure you have set what you think you have, check the contents of
698 these attributes after everything is configured. Drivers may
699 have to buffer any parameters so that they are consistent when
700 a given event type is enabled a future point (and not those for
701 whatever event was previously enabled).
703 What: /sys/.../events/in_accel_thresh_rising_value
704 What: /sys/.../events/in_accel_thresh_falling_value
705 What: /sys/.../events/in_accel_x_raw_thresh_rising_value
706 What: /sys/.../events/in_accel_x_raw_thresh_falling_value
707 What: /sys/.../events/in_accel_y_raw_thresh_rising_value
708 What: /sys/.../events/in_accel_y_raw_thresh_falling_value
709 What: /sys/.../events/in_accel_z_raw_thresh_rising_value
710 What: /sys/.../events/in_accel_z_raw_thresh_falling_value
711 What: /sys/.../events/in_anglvel_x_raw_thresh_rising_value
712 What: /sys/.../events/in_anglvel_x_raw_thresh_falling_value
713 What: /sys/.../events/in_anglvel_y_raw_thresh_rising_value
714 What: /sys/.../events/in_anglvel_y_raw_thresh_falling_value
715 What: /sys/.../events/in_anglvel_z_raw_thresh_rising_value
716 What: /sys/.../events/in_anglvel_z_raw_thresh_falling_value
717 What: /sys/.../events/in_magn_x_raw_thresh_rising_value
718 What: /sys/.../events/in_magn_x_raw_thresh_falling_value
719 What: /sys/.../events/in_magn_y_raw_thresh_rising_value
720 What: /sys/.../events/in_magn_y_raw_thresh_falling_value
721 What: /sys/.../events/in_magn_z_raw_thresh_rising_value
722 What: /sys/.../events/in_magn_z_raw_thresh_falling_value
723 What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_rising_value
724 What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_falling_value
725 What: /sys/.../events/in_rot_from_north_true_raw_thresh_rising_value
726 What: /sys/.../events/in_rot_from_north_true_raw_thresh_falling_value
727 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_rising_value
728 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_falling_value
729 What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_rising_value
730 What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_falling_value
731 What: /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
732 What: /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
733 What: /sys/.../events/in_voltageY_raw_thresh_rising_value
734 What: /sys/.../events/in_voltageY_raw_thresh_falling_value
735 What: /sys/.../events/in_tempY_raw_thresh_rising_value
736 What: /sys/.../events/in_tempY_raw_thresh_falling_value
737 What: /sys/.../events/in_illuminance0_thresh_falling_value
738 what: /sys/.../events/in_illuminance0_thresh_rising_value
739 what: /sys/.../events/in_proximity0_thresh_falling_value
740 what: /sys/.../events/in_proximity0_thresh_rising_value
741 KernelVersion: 2.6.37
742 Contact: linux-iio@vger.kernel.org
744 Specifies the value of threshold that the device is comparing
745 against for the events enabled by
746 <type>Y[_name]_thresh[_rising|falling]_en.
747 If separate attributes exist for the two directions, but
748 direction is not specified for this attribute, then a single
749 threshold value applies to both directions.
750 The raw or input element of the name indicates whether the
751 value is in raw device units or in processed units (as _raw
752 and _input do on sysfs direct channel read attributes).
754 What: /sys/.../events/in_accel_scale
755 What: /sys/.../events/in_accel_peak_scale
756 What: /sys/.../events/in_anglvel_scale
757 What: /sys/.../events/in_magn_scale
758 What: /sys/.../events/in_rot_from_north_magnetic_scale
759 What: /sys/.../events/in_rot_from_north_true_scale
760 What: /sys/.../events/in_voltage_scale
761 What: /sys/.../events/in_voltage_supply_scale
762 What: /sys/.../events/in_temp_scale
763 What: /sys/.../events/in_illuminance_scale
764 What: /sys/.../events/in_proximity_scale
766 Contact: linux-iio@vger.kernel.org
768 Specifies the conversion factor from the standard units
769 to device specific units used to set the event trigger
772 What: /sys/.../events/in_accel_x_thresh_rising_hysteresis
773 What: /sys/.../events/in_accel_x_thresh_falling_hysteresis
774 What: /sys/.../events/in_accel_x_thresh_either_hysteresis
775 What: /sys/.../events/in_accel_y_thresh_rising_hysteresis
776 What: /sys/.../events/in_accel_y_thresh_falling_hysteresis
777 What: /sys/.../events/in_accel_y_thresh_either_hysteresis
778 What: /sys/.../events/in_accel_z_thresh_rising_hysteresis
779 What: /sys/.../events/in_accel_z_thresh_falling_hysteresis
780 What: /sys/.../events/in_accel_z_thresh_either_hysteresis
781 What: /sys/.../events/in_anglvel_x_thresh_rising_hysteresis
782 What: /sys/.../events/in_anglvel_x_thresh_falling_hysteresis
783 What: /sys/.../events/in_anglvel_x_thresh_either_hysteresis
784 What: /sys/.../events/in_anglvel_y_thresh_rising_hysteresis
785 What: /sys/.../events/in_anglvel_y_thresh_falling_hysteresis
786 What: /sys/.../events/in_anglvel_y_thresh_either_hysteresis
787 What: /sys/.../events/in_anglvel_z_thresh_rising_hysteresis
788 What: /sys/.../events/in_anglvel_z_thresh_falling_hysteresis
789 What: /sys/.../events/in_anglvel_z_thresh_either_hysteresis
790 What: /sys/.../events/in_magn_x_thresh_rising_hysteresis
791 What: /sys/.../events/in_magn_x_thresh_falling_hysteresis
792 What: /sys/.../events/in_magn_x_thresh_either_hysteresis
793 What: /sys/.../events/in_magn_y_thresh_rising_hysteresis
794 What: /sys/.../events/in_magn_y_thresh_falling_hysteresis
795 What: /sys/.../events/in_magn_y_thresh_either_hysteresis
796 What: /sys/.../events/in_magn_z_thresh_rising_hysteresis
797 What: /sys/.../events/in_magn_z_thresh_falling_hysteresis
798 What: /sys/.../events/in_magn_z_thresh_either_hysteresis
799 What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_hysteresis
800 What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_hysteresis
801 What: /sys/.../events/in_rot_from_north_magnetic_thresh_either_hysteresis
802 What: /sys/.../events/in_rot_from_north_true_thresh_rising_hysteresis
803 What: /sys/.../events/in_rot_from_north_true_thresh_falling_hysteresis
804 What: /sys/.../events/in_rot_from_north_true_thresh_either_hysteresis
805 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_hysteresis
806 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_hysteresis
807 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_either_hysteresis
808 What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_hysteresis
809 What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_hysteresis
810 What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_either_hysteresis
811 What: /sys/.../events/in_voltageY_thresh_rising_hysteresis
812 What: /sys/.../events/in_voltageY_thresh_falling_hysteresis
813 What: /sys/.../events/in_voltageY_thresh_either_hysteresis
814 What: /sys/.../events/in_tempY_thresh_rising_hysteresis
815 What: /sys/.../events/in_tempY_thresh_falling_hysteresis
816 What: /sys/.../events/in_tempY_thresh_either_hysteresis
817 What: /sys/.../events/in_illuminance0_thresh_falling_hysteresis
818 what: /sys/.../events/in_illuminance0_thresh_rising_hysteresis
819 what: /sys/.../events/in_illuminance0_thresh_either_hysteresis
820 what: /sys/.../events/in_proximity0_thresh_falling_hysteresis
821 what: /sys/.../events/in_proximity0_thresh_rising_hysteresis
822 what: /sys/.../events/in_proximity0_thresh_either_hysteresis
824 Contact: linux-iio@vger.kernel.org
826 Specifies the hysteresis of threshold that the device is comparing
827 against for the events enabled by
828 <type>Y[_name]_thresh[_(rising|falling)]_hysteresis.
829 If separate attributes exist for the two directions, but
830 direction is not specified for this attribute, then a single
831 hysteresis value applies to both directions.
832 For falling events the hysteresis is added to the _value attribute for
833 this event to get the upper threshold for when the event goes back to
834 normal, for rising events the hysteresis is subtracted from the _value
835 attribute. E.g. if in_voltage0_raw_thresh_rising_value is set to 1200
836 and in_voltage0_raw_thresh_rising_hysteresis is set to 50. The event
837 will get activated once in_voltage0_raw goes above 1200 and will become
838 deactivated again once the value falls below 1150.
840 What: /sys/.../events/in_accel_x_raw_roc_rising_value
841 What: /sys/.../events/in_accel_x_raw_roc_falling_value
842 What: /sys/.../events/in_accel_y_raw_roc_rising_value
843 What: /sys/.../events/in_accel_y_raw_roc_falling_value
844 What: /sys/.../events/in_accel_z_raw_roc_rising_value
845 What: /sys/.../events/in_accel_z_raw_roc_falling_value
846 What: /sys/.../events/in_anglvel_x_raw_roc_rising_value
847 What: /sys/.../events/in_anglvel_x_raw_roc_falling_value
848 What: /sys/.../events/in_anglvel_y_raw_roc_rising_value
849 What: /sys/.../events/in_anglvel_y_raw_roc_falling_value
850 What: /sys/.../events/in_anglvel_z_raw_roc_rising_value
851 What: /sys/.../events/in_anglvel_z_raw_roc_falling_value
852 What: /sys/.../events/in_magn_x_raw_roc_rising_value
853 What: /sys/.../events/in_magn_x_raw_roc_falling_value
854 What: /sys/.../events/in_magn_y_raw_roc_rising_value
855 What: /sys/.../events/in_magn_y_raw_roc_falling_value
856 What: /sys/.../events/in_magn_z_raw_roc_rising_value
857 What: /sys/.../events/in_magn_z_raw_roc_falling_value
858 What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_rising_value
859 What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_falling_value
860 What: /sys/.../events/in_rot_from_north_true_raw_roc_rising_value
861 What: /sys/.../events/in_rot_from_north_true_raw_roc_falling_value
862 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_rising_value
863 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_falling_value
864 What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_rising_value
865 What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_falling_value
866 What: /sys/.../events/in_voltageY_supply_raw_roc_rising_value
867 What: /sys/.../events/in_voltageY_supply_raw_roc_falling_value
868 What: /sys/.../events/in_voltageY_raw_roc_rising_value
869 What: /sys/.../events/in_voltageY_raw_roc_falling_value
870 What: /sys/.../events/in_tempY_raw_roc_rising_value
871 What: /sys/.../events/in_tempY_raw_roc_falling_value
872 KernelVersion: 2.6.37
873 Contact: linux-iio@vger.kernel.org
875 Specifies the value of rate of change threshold that the
876 device is comparing against for the events enabled by
877 <type>[Y][_name]_roc[_rising|falling]_en.
878 If separate attributes exist for the two directions,
879 but direction is not specified for this attribute,
880 then a single threshold value applies to both directions.
881 The raw or input element of the name indicates whether the
882 value is in raw device units or in processed units (as _raw
883 and _input do on sysfs direct channel read attributes).
885 What: /sys/.../events/in_accel_x_thresh_rising_period
886 What: /sys/.../events/in_accel_x_thresh_falling_period
887 What: /sys/.../events/in_accel_x_roc_rising_period
888 What: /sys/.../events/in_accel_x_roc_falling_period
889 What: /sys/.../events/in_accel_y_thresh_rising_period
890 What: /sys/.../events/in_accel_y_thresh_falling_period
891 What: /sys/.../events/in_accel_y_roc_rising_period
892 What: /sys/.../events/in_accel_y_roc_falling_period
893 What: /sys/.../events/in_accel_z_thresh_rising_period
894 What: /sys/.../events/in_accel_z_thresh_falling_period
895 What: /sys/.../events/in_accel_z_roc_rising_period
896 What: /sys/.../events/in_accel_z_roc_falling_period
897 What: /sys/.../events/in_anglvel_x_thresh_rising_period
898 What: /sys/.../events/in_anglvel_x_thresh_falling_period
899 What: /sys/.../events/in_anglvel_x_roc_rising_period
900 What: /sys/.../events/in_anglvel_x_roc_falling_period
901 What: /sys/.../events/in_anglvel_y_thresh_rising_period
902 What: /sys/.../events/in_anglvel_y_thresh_falling_period
903 What: /sys/.../events/in_anglvel_y_roc_rising_period
904 What: /sys/.../events/in_anglvel_y_roc_falling_period
905 What: /sys/.../events/in_anglvel_z_thresh_rising_period
906 What: /sys/.../events/in_anglvel_z_thresh_falling_period
907 What: /sys/.../events/in_anglvel_z_roc_rising_period
908 What: /sys/.../events/in_anglvel_z_roc_falling_period
909 What: /sys/.../events/in_magn_x_thresh_rising_period
910 What: /sys/.../events/in_magn_x_thresh_falling_period
911 What: /sys/.../events/in_magn_x_roc_rising_period
912 What: /sys/.../events/in_magn_x_roc_falling_period
913 What: /sys/.../events/in_magn_y_thresh_rising_period
914 What: /sys/.../events/in_magn_y_thresh_falling_period
915 What: /sys/.../events/in_magn_y_roc_rising_period
916 What: /sys/.../events/in_magn_y_roc_falling_period
917 What: /sys/.../events/in_magn_z_thresh_rising_period
918 What: /sys/.../events/in_magn_z_thresh_falling_period
919 What: /sys/.../events/in_magn_z_roc_rising_period
920 What: /sys/.../events/in_magn_z_roc_falling_period
921 What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_period
922 What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_period
923 What: /sys/.../events/in_rot_from_north_magnetic_roc_rising_period
924 What: /sys/.../events/in_rot_from_north_magnetic_roc_falling_period
925 What: /sys/.../events/in_rot_from_north_true_thresh_rising_period
926 What: /sys/.../events/in_rot_from_north_true_thresh_falling_period
927 What: /sys/.../events/in_rot_from_north_true_roc_rising_period
928 What: /sys/.../events/in_rot_from_north_true_roc_falling_period
929 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_period
930 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_period
931 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_rising_period
932 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_falling_period
933 What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_period
934 What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_period
935 What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_rising_period
936 What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_falling_period
937 What: /sys/.../events/in_voltageY_supply_thresh_rising_period
938 What: /sys/.../events/in_voltageY_supply_thresh_falling_period
939 What: /sys/.../events/in_voltageY_supply_roc_rising_period
940 What: /sys/.../events/in_voltageY_supply_roc_falling_period
941 What: /sys/.../events/in_voltageY_thresh_rising_period
942 What: /sys/.../events/in_voltageY_thresh_falling_period
943 What: /sys/.../events/in_voltageY_roc_rising_period
944 What: /sys/.../events/in_voltageY_roc_falling_period
945 What: /sys/.../events/in_tempY_thresh_rising_period
946 What: /sys/.../events/in_tempY_thresh_falling_period
947 What: /sys/.../events/in_tempY_roc_rising_period
948 What: /sys/.../events/in_tempY_roc_falling_period
949 What: /sys/.../events/in_accel_x&y&z_mag_falling_period
950 What: /sys/.../events/in_intensity0_thresh_period
951 What: /sys/.../events/in_proximity0_thresh_period
952 What: /sys/.../events/in_activity_still_thresh_rising_period
953 What: /sys/.../events/in_activity_still_thresh_falling_period
954 What: /sys/.../events/in_activity_walking_thresh_rising_period
955 What: /sys/.../events/in_activity_walking_thresh_falling_period
956 What: /sys/.../events/in_activity_jogging_thresh_rising_period
957 What: /sys/.../events/in_activity_jogging_thresh_falling_period
958 What: /sys/.../events/in_activity_running_thresh_rising_period
959 What: /sys/.../events/in_activity_running_thresh_falling_period
960 KernelVersion: 2.6.37
961 Contact: linux-iio@vger.kernel.org
963 Period of time (in seconds) for which the condition must be
964 met before an event is generated. If direction is not
965 specified then this period applies to both directions.
967 What: /sys/.../events/in_accel_thresh_rising_low_pass_filter_3db
968 What: /sys/.../events/in_anglvel_thresh_rising_low_pass_filter_3db
969 What: /sys/.../events/in_magn_thresh_rising_low_pass_filter_3db
971 Contact: linux-iio@vger.kernel.org
973 If a low pass filter can be applied to the event generation
974 this property gives its 3db frequency in Hz.
975 A value of zero disables the filter.
977 What: /sys/.../events/in_accel_thresh_rising_high_pass_filter_3db
978 What: /sys/.../events/in_anglvel_thresh_rising_high_pass_filter_3db
979 What: /sys/.../events/in_magn_thresh_rising_high_pass_filter_3db
981 Contact: linux-iio@vger.kernel.org
983 If a high pass filter can be applied to the event generation
984 this property gives its 3db frequency in Hz.
985 A value of zero disables the filter.
987 What: /sys/.../events/in_activity_still_thresh_rising_en
988 What: /sys/.../events/in_activity_still_thresh_falling_en
989 What: /sys/.../events/in_activity_walking_thresh_rising_en
990 What: /sys/.../events/in_activity_walking_thresh_falling_en
991 What: /sys/.../events/in_activity_jogging_thresh_rising_en
992 What: /sys/.../events/in_activity_jogging_thresh_falling_en
993 What: /sys/.../events/in_activity_running_thresh_rising_en
994 What: /sys/.../events/in_activity_running_thresh_falling_en
996 Contact: linux-iio@vger.kernel.org
998 Enables or disables activitity events. Depending on direction
999 an event is generated when sensor ENTERS or LEAVES a given state.
1001 What: /sys/.../events/in_activity_still_thresh_rising_value
1002 What: /sys/.../events/in_activity_still_thresh_falling_value
1003 What: /sys/.../events/in_activity_walking_thresh_rising_value
1004 What: /sys/.../events/in_activity_walking_thresh_falling_value
1005 What: /sys/.../events/in_activity_jogging_thresh_rising_value
1006 What: /sys/.../events/in_activity_jogging_thresh_falling_value
1007 What: /sys/.../events/in_activity_running_thresh_rising_value
1008 What: /sys/.../events/in_activity_running_thresh_falling_value
1010 Contact: linux-iio@vger.kernel.org
1012 Confidence value (in units as percentage) to be used
1013 for deciding when an event should be generated. E.g for
1014 running: If the confidence value reported by the sensor
1015 is greater than in_activity_running_thresh_rising_value
1016 then the sensor ENTERS running state. Conversely, if the
1017 confidence value reported by the sensor is lower than
1018 in_activity_running_thresh_falling_value then the sensor
1019 is LEAVING running state.
1021 What: /sys/.../iio:deviceX/events/in_accel_mag_en
1022 What: /sys/.../iio:deviceX/events/in_accel_mag_rising_en
1023 What: /sys/.../iio:deviceX/events/in_accel_mag_falling_en
1024 What: /sys/.../iio:deviceX/events/in_accel_x_mag_en
1025 What: /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
1026 What: /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
1027 What: /sys/.../iio:deviceX/events/in_accel_y_mag_en
1028 What: /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
1029 What: /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
1030 What: /sys/.../iio:deviceX/events/in_accel_z_mag_en
1031 What: /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
1032 What: /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
1033 What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
1034 What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
1035 KernelVersion: 2.6.37
1036 Contact: linux-iio@vger.kernel.org
1038 Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
1039 magnitude of the channel is compared to the threshold, not its
1042 What: /sys/.../events/in_accel_raw_mag_value
1043 What: /sys/.../events/in_accel_x_raw_mag_rising_value
1044 What: /sys/.../events/in_accel_y_raw_mag_rising_value
1045 What: /sys/.../events/in_accel_z_raw_mag_rising_value
1046 KernelVersion: 2.6.37
1047 Contact: linux-iio@vger.kernel.org
1049 The value to which the magnitude of the channel is compared. If
1050 number or direction is not specified, applies to all channels of
1053 What: /sys/.../events/in_steps_change_en
1055 Contact: linux-iio@vger.kernel.org
1057 Event generated when channel passes a threshold on the absolute
1058 change in value. E.g. for steps: a step change event is
1059 generated each time the user takes N steps, where N is set using
1060 in_steps_change_value.
1062 What: /sys/.../events/in_steps_change_value
1064 Contact: linux-iio@vger.kernel.org
1066 Specifies the value of change threshold that the
1067 device is comparing against for the events enabled by
1068 <type>[Y][_name]_roc[_rising|falling|]_en. E.g. for steps:
1069 if set to 3, a step change event will be generated every 3
1072 What: /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
1073 KernelVersion: 2.6.35
1074 Contact: linux-iio@vger.kernel.org
1076 The name of the trigger source being used, as per string given
1077 in /sys/class/iio/triggerY/name.
1079 What: /sys/bus/iio/devices/iio:deviceX/buffer/length
1080 KernelVersion: 2.6.35
1081 Contact: linux-iio@vger.kernel.org
1083 Number of scans contained by the buffer.
1085 What: /sys/bus/iio/devices/iio:deviceX/buffer/enable
1086 KernelVersion: 2.6.35
1087 Contact: linux-iio@vger.kernel.org
1089 Actually start the buffer capture up. Will start trigger
1090 if first device and appropriate.
1092 What: /sys/bus/iio/devices/iio:deviceX/scan_elements
1093 KernelVersion: 2.6.37
1094 Contact: linux-iio@vger.kernel.org
1096 Directory containing interfaces for elements that will be
1097 captured for a single triggered sample set in the buffer.
1099 What: /sys/.../iio:deviceX/scan_elements/in_accel_x_en
1100 What: /sys/.../iio:deviceX/scan_elements/in_accel_y_en
1101 What: /sys/.../iio:deviceX/scan_elements/in_accel_z_en
1102 What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_en
1103 What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_en
1104 What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_en
1105 What: /sys/.../iio:deviceX/scan_elements/in_magn_x_en
1106 What: /sys/.../iio:deviceX/scan_elements/in_magn_y_en
1107 What: /sys/.../iio:deviceX/scan_elements/in_magn_z_en
1108 What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_en
1109 What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_en
1110 What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_en
1111 What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_en
1112 What: /sys/.../iio:deviceX/scan_elements/in_timestamp_en
1113 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_en
1114 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_en
1115 What: /sys/.../iio:deviceX/scan_elements/in_voltageY-voltageZ_en
1116 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_en
1117 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_en
1118 What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_en
1119 What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_en
1120 What: /sys/.../iio:deviceX/scan_elements/in_incli_x_en
1121 What: /sys/.../iio:deviceX/scan_elements/in_incli_y_en
1122 What: /sys/.../iio:deviceX/scan_elements/in_pressureY_en
1123 What: /sys/.../iio:deviceX/scan_elements/in_pressure_en
1124 What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_en
1125 What: /sys/.../iio:deviceX/scan_elements/in_proximity_en
1126 KernelVersion: 2.6.37
1127 Contact: linux-iio@vger.kernel.org
1129 Scan element control for triggered data capture.
1131 What: /sys/.../iio:deviceX/scan_elements/in_accel_type
1132 What: /sys/.../iio:deviceX/scan_elements/in_anglvel_type
1133 What: /sys/.../iio:deviceX/scan_elements/in_magn_type
1134 What: /sys/.../iio:deviceX/scan_elements/in_incli_type
1135 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_type
1136 What: /sys/.../iio:deviceX/scan_elements/in_voltage_type
1137 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_type
1138 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_type
1139 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_type
1140 What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_type
1141 What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_type
1142 What: /sys/.../iio:deviceX/scan_elements/in_timestamp_type
1143 What: /sys/.../iio:deviceX/scan_elements/in_pressureY_type
1144 What: /sys/.../iio:deviceX/scan_elements/in_pressure_type
1145 What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_type
1146 What: /sys/.../iio:deviceX/scan_elements/in_proximity_type
1147 KernelVersion: 2.6.37
1148 Contact: linux-iio@vger.kernel.org
1150 Description of the scan element data storage within the buffer
1151 and hence the form in which it is read from user-space.
1152 Form is [be|le]:[s|u]bits/storagebits[>>shift].
1153 be or le specifies big or little endian. s or u specifies if
1154 signed (2's complement) or unsigned. bits is the number of bits
1155 of data and storagebits is the space (after padding) that it
1156 occupies in the buffer. shift if specified, is the shift that
1157 needs to be applied prior to masking out unused bits. Some
1158 devices put their data in the middle of the transferred elements
1159 with additional information on both sides. Note that some
1160 devices will have additional information in the unused bits
1161 so to get a clean value, the bits value must be used to mask
1162 the buffer output value appropriately. The storagebits value
1163 also specifies the data alignment. So s48/64>>2 will be a
1164 signed 48 bit integer stored in a 64 bit location aligned to
1165 a 64 bit boundary. To obtain the clean value, shift right 2
1166 and apply a mask to zero the top 16 bits of the result.
1167 For other storage combinations this attribute will be extended
1170 What: /sys/.../iio:deviceX/scan_elements/in_accel_type_available
1171 KernelVersion: 2.6.37
1172 Contact: linux-iio@vger.kernel.org
1174 If the type parameter can take one of a small set of values,
1175 this attribute lists them.
1177 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_index
1178 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_index
1179 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_index
1180 What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_index
1181 What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_index
1182 What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_index
1183 What: /sys/.../iio:deviceX/scan_elements/in_accel_x_index
1184 What: /sys/.../iio:deviceX/scan_elements/in_accel_y_index
1185 What: /sys/.../iio:deviceX/scan_elements/in_accel_z_index
1186 What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_index
1187 What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_index
1188 What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_index
1189 What: /sys/.../iio:deviceX/scan_elements/in_magn_x_index
1190 What: /sys/.../iio:deviceX/scan_elements/in_magn_y_index
1191 What: /sys/.../iio:deviceX/scan_elements/in_magn_z_index
1192 What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_index
1193 What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_index
1194 What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_index
1195 What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_index
1196 What: /sys/.../iio:deviceX/scan_elements/in_incli_x_index
1197 What: /sys/.../iio:deviceX/scan_elements/in_incli_y_index
1198 What: /sys/.../iio:deviceX/scan_elements/in_timestamp_index
1199 What: /sys/.../iio:deviceX/scan_elements/in_pressureY_index
1200 What: /sys/.../iio:deviceX/scan_elements/in_pressure_index
1201 What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_index
1202 What: /sys/.../iio:deviceX/scan_elements/in_proximity_index
1203 KernelVersion: 2.6.37
1204 Contact: linux-iio@vger.kernel.org
1206 A single positive integer specifying the position of this
1207 scan element in the buffer. Note these are not dependent on
1208 what is enabled and may not be contiguous. Thus for user-space
1209 to establish the full layout these must be used in conjunction
1210 with all _en attributes to establish which channels are present,
1211 and the relevant _type attributes to establish the data storage
1214 What: /sys/.../iio:deviceX/in_activity_still_input
1215 What: /sys/.../iio:deviceX/in_activity_walking_input
1216 What: /sys/.../iio:deviceX/in_activity_jogging_input
1217 What: /sys/.../iio:deviceX/in_activity_running_input
1219 Contact: linux-iio@vger.kernel.org
1221 This attribute is used to read the confidence for an activity
1222 expressed in units as percentage.
1224 What: /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
1225 KernelVersion: 2.6.38
1226 Contact: linux-iio@vger.kernel.org
1228 This attribute is used to read the amount of quadrature error
1229 present in the device at a given time.
1231 What: /sys/.../iio:deviceX/in_accelX_power_mode
1233 Contact: linux-iio@vger.kernel.org
1235 Specifies the chip power mode.
1236 low_noise: reduce noise level from ADC,
1237 low_power: enable low current consumption.
1238 For a list of available output power modes read
1239 in_accel_power_mode_available.
1241 What: /sys/.../iio:deviceX/in_energy_input
1242 What: /sys/.../iio:deviceX/in_energy_raw
1244 Contact: linux-iio@vger.kernel.org
1246 This attribute is used to read the energy value reported by the
1247 device (e.g.: human activity sensors report energy burnt by the
1248 user). Units after application of scale are Joules.
1250 What: /sys/.../iio:deviceX/in_distance_input
1251 What: /sys/.../iio:deviceX/in_distance_raw
1253 Contact: linux-iio@vger.kernel.org
1255 This attribute is used to read the measured distance to an object
1256 or the distance covered by the user since the last reboot while
1257 activated. Units after application of scale are meters.
1259 What: /sys/bus/iio/devices/iio:deviceX/store_eeprom
1260 KernelVersion: 3.4.0
1261 Contact: linux-iio@vger.kernel.org
1263 Writing '1' stores the current device configuration into
1264 on-chip EEPROM. After power-up or chip reset the device will
1265 automatically load the saved configuration.
1267 What: /sys/.../iio:deviceX/in_proximity_raw
1268 What: /sys/.../iio:deviceX/in_proximity_input
1269 What: /sys/.../iio:deviceX/in_proximityY_raw
1271 Contact: linux-iio@vger.kernel.org
1273 Proximity measurement indicating that some
1274 object is near the sensor, usually by observing
1275 reflectivity of infrared or ultrasound emitted.
1276 Often these sensors are unit less and as such conversion
1277 to SI units is not possible. Higher proximity measurements
1278 indicate closer objects, and vice versa. Units after
1279 application of scale and offset are meters.
1281 What: /sys/.../iio:deviceX/in_illuminance_input
1282 What: /sys/.../iio:deviceX/in_illuminance_raw
1283 What: /sys/.../iio:deviceX/in_illuminanceY_input
1284 What: /sys/.../iio:deviceX/in_illuminanceY_raw
1285 What: /sys/.../iio:deviceX/in_illuminanceY_mean_raw
1286 What: /sys/.../iio:deviceX/in_illuminance_ir_raw
1287 What: /sys/.../iio:deviceX/in_illuminance_clear_raw
1289 Contact: linux-iio@vger.kernel.org
1291 Illuminance measurement, units after application of scale
1294 What: /sys/.../iio:deviceX/in_intensityY_raw
1295 What: /sys/.../iio:deviceX/in_intensityY_ir_raw
1296 What: /sys/.../iio:deviceX/in_intensityY_both_raw
1297 What: /sys/.../iio:deviceX/in_intensityY_uv_raw
1299 Contact: linux-iio@vger.kernel.org
1301 Unit-less light intensity. Modifiers both and ir indicate
1302 that measurements contain visible and infrared light
1303 components or just infrared light, respectively. Modifier uv indicates
1304 that measurements contain ultraviolet light components.
1306 What: /sys/.../iio:deviceX/in_uvindex_input
1308 Contact: linux-iio@vger.kernel.org
1310 UV light intensity index measuring the human skin's response to
1311 different wavelength of sunlight weighted according to the
1312 standardised CIE Erythemal Action Spectrum. UV index values range
1313 from 0 (low) to >=11 (extreme).
1315 What: /sys/.../iio:deviceX/in_intensity_red_integration_time
1316 What: /sys/.../iio:deviceX/in_intensity_green_integration_time
1317 What: /sys/.../iio:deviceX/in_intensity_blue_integration_time
1318 What: /sys/.../iio:deviceX/in_intensity_clear_integration_time
1319 What: /sys/.../iio:deviceX/in_illuminance_integration_time
1321 Contact: linux-iio@vger.kernel.org
1323 This attribute is used to get/set the integration time in
1326 What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_integration_time
1328 Contact: linux-iio@vger.kernel.org
1330 Number of seconds in which to compute speed.
1332 What: /sys/bus/iio/devices/iio:deviceX/in_rot_quaternion_raw
1334 Contact: linux-iio@vger.kernel.org
1336 Raw value of quaternion components using a format
1337 x y z w. Here x, y, and z component represents the axis about
1338 which a rotation will occur and w component represents the
1341 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_raw
1342 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_raw
1343 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_raw
1344 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_raw
1346 Contact: linux-iio@vger.kernel.org
1348 Raw value of rotation from true/magnetic north measured with
1349 or without compensation from tilt sensors.
1351 What: /sys/bus/iio/devices/iio:deviceX/in_currentX_raw
1352 What: /sys/bus/iio/devices/iio:deviceX/in_currentX_i_raw
1353 What: /sys/bus/iio/devices/iio:deviceX/in_currentX_q_raw
1355 Contact: linux-iio@vger.kernel.org
1357 Raw current measurement from channel X. Units are in milliamps
1358 after application of scale and offset. If no offset or scale is
1359 present, output should be considered as processed with the
1362 Channels with 'i' and 'q' modifiers always exist in pairs and both
1363 channels refer to the same signal. The 'i' channel contains the in-phase
1364 component of the signal while the 'q' channel contains the quadrature
1367 What: /sys/.../iio:deviceX/in_energy_en
1368 What: /sys/.../iio:deviceX/in_distance_en
1369 What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_en
1370 What: /sys/.../iio:deviceX/in_steps_en
1372 Contact: linux-iio@vger.kernel.org
1374 Activates a device feature that runs in firmware/hardware.
1375 E.g. for steps: the pedometer saves power while not used;
1376 when activated, it will count the steps taken by the user in
1377 firmware and export them through in_steps_input.
1379 What: /sys/.../iio:deviceX/in_steps_input
1381 Contact: linux-iio@vger.kernel.org
1383 This attribute is used to read the number of steps taken by the user
1384 since the last reboot while activated.
1386 What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_input
1387 What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_raw
1389 Contact: linux-iio@vger.kernel.org
1391 This attribute is used to read the current speed value of the
1392 user (which is the norm or magnitude of the velocity vector).
1393 Units after application of scale are m/s.
1395 What: /sys/.../iio:deviceX/in_steps_debounce_count
1397 Contact: linux-iio@vger.kernel.org
1399 Specifies the number of steps that must occur within
1400 in_steps_filter_debounce_time for the pedometer to decide the
1401 consumer is making steps.
1403 What: /sys/.../iio:deviceX/in_steps_debounce_time
1405 Contact: linux-iio@vger.kernel.org
1407 Specifies number of seconds in which we compute the steps
1408 that occur in order to decide if the consumer is making steps.
1410 What: /sys/bus/iio/devices/iio:deviceX/buffer/watermark
1412 Contact: linux-iio@vger.kernel.org
1414 A single positive integer specifying the maximum number of scan
1415 elements to wait for.
1416 Poll will block until the watermark is reached.
1417 Blocking read will wait until the minimum between the requested
1418 read amount or the low water mark is available.
1419 Non-blocking read will retrieve the available samples from the
1420 buffer even if there are less samples then watermark level. This
1421 allows the application to block on poll with a timeout and read
1422 the available samples after the timeout expires and thus have a
1423 maximum delay guarantee.
1425 What: /sys/bus/iio/devices/iio:deviceX/buffer/data_available
1427 Contact: linux-iio@vger.kernel.org
1429 A read-only value indicating the bytes of data available in the
1430 buffer. In the case of an output buffer, this indicates the
1431 amount of empty space available to write data to. In the case of
1432 an input buffer, this indicates the amount of data available for
1435 What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_enabled
1437 Contact: linux-iio@vger.kernel.org
1439 A read-only boolean value that indicates if the hardware fifo is
1440 currently enabled or disabled. If the device does not have a
1441 hardware fifo this entry is not present.
1442 The hardware fifo is enabled when the buffer is enabled if the
1443 current hardware fifo watermark level is set and other current
1444 device settings allows it (e.g. if a trigger is set that samples
1445 data differently that the hardware fifo does then hardware fifo
1447 If the hardware fifo is enabled and the level of the hardware
1448 fifo reaches the hardware fifo watermark level the device will
1449 flush its hardware fifo to the device buffer. Doing a non
1450 blocking read on the device when no samples are present in the
1451 device buffer will also force a flush.
1452 When the hardware fifo is enabled there is no need to use a
1453 trigger to use buffer mode since the watermark settings
1454 guarantees that the hardware fifo is flushed to the device
1457 What: /sys/bus/iio/devices/iio:device*/buffer/hwfifo_timeout
1459 Contact: linux-iio@vger.kernel.org
1461 A read/write property to provide capability to delay reporting of
1462 samples till a timeout is reached. This allows host processors to
1463 sleep, while the sensor is storing samples in its internal fifo.
1464 The maximum timeout in seconds can be specified by setting
1465 hwfifo_timeout.The current delay can be read by reading
1466 hwfifo_timeout. A value of 0 means that there is no timeout.
1468 What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark
1470 Contact: linux-iio@vger.kernel.org
1472 Read-only entry that contains a single integer specifying the
1473 current watermark level for the hardware fifo. If the device
1474 does not have a hardware fifo this entry is not present.
1475 The watermark level for the hardware fifo is set by the driver
1476 based on the value set by the user in buffer/watermark but
1477 taking into account hardware limitations (e.g. most hardware
1478 buffers are limited to 32-64 samples, some hardware buffers
1479 watermarks are fixed or have minimum levels). A value of 0
1480 means that the hardware watermark is unset.
1482 What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_min
1484 Contact: linux-iio@vger.kernel.org
1486 A single positive integer specifying the minimum watermark level
1487 for the hardware fifo of this device. If the device does not
1488 have a hardware fifo this entry is not present.
1489 If the user sets buffer/watermark to a value less than this one,
1490 then the hardware watermark will remain unset.
1492 What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_max
1494 Contact: linux-iio@vger.kernel.org
1496 A single positive integer specifying the maximum watermark level
1497 for the hardware fifo of this device. If the device does not
1498 have a hardware fifo this entry is not present.
1499 If the user sets buffer/watermark to a value greater than this
1500 one, then the hardware watermark will be capped at this value.
1502 What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_available
1504 Contact: linux-iio@vger.kernel.org
1506 A list of positive integers specifying the available watermark
1507 levels for the hardware fifo. This entry is optional and if it
1508 is not present it means that all the values between
1509 hwfifo_watermark_min and hwfifo_watermark_max are supported.
1510 If the user sets buffer/watermark to a value greater than
1511 hwfifo_watermak_min but not equal to any of the values in this
1512 list, the driver will chose an appropriate value for the
1513 hardware fifo watermark level.
1515 What: /sys/bus/iio/devices/iio:deviceX/in_temp_calibemissivity
1516 What: /sys/bus/iio/devices/iio:deviceX/in_tempX_calibemissivity
1517 What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_calibemissivity
1518 What: /sys/bus/iio/devices/iio:deviceX/in_tempX_object_calibemissivity
1520 Contact: linux-iio@vger.kernel.org
1522 The emissivity ratio of the surface in the field of view of the
1523 contactless temperature sensor. Emissivity varies from 0 to 1,
1524 with 1 being the emissivity of a black body.
1526 What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_oversampling_ratio
1527 What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_oversampling_ratio
1528 What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_oversampling_ratio
1530 Contact: linux-iio@vger.kernel.org
1532 Hardware applied number of measurements for acquiring one
1533 data point. The HW will do <type>[_name]_oversampling_ratio
1534 measurements and return the average value as output data. Each
1535 value resulted from <type>[_name]_oversampling_ratio measurements
1536 is considered as one sample for <type>[_name]_sampling_frequency.
1538 What: /sys/bus/iio/devices/iio:deviceX/in_concentration_raw
1539 What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_raw
1540 What: /sys/bus/iio/devices/iio:deviceX/in_concentration_co2_raw
1541 What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_co2_raw
1542 What: /sys/bus/iio/devices/iio:deviceX/in_concentration_voc_raw
1543 What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_voc_raw
1545 Contact: linux-iio@vger.kernel.org
1547 Raw (unscaled no offset etc.) percentage reading of a substance.
1549 What: /sys/bus/iio/devices/iio:deviceX/in_resistance_raw
1550 What: /sys/bus/iio/devices/iio:deviceX/in_resistanceX_raw
1551 What: /sys/bus/iio/devices/iio:deviceX/out_resistance_raw
1552 What: /sys/bus/iio/devices/iio:deviceX/out_resistanceX_raw
1554 Contact: linux-iio@vger.kernel.org
1556 Raw (unscaled no offset etc.) resistance reading that can be processed
1559 What: /sys/bus/iio/devices/iio:deviceX/heater_enable
1560 KernelVersion: 4.1.0
1561 Contact: linux-iio@vger.kernel.org
1563 '1' (enable) or '0' (disable) specifying the enable
1564 of heater function. Same reading values apply
1565 This ABI is especially applicable for humidity sensors
1566 to heatup the device and get rid of any condensation
1567 in some humidity environment
1569 What: /sys/bus/iio/devices/iio:deviceX/in_ph_raw
1571 Contact: linux-iio@vger.kernel.org
1573 Raw (unscaled no offset etc.) pH reading of a substance as a negative
1574 base-10 logarithm of hydrodium ions in a litre of water.
1576 What: /sys/bus/iio/devices/iio:deviceX/mount_matrix
1577 What: /sys/bus/iio/devices/iio:deviceX/in_mount_matrix
1578 What: /sys/bus/iio/devices/iio:deviceX/out_mount_matrix
1579 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_mount_matrix
1580 What: /sys/bus/iio/devices/iio:deviceX/in_accel_mount_matrix
1582 Contact: linux-iio@vger.kernel.org
1584 Mounting matrix for IIO sensors. This is a rotation matrix which
1585 informs userspace about sensor chip's placement relative to the
1586 main hardware it is mounted on.
1587 Main hardware placement is defined according to the local
1588 reference frame related to the physical quantity the sensor
1590 Given that the rotation matrix is defined in a board specific
1591 way (platform data and / or device-tree), the main hardware
1592 reference frame definition is left to the implementor's choice
1593 (see below for a magnetometer example).
1594 Applications should apply this rotation matrix to samples so
1595 that when main hardware reference frame is aligned onto local
1596 reference frame, then sensor chip reference frame is also
1597 perfectly aligned with it.
1598 Matrix is a 3x3 unitary matrix and typically looks like
1599 [0, 1, 0; 1, 0, 0; 0, 0, -1]. Identity matrix
1600 [1, 0, 0; 0, 1, 0; 0, 0, 1] means sensor chip and main hardware
1601 are perfectly aligned with each other.
1603 For example, a mounting matrix for a magnetometer sensor informs
1604 userspace about sensor chip's ORIENTATION relative to the main
1606 More specifically, main hardware orientation is defined with
1607 respect to the LOCAL EARTH GEOMAGNETIC REFERENCE FRAME where :
1608 * Y is in the ground plane and positive towards magnetic North ;
1609 * X is in the ground plane, perpendicular to the North axis and
1610 positive towards the East ;
1611 * Z is perpendicular to the ground plane and positive upwards.
1613 An implementor might consider that for a hand-held device, a
1614 'natural' orientation would be 'front facing camera at the top'.
1615 The main hardware reference frame could then be described as :
1616 * Y is in the plane of the screen and is positive towards the
1618 * X is in the plane of the screen, perpendicular to Y axis, and
1619 positive towards the right hand side of the screen ;
1620 * Z is perpendicular to the screen plane and positive out of the
1622 Another example for a quadrotor UAV might be :
1623 * Y is in the plane of the propellers and positive towards the
1625 * X is in the plane of the propellers, perpendicular to Y axis,
1626 and positive towards the starboard side of the UAV ;
1627 * Z is perpendicular to propellers plane and positive upwards.
1629 What: /sys/bus/iio/devices/iio:deviceX/in_electricalconductivity_raw
1631 Contact: linux-iio@vger.kernel.org
1633 Raw (unscaled no offset etc.) electric conductivity reading that
1634 can be processed to siemens per meter.
1636 What: /sys/bus/iio/devices/iio:deviceX/in_countY_raw
1638 Contact: linux-iio@vger.kernel.org
1640 Raw counter device counts from channel Y. For quadrature
1641 counters, multiplication by an available [Y]_scale results in
1642 the counts of a single quadrature signal phase from channel Y.
1644 What: /sys/bus/iio/devices/iio:deviceX/in_indexY_raw
1646 Contact: linux-iio@vger.kernel.org
1648 Raw counter device index value from channel Y. This attribute
1649 provides an absolute positional reference (e.g. a pulse once per
1650 revolution) which may be used to home positional systems as
1653 What: /sys/bus/iio/devices/iio:deviceX/in_count_count_direction_available
1655 Contact: linux-iio@vger.kernel.org
1657 A list of possible counting directions which are:
1658 - "up" : counter device is increasing.
1659 - "down": counter device is decreasing.
1661 What: /sys/bus/iio/devices/iio:deviceX/in_countY_count_direction
1663 Contact: linux-iio@vger.kernel.org
1665 Raw counter device counters direction for channel Y.