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