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