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).
19 Contains trigger type specific elements. These do not
20 generalize well and hence are not documented in this file.
21 X is the IIO index of the trigger.
23 What: /sys/bus/iio/devices/iio:deviceX/buffer
25 Contact: linux-iio@vger.kernel.org
27 Directory of attributes relating to the buffer for the device.
29 What: /sys/bus/iio/devices/iio:deviceX/name
31 Contact: linux-iio@vger.kernel.org
33 Description of the physical chip / device for device X.
34 Typically a part number.
36 What: /sys/bus/iio/devices/iio:deviceX/label
38 Contact: linux-iio@vger.kernel.org
40 Optional symbolic label for a device.
41 This is useful for userspace to be able to better identify an
44 The contents of the label are free-form, but there are some
47 For proximity sensors which give the proximity (of a person) to
48 a certain wlan or wwan antenna the following standardized labels
53 * "proximity-wifi-lte"
54 * "proximity-wifi-left"
55 * "proximity-wifi-right"
57 These are used to indicate to userspace that these proximity
58 sensors may be used to tune transmit power to ensure that
59 Specific Absorption Rate (SAR) limits are honored.
60 The "-left" and "-right" labels are for devices with multiple
63 In some laptops/tablets the standardized proximity sensor labels
64 instead indicate proximity to a specific part of the device:
66 * "proximity-palmrest" indicates proximity to the keyboard's palmrest
67 * "proximity-palmrest-left" indicates proximity to the left part of the palmrest
68 * "proximity-palmrest-right" indicates proximity to the right part of the palmrest
69 * "proximity-lap" indicates the device is being used on someone's lap
71 Note "proximity-lap" is special in that its value may be
72 calculated by firmware from other sensor readings, rather then
73 being a raw sensor reading.
75 For accelerometers used in 2-in-1s with 360° (yoga-style) hinges,
76 which have an accelerometer in both their base and their display,
77 the following standardized labels are used:
82 For devices where an accelerometer is housed in the swivel camera subassembly
83 (for AR application), the following standardized label is used:
87 What: /sys/bus/iio/devices/iio:deviceX/current_timestamp_clock
89 Contact: linux-iio@vger.kernel.org
91 String identifying current posix clock used to timestamp
92 buffered samples and events for device X.
94 What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency
95 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_sampling_frequency
96 What: /sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency
97 What: /sys/bus/iio/devices/triggerX/sampling_frequency
99 Contact: linux-iio@vger.kernel.org
101 Some devices have internal clocks. This parameter sets the
102 resulting sampling frequency. In many devices this
103 parameter has an effect on input filters etc. rather than
104 simply controlling when the input is sampled. As this
105 affects data ready triggers, hardware buffers and the sysfs
106 direct access interfaces, it may be found in any of the
107 relevant directories. If it affects all of the above
108 then it is to be found in the base device directory.
110 The stm32-timer-trigger has the additional characteristic that
111 a sampling_frequency of 0 is defined to stop sampling.
113 What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency_available
114 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_sampling_frequency_available
115 What: /sys/bus/iio/devices/iio:deviceX/in_proximity_sampling_frequency_available
116 What: /sys/.../iio:deviceX/buffer/sampling_frequency_available
117 What: /sys/bus/iio/devices/triggerX/sampling_frequency_available
118 KernelVersion: 2.6.35
119 Contact: linux-iio@vger.kernel.org
121 When the internal sampling clock can only take a specific set of
122 frequencies, we can specify the available values with:
124 - a small discrete set of values like "0 2 4 6 8"
125 - a range with minimum, step and maximum frequencies like
128 What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio
129 KernelVersion: 2.6.38
130 Contact: linux-iio@vger.kernel.org
132 Hardware dependent ADC oversampling. Controls the sampling ratio
133 of the digital filter if available.
135 What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available
136 KernelVersion: 2.6.38
137 Contact: linux-iio@vger.kernel.org
139 Hardware dependent values supported by the oversampling filter.
141 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
142 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
143 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_raw
144 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_raw
145 KernelVersion: 2.6.35
146 Contact: linux-iio@vger.kernel.org
148 Raw (unscaled no bias removal etc.) voltage measurement from
149 channel Y. In special cases where the channel does not
150 correspond to externally available input one of the named
151 versions may be used. The number must always be specified and
152 unique to allow association with event codes. Units after
153 application of scale and offset are millivolts.
155 Channels with 'i' and 'q' modifiers always exist in pairs and both
156 channels refer to the same signal. The 'i' channel contains the in-phase
157 component of the signal while the 'q' channel contains the quadrature
160 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw
161 KernelVersion: 2.6.35
162 Contact: linux-iio@vger.kernel.org
164 Raw (unscaled) differential voltage measurement equivalent to
165 channel Y - channel Z where these channel numbers apply to the
166 physically equivalent inputs when non differential readings are
167 separately available. In differential only parts, then all that
168 is required is a consistent labeling. Units after application
169 of scale and offset are millivolts.
171 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_raw
172 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_raw
174 Contact: linux-iio@vger.kernel.org
176 Raw (unscaled no bias removal etc.) current measurement from
177 channel Y. In special cases where the channel does not
178 correspond to externally available input one of the named
179 versions may be used. The number must always be specified and
180 unique to allow association with event codes. Units after
181 application of scale and offset are milliamps.
183 What: /sys/bus/iio/devices/iio:deviceX/in_powerY_raw
185 Contact: linux-iio@vger.kernel.org
187 Raw (unscaled no bias removal etc.) power measurement from
188 channel Y. The number must always be specified and
189 unique to allow association with event codes. Units after
190 application of scale and offset are milliwatts.
192 What: /sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw
194 Contact: linux-iio@vger.kernel.org
196 Raw capacitance measurement from channel Y. Units after
197 application of scale and offset are nanofarads.
199 What: /sys/.../iio:deviceX/in_capacitanceY-capacitanceZ_raw
201 Contact: linux-iio@vger.kernel.org
203 Raw differential capacitance measurement equivalent to
204 channel Y - channel Z where these channel numbers apply to the
205 physically equivalent inputs when non differential readings are
206 separately available. In differential only parts, then all that
207 is required is a consistent labeling. Units after application
208 of scale and offset are nanofarads.
210 What: /sys/.../iio:deviceX/in_capacitanceY-capacitanceZ_zeropoint
212 Contact: linux-iio@vger.kernel.org
214 For differential channels, this an offset that is applied
215 equally to both inputs. As the reading is of the difference
216 between the two inputs, this should not be applied to the _raw
217 reading by userspace (unlike _offset) and unlike calibbias
218 it does not affect the differential value measured because
219 the effect of _zeropoint cancels out across the two inputs
220 that make up the differential pair. It's purpose is to bring
221 the individual signals, before the differential is measured,
222 within the measurement range of the device. The naming is
223 chosen because if the separate inputs that make the
224 differential pair are drawn on a graph in their
225 _raw units, this is the value that the zero point on the
226 measurement axis represents. It is expressed with the
227 same scaling as _raw.
229 What: /sys/bus/iio/devices/iio:deviceX/in_temp_raw
230 What: /sys/bus/iio/devices/iio:deviceX/in_tempX_raw
231 What: /sys/bus/iio/devices/iio:deviceX/in_temp_x_raw
232 What: /sys/bus/iio/devices/iio:deviceX/in_temp_y_raw
233 What: /sys/bus/iio/devices/iio:deviceX/in_temp_ambient_raw
234 What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_raw
235 KernelVersion: 2.6.35
236 Contact: linux-iio@vger.kernel.org
238 Raw (unscaled no bias removal etc.) temperature measurement.
239 If an axis is specified it generally means that the temperature
240 sensor is associated with one part of a compound device (e.g.
241 a gyroscope axis). The ambient and object modifiers distinguish
242 between ambient (reference) and distant temperature for contact-
243 less measurements. Units after application of scale and offset
244 are milli degrees Celsius.
246 What: /sys/bus/iio/devices/iio:deviceX/in_tempY_input
247 What: /sys/bus/iio/devices/iio:deviceX/in_temp_input
248 KernelVersion: 2.6.38
249 Contact: linux-iio@vger.kernel.org
251 Scaled temperature measurement in milli degrees Celsius.
253 What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw
254 What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_raw
255 What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_raw
256 KernelVersion: 2.6.35
257 Contact: linux-iio@vger.kernel.org
259 Acceleration in direction x, y or z (may be arbitrarily assigned
260 but should match other such assignments on device).
261 Has all of the equivalent parameters as per voltageY. Units
262 after application of scale and offset are m/s^2.
264 What: /sys/bus/iio/devices/iio:deviceX/in_accel_linear_x_raw
265 What: /sys/bus/iio/devices/iio:deviceX/in_accel_linear_y_raw
266 What: /sys/bus/iio/devices/iio:deviceX/in_accel_linear_z_raw
268 Contact: linux-iio@vger.kernel.org
270 As per in_accel_X_raw attributes, but minus the
271 acceleration due to gravity.
273 What: /sys/bus/iio/devices/iio:deviceX/in_gravity_x_raw
274 What: /sys/bus/iio/devices/iio:deviceX/in_gravity_y_raw
275 What: /sys/bus/iio/devices/iio:deviceX/in_gravity_z_raw
277 Contact: linux-iio@vger.kernel.org
279 Gravity in direction x, y or z (may be arbitrarily assigned
280 but should match other such assignments on device).
281 Units after application of scale and offset are m/s^2.
283 What: /sys/bus/iio/devices/iio:deviceX/in_deltaangl_x_raw
284 What: /sys/bus/iio/devices/iio:deviceX/in_deltaangl_y_raw
285 What: /sys/bus/iio/devices/iio:deviceX/in_deltaangl_z_raw
287 Contact: linux-iio@vger.kernel.org
289 Angular displacement between two consecutive samples on x, y or
290 z (may be arbitrarily assigned but should match other such
291 assignments on device).
292 In order to compute the total angular displacement during a
293 desired period of time, the application should sum-up the delta
294 angle samples acquired during that time.
295 Units after application of scale and offset are radians.
297 What: /sys/bus/iio/devices/iio:deviceX/in_deltavelocity_x_raw
298 What: /sys/bus/iio/devices/iio:deviceX/in_deltavelocity_y_raw
299 What: /sys/bus/iio/devices/iio:deviceX/in_deltavelocity_z_raw
301 Contact: linux-iio@vger.kernel.org
303 The linear velocity change between two consecutive samples on x,
304 y or z (may be arbitrarily assigned but should match other such
305 assignments on device).
306 In order to compute the total linear velocity change during a
307 desired period of time, the application should sum-up the delta
308 velocity samples acquired during that time.
309 Units after application of scale and offset are meters per
312 What: /sys/bus/iio/devices/iio:deviceX/in_angl_raw
313 What: /sys/bus/iio/devices/iio:deviceX/in_anglY_raw
315 Contact: linux-iio@vger.kernel.org
317 Angle of rotation. Units after application of scale and offset
320 What: /sys/bus/iio/devices/iio:deviceX/in_positionrelative_x_raw
321 What: /sys/bus/iio/devices/iio:deviceX/in_positionrelative_y_raw
323 Contact: linux-iio@vger.kernel.org
325 Relative position in direction x or y on a pad (may be
326 arbitrarily assigned but should match other such assignments on
328 Units after application of scale and offset are milli percents
329 from the pad's size in both directions. Should be calibrated by
332 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw
333 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw
334 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw
335 KernelVersion: 2.6.35
336 Contact: linux-iio@vger.kernel.org
338 Angular velocity about axis x, y or z (may be arbitrarily
339 assigned). Has all the equivalent parameters as per voltageY.
340 Units after application of scale and offset are radians per
343 What: /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
344 What: /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
345 What: /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
346 KernelVersion: 2.6.35
347 Contact: linux-iio@vger.kernel.org
349 Inclination raw reading about axis x, y or z (may be
350 arbitrarily assigned). Data converted by application of offset
351 and scale to degrees.
353 What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
354 What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
355 What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
356 KernelVersion: 2.6.35
357 Contact: linux-iio@vger.kernel.org
359 Magnetic field along axis x, y or z (may be arbitrarily
360 assigned). Data converted by application of offset
363 What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
364 What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
365 What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
366 What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_peak_raw
367 What: /sys/bus/iio/devices/iio:deviceX/in_temp_peak_raw
368 KernelVersion: 2.6.36
369 Contact: linux-iio@vger.kernel.org
371 Highest value since some reset condition. These
372 attributes allow access to this and are otherwise
373 the direct equivalent of the <type>Y[_name]_raw attributes.
375 What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_trough_raw
376 What: /sys/bus/iio/devices/iio:deviceX/in_temp_trough_raw
378 Contact: linux-iio@vger.kernel.org
380 Lowest value since some reset condition. These
381 attributes allow access to this and are otherwise
382 the direct equivalent of the <type>Y[_name]_raw attributes.
384 What: /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
385 KernelVersion: 2.6.36
386 Contact: linux-iio@vger.kernel.org
388 A computed peak value based on the sum squared magnitude of
389 the underlying value in the specified directions.
391 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_raw
392 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_raw
394 Contact: linux-iio@vger.kernel.org
396 Raw pressure measurement from channel Y. Units after
397 application of scale and offset are kilopascal.
399 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_input
400 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_input
402 Contact: linux-iio@vger.kernel.org
404 Scaled pressure measurement from channel Y, in kilopascal.
406 What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_raw
408 Contact: linux-iio@vger.kernel.org
410 Raw humidity measurement of air. Units after application of
411 scale and offset are milli percent.
413 What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_input
415 Contact: linux-iio@vger.kernel.org
417 Scaled humidity measurement in milli percent.
419 What: /sys/bus/iio/devices/iio:deviceX/in_X_mean_raw
421 Contact: linux-iio@vger.kernel.org
423 Averaged raw measurement from channel X. The number of values
424 used for averaging is device specific. The converting rules for
425 normal raw values also applies to the averaged raw values.
427 What: /sys/bus/iio/devices/iio:deviceX/in_accel_offset
428 What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
429 What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
430 What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
431 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
432 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
433 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_offset
434 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_offset
435 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_offset
436 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_offset
437 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_offset
438 What: /sys/bus/iio/devices/iio:deviceX/in_current_offset
439 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_offset
440 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_offset
441 What: /sys/bus/iio/devices/iio:deviceX/in_current_q_offset
442 What: /sys/bus/iio/devices/iio:deviceX/in_current_i_offset
443 What: /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
444 What: /sys/bus/iio/devices/iio:deviceX/in_temp_offset
445 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_offset
446 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_offset
447 What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_offset
448 What: /sys/bus/iio/devices/iio:deviceX/in_magn_offset
449 What: /sys/bus/iio/devices/iio:deviceX/in_rot_offset
450 What: /sys/bus/iio/devices/iio:deviceX/in_angl_offset
451 What: /sys/bus/iio/devices/iio:deviceX/in_capacitanceX_offset
452 KernelVersion: 2.6.35
453 Contact: linux-iio@vger.kernel.org
455 If known for a device, offset to be added to <type>[Y]_raw prior
456 to scaling by <type>[Y]_scale in order to obtain value in the
457 <type> units as specified in <type>[Y]_raw documentation.
458 Not present if the offset is always 0 or unknown. If Y or
459 axis <x|y|z> is not present, then the offset applies to all
460 in channels of <type>.
461 May be writable if a variable offset can be applied on the
462 device. Note that this is different to calibbias which
463 is for devices (or drivers) that apply offsets to compensate
464 for variation between different instances of the part, typically
465 adjusted by using some hardware supported calibration procedure.
466 Calibbias is applied internally, offset is applied in userspace
469 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
470 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_scale
471 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_scale
472 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
473 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
474 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_scale
475 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_scale
476 What: /sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_scale
477 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
478 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale
479 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_scale
480 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_scale
481 What: /sys/bus/iio/devices/iio:deviceX/in_current_scale
482 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_scale
483 What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_scale
484 What: /sys/bus/iio/devices/iio:deviceX/in_current_i_scale
485 What: /sys/bus/iio/devices/iio:deviceX/in_current_q_scale
486 What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale
487 What: /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
488 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale
489 What: /sys/bus/iio/devices/iio:deviceX/in_energy_scale
490 What: /sys/bus/iio/devices/iio:deviceX/in_distance_scale
491 What: /sys/bus/iio/devices/iio:deviceX/in_magn_scale
492 What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
493 What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
494 What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
495 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_scale
496 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_scale
497 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_scale
498 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_scale
499 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_scale
500 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_scale
501 What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_scale
502 What: /sys/bus/iio/devices/iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_scale
503 What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_scale
504 What: /sys/bus/iio/devices/iio:deviceX/in_countY_scale
505 What: /sys/bus/iio/devices/iio:deviceX/in_deltaangl_scale
506 What: /sys/bus/iio/devices/iio:deviceX/in_deltavelocity_scale
507 What: /sys/bus/iio/devices/iio:deviceX/in_angl_scale
508 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_x_scale
509 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_y_scale
510 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_z_scale
511 What: /sys/bus/iio/devices/iio:deviceX/in_concentration_co2_scale
512 KernelVersion: 2.6.35
513 Contact: linux-iio@vger.kernel.org
515 If known for a device, scale to be applied to <type>Y[_name]_raw
516 post addition of <type>[Y][_name]_offset in order to obtain the
517 measured value in <type> units as specified in
518 <type>[Y][_name]_raw documentation. If shared across all in
519 channels then Y and <x|y|z> are not present and the value is
520 called <type>[Y][_name]_scale. The peak modifier means this
521 value is applied to <type>Y[_name]_peak_raw values.
523 What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
524 What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
525 What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
526 What: /sys/bus/iio/devices/iio:deviceX/in_altvoltageY_i_calibbias
527 What: /sys/bus/iio/devices/iio:deviceX/in_altvoltageY_q_calibbias
528 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias
529 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
530 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
531 What: /sys/bus/iio/devices/iio:deviceX/in_capacitance_calibbias
532 What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_calibbias
533 What: /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
534 What: /sys/bus/iio/devices/iio:deviceX/in_intensityY_calibbias
535 What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_calibbias
536 What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_calibbias
537 What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_calibbias
538 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibbias
539 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibbias
540 What: /sys/bus/iio/devices/iio:deviceX/in_proximity_calibbias
541 What: /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
542 What: /sys/bus/iio/devices/iio:deviceX/in_resistance_calibbias
543 What: /sys/bus/iio/devices/iio:deviceX/in_temp_calibbias
544 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibbias
545 What: /sys/bus/iio/devices/iio:deviceX/out_currentY_calibbias
546 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_calibbias
547 KernelVersion: 2.6.35
548 Contact: linux-iio@vger.kernel.org
550 Hardware applied calibration offset (assumed to fix production
552 icm42600: For this device values are real physical offsets
553 expressed in SI units (m/s^2 for accelerometers and rad/s
556 What: /sys/bus/iio/devices/iio:deviceX/in_accel_calibbias_available
557 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_calibbias_available
558 What: /sys/bus/iio/devices/iio:deviceX/in_temp_calibbias_available
559 What: /sys/bus/iio/devices/iio:deviceX/in_proximity_calibbias_available
560 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibbias_available
561 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_calibbias_available
563 Contact: linux-iio@vger.kernel.org
565 Available values of calibbias. Maybe expressed as either of:
567 - a small discrete set of values like "0 2 4 6 8"
568 - a range specified as "[min step max]"
570 What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
571 What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
572 What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
573 What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage_calibscale
574 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
575 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
576 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
577 What: /sys/bus/iio/devices/iio:deviceX/in_capacitance_calibscale
578 What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_calibscale
579 What: /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
580 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_both_calibscale
581 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_calibscale
582 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_ir_calibscale
583 What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_calibscale
584 What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_calibscale
585 What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_calibscale
586 What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibscale
587 What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibscale
588 What: /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
589 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
590 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_calibscale
591 What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_calibscale
592 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
593 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_calibscale
594 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_calibscale
595 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
596 What: /sys/bus/iio/devices/iio:deviceX/out_currentY_calibscale
597 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_calibscale
598 KernelVersion: 2.6.35
599 Contact: linux-iio@vger.kernel.org
601 Hardware applied calibration scale factor (assumed to fix
602 production inaccuracies). If shared across all channels,
603 <type>_calibscale is used.
605 What: /sys/bus/iio/devices/iio:deviceX/in_illuminanceY_calibscale_available
606 What: /sys/bus/iio/devices/iio:deviceX/in_intensityY_calibscale_available
607 What: /sys/bus/iio/devices/iio:deviceX/in_proximityY_calibscale_available
608 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale_available
610 Contact: linux-iio@vger.kernel.org
612 Available values of calibscale. Maybe expressed as either of:
614 - a small discrete set of values like "1 8 16"
615 - a range specified as "[min step max]"
617 If shared across all channels, <type>_calibscale_available is used.
619 What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender
620 What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender
621 What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender
622 What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender
624 Contact: linux-iio@vger.kernel.org
626 Gender of the user (e.g.: male, female) used by some pedometers
627 to compute the stride length, distance, speed and activity
630 What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender_available
631 What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender_available
632 What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender_available
633 What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender_available
635 Contact: linux-iio@vger.kernel.org
637 Lists all available gender values (e.g.: male, female).
639 What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibheight
640 What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibheight
641 What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibheight
642 What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibheight
644 Contact: linux-iio@vger.kernel.org
646 Height of the user (in meters) used by some pedometers
647 to compute the stride length, distance, speed and activity
650 What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibweight
652 Contact: linux-iio@vger.kernel.org
654 Weight of the user (in kg). It is needed by some pedometers
655 to compute the calories burnt by the user.
657 What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
658 What: /sys/.../iio:deviceX/in_anglvel_scale_available
659 What: /sys/.../iio:deviceX/in_magn_scale_available
660 What: /sys/.../iio:deviceX/in_illuminance_scale_available
661 What: /sys/.../iio:deviceX/in_intensity_scale_available
662 What: /sys/.../iio:deviceX/in_proximity_scale_available
663 What: /sys/.../iio:deviceX/in_voltageX_scale_available
664 What: /sys/.../iio:deviceX/in_voltage-voltage_scale_available
665 What: /sys/.../iio:deviceX/out_voltageX_scale_available
666 What: /sys/.../iio:deviceX/out_altvoltageX_scale_available
667 What: /sys/.../iio:deviceX/in_capacitance_scale_available
668 What: /sys/.../iio:deviceX/in_pressure_scale_available
669 What: /sys/.../iio:deviceX/in_pressureY_scale_available
670 KernelVersion: 2.6.35
671 Contact: linux-iio@vger.kernel.org
673 If a discrete set of scale values is available, they
674 are listed in this attribute. Unlike illumination,
675 multiplying intensity by intensity_scale does not
676 yield value with any standardized unit.
678 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
679 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_hardwaregain
680 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_red_hardwaregain
681 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_green_hardwaregain
682 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_blue_hardwaregain
683 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_clear_hardwaregain
684 KernelVersion: 2.6.35
685 Contact: linux-iio@vger.kernel.org
687 Hardware applied gain factor. If shared across all channels,
688 <type>_hardwaregain is used.
690 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_hardwaregain_available
692 Contact: linux-iio@vger.kernel.org
694 Lists all available hardware applied gain factors. Shared across all
697 What: /sys/.../in_accel_filter_low_pass_3db_frequency
698 What: /sys/.../in_magn_filter_low_pass_3db_frequency
699 What: /sys/.../in_anglvel_filter_low_pass_3db_frequency
701 Contact: linux-iio@vger.kernel.org
703 If a known or controllable low pass filter is applied
704 to the underlying data channel, then this parameter
705 gives the 3dB frequency of the filter in Hz.
707 What: /sys/.../in_accel_filter_high_pass_3db_frequency
708 What: /sys/.../in_anglvel_filter_high_pass_3db_frequency
709 What: /sys/.../in_magn_filter_high_pass_3db_frequency
711 Contact: linux-iio@vger.kernel.org
713 If a known or controllable high pass filter is applied
714 to the underlying data channel, then this parameter
715 gives the 3dB frequency of the filter in Hz.
717 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
718 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw
719 KernelVersion: 2.6.37
720 Contact: linux-iio@vger.kernel.org
722 Raw (unscaled, no bias etc.) output voltage for
723 channel Y. The number must always be specified and
724 unique if the output corresponds to a single channel.
725 While DAC like devices typically use out_voltage,
726 a continuous frequency generating device, such as
727 a DDS or PLL should use out_altvoltage.
729 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
730 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw
731 KernelVersion: 2.6.37
732 Contact: linux-iio@vger.kernel.org
734 Raw (unscaled, no bias etc.) output voltage for an aggregate of
735 channel Y, channel Z, etc. This interface is available in cases
736 where a single output sets the value for multiple channels
739 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
740 What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
741 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode
742 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode
743 KernelVersion: 2.6.38
744 Contact: linux-iio@vger.kernel.org
746 Specifies the output powerdown mode.
747 DAC output stage is disconnected from the amplifier and
748 1kohm_to_gnd: connected to ground via an 1kOhm resistor,
749 2.5kohm_to_gnd: connected to ground via a 2.5kOhm resistor,
750 6kohm_to_gnd: connected to ground via a 6kOhm resistor,
751 20kohm_to_gnd: connected to ground via a 20kOhm resistor,
752 42kohm_to_gnd: connected to ground via a 42kOhm resistor,
753 90kohm_to_gnd: connected to ground via a 90kOhm resistor,
754 100kohm_to_gnd: connected to ground via an 100kOhm resistor,
755 125kohm_to_gnd: connected to ground via an 125kOhm resistor,
756 500kohm_to_gnd: connected to ground via a 500kOhm resistor,
757 640kohm_to_gnd: connected to ground via a 640kOhm resistor,
758 three_state: left floating.
759 For a list of available output power down options read
760 outX_powerdown_mode_available. If Y is not present the
761 mode is shared across all outputs.
763 What: /sys/.../iio:deviceX/out_voltageY_powerdown_mode_available
764 What: /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
765 What: /sys/.../iio:deviceX/out_altvoltageY_powerdown_mode_available
766 What: /sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available
767 KernelVersion: 2.6.38
768 Contact: linux-iio@vger.kernel.org
770 Lists all available output power down modes.
771 If Y is not present the mode is shared across all outputs.
773 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
774 What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
775 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
776 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown
777 KernelVersion: 2.6.38
778 Contact: linux-iio@vger.kernel.org
780 Writing 1 causes output Y to enter the power down mode specified
781 by the corresponding outY_powerdown_mode. DAC output stage is
782 disconnected from the amplifier. Clearing returns to normal
783 operation. Y may be suppressed if all outputs are controlled
786 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency
788 Contact: linux-iio@vger.kernel.org
790 Output frequency for channel Y in Hz. The number must always be
791 specified and unique if the output corresponds to a single
793 Some drivers have additional constraints:
794 ADF4371 has an integrated VCO with fundamendal output
795 frequency ranging from 4000000000 Hz 8000000000 Hz.
797 out_altvoltage0_frequency:
798 A divide by 1, 2, 4, 8, 16, 32 or circuit generates
799 frequencies from 62500000 Hz to 8000000000 Hz.
800 out_altvoltage1_frequency:
801 This channel duplicates the channel 0 frequency
802 out_altvoltage2_frequency:
803 A frequency doubler generates frequencies from
804 8000000000 Hz to 16000000000 Hz.
805 out_altvoltage3_frequency:
806 A frequency quadrupler generates frequencies from
807 16000000000 Hz to 32000000000 Hz.
809 Note: writes to one of the channels will affect the frequency of
810 all the other channels, since it involves changing the VCO
811 fundamental output frequency.
813 What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase
815 Contact: linux-iio@vger.kernel.org
817 Phase in radians of one frequency/clock output Y
818 (out_altvoltageY) relative to another frequency/clock output
819 (out_altvoltageZ) of the device X. The number must always be
820 specified and unique if the output corresponds to a single
823 What: /sys/bus/iio/devices/iio:deviceX/out_currentY_raw
826 Contact: Johan Hovold <jhovold@gmail.com>
828 Set/get output current for channel Y. Units after application
829 of scale and offset are milliamps.
830 For some devices current channels are used to specify
831 current supplied to elements used in taking a measurement
832 of a different type. E.g. LED currents.
834 What: /sys/bus/iio/devices/iio:deviceX/events
835 KernelVersion: 2.6.35
836 Contact: linux-iio@vger.kernel.org
838 Configuration of which hardware generated events are passed up
841 What: /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
842 What: /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
843 What: /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
844 What: /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
845 What: /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
846 What: /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
847 What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
848 What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
849 What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
850 What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
851 What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
852 What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
853 What: /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
854 What: /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
855 What: /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
856 What: /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
857 What: /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
858 What: /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
859 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_rising_en
860 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_falling_en
861 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_rising_en
862 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_falling_en
863 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_en
864 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_en
865 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_rising_en
866 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_falling_en
867 What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
868 What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
869 What: /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
870 What: /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
871 What: /sys/.../iio:deviceX/events/in_voltageY_thresh_either_en
872 What: /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
873 What: /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
874 What: /sys/.../iio:deviceX/events/in_capacitanceY_thresh_rising_en
875 What: /sys/.../iio:deviceX/events/in_capacitanceY_thresh_falling_en
876 KernelVersion: 2.6.37
877 Contact: linux-iio@vger.kernel.org
879 Event generated when channel passes a threshold in the specified
880 (_rising|_falling) direction. If the direction is not specified,
881 then either the device will report an event which ever direction
882 a single threshold value is passed in (e.g.
883 <type>[Y][_name]_<raw|input>_thresh_value) or
884 <type>[Y][_name]_<raw|input>_thresh_rising_value and
885 <type>[Y][_name]_<raw|input>_thresh_falling_value may take
886 different values, but the device can only enable both thresholds
889 Note the driver will assume the last p events requested are
890 to be enabled where p is how many it supports (which may vary
891 depending on the exact set requested. So if you want to be
892 sure you have set what you think you have, check the contents of
893 these attributes after everything is configured. Drivers may
894 have to buffer any parameters so that they are consistent when
895 a given event type is enabled at a future point (and not those for
896 whatever event was previously enabled).
898 What: /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
899 What: /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
900 What: /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
901 What: /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
902 What: /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
903 What: /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
904 What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
905 What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
906 What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
907 What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
908 What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
909 What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
910 What: /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
911 What: /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
912 What: /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
913 What: /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
914 What: /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
915 What: /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
916 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_rising_en
917 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_falling_en
918 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_rising_en
919 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_falling_en
920 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_rising_en
921 What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_falling_en
922 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_rising_en
923 What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_falling_en
924 What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
925 What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
926 What: /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
927 What: /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
928 What: /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
929 What: /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
930 KernelVersion: 2.6.37
931 Contact: linux-iio@vger.kernel.org
933 Event generated when channel passes a threshold on the rate of
934 change (1st differential) in the specified (_rising|_falling)
935 direction. If the direction is not specified, then either the
936 device will report an event which ever direction a single
937 threshold value is passed in (e.g.
938 <type>[Y][_name]_<raw|input>_roc_value) or
939 <type>[Y][_name]_<raw|input>_roc_rising_value and
940 <type>[Y][_name]_<raw|input>_roc_falling_value may take
941 different values, but the device can only enable both rate of
942 change thresholds or neither.
944 Note the driver will assume the last p events requested are
945 to be enabled where p is however many it supports (which may
946 vary depending on the exact set requested. So if you want to be
947 sure you have set what you think you have, check the contents of
948 these attributes after everything is configured. Drivers may
949 have to buffer any parameters so that they are consistent when
950 a given event type is enabled a future point (and not those for
951 whatever event was previously enabled).
953 What: /sys/.../events/in_capacitanceY_adaptive_thresh_rising_en
954 What: /sys/.../events/in_capacitanceY_adaptive_thresh_falling_en
956 Contact: linux-iio@vger.kernel.org
958 Adaptive thresholds are similar to normal fixed thresholds
959 but the value is expressed as an offset from a value which
960 provides a low frequency approximation of the channel itself.
961 Thus these detect if a rapid change occurs in the specified
962 direction which crosses tracking value + offset.
963 Tracking value calculation is devices specific.
965 What: /sys/.../in_capacitanceY_adaptive_thresh_rising_timeout
966 What: /sys/.../in_capacitanceY_adaptive_thresh_falling_timeout
968 Contact: linux-iio@vger.kernel.org
970 When adaptive thresholds are used, the tracking signal
971 may adjust too slowly to step changes in the raw signal.
972 Thus these specify the time in seconds for which the
973 difference between the slow tracking signal and the raw
974 signal is allowed to remain out-of-range before a reset
975 event occurs in which the tracking signal is made equal
976 to the raw signal, allowing slow tracking to resume and the
977 adaptive threshold event detection to function as expected.
979 What: /sys/.../events/in_accel_thresh_rising_value
980 What: /sys/.../events/in_accel_thresh_falling_value
981 What: /sys/.../events/in_accel_x_raw_thresh_rising_value
982 What: /sys/.../events/in_accel_x_raw_thresh_falling_value
983 What: /sys/.../events/in_accel_y_raw_thresh_rising_value
984 What: /sys/.../events/in_accel_y_raw_thresh_falling_value
985 What: /sys/.../events/in_accel_z_raw_thresh_rising_value
986 What: /sys/.../events/in_accel_z_raw_thresh_falling_value
987 What: /sys/.../events/in_anglvel_x_raw_thresh_rising_value
988 What: /sys/.../events/in_anglvel_x_raw_thresh_falling_value
989 What: /sys/.../events/in_anglvel_y_raw_thresh_rising_value
990 What: /sys/.../events/in_anglvel_y_raw_thresh_falling_value
991 What: /sys/.../events/in_anglvel_z_raw_thresh_rising_value
992 What: /sys/.../events/in_anglvel_z_raw_thresh_falling_value
993 What: /sys/.../events/in_magn_x_raw_thresh_rising_value
994 What: /sys/.../events/in_magn_x_raw_thresh_falling_value
995 What: /sys/.../events/in_magn_y_raw_thresh_rising_value
996 What: /sys/.../events/in_magn_y_raw_thresh_falling_value
997 What: /sys/.../events/in_magn_z_raw_thresh_rising_value
998 What: /sys/.../events/in_magn_z_raw_thresh_falling_value
999 What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_rising_value
1000 What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_falling_value
1001 What: /sys/.../events/in_rot_from_north_true_raw_thresh_rising_value
1002 What: /sys/.../events/in_rot_from_north_true_raw_thresh_falling_value
1003 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_rising_value
1004 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_falling_value
1005 What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_rising_value
1006 What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_falling_value
1007 What: /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
1008 What: /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
1009 What: /sys/.../events/in_voltageY_raw_thresh_rising_value
1010 What: /sys/.../events/in_voltageY_raw_thresh_falling_value
1011 What: /sys/.../events/in_tempY_raw_thresh_rising_value
1012 What: /sys/.../events/in_tempY_raw_thresh_falling_value
1013 What: /sys/.../events/in_illuminance0_thresh_falling_value
1014 What: /sys/.../events/in_illuminance0_thresh_rising_value
1015 What: /sys/.../events/in_proximity0_thresh_falling_value
1016 What: /sys/.../events/in_proximity0_thresh_rising_value
1017 What: /sys/.../events/in_illuminance_thresh_rising_value
1018 What: /sys/.../events/in_illuminance_thresh_falling_value
1019 What: /sys/.../events/in_capacitanceY_thresh_rising_value
1020 What: /sys/.../events/in_capacitanceY_thresh_falling_value
1021 What: /sys/.../events/in_capacitanceY_thresh_adaptive_rising_value
1022 What: /sys/.../events/in_capacitanceY_thresh_falling_rising_value
1023 KernelVersion: 2.6.37
1024 Contact: linux-iio@vger.kernel.org
1026 Specifies the value of threshold that the device is comparing
1027 against for the events enabled by
1028 <type>Y[_name]_thresh[_rising|falling]_en.
1030 If separate attributes exist for the two directions, but
1031 direction is not specified for this attribute, then a single
1032 threshold value applies to both directions.
1034 The raw or input element of the name indicates whether the
1035 value is in raw device units or in processed units (as _raw
1036 and _input do on sysfs direct channel read attributes).
1038 What: /sys/.../events/in_accel_scale
1039 What: /sys/.../events/in_accel_peak_scale
1040 What: /sys/.../events/in_anglvel_scale
1041 What: /sys/.../events/in_magn_scale
1042 What: /sys/.../events/in_rot_from_north_magnetic_scale
1043 What: /sys/.../events/in_rot_from_north_true_scale
1044 What: /sys/.../events/in_voltage_scale
1045 What: /sys/.../events/in_voltage_supply_scale
1046 What: /sys/.../events/in_temp_scale
1047 What: /sys/.../events/in_illuminance_scale
1048 What: /sys/.../events/in_proximity_scale
1050 Contact: linux-iio@vger.kernel.org
1052 Specifies the conversion factor from the standard units
1053 to device specific units used to set the event trigger
1056 What: /sys/.../events/in_accel_x_thresh_rising_hysteresis
1057 What: /sys/.../events/in_accel_x_thresh_falling_hysteresis
1058 What: /sys/.../events/in_accel_x_thresh_either_hysteresis
1059 What: /sys/.../events/in_accel_y_thresh_rising_hysteresis
1060 What: /sys/.../events/in_accel_y_thresh_falling_hysteresis
1061 What: /sys/.../events/in_accel_y_thresh_either_hysteresis
1062 What: /sys/.../events/in_accel_z_thresh_rising_hysteresis
1063 What: /sys/.../events/in_accel_z_thresh_falling_hysteresis
1064 What: /sys/.../events/in_accel_z_thresh_either_hysteresis
1065 What: /sys/.../events/in_anglvel_x_thresh_rising_hysteresis
1066 What: /sys/.../events/in_anglvel_x_thresh_falling_hysteresis
1067 What: /sys/.../events/in_anglvel_x_thresh_either_hysteresis
1068 What: /sys/.../events/in_anglvel_y_thresh_rising_hysteresis
1069 What: /sys/.../events/in_anglvel_y_thresh_falling_hysteresis
1070 What: /sys/.../events/in_anglvel_y_thresh_either_hysteresis
1071 What: /sys/.../events/in_anglvel_z_thresh_rising_hysteresis
1072 What: /sys/.../events/in_anglvel_z_thresh_falling_hysteresis
1073 What: /sys/.../events/in_anglvel_z_thresh_either_hysteresis
1074 What: /sys/.../events/in_magn_x_thresh_rising_hysteresis
1075 What: /sys/.../events/in_magn_x_thresh_falling_hysteresis
1076 What: /sys/.../events/in_magn_x_thresh_either_hysteresis
1077 What: /sys/.../events/in_magn_y_thresh_rising_hysteresis
1078 What: /sys/.../events/in_magn_y_thresh_falling_hysteresis
1079 What: /sys/.../events/in_magn_y_thresh_either_hysteresis
1080 What: /sys/.../events/in_magn_z_thresh_rising_hysteresis
1081 What: /sys/.../events/in_magn_z_thresh_falling_hysteresis
1082 What: /sys/.../events/in_magn_z_thresh_either_hysteresis
1083 What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_hysteresis
1084 What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_hysteresis
1085 What: /sys/.../events/in_rot_from_north_magnetic_thresh_either_hysteresis
1086 What: /sys/.../events/in_rot_from_north_true_thresh_rising_hysteresis
1087 What: /sys/.../events/in_rot_from_north_true_thresh_falling_hysteresis
1088 What: /sys/.../events/in_rot_from_north_true_thresh_either_hysteresis
1089 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_hysteresis
1090 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_hysteresis
1091 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_either_hysteresis
1092 What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_hysteresis
1093 What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_hysteresis
1094 What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_either_hysteresis
1095 What: /sys/.../events/in_voltageY_thresh_rising_hysteresis
1096 What: /sys/.../events/in_voltageY_thresh_falling_hysteresis
1097 What: /sys/.../events/in_voltageY_thresh_either_hysteresis
1098 What: /sys/.../events/in_tempY_thresh_rising_hysteresis
1099 What: /sys/.../events/in_tempY_thresh_falling_hysteresis
1100 What: /sys/.../events/in_tempY_thresh_either_hysteresis
1101 What: /sys/.../events/in_illuminance0_thresh_falling_hysteresis
1102 What: /sys/.../events/in_illuminance0_thresh_rising_hysteresis
1103 What: /sys/.../events/in_illuminance0_thresh_either_hysteresis
1104 What: /sys/.../events/in_proximity0_thresh_falling_hysteresis
1105 What: /sys/.../events/in_proximity0_thresh_rising_hysteresis
1106 What: /sys/.../events/in_proximity0_thresh_either_hysteresis
1108 Contact: linux-iio@vger.kernel.org
1110 Specifies the hysteresis of threshold that the device is comparing
1111 against for the events enabled by
1112 <type>Y[_name]_thresh[_(rising|falling)]_hysteresis.
1113 If separate attributes exist for the two directions, but
1114 direction is not specified for this attribute, then a single
1115 hysteresis value applies to both directions.
1117 For falling events the hysteresis is added to the _value attribute for
1118 this event to get the upper threshold for when the event goes back to
1119 normal, for rising events the hysteresis is subtracted from the _value
1120 attribute. E.g. if in_voltage0_raw_thresh_rising_value is set to 1200
1121 and in_voltage0_raw_thresh_rising_hysteresis is set to 50. The event
1122 will get activated once in_voltage0_raw goes above 1200 and will become
1123 deactivated again once the value falls below 1150.
1125 What: /sys/.../events/in_accel_x_raw_roc_rising_value
1126 What: /sys/.../events/in_accel_x_raw_roc_falling_value
1127 What: /sys/.../events/in_accel_y_raw_roc_rising_value
1128 What: /sys/.../events/in_accel_y_raw_roc_falling_value
1129 What: /sys/.../events/in_accel_z_raw_roc_rising_value
1130 What: /sys/.../events/in_accel_z_raw_roc_falling_value
1131 What: /sys/.../events/in_anglvel_x_raw_roc_rising_value
1132 What: /sys/.../events/in_anglvel_x_raw_roc_falling_value
1133 What: /sys/.../events/in_anglvel_y_raw_roc_rising_value
1134 What: /sys/.../events/in_anglvel_y_raw_roc_falling_value
1135 What: /sys/.../events/in_anglvel_z_raw_roc_rising_value
1136 What: /sys/.../events/in_anglvel_z_raw_roc_falling_value
1137 What: /sys/.../events/in_magn_x_raw_roc_rising_value
1138 What: /sys/.../events/in_magn_x_raw_roc_falling_value
1139 What: /sys/.../events/in_magn_y_raw_roc_rising_value
1140 What: /sys/.../events/in_magn_y_raw_roc_falling_value
1141 What: /sys/.../events/in_magn_z_raw_roc_rising_value
1142 What: /sys/.../events/in_magn_z_raw_roc_falling_value
1143 What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_rising_value
1144 What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_falling_value
1145 What: /sys/.../events/in_rot_from_north_true_raw_roc_rising_value
1146 What: /sys/.../events/in_rot_from_north_true_raw_roc_falling_value
1147 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_rising_value
1148 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_falling_value
1149 What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_rising_value
1150 What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_falling_value
1151 What: /sys/.../events/in_voltageY_supply_raw_roc_rising_value
1152 What: /sys/.../events/in_voltageY_supply_raw_roc_falling_value
1153 What: /sys/.../events/in_voltageY_raw_roc_rising_value
1154 What: /sys/.../events/in_voltageY_raw_roc_falling_value
1155 What: /sys/.../events/in_tempY_raw_roc_rising_value
1156 What: /sys/.../events/in_tempY_raw_roc_falling_value
1157 KernelVersion: 2.6.37
1158 Contact: linux-iio@vger.kernel.org
1160 Specifies the value of rate of change threshold that the
1161 device is comparing against for the events enabled by
1162 <type>[Y][_name]_roc[_rising|falling]_en.
1164 If separate attributes exist for the two directions,
1165 but direction is not specified for this attribute,
1166 then a single threshold value applies to both directions.
1167 The raw or input element of the name indicates whether the
1168 value is in raw device units or in processed units (as _raw
1169 and _input do on sysfs direct channel read attributes).
1171 What: /sys/.../events/in_accel_x_thresh_rising_period
1172 What: /sys/.../events/in_accel_x_thresh_falling_period
1173 What: /sys/.../events/in_accel_x_roc_rising_period
1174 What: /sys/.../events/in_accel_x_roc_falling_period
1175 What: /sys/.../events/in_accel_y_thresh_rising_period
1176 What: /sys/.../events/in_accel_y_thresh_falling_period
1177 What: /sys/.../events/in_accel_y_roc_rising_period
1178 What: /sys/.../events/in_accel_y_roc_falling_period
1179 What: /sys/.../events/in_accel_z_thresh_rising_period
1180 What: /sys/.../events/in_accel_z_thresh_falling_period
1181 What: /sys/.../events/in_accel_z_roc_rising_period
1182 What: /sys/.../events/in_accel_z_roc_falling_period
1183 What: /sys/.../events/in_anglvel_x_thresh_rising_period
1184 What: /sys/.../events/in_anglvel_x_thresh_falling_period
1185 What: /sys/.../events/in_anglvel_x_roc_rising_period
1186 What: /sys/.../events/in_anglvel_x_roc_falling_period
1187 What: /sys/.../events/in_anglvel_y_thresh_rising_period
1188 What: /sys/.../events/in_anglvel_y_thresh_falling_period
1189 What: /sys/.../events/in_anglvel_y_roc_rising_period
1190 What: /sys/.../events/in_anglvel_y_roc_falling_period
1191 What: /sys/.../events/in_anglvel_z_thresh_rising_period
1192 What: /sys/.../events/in_anglvel_z_thresh_falling_period
1193 What: /sys/.../events/in_anglvel_z_roc_rising_period
1194 What: /sys/.../events/in_anglvel_z_roc_falling_period
1195 What: /sys/.../events/in_magn_x_thresh_rising_period
1196 What: /sys/.../events/in_magn_x_thresh_falling_period
1197 What: /sys/.../events/in_magn_x_roc_rising_period
1198 What: /sys/.../events/in_magn_x_roc_falling_period
1199 What: /sys/.../events/in_magn_y_thresh_rising_period
1200 What: /sys/.../events/in_magn_y_thresh_falling_period
1201 What: /sys/.../events/in_magn_y_roc_rising_period
1202 What: /sys/.../events/in_magn_y_roc_falling_period
1203 What: /sys/.../events/in_magn_z_thresh_rising_period
1204 What: /sys/.../events/in_magn_z_thresh_falling_period
1205 What: /sys/.../events/in_magn_z_roc_rising_period
1206 What: /sys/.../events/in_magn_z_roc_falling_period
1207 What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_period
1208 What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_period
1209 What: /sys/.../events/in_rot_from_north_magnetic_roc_rising_period
1210 What: /sys/.../events/in_rot_from_north_magnetic_roc_falling_period
1211 What: /sys/.../events/in_rot_from_north_true_thresh_rising_period
1212 What: /sys/.../events/in_rot_from_north_true_thresh_falling_period
1213 What: /sys/.../events/in_rot_from_north_true_roc_rising_period
1214 What: /sys/.../events/in_rot_from_north_true_roc_falling_period
1215 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_period
1216 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_period
1217 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_rising_period
1218 What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_falling_period
1219 What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_period
1220 What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_period
1221 What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_rising_period
1222 What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_falling_period
1223 What: /sys/.../events/in_voltageY_supply_thresh_rising_period
1224 What: /sys/.../events/in_voltageY_supply_thresh_falling_period
1225 What: /sys/.../events/in_voltageY_supply_roc_rising_period
1226 What: /sys/.../events/in_voltageY_supply_roc_falling_period
1227 What: /sys/.../events/in_voltageY_thresh_rising_period
1228 What: /sys/.../events/in_voltageY_thresh_falling_period
1229 What: /sys/.../events/in_voltageY_roc_rising_period
1230 What: /sys/.../events/in_voltageY_roc_falling_period
1231 What: /sys/.../events/in_tempY_thresh_rising_period
1232 What: /sys/.../events/in_tempY_thresh_falling_period
1233 What: /sys/.../events/in_tempY_roc_rising_period
1234 What: /sys/.../events/in_tempY_roc_falling_period
1235 What: /sys/.../events/in_accel_x&y&z_mag_falling_period
1236 What: /sys/.../events/in_intensity0_thresh_period
1237 What: /sys/.../events/in_proximity0_thresh_period
1238 What: /sys/.../events/in_activity_still_thresh_rising_period
1239 What: /sys/.../events/in_activity_still_thresh_falling_period
1240 What: /sys/.../events/in_activity_walking_thresh_rising_period
1241 What: /sys/.../events/in_activity_walking_thresh_falling_period
1242 What: /sys/.../events/in_activity_jogging_thresh_rising_period
1243 What: /sys/.../events/in_activity_jogging_thresh_falling_period
1244 What: /sys/.../events/in_activity_running_thresh_rising_period
1245 What: /sys/.../events/in_activity_running_thresh_falling_period
1246 What: /sys/.../events/in_illuminance_thresh_either_period
1247 KernelVersion: 2.6.37
1248 Contact: linux-iio@vger.kernel.org
1250 Period of time (in seconds) for which the condition must be
1251 met before an event is generated. If direction is not
1252 specified then this period applies to both directions.
1254 What: /sys/.../events/in_accel_thresh_rising_low_pass_filter_3db
1255 What: /sys/.../events/in_anglvel_thresh_rising_low_pass_filter_3db
1256 What: /sys/.../events/in_magn_thresh_rising_low_pass_filter_3db
1258 Contact: linux-iio@vger.kernel.org
1260 If a low pass filter can be applied to the event generation
1261 this property gives its 3db frequency in Hz.
1262 A value of zero disables the filter.
1264 What: /sys/.../events/in_accel_thresh_rising_high_pass_filter_3db
1265 What: /sys/.../events/in_anglvel_thresh_rising_high_pass_filter_3db
1266 What: /sys/.../events/in_magn_thresh_rising_high_pass_filter_3db
1268 Contact: linux-iio@vger.kernel.org
1270 If a high pass filter can be applied to the event generation
1271 this property gives its 3db frequency in Hz.
1272 A value of zero disables the filter.
1274 What: /sys/.../events/in_activity_still_thresh_rising_en
1275 What: /sys/.../events/in_activity_still_thresh_falling_en
1276 What: /sys/.../events/in_activity_walking_thresh_rising_en
1277 What: /sys/.../events/in_activity_walking_thresh_falling_en
1278 What: /sys/.../events/in_activity_jogging_thresh_rising_en
1279 What: /sys/.../events/in_activity_jogging_thresh_falling_en
1280 What: /sys/.../events/in_activity_running_thresh_rising_en
1281 What: /sys/.../events/in_activity_running_thresh_falling_en
1283 Contact: linux-iio@vger.kernel.org
1285 Enables or disables activity events. Depending on direction
1286 an event is generated when sensor ENTERS or LEAVES a given state.
1288 What: /sys/.../events/in_activity_still_thresh_rising_value
1289 What: /sys/.../events/in_activity_still_thresh_falling_value
1290 What: /sys/.../events/in_activity_walking_thresh_rising_value
1291 What: /sys/.../events/in_activity_walking_thresh_falling_value
1292 What: /sys/.../events/in_activity_jogging_thresh_rising_value
1293 What: /sys/.../events/in_activity_jogging_thresh_falling_value
1294 What: /sys/.../events/in_activity_running_thresh_rising_value
1295 What: /sys/.../events/in_activity_running_thresh_falling_value
1297 Contact: linux-iio@vger.kernel.org
1299 Confidence value (in units as percentage) to be used
1300 for deciding when an event should be generated. E.g for
1301 running: If the confidence value reported by the sensor
1302 is greater than in_activity_running_thresh_rising_value
1303 then the sensor ENTERS running state. Conversely, if the
1304 confidence value reported by the sensor is lower than
1305 in_activity_running_thresh_falling_value then the sensor
1306 is LEAVING running state.
1308 What: /sys/.../iio:deviceX/events/in_accel_mag_en
1309 What: /sys/.../iio:deviceX/events/in_accel_mag_rising_en
1310 What: /sys/.../iio:deviceX/events/in_accel_mag_falling_en
1311 What: /sys/.../iio:deviceX/events/in_accel_x_mag_en
1312 What: /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
1313 What: /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
1314 What: /sys/.../iio:deviceX/events/in_accel_y_mag_en
1315 What: /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
1316 What: /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
1317 What: /sys/.../iio:deviceX/events/in_accel_z_mag_en
1318 What: /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
1319 What: /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
1320 What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
1321 What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
1322 KernelVersion: 2.6.37
1323 Contact: linux-iio@vger.kernel.org
1325 Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
1326 magnitude of the channel is compared to the threshold, not its
1329 What: /sys/.../events/in_accel_raw_mag_value
1330 What: /sys/.../events/in_accel_x_raw_mag_rising_value
1331 What: /sys/.../events/in_accel_y_raw_mag_rising_value
1332 What: /sys/.../events/in_accel_z_raw_mag_rising_value
1333 KernelVersion: 2.6.37
1334 Contact: linux-iio@vger.kernel.org
1336 The value to which the magnitude of the channel is compared. If
1337 number or direction is not specified, applies to all channels of
1340 What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_en
1341 What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_rising_en
1342 What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_falling_en
1343 What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_en
1344 What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_rising_en
1345 What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_falling_en
1347 Contact: linux-iio@vger.kernel.org
1349 Similar to in_accel_mag[_y][_rising|_falling]_en, but the event
1350 value is relative to a reference magnitude. The reference magnitude
1351 includes the graviational acceleration.
1353 What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_value
1354 What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_rising_value
1355 What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_falling_value
1356 What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_value
1357 What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_rising_value
1358 What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_falling_value
1360 Contact: linux-iio@vger.kernel.org
1362 The value to which the reference magnitude of the channel is
1363 compared. If the axis is not specified, it applies to all channels
1366 What: /sys/.../events/in_steps_change_en
1368 Contact: linux-iio@vger.kernel.org
1370 Event generated when channel passes a threshold on the absolute
1371 change in value. E.g. for steps: a step change event is
1372 generated each time the user takes N steps, where N is set using
1373 in_steps_change_value.
1375 What: /sys/.../events/in_steps_change_value
1377 Contact: linux-iio@vger.kernel.org
1379 Specifies the value of change threshold that the
1380 device is comparing against for the events enabled by
1381 <type>[Y][_name]_roc[_rising|falling|]_en. E.g. for steps:
1382 if set to 3, a step change event will be generated every 3
1385 What: /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
1386 KernelVersion: 2.6.35
1387 Contact: linux-iio@vger.kernel.org
1389 The name of the trigger source being used, as per string given
1390 in /sys/class/iio/triggerY/name.
1392 What: /sys/bus/iio/devices/iio:deviceX/bufferY/length
1394 Contact: linux-iio@vger.kernel.org
1396 Number of scans contained by the buffer.
1398 What: /sys/bus/iio/devices/iio:deviceX/bufferY/enable
1400 Contact: linux-iio@vger.kernel.org
1402 Actually start the buffer capture up. Will start trigger
1403 if first device and appropriate.
1405 Note that it might be impossible to configure other attributes,
1406 (e.g.: events, scale, sampling rate) if they impact the currently
1407 active buffer capture session.
1409 What: /sys/bus/iio/devices/iio:deviceX/bufferY
1411 Contact: linux-iio@vger.kernel.org
1413 Directory containing interfaces for elements that will be
1414 captured for a single triggered sample set in the buffer.
1416 Since kernel 5.11 the scan_elements attributes are merged into
1417 the bufferY directory, to be configurable per buffer.
1419 What: /sys/.../iio:deviceX/bufferY/in_accel_x_en
1420 What: /sys/.../iio:deviceX/bufferY/in_accel_y_en
1421 What: /sys/.../iio:deviceX/bufferY/in_accel_z_en
1422 What: /sys/.../iio:deviceX/bufferY/in_deltaangl_x_en
1423 What: /sys/.../iio:deviceX/bufferY/in_deltaangl_y_en
1424 What: /sys/.../iio:deviceX/bufferY/in_deltaangl_z_en
1425 What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_x_en
1426 What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_y_en
1427 What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_z_en
1428 What: /sys/.../iio:deviceX/bufferY/in_anglvel_x_en
1429 What: /sys/.../iio:deviceX/bufferY/in_anglvel_y_en
1430 What: /sys/.../iio:deviceX/bufferY/in_anglvel_z_en
1431 What: /sys/.../iio:deviceX/bufferY/in_magn_x_en
1432 What: /sys/.../iio:deviceX/bufferY/in_magn_y_en
1433 What: /sys/.../iio:deviceX/bufferY/in_magn_z_en
1434 What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_en
1435 What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_en
1436 What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_tilt_comp_en
1437 What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_tilt_comp_en
1438 What: /sys/.../iio:deviceX/bufferY/in_timestamp_en
1439 What: /sys/.../iio:deviceX/bufferY/in_voltageY_supply_en
1440 What: /sys/.../iio:deviceX/bufferY/in_voltageY_en
1441 What: /sys/.../iio:deviceX/bufferY/in_voltageY-voltageZ_en
1442 What: /sys/.../iio:deviceX/bufferY/in_voltageY_i_en
1443 What: /sys/.../iio:deviceX/bufferY/in_voltageY_q_en
1444 What: /sys/.../iio:deviceX/bufferY/in_voltage_i_en
1445 What: /sys/.../iio:deviceX/bufferY/in_voltage_q_en
1446 What: /sys/.../iio:deviceX/bufferY/in_incli_x_en
1447 What: /sys/.../iio:deviceX/bufferY/in_incli_y_en
1448 What: /sys/.../iio:deviceX/bufferY/in_pressureY_en
1449 What: /sys/.../iio:deviceX/bufferY/in_pressure_en
1450 What: /sys/.../iio:deviceX/bufferY/in_rot_quaternion_en
1451 What: /sys/.../iio:deviceX/bufferY/in_proximity_en
1453 Contact: linux-iio@vger.kernel.org
1455 Scan element control for triggered data capture.
1457 What: /sys/.../iio:deviceX/bufferY/in_accel_type
1458 What: /sys/.../iio:deviceX/bufferY/in_deltaangl_type
1459 What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_type
1460 What: /sys/.../iio:deviceX/bufferY/in_anglvel_type
1461 What: /sys/.../iio:deviceX/bufferY/in_magn_type
1462 What: /sys/.../iio:deviceX/bufferY/in_incli_type
1463 What: /sys/.../iio:deviceX/bufferY/in_voltageY_type
1464 What: /sys/.../iio:deviceX/bufferY/in_voltage_type
1465 What: /sys/.../iio:deviceX/bufferY/in_voltageY_supply_type
1466 What: /sys/.../iio:deviceX/bufferY/in_voltageY_i_type
1467 What: /sys/.../iio:deviceX/bufferY/in_voltageY_q_type
1468 What: /sys/.../iio:deviceX/bufferY/in_voltage_i_type
1469 What: /sys/.../iio:deviceX/bufferY/in_voltage_q_type
1470 What: /sys/.../iio:deviceX/bufferY/in_timestamp_type
1471 What: /sys/.../iio:deviceX/bufferY/in_pressureY_type
1472 What: /sys/.../iio:deviceX/bufferY/in_pressure_type
1473 What: /sys/.../iio:deviceX/bufferY/in_rot_quaternion_type
1474 What: /sys/.../iio:deviceX/bufferY/in_proximity_type
1476 Contact: linux-iio@vger.kernel.org
1478 Description of the scan element data storage within the buffer
1479 and hence the form in which it is read from user-space.
1480 Form is [be|le]:[s|u]bits/storagebits[>>shift].
1481 be or le specifies big or little endian. s or u specifies if
1482 signed (2's complement) or unsigned. bits is the number of bits
1483 of data and storagebits is the space (after padding) that it
1484 occupies in the buffer. shift if specified, is the shift that
1485 needs to be applied prior to masking out unused bits. Some
1486 devices put their data in the middle of the transferred elements
1487 with additional information on both sides. Note that some
1488 devices will have additional information in the unused bits
1489 so to get a clean value, the bits value must be used to mask
1490 the buffer output value appropriately. The storagebits value
1491 also specifies the data alignment. So s48/64>>2 will be a
1492 signed 48 bit integer stored in a 64 bit location aligned to
1493 a 64 bit boundary. To obtain the clean value, shift right 2
1494 and apply a mask to zero the top 16 bits of the result.
1495 For other storage combinations this attribute will be extended
1498 What: /sys/.../iio:deviceX/scan_elements/in_accel_type_available
1499 KernelVersion: 2.6.37
1500 Contact: linux-iio@vger.kernel.org
1502 If the type parameter can take one of a small set of values,
1503 this attribute lists them.
1505 What: /sys/.../iio:deviceX/bufferY/in_voltageY_index
1506 What: /sys/.../iio:deviceX/bufferY/in_voltageY_supply_index
1507 What: /sys/.../iio:deviceX/bufferY/in_voltageY_i_index
1508 What: /sys/.../iio:deviceX/bufferY/in_voltageY_q_index
1509 What: /sys/.../iio:deviceX/bufferY/in_voltage_i_index
1510 What: /sys/.../iio:deviceX/bufferY/in_voltage_q_index
1511 What: /sys/.../iio:deviceX/bufferY/in_accel_x_index
1512 What: /sys/.../iio:deviceX/bufferY/in_accel_y_index
1513 What: /sys/.../iio:deviceX/bufferY/in_accel_z_index
1514 What: /sys/.../iio:deviceX/bufferY/in_deltaangl_x_index
1515 What: /sys/.../iio:deviceX/bufferY/in_deltaangl_y_index
1516 What: /sys/.../iio:deviceX/bufferY/in_deltaangl_z_index
1517 What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_x_index
1518 What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_y_index
1519 What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_z_index
1520 What: /sys/.../iio:deviceX/bufferY/in_anglvel_x_index
1521 What: /sys/.../iio:deviceX/bufferY/in_anglvel_y_index
1522 What: /sys/.../iio:deviceX/bufferY/in_anglvel_z_index
1523 What: /sys/.../iio:deviceX/bufferY/in_magn_x_index
1524 What: /sys/.../iio:deviceX/bufferY/in_magn_y_index
1525 What: /sys/.../iio:deviceX/bufferY/in_magn_z_index
1526 What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_index
1527 What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_index
1528 What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_tilt_comp_index
1529 What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_tilt_comp_index
1530 What: /sys/.../iio:deviceX/bufferY/in_incli_x_index
1531 What: /sys/.../iio:deviceX/bufferY/in_incli_y_index
1532 What: /sys/.../iio:deviceX/bufferY/in_timestamp_index
1533 What: /sys/.../iio:deviceX/bufferY/in_pressureY_index
1534 What: /sys/.../iio:deviceX/bufferY/in_pressure_index
1535 What: /sys/.../iio:deviceX/bufferY/in_rot_quaternion_index
1536 What: /sys/.../iio:deviceX/bufferY/in_proximity_index
1538 Contact: linux-iio@vger.kernel.org
1540 A single positive integer specifying the position of this
1541 scan element in the buffer. Note these are not dependent on
1542 what is enabled and may not be contiguous. Thus for user-space
1543 to establish the full layout these must be used in conjunction
1544 with all _en attributes to establish which channels are present,
1545 and the relevant _type attributes to establish the data storage
1548 What: /sys/.../iio:deviceX/in_activity_still_input
1549 What: /sys/.../iio:deviceX/in_activity_walking_input
1550 What: /sys/.../iio:deviceX/in_activity_jogging_input
1551 What: /sys/.../iio:deviceX/in_activity_running_input
1553 Contact: linux-iio@vger.kernel.org
1555 This attribute is used to read the confidence for an activity
1556 expressed in units as percentage.
1558 What: /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
1559 KernelVersion: 2.6.38
1560 Contact: linux-iio@vger.kernel.org
1562 This attribute is used to read the amount of quadrature error
1563 present in the device at a given time.
1565 What: /sys/.../iio:deviceX/in_accelX_power_mode
1567 Contact: linux-iio@vger.kernel.org
1569 Specifies the chip power mode.
1570 low_noise: reduce noise level from ADC,
1571 low_power: enable low current consumption.
1572 For a list of available output power modes read
1573 in_accel_power_mode_available.
1575 What: /sys/.../iio:deviceX/in_energy_input
1576 What: /sys/.../iio:deviceX/in_energy_raw
1578 Contact: linux-iio@vger.kernel.org
1580 This attribute is used to read the energy value reported by the
1581 device (e.g.: human activity sensors report energy burnt by the
1582 user). Units after application of scale are Joules.
1584 What: /sys/.../iio:deviceX/in_distance_input
1585 What: /sys/.../iio:deviceX/in_distance_raw
1587 Contact: linux-iio@vger.kernel.org
1589 This attribute is used to read the measured distance to an object
1590 or the distance covered by the user since the last reboot while
1591 activated. Units after application of scale are meters.
1593 What: /sys/bus/iio/devices/iio:deviceX/store_eeprom
1594 KernelVersion: 3.4.0
1595 Contact: linux-iio@vger.kernel.org
1597 Writing '1' stores the current device configuration into
1598 on-chip EEPROM. After power-up or chip reset the device will
1599 automatically load the saved configuration.
1601 What: /sys/.../iio:deviceX/in_proximity_raw
1602 What: /sys/.../iio:deviceX/in_proximity_input
1603 What: /sys/.../iio:deviceX/in_proximityY_raw
1605 Contact: linux-iio@vger.kernel.org
1607 Proximity measurement indicating that some
1608 object is near the sensor, usually by observing
1609 reflectivity of infrared or ultrasound emitted.
1611 Often these sensors are unit less and as such conversion
1612 to SI units is not possible. Higher proximity measurements
1613 indicate closer objects, and vice versa. Units after
1614 application of scale and offset are meters.
1616 What: /sys/.../iio:deviceX/in_illuminance_input
1617 What: /sys/.../iio:deviceX/in_illuminance_raw
1618 What: /sys/.../iio:deviceX/in_illuminanceY_input
1619 What: /sys/.../iio:deviceX/in_illuminanceY_raw
1620 What: /sys/.../iio:deviceX/in_illuminanceY_mean_raw
1621 What: /sys/.../iio:deviceX/in_illuminance_ir_raw
1622 What: /sys/.../iio:deviceX/in_illuminance_clear_raw
1624 Contact: linux-iio@vger.kernel.org
1626 Illuminance measurement, units after application of scale
1629 What: /sys/.../iio:deviceX/in_intensityY_raw
1630 What: /sys/.../iio:deviceX/in_intensityY_ir_raw
1631 What: /sys/.../iio:deviceX/in_intensityY_both_raw
1632 What: /sys/.../iio:deviceX/in_intensityY_uv_raw
1633 What: /sys/.../iio:deviceX/in_intensityY_uva_raw
1634 What: /sys/.../iio:deviceX/in_intensityY_uvb_raw
1635 What: /sys/.../iio:deviceX/in_intensityY_duv_raw
1637 Contact: linux-iio@vger.kernel.org
1639 Unit-less light intensity. Modifiers both and ir indicate
1640 that measurements contain visible and infrared light
1641 components or just infrared light, respectively. Modifier
1642 uv indicates that measurements contain ultraviolet light
1643 components. Modifiers uva, uvb and duv indicate that
1644 measurements contain A, B or deep (C) ultraviolet light
1645 components respectively.
1647 What: /sys/.../iio:deviceX/in_uvindex_input
1649 Contact: linux-iio@vger.kernel.org
1651 UV light intensity index measuring the human skin's response to
1652 different wavelength of sunlight weighted according to the
1653 standardised CIE Erythemal Action Spectrum. UV index values range
1654 from 0 (low) to >=11 (extreme).
1656 What: /sys/.../iio:deviceX/in_intensity_integration_time
1657 What: /sys/.../iio:deviceX/in_intensity_red_integration_time
1658 What: /sys/.../iio:deviceX/in_intensity_green_integration_time
1659 What: /sys/.../iio:deviceX/in_intensity_blue_integration_time
1660 What: /sys/.../iio:deviceX/in_intensity_clear_integration_time
1661 What: /sys/.../iio:deviceX/in_illuminance_integration_time
1663 Contact: linux-iio@vger.kernel.org
1665 This attribute is used to get/set the integration time in
1666 seconds. If shared across all channels of a given type,
1667 <type>_integration_time is used.
1669 What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_integration_time
1671 Contact: linux-iio@vger.kernel.org
1673 Number of seconds in which to compute speed.
1675 What: /sys/bus/iio/devices/iio:deviceX/in_rot_quaternion_raw
1677 Contact: linux-iio@vger.kernel.org
1679 Raw value of quaternion components using a format
1680 x y z w. Here x, y, and z component represents the axis about
1681 which a rotation will occur and w component represents the
1684 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_raw
1685 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_raw
1686 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_raw
1687 What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_raw
1689 Contact: linux-iio@vger.kernel.org
1691 Raw value of rotation from true/magnetic north measured with
1692 or without compensation from tilt sensors.
1694 What: /sys/bus/iio/devices/iio:deviceX/in_currentX_raw
1695 What: /sys/bus/iio/devices/iio:deviceX/in_currentX_i_raw
1696 What: /sys/bus/iio/devices/iio:deviceX/in_currentX_q_raw
1698 Contact: linux-iio@vger.kernel.org
1700 Raw current measurement from channel X. Units are in milliamps
1701 after application of scale and offset. If no offset or scale is
1702 present, output should be considered as processed with the
1705 Channels with 'i' and 'q' modifiers always exist in pairs and both
1706 channels refer to the same signal. The 'i' channel contains the in-phase
1707 component of the signal while the 'q' channel contains the quadrature
1710 What: /sys/.../iio:deviceX/in_energy_en
1711 What: /sys/.../iio:deviceX/in_distance_en
1712 What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_en
1713 What: /sys/.../iio:deviceX/in_steps_en
1715 Contact: linux-iio@vger.kernel.org
1717 Activates a device feature that runs in firmware/hardware.
1718 E.g. for steps: the pedometer saves power while not used;
1719 when activated, it will count the steps taken by the user in
1720 firmware and export them through in_steps_input.
1722 What: /sys/.../iio:deviceX/in_steps_input
1724 Contact: linux-iio@vger.kernel.org
1726 This attribute is used to read the number of steps taken by the user
1727 since the last reboot while activated.
1729 What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_input
1730 What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_raw
1732 Contact: linux-iio@vger.kernel.org
1734 This attribute is used to read the current speed value of the
1735 user (which is the norm or magnitude of the velocity vector).
1736 Units after application of scale are m/s.
1738 What: /sys/.../iio:deviceX/in_steps_debounce_count
1740 Contact: linux-iio@vger.kernel.org
1742 Specifies the number of steps that must occur within
1743 in_steps_filter_debounce_time for the pedometer to decide the
1744 consumer is making steps.
1746 What: /sys/.../iio:deviceX/in_steps_debounce_time
1748 Contact: linux-iio@vger.kernel.org
1750 Specifies number of seconds in which we compute the steps
1751 that occur in order to decide if the consumer is making steps.
1753 What: /sys/bus/iio/devices/iio:deviceX/bufferY/watermark
1755 Contact: linux-iio@vger.kernel.org
1757 A single positive integer specifying the maximum number of scan
1758 elements to wait for.
1760 Poll will block until the watermark is reached.
1762 Blocking read will wait until the minimum between the requested
1763 read amount or the low water mark is available.
1765 Non-blocking read will retrieve the available samples from the
1766 buffer even if there are less samples then watermark level. This
1767 allows the application to block on poll with a timeout and read
1768 the available samples after the timeout expires and thus have a
1769 maximum delay guarantee.
1771 What: /sys/bus/iio/devices/iio:deviceX/bufferY/data_available
1773 Contact: linux-iio@vger.kernel.org
1775 A read-only value indicating the bytes of data available in the
1776 buffer. In the case of an output buffer, this indicates the
1777 amount of empty space available to write data to. In the case of
1778 an input buffer, this indicates the amount of data available for
1781 What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_enabled
1783 Contact: linux-iio@vger.kernel.org
1785 A read-only boolean value that indicates if the hardware fifo is
1786 currently enabled or disabled. If the device does not have a
1787 hardware fifo this entry is not present.
1788 The hardware fifo is enabled when the buffer is enabled if the
1789 current hardware fifo watermark level is set and other current
1790 device settings allows it (e.g. if a trigger is set that samples
1791 data differently that the hardware fifo does then hardware fifo
1794 If the hardware fifo is enabled and the level of the hardware
1795 fifo reaches the hardware fifo watermark level the device will
1796 flush its hardware fifo to the device buffer. Doing a non
1797 blocking read on the device when no samples are present in the
1798 device buffer will also force a flush.
1800 When the hardware fifo is enabled there is no need to use a
1801 trigger to use buffer mode since the watermark settings
1802 guarantees that the hardware fifo is flushed to the device
1805 What: /sys/bus/iio/devices/iio:device*/buffer/hwfifo_timeout
1807 Contact: linux-iio@vger.kernel.org
1809 A read/write property to provide capability to delay reporting of
1810 samples till a timeout is reached. This allows host processors to
1811 sleep, while the sensor is storing samples in its internal fifo.
1812 The maximum timeout in seconds can be specified by setting
1813 hwfifo_timeout.The current delay can be read by reading
1814 hwfifo_timeout. A value of 0 means that there is no timeout.
1816 What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark
1818 Contact: linux-iio@vger.kernel.org
1820 Read-only entry that contains a single integer specifying the
1821 current watermark level for the hardware fifo. If the device
1822 does not have a hardware fifo this entry is not present.
1823 The watermark level for the hardware fifo is set by the driver
1824 based on the value set by the user in buffer/watermark but
1825 taking into account hardware limitations (e.g. most hardware
1826 buffers are limited to 32-64 samples, some hardware buffers
1827 watermarks are fixed or have minimum levels). A value of 0
1828 means that the hardware watermark is unset.
1830 What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_min
1832 Contact: linux-iio@vger.kernel.org
1834 A single positive integer specifying the minimum watermark level
1835 for the hardware fifo of this device. If the device does not
1836 have a hardware fifo this entry is not present.
1838 If the user sets buffer/watermark to a value less than this one,
1839 then the hardware watermark will remain unset.
1841 What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_max
1843 Contact: linux-iio@vger.kernel.org
1845 A single positive integer specifying the maximum watermark level
1846 for the hardware fifo of this device. If the device does not
1847 have a hardware fifo this entry is not present.
1849 If the user sets buffer/watermark to a value greater than this
1850 one, then the hardware watermark will be capped at this value.
1852 What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_available
1854 Contact: linux-iio@vger.kernel.org
1856 A list of positive integers specifying the available watermark
1857 levels for the hardware fifo. This entry is optional and if it
1858 is not present it means that all the values between
1859 hwfifo_watermark_min and hwfifo_watermark_max are supported.
1861 If the user sets buffer/watermark to a value greater than
1862 hwfifo_watermak_min but not equal to any of the values in this
1863 list, the driver will chose an appropriate value for the
1864 hardware fifo watermark level.
1866 What: /sys/bus/iio/devices/iio:deviceX/in_temp_calibemissivity
1867 What: /sys/bus/iio/devices/iio:deviceX/in_tempX_calibemissivity
1868 What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_calibemissivity
1869 What: /sys/bus/iio/devices/iio:deviceX/in_tempX_object_calibemissivity
1871 Contact: linux-iio@vger.kernel.org
1873 The emissivity ratio of the surface in the field of view of the
1874 contactless temperature sensor. Emissivity varies from 0 to 1,
1875 with 1 being the emissivity of a black body.
1877 What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_oversampling_ratio
1878 What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_oversampling_ratio
1879 What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_oversampling_ratio
1881 Contact: linux-iio@vger.kernel.org
1883 Hardware applied number of measurements for acquiring one
1884 data point. The HW will do <type>[_name]_oversampling_ratio
1885 measurements and return the average value as output data. Each
1886 value resulted from <type>[_name]_oversampling_ratio measurements
1887 is considered as one sample for <type>[_name]_sampling_frequency.
1889 What: /sys/bus/iio/devices/iio:deviceX/in_concentration_raw
1890 What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_raw
1891 What: /sys/bus/iio/devices/iio:deviceX/in_concentration_co2_raw
1892 What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_co2_raw
1893 What: /sys/bus/iio/devices/iio:deviceX/in_concentration_ethanol_raw
1894 What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_ethanol_raw
1895 What: /sys/bus/iio/devices/iio:deviceX/in_concentration_h2_raw
1896 What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_h2_raw
1897 What: /sys/bus/iio/devices/iio:deviceX/in_concentration_o2_raw
1898 What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_o2_raw
1899 What: /sys/bus/iio/devices/iio:deviceX/in_concentration_voc_raw
1900 What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_voc_raw
1902 Contact: linux-iio@vger.kernel.org
1904 Raw (unscaled no offset etc.) reading of a substance. Units
1905 after application of scale and offset are percents.
1907 What: /sys/bus/iio/devices/iio:deviceX/in_resistance_raw
1908 What: /sys/bus/iio/devices/iio:deviceX/in_resistanceX_raw
1909 What: /sys/bus/iio/devices/iio:deviceX/out_resistance_raw
1910 What: /sys/bus/iio/devices/iio:deviceX/out_resistanceX_raw
1912 Contact: linux-iio@vger.kernel.org
1914 Raw (unscaled no offset etc.) resistance reading.
1915 Units after application of scale and offset are ohms.
1917 What: /sys/bus/iio/devices/iio:deviceX/heater_enable
1918 KernelVersion: 4.1.0
1919 Contact: linux-iio@vger.kernel.org
1921 '1' (enable) or '0' (disable) specifying the enable
1922 of heater function. Same reading values apply.
1924 This ABI is especially applicable for humidity sensors
1925 to heatup the device and get rid of any condensation
1926 in some humidity environment
1928 What: /sys/bus/iio/devices/iio:deviceX/in_ph_raw
1930 Contact: linux-iio@vger.kernel.org
1932 Raw (unscaled no offset etc.) pH reading of a substance as a negative
1933 base-10 logarithm of hydrodium ions in a litre of water.
1935 What: /sys/bus/iio/devices/iio:deviceX/mount_matrix
1936 What: /sys/bus/iio/devices/iio:deviceX/in_mount_matrix
1937 What: /sys/bus/iio/devices/iio:deviceX/out_mount_matrix
1938 What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_mount_matrix
1939 What: /sys/bus/iio/devices/iio:deviceX/in_accel_mount_matrix
1941 Contact: linux-iio@vger.kernel.org
1943 Mounting matrix for IIO sensors. This is a rotation matrix which
1944 informs userspace about sensor chip's placement relative to the
1945 main hardware it is mounted on.
1947 Main hardware placement is defined according to the local
1948 reference frame related to the physical quantity the sensor
1951 Given that the rotation matrix is defined in a board specific
1952 way (platform data and / or device-tree), the main hardware
1953 reference frame definition is left to the implementor's choice
1954 (see below for a magnetometer example).
1956 Applications should apply this rotation matrix to samples so
1957 that when main hardware reference frame is aligned onto local
1958 reference frame, then sensor chip reference frame is also
1959 perfectly aligned with it.
1961 Matrix is a 3x3 unitary matrix and typically looks like
1962 [0, 1, 0; 1, 0, 0; 0, 0, -1]. Identity matrix
1963 [1, 0, 0; 0, 1, 0; 0, 0, 1] means sensor chip and main hardware
1964 are perfectly aligned with each other.
1966 For example, a mounting matrix for a magnetometer sensor informs
1967 userspace about sensor chip's ORIENTATION relative to the main
1970 More specifically, main hardware orientation is defined with
1971 respect to the LOCAL EARTH GEOMAGNETIC REFERENCE FRAME where :
1973 * Y is in the ground plane and positive towards magnetic North ;
1974 * X is in the ground plane, perpendicular to the North axis and
1975 positive towards the East ;
1976 * Z is perpendicular to the ground plane and positive upwards.
1978 An implementor might consider that for a hand-held device, a
1979 'natural' orientation would be 'front facing camera at the top'.
1980 The main hardware reference frame could then be described as :
1982 * Y is in the plane of the screen and is positive towards the
1984 * X is in the plane of the screen, perpendicular to Y axis, and
1985 positive towards the right hand side of the screen ;
1986 * Z is perpendicular to the screen plane and positive out of the
1989 Another example for a quadrotor UAV might be :
1991 * Y is in the plane of the propellers and positive towards the
1993 * X is in the plane of the propellers, perpendicular to Y axis,
1994 and positive towards the starboard side of the UAV ;
1995 * Z is perpendicular to propellers plane and positive upwards.
1997 What: /sys/bus/iio/devices/iio:deviceX/in_electricalconductivity_raw
1999 Contact: linux-iio@vger.kernel.org
2001 Raw (unscaled no offset etc.) electric conductivity reading.
2002 Units after application of scale and offset are siemens per
2005 What: /sys/bus/iio/devices/iio:deviceX/in_countY_raw
2007 Contact: linux-iio@vger.kernel.org
2009 This interface is deprecated; please use the Counter subsystem.
2011 Raw counter device counts from channel Y. For quadrature
2012 counters, multiplication by an available [Y]_scale results in
2013 the counts of a single quadrature signal phase from channel Y.
2015 What: /sys/bus/iio/devices/iio:deviceX/in_indexY_raw
2017 Contact: linux-iio@vger.kernel.org
2019 This interface is deprecated; please use the Counter subsystem.
2021 Raw counter device index value from channel Y. This attribute
2022 provides an absolute positional reference (e.g. a pulse once per
2023 revolution) which may be used to home positional systems as
2026 What: /sys/bus/iio/devices/iio:deviceX/in_count_count_direction_available
2028 Contact: linux-iio@vger.kernel.org
2030 This interface is deprecated; please use the Counter subsystem.
2032 A list of possible counting directions which are:
2034 - "up" : counter device is increasing.
2035 - "down": counter device is decreasing.
2037 What: /sys/bus/iio/devices/iio:deviceX/in_countY_count_direction
2039 Contact: linux-iio@vger.kernel.org
2041 This interface is deprecated; please use the Counter subsystem.
2043 Raw counter device counters direction for channel Y.
2045 What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_label
2046 What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_label
2048 Contact: linux-iio@vger.kernel.org
2050 Optional symbolic label to a device channel.
2051 If a label is defined for this channel add that to the channel
2052 specific attributes. This is useful for userspace to be able to
2053 better identify an individual channel.
2055 What: /sys/bus/iio/devices/iio:deviceX/in_phaseY_raw
2057 Contact: linux-iio@vger.kernel.org
2059 Raw (unscaled) phase difference reading from channel Y.
2060 Units after application of scale and offset are radians.
2062 What: /sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm1_input
2063 What: /sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm1_input
2064 What: /sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm2p5_input
2065 What: /sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm2p5_input
2066 What: /sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm4_input
2067 What: /sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm4_input
2068 What: /sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm10_input
2069 What: /sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm10_input
2071 Contact: linux-iio@vger.kernel.org
2073 Mass concentration reading of particulate matter in ug / m3.
2074 pmX consists of particles with aerodynamic diameter less or
2075 equal to X micrometers.
2077 What: /sys/bus/iio/devices/iio:deviceX/events/in_illuminance_period_available
2080 Contact: linux-iio@vger.kernel.org
2082 List of valid periods (in seconds) for which the light intensity
2083 must be above the threshold level before interrupt is asserted.
2085 What: /sys/bus/iio/devices/iio:deviceX/in_filter_notch_center_frequency
2087 Contact: linux-iio@vger.kernel.org
2089 Center frequency in Hz for a notch filter. Used i.e. for line
2092 What: /sys/bus/iio/devices/iio:deviceX/in_temp_thermocouple_type
2094 Contact: linux-iio@vger.kernel.org
2096 One of the following thermocouple types: B, E, J, K, N, R, S, T.
2098 What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_calibambient
2099 What: /sys/bus/iio/devices/iio:deviceX/in_tempX_object_calibambient
2101 Contact: linux-iio@vger.kernel.org
2103 Calibrated ambient temperature for object temperature
2104 calculation in milli degrees Celsius.
2106 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_x_raw
2107 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_y_raw
2108 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_z_raw
2110 Contact: linux-iio@vger.kernel.org
2112 Unscaled light intensity according to CIE 1931/DIN 5033 color space.
2113 Units after application of scale are nano nanowatts per square meter.
2115 What: /sys/bus/iio/devices/iio:deviceX/in_anglY_label
2117 Contact: linux-iio@vger.kernel.org
2119 Optional symbolic label for channel Y.
2120 For Intel hid hinge sensor, the label values are:
2121 hinge, keyboard, screen. It means the three channels
2122 each correspond respectively to hinge angle, keyboard angle,
2125 What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_hysteresis_relative
2126 What: /sys/bus/iio/devices/iio:deviceX/in_intensity_hysteresis_relative
2128 Contact: linux-iio@vger.kernel.org
2130 Specify the percent for light sensor relative to the channel
2131 absolute value that a data field should change before an event
2132 is generated. Units are a percentage of the prior reading.
2134 What: /sys/bus/iio/devices/iio:deviceX/calibration_auto_enable
2137 Contact: linux-iio@vger.kernel.org
2139 Some sensors have the ability to apply auto calibration at
2140 runtime. For example, it may be necessary to compensate for
2141 contaminant build-up in a measurement chamber or optical
2142 element deterioration that would otherwise lead to sensor drift.
2144 Writing 1 or 0 to this attribute will respectively activate or
2145 deactivate this auto calibration function.
2147 Upon reading, the current status is returned.
2149 What: /sys/bus/iio/devices/iio:deviceX/calibration_forced_value
2152 Contact: linux-iio@vger.kernel.org
2154 Some sensors have the ability to apply a manual calibration using
2155 a known measurement value, perhaps obtained from an external
2158 Writing a value to this function will force such a calibration
2159 change. For the scd30 the value should be from the range
2162 Note for the scd30 that a valid value may only be obtained once
2163 it is has been written. Until then any read back of this value
2164 should be ignored. As for the scd4x an error will be returned
2165 immediately if the manual calibration has failed.
2167 What: /sys/bus/iio/devices/iio:deviceX/calibration_forced_value_available
2169 Contact: linux-iio@vger.kernel.org
2171 Available range for the forced calibration value, expressed as:
2173 - a range specified as "[min step max]"
2175 What: /sys/bus/iio/devices/iio:deviceX/in_voltageX_sampling_frequency
2176 What: /sys/bus/iio/devices/iio:deviceX/in_powerY_sampling_frequency
2177 What: /sys/bus/iio/devices/iio:deviceX/in_currentZ_sampling_frequency
2179 Contact: linux-iio@vger.kernel.org
2181 Some devices have separate controls of sampling frequency for
2182 individual channels. If multiple channels are enabled in a scan,
2183 then the sampling_frequency of the scan may be computed from the
2184 per channel sampling frequencies.
2186 What: /sys/.../events/in_accel_gesture_singletap_en
2187 What: /sys/.../events/in_accel_gesture_doubletap_en
2189 Contact: linux-iio@vger.kernel.org
2191 Device generates an event on a single or double tap.
2193 What: /sys/.../events/in_accel_gesture_singletap_value
2194 What: /sys/.../events/in_accel_gesture_doubletap_value
2196 Contact: linux-iio@vger.kernel.org
2198 Specifies the threshold value that the device is comparing
2199 against to generate the tap gesture event. The lower
2200 threshold value increases the sensitivity of tap detection.
2201 Units and the exact meaning of value are device-specific.
2203 What: /sys/.../events/in_accel_gesture_tap_value_available
2205 Contact: linux-iio@vger.kernel.org
2207 Lists all available threshold values which can be used to
2208 modify the sensitivity of the tap detection.
2210 What: /sys/.../events/in_accel_gesture_singletap_reset_timeout
2211 What: /sys/.../events/in_accel_gesture_doubletap_reset_timeout
2213 Contact: linux-iio@vger.kernel.org
2215 Specifies the timeout value in seconds for the tap detector
2216 to not to look for another tap event after the event as
2217 occurred. Basically the minimum quiet time between the two
2218 single-tap's or two double-tap's.
2220 What: /sys/.../events/in_accel_gesture_tap_reset_timeout_available
2222 Contact: linux-iio@vger.kernel.org
2224 Lists all available tap reset timeout values. Units in seconds.
2226 What: /sys/.../events/in_accel_gesture_doubletap_tap2_min_delay
2228 Contact: linux-iio@vger.kernel.org
2230 Specifies the minimum quiet time in seconds between the two
2231 taps of a double tap.
2233 What: /sys/.../events/in_accel_gesture_doubletap_tap2_min_delay_available
2235 Contact: linux-iio@vger.kernel.org
2237 Lists all available delay values between two taps in the double
2238 tap. Units in seconds.
2240 What: /sys/.../events/in_accel_gesture_tap_maxtomin_time
2242 Contact: linux-iio@vger.kernel.org
2244 Specifies the maximum time difference allowed between upper
2245 and lower peak of tap to consider it as the valid tap event.
2248 What: /sys/.../events/in_accel_gesture_tap_maxtomin_time_available
2250 Contact: linux-iio@vger.kernel.org
2252 Lists all available time values between upper peak to lower
2253 peak. Units in seconds.
2255 What: /sys/bus/iio/devices/iio:deviceX/in_rot_yaw_raw
2256 What: /sys/bus/iio/devices/iio:deviceX/in_rot_pitch_raw
2257 What: /sys/bus/iio/devices/iio:deviceX/in_rot_roll_raw
2259 Contact: linux-iio@vger.kernel.org
2261 Raw (unscaled) euler angles readings. Units after
2262 application of scale are deg.
2264 What: /sys/bus/iio/devices/iio:deviceX/serialnumber
2266 Contact: linux-iio@vger.kernel.org
2268 An example format is 16-bytes, 2-digits-per-byte, HEX-string
2269 representing the sensor unique ID number.
2271 What: /sys/bus/iio/devices/iio:deviceX/filter_type_available
2272 What: /sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_filter_mode_available
2274 Contact: linux-iio@vger.kernel.org
2276 Reading returns a list with the possible filter modes. Options
2279 * "sinc3" - The digital sinc3 filter. Moderate 1st
2280 conversion time. Good noise performance.
2281 * "sinc4" - Sinc 4. Excellent noise performance. Long
2282 1st conversion time.
2283 * "sinc5" - The digital sinc5 filter. Excellent noise
2285 * "sinc4+sinc1" - Sinc4 + averaging by 8. Low 1st conversion
2287 * "sinc3+rej60" - Sinc3 + 60Hz rejection.
2288 * "sinc3+sinc1" - Sinc3 + averaging by 8. Low 1st conversion
2290 * "sinc3+pf1" - Sinc3 + device specific Post Filter 1.
2291 * "sinc3+pf2" - Sinc3 + device specific Post Filter 2.
2292 * "sinc3+pf3" - Sinc3 + device specific Post Filter 3.
2293 * "sinc3+pf4" - Sinc3 + device specific Post Filter 4.
2295 What: /sys/.../events/in_proximity_thresh_either_runningperiod
2297 Contact: linux-iio@vger.kernel.org
2299 A running period of time (in seconds) for which
2300 in_proximity_thresh_either_runningcount amount of conditions
2301 must occur before an event is generated. If direction is not
2302 specified then this period applies to both directions.
2304 What: /sys/.../events/in_proximity_thresh_either_runningcount
2306 Contact: linux-iio@vger.kernel.org
2308 Number of conditions that must occur, during a running
2309 period, before an event is generated.
2311 What: /sys/bus/iio/devices/iio:deviceX/in_colortemp_raw
2313 Contact: linux-iio@vger.kernel.org
2315 Represents light color temperature, which measures light color
2316 temperature in Kelvin.
2318 What: /sys/bus/iio/devices/iio:deviceX/in_chromaticity_x_raw
2319 What: /sys/bus/iio/devices/iio:deviceX/in_chromaticity_y_raw
2321 Contact: linux-iio@vger.kernel.org
2323 The x and y light color coordinate on the CIE 1931 chromaticity
2326 What: /sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_mag_either_label
2327 What: /sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_mag_rising_label
2328 What: /sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_thresh_falling_label
2329 What: /sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_thresh_rising_label
2330 What: /sys/bus/iio/devices/iio:deviceX/events/in_anglvelY_mag_rising_label
2331 What: /sys/bus/iio/devices/iio:deviceX/events/in_anglY_thresh_rising_label
2332 What: /sys/bus/iio/devices/iio:deviceX/events/in_phaseY_mag_rising_label
2334 Contact: linux-iio@vger.kernel.org
2336 Optional symbolic label to a device channel event.
2337 If a label is defined for this event add that to the event
2338 specific attributes. This is useful for userspace to be able to
2339 better identify an individual event.
2341 What: /sys/.../events/in_accel_gesture_tap_wait_timeout
2343 Contact: linux-iio@vger.kernel.org
2345 Enable tap gesture confirmation with timeout.
2347 What: /sys/.../events/in_accel_gesture_tap_wait_dur
2349 Contact: linux-iio@vger.kernel.org
2351 Timeout value in seconds for tap gesture confirmation.
2353 What: /sys/.../events/in_accel_gesture_tap_wait_dur_available
2355 Contact: linux-iio@vger.kernel.org
2357 List of available timeout value for tap gesture confirmation.
2359 What: /sys/.../iio:deviceX/in_shunt_resistor
2360 What: /sys/.../iio:deviceX/in_current_shunt_resistor
2361 What: /sys/.../iio:deviceX/in_power_shunt_resistor
2363 Contact: linux-iio@vger.kernel.org
2365 The value of current sense resistor in Ohms.
2367 What: /sys/.../iio:deviceX/in_attention_input
2369 Contact: linux-iio@vger.kernel.org
2371 Value representing the user's attention to the system expressed
2372 in units as percentage. This usually means if the user is
2373 looking at the screen or not.