sysfs-bus-iio 36.0 KB
Newer Older
1
What:		/sys/bus/iio/devices/iio:deviceX
2 3 4
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
5
		Hardware chip or device accessed by one communication port.
6 7
		Corresponds to a grouping of sensor channels. X is the IIO
		index of the device.
8

9
What:		/sys/bus/iio/devices/triggerX
10 11 12 13 14 15 16
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
		An event driven driver of data capture to an in kernel buffer.
		May be provided by a device driver that also has an IIO device
		based on hardware generated events (e.g. data ready) or
		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
		generalize well and hence are not documented in this file.
20
		X is the IIO index of the trigger.
21

22
What:		/sys/bus/iio/devices/iio:deviceX/buffer
23 24 25
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
26
		Directory of attributes relating to the buffer for the device.
27

28
What:		/sys/bus/iio/devices/iio:deviceX/name
29 30 31
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
32 33
		Description of the physical chip / device for device X.
		Typically a part number.
34

35
What:		/sys/bus/iio/devices/iio:deviceX/sampling_frequency
36 37
What:		/sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency
What:		/sys/bus/iio/devices/triggerX/sampling_frequency
38 39 40 41 42
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
		Some devices have internal clocks.  This parameter sets the
		resulting sampling frequency.  In many devices this
43
		parameter has an effect on input filters etc. rather than
44
		simply controlling when the input is sampled.  As this
45
		effects data ready triggers, hardware buffers and the sysfs
46 47
		direct access interfaces, it may be found in any of the
		relevant directories.  If it effects all of the above
48
		then it is to be found in the base device directory.
49

50
What:		/sys/bus/iio/devices/iio:deviceX/sampling_frequency_available
51 52
What:		/sys/.../iio:deviceX/buffer/sampling_frequency_available
What:		/sys/bus/iio/devices/triggerX/sampling_frequency_available
53 54 55 56
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
		When the internal sampling clock can only take a small
57
		discrete set of values, this file lists those available.
58

59
What:		/sys/bus/iio/devices/iio:deviceX/oversampling_ratio
60 61 62 63 64 65
KernelVersion:	2.6.38
Contact:	linux-iio@vger.kernel.org
Description:
		Hardware dependent ADC oversampling. Controls the sampling ratio
		of the digital filter if available.

66
What:		/sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available
67 68 69 70 71
KernelVersion:	2.6.38
Contact:	linux-iio@vger.kernel.org
Description:
		Hardware dependent values supported by the oversampling filter.

72 73
What:		/sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
74 75 76
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
77
		Raw (unscaled no bias removal etc.) voltage measurement from
78 79 80
		channel Y. In special cases where the channel does not
		correspond to externally available input one of the named
		versions may be used. The number must always be specified and
81 82
		unique to allow association with event codes. Units after
		application of scale and offset are microvolts.
83

84
What:		/sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw
85 86 87
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
88 89 90 91
		Raw (unscaled) differential voltage measurement equivalent to
		channel Y - channel Z where these channel numbers apply to the
		physically equivalent inputs when non differential readings are
		separately available. In differential only parts, then all that
92 93
		is required is a consistent labeling.  Units after application
		of scale and offset are microvolts.
94

95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110
What:		/sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw
KernelVersion:	3.2
Contact:	linux-iio@vger.kernel.org
Description:
		Raw capacitance measurement from channel Y. Units after
		application of scale and offset are nanofarads.

What:		/sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw
KernelVersion:	3.2
Contact:	linux-iio@vger.kernel.org
Description:
		Raw differential capacitance measurement equivalent to
		channel Y - channel Z where these channel numbers apply to the
		physically equivalent inputs when non differential readings are
		separately available. In differential only parts, then all that
		is required is a consistent labeling.  Units after application
111
		of scale and offset are nanofarads.
112

113
What:		/sys/bus/iio/devices/iio:deviceX/in_temp_raw
114
What:		/sys/bus/iio/devices/iio:deviceX/in_tempX_raw
115 116 117
What:		/sys/bus/iio/devices/iio:deviceX/in_temp_x_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_temp_y_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_temp_z_raw
118 119 120
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
121
		Raw (unscaled no bias removal etc.) temperature measurement.
122
		If an axis is specified it generally means that the temperature
123
		sensor is associated with one part of a compound device (e.g.
124
		a gyroscope axis). Units after application of scale and offset
P
Peter Meerwald 已提交
125
		are milli degrees Celsius.
126

127
What:		/sys/bus/iio/devices/iio:deviceX/in_tempX_input
128 129 130 131 132
KernelVersion:	2.6.38
Contact:	linux-iio@vger.kernel.org
Description:
		Scaled temperature measurement in milli degrees Celsius.

133 134 135
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_x_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_y_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_z_raw
136 137 138
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
139
		Acceleration in direction x, y or z (may be arbitrarily assigned
140 141 142
		but should match other such assignments on device).
		Has all of the equivalent parameters as per voltageY. Units
		after application of scale and offset are m/s^2.
143

144 145 146
What:		/sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw
147 148 149
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
150
		Angular velocity about axis x, y or z (may be arbitrarily
151 152 153
		assigned). Has all the equivalent parameters as	per voltageY.
		Units after application of scale and offset are	radians per
		second.
154

155 156 157
What:		/sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
158 159 160
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
161 162
		Inclination raw reading about axis x, y or z (may be
		arbitrarily assigned). Data converted by application of offset
163
		and scale to degrees.
164

165 166 167
What:		/sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
168 169 170
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
171
		Magnetic field along axis x, y or z (may be arbitrarily
172 173
		assigned).  Data converted by application of offset
		then scale to Gauss.
174

175 176 177
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
178
KernelVersion:	2.6.36
179 180
Contact:	linux-iio@vger.kernel.org
Description:
181 182 183
		Highest value since some reset condition.  These
		attributes allow access to this and are otherwise
		the direct equivalent of the <type>Y[_name]_raw attributes.
184

185
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
186
KernelVersion:	2.6.36
187 188
Contact:	linux-iio@vger.kernel.org
Description:
189 190
		A computed peak value based on the sum squared magnitude of
		the underlying value in the specified directions.
191

192 193 194 195 196 197 198 199
What:		/sys/bus/iio/devices/iio:deviceX/in_pressureY_raw
What:		/sys/bus/iio/devices/iio:deviceX/in_pressure_raw
KernelVersion:	3.8
Contact:	linux-iio@vger.kernel.org
Description:
		Raw pressure measurement from channel Y. Units after
		application of scale and offset are kilopascal.

200
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_offset
201 202 203 204 205 206
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
What:		/sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
What:		/sys/bus/iio/devices/iio:deviceX/in_voltage_offset
What:		/sys/bus/iio/devices/iio:deviceX/in_tempY_offset
207
What:		/sys/bus/iio/devices/iio:deviceX/in_temp_offset
208 209
What:		/sys/bus/iio/devices/iio:deviceX/in_pressureY_offset
What:		/sys/bus/iio/devices/iio:deviceX/in_pressure_offset
210 211 212
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
213 214
		If known for a device, offset to be added to <type>[Y]_raw prior
		to scaling by <type>[Y]_scale in order to obtain value in the
215
		<type> units as specified in <type>[Y]_raw documentation.
216 217 218
		Not present if the offset is always 0 or unknown. If Y or
		axis <x|y|z> is not present, then the offset applies to all
		in channels of <type>.
219 220 221 222 223
		May be writable if a variable offset can be applied on the
		device. Note that this is different to calibbias which
		is for devices (or drivers) that apply offsets to compensate
		for variation between different instances of the part, typically
		adjusted by using some hardware supported calibration procedure.
224 225
		Calibbias is applied internally, offset is applied in userspace
		to the _raw output.
226

227 228 229 230
What:		/sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
What:		/sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
What:		/sys/bus/iio/devices/iio:deviceX/in_voltage_scale
What:		/sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
231
What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale
232 233
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_scale
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
234
What:		/sys/bus/iio/devices/iio:deviceX/in_anglvel_scale
235 236 237 238
What:		/sys/bus/iio/devices/iio:deviceX/in_magn_scale
What:		/sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
What:		/sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
What:		/sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
239 240
What:		/sys/bus/iio/devices/iio:deviceX/in_pressureY_scale
What:		/sys/bus/iio/devices/iio:deviceX/in_pressure_scale
241 242 243
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
244 245 246
		If known for a device, scale to be applied to <type>Y[_name]_raw
		post addition of <type>[Y][_name]_offset in order to obtain the
		measured value in <type> units as specified in
247
		<type>[Y][_name]_raw documentation.  If shared across all in
248 249 250
		channels then Y and <x|y|z> are not present and the value is
		called <type>[Y][_name]_scale. The peak modifier means this
		value is applied to <type>Y[_name]_peak_raw values.
251

252 253 254
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
255 256 257
What:		/sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias
What:		/sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
What:		/sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
258 259
What:		/sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
What:		/sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
260 261
What:		/sys/bus/iio/devices/iio:deviceX/in_pressureY_calibbias
What:		/sys/bus/iio/devices/iio:deviceX/in_pressure_calibbias
262 263 264
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
265
		Hardware applied calibration offset (assumed to fix production
266
		inaccuracies).
267

268 269 270 271 272 273
What		/sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
What		/sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
What		/sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
What		/sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
What		/sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
What		/sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
274 275 276
What		/sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
What		/sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
What		/sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
277 278
what		/sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
what		/sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
279 280
What:		/sys/bus/iio/devices/iio:deviceX/in_pressureY_calibscale
What:		/sys/bus/iio/devices/iio:deviceX/in_pressure_calibscale
281 282 283
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
284
		Hardware applied calibration scale factor (assumed to fix
285 286
		production inaccuracies).  If shared across all channels,
		<type>_calibscale is used.
287

288
What:		/sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
289 290 291
What:		/sys/.../iio:deviceX/in_voltageX_scale_available
What:		/sys/.../iio:deviceX/in_voltage-voltage_scale_available
What:		/sys/.../iio:deviceX/out_voltageX_scale_available
292
What:		/sys/.../iio:deviceX/out_altvoltageX_scale_available
293
What:		/sys/.../iio:deviceX/in_capacitance_scale_available
294 295
What:		/sys/.../iio:deviceX/in_pressure_scale_available
What:		/sys/.../iio:deviceX/in_pressureY_scale_available
296
KernelVersion:	2.6.35
297 298
Contact:	linux-iio@vger.kernel.org
Description:
299
		If a discrete set of scale values is available, they
300
		are listed in this attribute.
301

302 303 304 305 306 307 308
What		/sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
		Hardware applied gain factor. If shared across all channels,
		<type>_hardwaregain is used.

309 310 311 312 313 314 315 316 317 318
What:		/sys/.../in_accel_filter_low_pass_3db_frequency
What:		/sys/.../in_magn_filter_low_pass_3db_frequency
What:		/sys/.../in_anglvel_filter_low_pass_3db_frequency
KernelVersion:	3.2
Contact:	linux-iio@vger.kernel.org
Description:
		If a known or controllable low pass filter is applied
		to the underlying data channel, then this parameter
		gives the 3dB frequency of the filter in Hz.

319
What:		/sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
320
What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw
321 322 323 324 325 326
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
		Raw (unscaled, no bias etc.) output voltage for
		channel Y.  The number must always be specified and
		unique if the output corresponds to a single channel.
327 328 329
		While DAC like devices typically use out_voltage,
		a continuous frequency generating device, such as
		a DDS or PLL should use out_altvoltage.
330

331
What:		/sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
332
What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw
333 334 335 336 337 338 339 340
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
		Raw (unscaled, no bias etc.) output voltage for an aggregate of
		channel Y, channel Z, etc.  This interface is available in cases
		where a single output sets the value for multiple channels
		simultaneously.

341 342
What:		/sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
What:		/sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
343 344
What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode
What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode
345 346 347 348 349
KernelVersion:	2.6.38
Contact:	linux-iio@vger.kernel.org
Description:
		Specifies the output powerdown mode.
		DAC output stage is disconnected from the amplifier and
350 351 352 353 354
		1kohm_to_gnd: connected	to ground via an 1kOhm resistor,
		6kohm_to_gnd: connected to ground via a 6kOhm resistor,
		20kohm_to_gnd: connected to ground via a 20kOhm resistor,
		100kohm_to_gnd: connected to ground via an 100kOhm resistor,
		three_state: left floating.
355 356 357 358
		For a list of available output power down options read
		outX_powerdown_mode_available. If Y is not present the
		mode is shared across all outputs.

359 360
What:		/sys/.../iio:deviceX/out_votlageY_powerdown_mode_available
What:		/sys/.../iio:deviceX/out_voltage_powerdown_mode_available
361 362
What:		/sys/.../iio:deviceX/out_altvotlageY_powerdown_mode_available
What:		/sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available
363 364 365 366 367 368
KernelVersion:	2.6.38
Contact:	linux-iio@vger.kernel.org
Description:
		Lists all available output power down modes.
		If Y is not present the mode is shared across all outputs.

369 370
What:		/sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
What:		/sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
371 372
What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown
373 374 375 376
KernelVersion:	2.6.38
Contact:	linux-iio@vger.kernel.org
Description:
		Writing 1 causes output Y to enter the power down mode specified
377 378 379 380
		by the corresponding outY_powerdown_mode. DAC output stage is
		disconnected from the amplifier. Clearing returns to normal
		operation. Y may be suppressed if all outputs are controlled
		together.
381

382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399
What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency
KernelVersion:	3.4.0
Contact:	linux-iio@vger.kernel.org
Description:
		Output frequency for channel Y in Hz. The number must always be
		specified and unique if the output corresponds to a single
		channel.

What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase
KernelVersion:	3.4.0
Contact:	linux-iio@vger.kernel.org
Description:
		Phase in radians of one frequency/clock output Y
		(out_altvoltageY) relative to another frequency/clock output
		(out_altvoltageZ) of the device X. The number must always be
		specified and unique if the output corresponds to a single
		channel.

400
What:		/sys/bus/iio/devices/iio:deviceX/events
401 402 403 404 405
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
		Configuration of which hardware generated events are passed up
		to user-space.
406

407 408 409 410 411 412
What:		/sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
What:		/sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
What:		/sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
413 414 415 416 417 418
What:		/sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
What:		/sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
What:		/sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
419 420 421 422 423 424
What:		/sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
What:		/sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
What:		/sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
425 426 427 428 429 430
What:		/sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
What:		/sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
What:		/sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
What:		/sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
431 432 433
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
434
		Event generated when channel passes a threshold in the specified
435 436
		(_rising|_falling) direction. If the direction is not specified,
		then either the device will report an event which ever direction
437 438 439 440
		a single threshold value is passed in (e.g.
		<type>[Y][_name]_<raw|input>_thresh_value) or
		<type>[Y][_name]_<raw|input>_thresh_rising_value and
		<type>[Y][_name]_<raw|input>_thresh_falling_value may take
441 442
		different values, but the device can only enable both thresholds
		or neither.
443
		Note the driver will assume the last p events requested are
444 445
		to be enabled where p is how many it supports (which may vary
		depending on the exact set requested. So if you want to be
446 447 448
		sure you have set what you think you have, check the contents of
		these attributes after everything is configured. Drivers may
		have to buffer any parameters so that they are consistent when
449
		a given event type is enabled at a future point (and not those for
450 451
		whatever event was previously enabled).

452 453 454 455 456 457
What:		/sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
What:		/sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
What:		/sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
458 459 460 461 462 463
What:		/sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
What:		/sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
What:		/sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
464 465 466 467 468 469
What:		/sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
What:		/sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
What:		/sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
470 471 472 473 474 475
What:		/sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
What:		/sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
What:		/sys/.../iio:deviceX/events/in_tempY_roc_rising_en
What:		/sys/.../iio:deviceX/events/in_tempY_roc_falling_en
476 477 478 479 480 481 482
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
		Event generated when channel passes a threshold on the rate of
		change (1st differential) in the specified (_rising|_falling)
		direction. If the direction is not specified, then either the
		device will report an event which ever direction a single
483 484 485 486
		threshold value is passed in (e.g.
		<type>[Y][_name]_<raw|input>_roc_value) or
		<type>[Y][_name]_<raw|input>_roc_rising_value and
		<type>[Y][_name]_<raw|input>_roc_falling_value may take
487 488 489 490 491 492 493 494 495 496 497
		different values, but the device can only enable both rate of
		change thresholds or neither.
		Note the driver will assume the last p events requested are
		to be enabled where p is however many it supports (which may
		vary depending on the exact set requested. So if you want to be
		sure you have set what you think you have, check the contents of
		these attributes after everything is configured. Drivers may
		have to buffer any parameters so that they are consistent when
		a given event type is enabled a future point (and not those for
		whatever event was previously enabled).

498 499 500 501 502 503
What:		/sys/.../events/in_accel_x_raw_thresh_rising_value
What:		/sys/.../events/in_accel_x_raw_thresh_falling_value
What:		/sys/.../events/in_accel_y_raw_thresh_rising_value
What:		/sys/.../events/in_accel_y_raw_thresh_falling_value
What:		/sys/.../events/in_accel_z_raw_thresh_rising_value
What:		/sys/.../events/in_accel_z_raw_thresh_falling_value
504 505 506 507 508 509
What:		/sys/.../events/in_anglvel_x_raw_thresh_rising_value
What:		/sys/.../events/in_anglvel_x_raw_thresh_falling_value
What:		/sys/.../events/in_anglvel_y_raw_thresh_rising_value
What:		/sys/.../events/in_anglvel_y_raw_thresh_falling_value
What:		/sys/.../events/in_anglvel_z_raw_thresh_rising_value
What:		/sys/.../events/in_anglvel_z_raw_thresh_falling_value
510 511 512 513 514 515
What:		/sys/.../events/in_magn_x_raw_thresh_rising_value
What:		/sys/.../events/in_magn_x_raw_thresh_falling_value
What:		/sys/.../events/in_magn_y_raw_thresh_rising_value
What:		/sys/.../events/in_magn_y_raw_thresh_falling_value
What:		/sys/.../events/in_magn_z_raw_thresh_rising_value
What:		/sys/.../events/in_magn_z_raw_thresh_falling_value
516 517
What:		/sys/.../events/in_voltageY_supply_raw_thresh_rising_value
What:		/sys/.../events/in_voltageY_supply_raw_thresh_falling_value
518
What:		/sys/.../events/in_voltageY_raw_thresh_rising_value
519
What:		/sys/.../events/in_voltageY_raw_thresh_falling_value
520
What:		/sys/.../events/in_tempY_raw_thresh_rising_value
521
What:		/sys/.../events/in_tempY_raw_thresh_falling_value
522 523 524 525
What:		/sys/.../events/in_illuminance0_thresh_falling_value
what:		/sys/.../events/in_illuminance0_thresh_rising_value
what:		/sys/.../events/in_proximity0_thresh_falling_value
what:		/sys/.../events/in_proximity0_thresh_rising_value
526
KernelVersion:	2.6.37
527 528
Contact:	linux-iio@vger.kernel.org
Description:
529 530
		Specifies the value of threshold that the device is comparing
		against for the events enabled by
531 532
		<type>Y[_name]_thresh[_rising|falling]_en.
		If separate attributes exist for the two directions, but
533 534
		direction is not specified for this attribute, then a single
		threshold value applies to both directions.
535 536 537
		The raw or input element of the name indicates whether the
		value is in raw device units or in processed units (as _raw
		and _input do on sysfs direct channel read attributes).
538

539 540 541 542 543 544
What:		/sys/.../events/in_accel_x_raw_roc_rising_value
What:		/sys/.../events/in_accel_x_raw_roc_falling_value
What:		/sys/.../events/in_accel_y_raw_roc_rising_value
What:		/sys/.../events/in_accel_y_raw_roc_falling_value
What:		/sys/.../events/in_accel_z_raw_roc_rising_value
What:		/sys/.../events/in_accel_z_raw_roc_falling_value
545 546 547 548 549 550
What:		/sys/.../events/in_anglvel_x_raw_roc_rising_value
What:		/sys/.../events/in_anglvel_x_raw_roc_falling_value
What:		/sys/.../events/in_anglvel_y_raw_roc_rising_value
What:		/sys/.../events/in_anglvel_y_raw_roc_falling_value
What:		/sys/.../events/in_anglvel_z_raw_roc_rising_value
What:		/sys/.../events/in_anglvel_z_raw_roc_falling_value
551 552 553 554 555 556
What:		/sys/.../events/in_magn_x_raw_roc_rising_value
What:		/sys/.../events/in_magn_x_raw_roc_falling_value
What:		/sys/.../events/in_magn_y_raw_roc_rising_value
What:		/sys/.../events/in_magn_y_raw_roc_falling_value
What:		/sys/.../events/in_magn_z_raw_roc_rising_value
What:		/sys/.../events/in_magn_z_raw_roc_falling_value
557 558
What:		/sys/.../events/in_voltageY_supply_raw_roc_rising_value
What:		/sys/.../events/in_voltageY_supply_raw_roc_falling_value
559
What:		/sys/.../events/in_voltageY_raw_roc_rising_value
560
What:		/sys/.../events/in_voltageY_raw_roc_falling_value
561
What:		/sys/.../events/in_tempY_raw_roc_rising_value
562
What:		/sys/.../events/in_tempY_raw_roc_falling_value
563 564 565
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
566 567
		Specifies the value of rate of change threshold that the
		device is comparing against for the events enabled by
568
		<type>[Y][_name]_roc[_rising|falling]_en.
569 570 571 572 573 574
		If separate attributes exist for the two directions,
		but direction is not specified for this attribute,
		then a single threshold value applies to both directions.
		The raw or input element of the name indicates whether the
		value is in raw device units or in processed units (as _raw
		and _input do on sysfs direct channel read attributes).
575

576 577 578 579 580 581 582 583 584 585 586 587
What:		/sys/.../events/in_accel_x_thresh_rising_period
What:		/sys/.../events/in_accel_x_thresh_falling_period
hat:		/sys/.../events/in_accel_x_roc_rising_period
What:		/sys/.../events/in_accel_x_roc_falling_period
What:		/sys/.../events/in_accel_y_thresh_rising_period
What:		/sys/.../events/in_accel_y_thresh_falling_period
What:		/sys/.../events/in_accel_y_roc_rising_period
What:		/sys/.../events/in_accel_y_roc_falling_period
What:		/sys/.../events/in_accel_z_thresh_rising_period
What:		/sys/.../events/in_accel_z_thresh_falling_period
What:		/sys/.../events/in_accel_z_roc_rising_period
What:		/sys/.../events/in_accel_z_roc_falling_period
588 589 590 591 592 593 594 595 596 597 598 599
What:		/sys/.../events/in_anglvel_x_thresh_rising_period
What:		/sys/.../events/in_anglvel_x_thresh_falling_period
What:		/sys/.../events/in_anglvel_x_roc_rising_period
What:		/sys/.../events/in_anglvel_x_roc_falling_period
What:		/sys/.../events/in_anglvel_y_thresh_rising_period
What:		/sys/.../events/in_anglvel_y_thresh_falling_period
What:		/sys/.../events/in_anglvel_y_roc_rising_period
What:		/sys/.../events/in_anglvel_y_roc_falling_period
What:		/sys/.../events/in_anglvel_z_thresh_rising_period
What:		/sys/.../events/in_anglvel_z_thresh_falling_period
What:		/sys/.../events/in_anglvel_z_roc_rising_period
What:		/sys/.../events/in_anglvel_z_roc_falling_period
600 601 602 603 604 605 606 607 608 609 610 611
What:		/sys/.../events/in_magn_x_thresh_rising_period
What:		/sys/.../events/in_magn_x_thresh_falling_period
What:		/sys/.../events/in_magn_x_roc_rising_period
What:		/sys/.../events/in_magn_x_roc_falling_period
What:		/sys/.../events/in_magn_y_thresh_rising_period
What:		/sys/.../events/in_magn_y_thresh_falling_period
What:		/sys/.../events/in_magn_y_roc_rising_period
What:		/sys/.../events/in_magn_y_roc_falling_period
What:		/sys/.../events/in_magn_z_thresh_rising_period
What:		/sys/.../events/in_magn_z_thresh_falling_period
What:		/sys/.../events/in_magn_z_roc_rising_period
What:		/sys/.../events/in_magn_z_roc_falling_period
612 613 614 615 616 617 618 619 620 621 622 623
What:		/sys/.../events/in_voltageY_supply_thresh_rising_period
What:		/sys/.../events/in_voltageY_supply_thresh_falling_period
What:		/sys/.../events/in_voltageY_supply_roc_rising_period
What:		/sys/.../events/in_voltageY_supply_roc_falling_period
What:		/sys/.../events/in_voltageY_thresh_rising_period
What:		/sys/.../events/in_voltageY_thresh_falling_period
What:		/sys/.../events/in_voltageY_roc_rising_period
What:		/sys/.../events/in_voltageY_roc_falling_period
What:		/sys/.../events/in_tempY_thresh_rising_period
What:		/sys/.../events/in_tempY_thresh_falling_period
What:		/sys/.../events/in_tempY_roc_rising_period
What:		/sys/.../events/in_tempY_roc_falling_period
624
What:		/sys/.../events/in_accel_x&y&z_mag_falling_period
625 626
What:		/sys/.../events/in_intensity0_thresh_period
What:		/sys/.../events/in_proximity0_thresh_period
627
KernelVersion:	2.6.37
628 629
Contact:	linux-iio@vger.kernel.org
Description:
630 631
		Period of time (in seconds) for which the condition must be
		met before an event is generated. If direction is not
632
		specified then this period applies to both directions.
633

634 635 636 637 638 639 640 641 642 643 644 645 646 647
What:		/sys/.../iio:deviceX/events/in_accel_mag_en
What:		/sys/.../iio:deviceX/events/in_accel_mag_rising_en
What:		/sys/.../iio:deviceX/events/in_accel_mag_falling_en
What:		/sys/.../iio:deviceX/events/in_accel_x_mag_en
What:		/sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
What:		/sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
What:		/sys/.../iio:deviceX/events/in_accel_y_mag_en
What:		/sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
What:		/sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
What:		/sys/.../iio:deviceX/events/in_accel_z_mag_en
What:		/sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
What:		/sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
What:		/sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
What:		/sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
648 649 650
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
651
		Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
652 653
		magnitude of the channel is compared to the threshold, not its
		signed value.
654

655 656 657 658
What:		/sys/.../events/in_accel_raw_mag_value
What:		/sys/.../events/in_accel_x_raw_mag_rising_value
What:		/sys/.../events/in_accel_y_raw_mag_rising_value
What:		/sys/.../events/in_accel_z_raw_mag_rising_value
659 660 661
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
662 663 664
		The value to which the magnitude of the channel is compared. If
		number or direction is not specified, applies to all channels of
		this type.
665

666
What:		/sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
667 668 669 670
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
		The name of the trigger source being used, as per string given
671
		in /sys/class/iio/triggerY/name.
672

673
What:		/sys/bus/iio/devices/iio:deviceX/buffer/length
674 675 676 677 678
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
		Number of scans contained by the buffer.

679
What:		/sys/bus/iio/devices/iio:deviceX/buffer/bytes_per_datum
680
KernelVersion:	2.6.37
681 682 683 684 685
Contact:	linux-iio@vger.kernel.org
Description:
		Bytes per scan.  Due to alignment fun, the scan may be larger
		than implied directly by the scan_element parameters.

686
What:		/sys/bus/iio/devices/iio:deviceX/buffer/enable
687 688 689 690 691 692
KernelVersion:	2.6.35
Contact:	linux-iio@vger.kernel.org
Description:
		Actually start the buffer capture up.  Will start trigger
		if first device and appropriate.

693
What:		/sys/bus/iio/devices/iio:deviceX/buffer/scan_elements
694 695 696
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
697 698
		Directory containing interfaces for elements that will be
		captured for a single triggered sample set in the buffer.
699

700 701 702
What:		/sys/.../buffer/scan_elements/in_accel_x_en
What:		/sys/.../buffer/scan_elements/in_accel_y_en
What:		/sys/.../buffer/scan_elements/in_accel_z_en
703 704 705
What:		/sys/.../buffer/scan_elements/in_anglvel_x_en
What:		/sys/.../buffer/scan_elements/in_anglvel_y_en
What:		/sys/.../buffer/scan_elements/in_anglvel_z_en
706 707 708 709 710 711 712 713 714
What:		/sys/.../buffer/scan_elements/in_magn_x_en
What:		/sys/.../buffer/scan_elements/in_magn_y_en
What:		/sys/.../buffer/scan_elements/in_magn_z_en
What:		/sys/.../buffer/scan_elements/in_timestamp_en
What:		/sys/.../buffer/scan_elements/in_voltageY_supply_en
What:		/sys/.../buffer/scan_elements/in_voltageY_en
What:		/sys/.../buffer/scan_elements/in_voltageY-voltageZ_en
What:		/sys/.../buffer/scan_elements/in_incli_x_en
What:		/sys/.../buffer/scan_elements/in_incli_y_en
715 716
What:		/sys/.../buffer/scan_elements/in_pressureY_en
What:		/sys/.../buffer/scan_elements/in_pressure_en
717 718 719
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
720
		Scan element control for triggered data capture.
721

722
What:		/sys/.../buffer/scan_elements/in_accel_type
723
What:		/sys/.../buffer/scan_elements/in_anglvel_type
724 725 726
What:		/sys/.../buffer/scan_elements/in_magn_type
What:		/sys/.../buffer/scan_elements/in_incli_type
What:		/sys/.../buffer/scan_elements/in_voltageY_type
727
What:		/sys/.../buffer/scan_elements/in_voltage_type
728 729
What:		/sys/.../buffer/scan_elements/in_voltageY_supply_type
What:		/sys/.../buffer/scan_elements/in_timestamp_type
730 731
What:		/sys/.../buffer/scan_elements/in_pressureY_type
What:		/sys/.../buffer/scan_elements/in_pressure_type
732 733 734
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
735
		Description of the scan element data storage within the buffer
736
		and hence the form in which it is read from user-space.
737 738
		Form is [be|le]:[s|u]bits/storagebits[>>shift].
		be or le specifies big or little endian. s or u specifies if
739 740 741 742 743 744 745 746 747 748 749
		signed (2's complement) or unsigned. bits is the number of bits
		of data and storagebits is the space (after padding) that it
		occupies in the buffer. shift if specified, is the shift that
		needs to be applied prior to masking out unused bits. Some
		devices put their data in the middle of the transferred elements
		with additional information on both sides.  Note that some
		devices will have additional information in the unused bits
		so to get a clean value, the bits value must be used to mask
		the buffer output value appropriately.  The storagebits value
		also specifies the data alignment.  So s48/64>>2 will be a
		signed 48 bit integer stored in a 64 bit location aligned to
750
		a 64 bit boundary. To obtain the clean value, shift right 2
751
		and apply a mask to zero the top 16 bits of the result.
752 753 754
		For other storage combinations this attribute will be extended
		appropriately.

755
What:		/sys/.../buffer/scan_elements/in_accel_type_available
756 757 758 759 760 761
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
		If the type parameter can take one of a small set of values,
		this attribute lists them.

762 763 764 765 766
What:		/sys/.../buffer/scan_elements/in_voltageY_index
What:		/sys/.../buffer/scan_elements/in_voltageY_supply_index
What:		/sys/.../buffer/scan_elements/in_accel_x_index
What:		/sys/.../buffer/scan_elements/in_accel_y_index
What:		/sys/.../buffer/scan_elements/in_accel_z_index
767 768 769
What:		/sys/.../buffer/scan_elements/in_anglvel_x_index
What:		/sys/.../buffer/scan_elements/in_anglvel_y_index
What:		/sys/.../buffer/scan_elements/in_anglvel_z_index
770 771 772 773 774
What:		/sys/.../buffer/scan_elements/in_magn_x_index
What:		/sys/.../buffer/scan_elements/in_magn_y_index
What:		/sys/.../buffer/scan_elements/in_magn_z_index
What:		/sys/.../buffer/scan_elements/in_incli_x_index
What:		/sys/.../buffer/scan_elements/in_incli_y_index
775
What:		/sys/.../buffer/scan_elements/in_timestamp_index
776 777
What:		/sys/.../buffer/scan_elements/in_pressureY_index
What:		/sys/.../buffer/scan_elements/in_pressure_index
778 779 780 781
KernelVersion:	2.6.37
Contact:	linux-iio@vger.kernel.org
Description:
		A single positive integer specifying the position of this
782 783
		scan element in the buffer. Note these are not dependent on
		what is enabled and may not be contiguous. Thus for user-space
784 785 786 787
		to establish the full layout these must be used in conjunction
		with all _en attributes to establish which channels are present,
		and the relevant _type attributes to establish the data storage
		format.
788

789
What:		/sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
790
KernelVersion:	2.6.38
791
Contact:	linux-iio@vger.kernel.org
792 793 794
Description:
		This attribute is used to read the amount of quadrature error
		present in the device at a given time.