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