Documentation/ABI/testing/sysfs-bus-iio

   1 What:           /sys/bus/iio/devices/iio:deviceX
   2 KernelVersion:  2.6.35
   3 Contact:        linux-iio@vger.kernel.org
   4 Description:
   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
   9 What:           /sys/bus/iio/devices/triggerX
  10 KernelVersion:  2.6.35
  11 Contact:        linux-iio@vger.kernel.org
  12 Description:
  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
  22 What:           /sys/bus/iio/devices/iio:deviceX/buffer
  23 KernelVersion:  2.6.35
  24 Contact:        linux-iio@vger.kernel.org
  25 Description:
  26                 Directory of attributes relating to the buffer for the device.
  27
  28 What:           /sys/bus/iio/devices/iio:deviceX/name
  29 KernelVersion:  2.6.35
  30 Contact:        linux-iio@vger.kernel.org
  31 Description:
  32                 Description of the physical chip / device for device X.
  33                 Typically a part number.
  34
  35 What:           /sys/bus/iio/devices/iio:deviceX/sampling_frequency
  36 What:           /sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency
  37 What:           /sys/bus/iio/devices/triggerX/sampling_frequency
  38 KernelVersion:  2.6.35
  39 Contact:        linux-iio@vger.kernel.org
  40 Description:
  41                 Some devices have internal clocks.  This parameter sets the
  42                 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                 direct access interfaces, it may be found in any of the
  47                 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 What:           /sys/.../iio:deviceX/buffer/sampling_frequency_available
  52 What:           /sys/bus/iio/devices/triggerX/sampling_frequency_available
  53 KernelVersion:  2.6.35
  54 Contact:        linux-iio@vger.kernel.org
  55 Description:
  56                 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 KernelVersion:  2.6.38
  61 Contact:        linux-iio@vger.kernel.org
  62 Description:
  63                 Hardware dependent ADC oversampling. Controls the sampling ratio
  64                 of the digital filter if available.
  65
  66 What:           /sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available
  67 KernelVersion:  2.6.38
  68 Contact:        linux-iio@vger.kernel.org
  69 Description:
  70                 Hardware dependent values supported by the oversampling filter.
  71
  72 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
  73 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
  74 KernelVersion:  2.6.35
  75 Contact:        linux-iio@vger.kernel.org
  76 Description:
  77                 Raw (unscaled no bias removal etc.) voltage measurement from
  78                 channel Y. In special cases where the channel does not
  79                 correspond to externally available input one of the named
  80                 versions may be used. The number must always be specified and
  81                 unique to allow association with event codes. Units after
  82                 application of scale and offset are microvolts.
  83
  84 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw
  85 KernelVersion:  2.6.35
  86 Contact:        linux-iio@vger.kernel.org
  87 Description:
  88                 Raw (unscaled) differential voltage measurement equivalent to
  89                 channel Y - channel Z where these channel numbers apply to the
  90                 physically equivalent inputs when non differential readings are
  91                 separately available. In differential only parts, then all that
  92                 is required is a consistent labeling.  Units after application
  93                 of scale and offset are microvolts.
  94
  95 What:           /sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw
  96 KernelVersion:  3.2
  97 Contact:        linux-iio@vger.kernel.org
  98 Description:
  99                 Raw capacitance measurement from channel Y. Units after
 100                 application of scale and offset are nanofarads.
 101
 102 What:           /sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw
 103 KernelVersion:  3.2
 104 Contact:        linux-iio@vger.kernel.org
 105 Description:
 106                 Raw differential capacitance 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 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 What:           /sys/bus/iio/devices/iio:deviceX/in_temp_x_raw
 116 What:           /sys/bus/iio/devices/iio:deviceX/in_temp_y_raw
 117 What:           /sys/bus/iio/devices/iio:deviceX/in_temp_z_raw
 118 KernelVersion:  2.6.35
 119 Contact:        linux-iio@vger.kernel.org
 120 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
 125                 are milli degrees Celsius.
 126
 127 What:           /sys/bus/iio/devices/iio:deviceX/in_tempX_input
 128 KernelVersion:  2.6.38
 129 Contact:        linux-iio@vger.kernel.org
 130 Description:
 131                 Scaled temperature measurement in milli degrees Celsius.
 132
 133 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw
 134 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_raw
 135 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_raw
 136 KernelVersion:  2.6.35
 137 Contact:        linux-iio@vger.kernel.org
 138 Description:
 139                 Acceleration in direction x, y or z (may be arbitrarily assigned
 140                 but should match other such assignments on device).
 141                 Has all of the equivalent parameters as per voltageY. Units
 142                 after application of scale and offset are m/s^2.
 143
 144 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw
 145 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw
 146 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw
 147 KernelVersion:  2.6.35
 148 Contact:        linux-iio@vger.kernel.org
 149 Description:
 150                 Angular velocity about axis x, y or z (may be arbitrarily
 151                 assigned). Has all the equivalent parameters as per voltageY.
 152                 Units after application of scale and offset are radians per
 153                 second.
 154
 155 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
 156 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
 157 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
 158 KernelVersion:  2.6.35
 159 Contact:        linux-iio@vger.kernel.org
 160 Description:
 161                 Inclination raw reading about axis x, y or z (may be
 162                 arbitrarily assigned). Data converted by application of offset
 163                 and scale to degrees.
 164
 165 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
 166 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
 167 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
 168 KernelVersion:  2.6.35
 169 Contact:        linux-iio@vger.kernel.org
 170 Description:
 171                 Magnetic field along axis x, y or z (may be arbitrarily
 172                 assigned).  Data converted by application of offset
 173                 then scale to Gauss.
 174
 175 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
 176 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
 177 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
 178 KernelVersion:  2.6.36
 179 Contact:        linux-iio@vger.kernel.org
 180 Description:
 181                 Highest value since some reset condition.  These
 182                 attributes allow access to this and are otherwise
 183                 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 Contact:        linux-iio@vger.kernel.org
 188 Description:
 189                 A computed peak value based on the sum squared magnitude of
 190                 the underlying value in the specified directions.
 191
 192 What:           /sys/bus/iio/devices/iio:deviceX/in_pressureY_raw
 193 What:           /sys/bus/iio/devices/iio:deviceX/in_pressure_raw
 194 KernelVersion:  3.8
 195 Contact:        linux-iio@vger.kernel.org
 196 Description:
 197                 Raw pressure measurement from channel Y. Units after
 198                 application of scale and offset are kilopascal.
 199
 200 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_offset
 201 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
 202 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
 203 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
 204 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
 205 What:           /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
 206 What:           /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
 207 What:           /sys/bus/iio/devices/iio:deviceX/in_temp_offset
 208 What:           /sys/bus/iio/devices/iio:deviceX/in_pressureY_offset
 209 What:           /sys/bus/iio/devices/iio:deviceX/in_pressure_offset
 210 KernelVersion:  2.6.35
 211 Contact:        linux-iio@vger.kernel.org
 212 Description:
 213                 If known for a device, offset to be added to <type>[Y]_raw prior
 214                 to scaling by <type>[Y]_scale in order to obtain value in the
 215                 <type> units as specified in <type>[Y]_raw documentation.
 216                 Not present if the offset is always 0 or unknown. If Y or
 217                 axis <x|y|z> is not present, then the offset applies to all
 218                 in channels of <type>.
 219                 May be writable if a variable offset can be applied on the
 220                 device. Note that this is different to calibbias which
 221                 is for devices (or drivers) that apply offsets to compensate
 222                 for variation between different instances of the part, typically
 223                 adjusted by using some hardware supported calibration procedure.
 224                 Calibbias is applied internally, offset is applied in userspace
 225                 to the _raw output.
 226
 227 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
 228 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
 229 What:           /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
 230 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
 231 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale
 232 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_scale
 233 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
 234 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale
 235 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_scale
 236 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
 237 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
 238 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
 239 What:           /sys/bus/iio/devices/iio:deviceX/in_pressureY_scale
 240 What:           /sys/bus/iio/devices/iio:deviceX/in_pressure_scale
 241 KernelVersion:  2.6.35
 242 Contact:        linux-iio@vger.kernel.org
 243 Description:
 244                 If known for a device, scale to be applied to <type>Y[_name]_raw
 245                 post addition of <type>[Y][_name]_offset in order to obtain the
 246                 measured value in <type> units as specified in
 247                 <type>[Y][_name]_raw documentation.  If shared across all in
 248                 channels then Y and <x|y|z> are not present and the value is
 249                 called <type>[Y][_name]_scale. The peak modifier means this
 250                 value is applied to <type>Y[_name]_peak_raw values.
 251
 252 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
 253 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
 254 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
 255 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias
 256 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
 257 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
 258 What:           /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
 259 What:           /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
 260 What:           /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibbias
 261 What:           /sys/bus/iio/devices/iio:deviceX/in_pressure_calibbias
 262 KernelVersion:  2.6.35
 263 Contact:        linux-iio@vger.kernel.org
 264 Description:
 265                 Hardware applied calibration offset (assumed to fix production
 266                 inaccuracies).
 267
 268 What            /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
 269 What            /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
 270 What            /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
 271 What            /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
 272 What            /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
 273 What            /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
 274 What            /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
 275 What            /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
 276 What            /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
 277 what            /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
 278 what            /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
 279 What:           /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibscale
 280 What:           /sys/bus/iio/devices/iio:deviceX/in_pressure_calibscale
 281 KernelVersion:  2.6.35
 282 Contact:        linux-iio@vger.kernel.org
 283 Description:
 284                 Hardware applied calibration scale factor (assumed to fix
 285                 production inaccuracies).  If shared across all channels,
 286                 <type>_calibscale is used.
 287
 288 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
 289 What:           /sys/.../iio:deviceX/in_voltageX_scale_available
 290 What:           /sys/.../iio:deviceX/in_voltage-voltage_scale_available
 291 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 What:           /sys/.../iio:deviceX/in_pressure_scale_available
 295 What:           /sys/.../iio:deviceX/in_pressureY_scale_available
 296 KernelVersion:  2.6.35
 297 Contact:        linux-iio@vger.kernel.org
 298 Description:
 299                 If a discrete set of scale values is available, they
 300                 are listed in this attribute.
 301
 302 What            /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
 303 KernelVersion:  2.6.35
 304 Contact:        linux-iio@vger.kernel.org
 305 Description:
 306                 Hardware applied gain factor. If shared across all channels,
 307                 <type>_hardwaregain is used.
 308
 309 What:           /sys/.../in_accel_filter_low_pass_3db_frequency
 310 What:           /sys/.../in_magn_filter_low_pass_3db_frequency
 311 What:           /sys/.../in_anglvel_filter_low_pass_3db_frequency
 312 KernelVersion:  3.2
 313 Contact:        linux-iio@vger.kernel.org
 314 Description:
 315                 If a known or controllable low pass filter is applied
 316                 to the underlying data channel, then this parameter
 317                 gives the 3dB frequency of the filter in Hz.
 318
 319 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
 320 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw
 321 KernelVersion:  2.6.37
 322 Contact:        linux-iio@vger.kernel.org
 323 Description:
 324                 Raw (unscaled, no bias etc.) output voltage for
 325                 channel Y.  The number must always be specified and
 326                 unique if the output corresponds to a single channel.
 327                 While DAC like devices typically use out_voltage,
 328                 a continuous frequency generating device, such as
 329                 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 KernelVersion:  2.6.37
 334 Contact:        linux-iio@vger.kernel.org
 335 Description:
 336                 Raw (unscaled, no bias etc.) output voltage for an aggregate of
 337                 channel Y, channel Z, etc.  This interface is available in cases
 338                 where a single output sets the value for multiple channels
 339                 simultaneously.
 340
 341 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
 342 What:           /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
 343 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode
 344 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode
 345 KernelVersion:  2.6.38
 346 Contact:        linux-iio@vger.kernel.org
 347 Description:
 348                 Specifies the output powerdown mode.
 349                 DAC output stage is disconnected from the amplifier and
 350                 1kohm_to_gnd: connected to ground via an 1kOhm resistor,
 351                 6kohm_to_gnd: connected to ground via a 6kOhm resistor,
 352                 20kohm_to_gnd: connected to ground via a 20kOhm resistor,
 353                 100kohm_to_gnd: connected to ground via an 100kOhm resistor,
 354                 500kohm_to_gnd: connected to ground via a 500kOhm resistor,
 355                 three_state: left floating.
 356                 For a list of available output power down options read
 357                 outX_powerdown_mode_available. If Y is not present the
 358                 mode is shared across all outputs.
 359
 360 What:           /sys/.../iio:deviceX/out_votlageY_powerdown_mode_available
 361 What:           /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
 362 What:           /sys/.../iio:deviceX/out_altvotlageY_powerdown_mode_available
 363 What:           /sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available
 364 KernelVersion:  2.6.38
 365 Contact:        linux-iio@vger.kernel.org
 366 Description:
 367                 Lists all available output power down modes.
 368                 If Y is not present the mode is shared across all outputs.
 369
 370 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
 371 What:           /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
 372 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
 373 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown
 374 KernelVersion:  2.6.38
 375 Contact:        linux-iio@vger.kernel.org
 376 Description:
 377                 Writing 1 causes output Y to enter the power down mode specified
 378                 by the corresponding outY_powerdown_mode. DAC output stage is
 379                 disconnected from the amplifier. Clearing returns to normal
 380                 operation. Y may be suppressed if all outputs are controlled
 381                 together.
 382
 383 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency
 384 KernelVersion:  3.4.0
 385 Contact:        linux-iio@vger.kernel.org
 386 Description:
 387                 Output frequency for channel Y in Hz. The number must always be
 388                 specified and unique if the output corresponds to a single
 389                 channel.
 390
 391 What:           /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase
 392 KernelVersion:  3.4.0
 393 Contact:        linux-iio@vger.kernel.org
 394 Description:
 395                 Phase in radians of one frequency/clock output Y
 396                 (out_altvoltageY) relative to another frequency/clock output
 397                 (out_altvoltageZ) of the device X. The number must always be
 398                 specified and unique if the output corresponds to a single
 399                 channel.
 400
 401 What:           /sys/bus/iio/devices/iio:deviceX/events
 402 KernelVersion:  2.6.35
 403 Contact:        linux-iio@vger.kernel.org
 404 Description:
 405                 Configuration of which hardware generated events are passed up
 406                 to user-space.
 407
 408 What:           /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
 409 What:           /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
 410 What:           /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
 411 What:           /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
 412 What:           /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
 413 What:           /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
 414 What:           /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
 415 What:           /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
 416 What:           /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
 417 What:           /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
 418 What:           /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
 419 What:           /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
 420 What:           /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
 421 What:           /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
 422 What:           /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
 423 What:           /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
 424 What:           /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
 425 What:           /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
 426 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
 427 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
 428 What:           /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
 429 What:           /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
 430 What:           /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
 431 What:           /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
 432 KernelVersion:  2.6.37
 433 Contact:        linux-iio@vger.kernel.org
 434 Description:
 435                 Event generated when channel passes a threshold in the specified
 436                 (_rising|_falling) direction. If the direction is not specified,
 437                 then either the device will report an event which ever direction
 438                 a single threshold value is passed in (e.g.
 439                 <type>[Y][_name]_<raw|input>_thresh_value) or
 440                 <type>[Y][_name]_<raw|input>_thresh_rising_value and
 441                 <type>[Y][_name]_<raw|input>_thresh_falling_value may take
 442                 different values, but the device can only enable both thresholds
 443                 or neither.
 444                 Note the driver will assume the last p events requested are
 445                 to be enabled where p is how many it supports (which may vary
 446                 depending on the exact set requested. So if you want to be
 447                 sure you have set what you think you have, check the contents of
 448                 these attributes after everything is configured. Drivers may
 449                 have to buffer any parameters so that they are consistent when
 450                 a given event type is enabled at a future point (and not those for
 451                 whatever event was previously enabled).
 452
 453 What:           /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
 454 What:           /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
 455 What:           /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
 456 What:           /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
 457 What:           /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
 458 What:           /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
 459 What:           /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
 460 What:           /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
 461 What:           /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
 462 What:           /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
 463 What:           /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
 464 What:           /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
 465 What:           /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
 466 What:           /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
 467 What:           /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
 468 What:           /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
 469 What:           /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
 470 What:           /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
 471 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
 472 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
 473 What:           /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
 474 What:           /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
 475 What:           /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
 476 What:           /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
 477 KernelVersion:  2.6.37
 478 Contact:        linux-iio@vger.kernel.org
 479 Description:
 480                 Event generated when channel passes a threshold on the rate of
 481                 change (1st differential) in the specified (_rising|_falling)
 482                 direction. If the direction is not specified, then either the
 483                 device will report an event which ever direction a single
 484                 threshold value is passed in (e.g.
 485                 <type>[Y][_name]_<raw|input>_roc_value) or
 486                 <type>[Y][_name]_<raw|input>_roc_rising_value and
 487                 <type>[Y][_name]_<raw|input>_roc_falling_value may take
 488                 different values, but the device can only enable both rate of
 489                 change thresholds or neither.
 490                 Note the driver will assume the last p events requested are
 491                 to be enabled where p is however many it supports (which may
 492                 vary depending on the exact set requested. So if you want to be
 493                 sure you have set what you think you have, check the contents of
 494                 these attributes after everything is configured. Drivers may
 495                 have to buffer any parameters so that they are consistent when
 496                 a given event type is enabled a future point (and not those for
 497                 whatever event was previously enabled).
 498
 499 What:           /sys/.../events/in_accel_x_raw_thresh_rising_value
 500 What:           /sys/.../events/in_accel_x_raw_thresh_falling_value
 501 What:           /sys/.../events/in_accel_y_raw_thresh_rising_value
 502 What:           /sys/.../events/in_accel_y_raw_thresh_falling_value
 503 What:           /sys/.../events/in_accel_z_raw_thresh_rising_value
 504 What:           /sys/.../events/in_accel_z_raw_thresh_falling_value
 505 What:           /sys/.../events/in_anglvel_x_raw_thresh_rising_value
 506 What:           /sys/.../events/in_anglvel_x_raw_thresh_falling_value
 507 What:           /sys/.../events/in_anglvel_y_raw_thresh_rising_value
 508 What:           /sys/.../events/in_anglvel_y_raw_thresh_falling_value
 509 What:           /sys/.../events/in_anglvel_z_raw_thresh_rising_value
 510 What:           /sys/.../events/in_anglvel_z_raw_thresh_falling_value
 511 What:           /sys/.../events/in_magn_x_raw_thresh_rising_value
 512 What:           /sys/.../events/in_magn_x_raw_thresh_falling_value
 513 What:           /sys/.../events/in_magn_y_raw_thresh_rising_value
 514 What:           /sys/.../events/in_magn_y_raw_thresh_falling_value
 515 What:           /sys/.../events/in_magn_z_raw_thresh_rising_value
 516 What:           /sys/.../events/in_magn_z_raw_thresh_falling_value
 517 What:           /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
 518 What:           /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
 519 What:           /sys/.../events/in_voltageY_raw_thresh_rising_value
 520 What:           /sys/.../events/in_voltageY_raw_thresh_falling_value
 521 What:           /sys/.../events/in_tempY_raw_thresh_rising_value
 522 What:           /sys/.../events/in_tempY_raw_thresh_falling_value
 523 What:           /sys/.../events/in_illuminance0_thresh_falling_value
 524 what:           /sys/.../events/in_illuminance0_thresh_rising_value
 525 what:           /sys/.../events/in_proximity0_thresh_falling_value
 526 what:           /sys/.../events/in_proximity0_thresh_rising_value
 527 KernelVersion:  2.6.37
 528 Contact:        linux-iio@vger.kernel.org
 529 Description:
 530                 Specifies the value of threshold that the device is comparing
 531                 against for the events enabled by
 532                 <type>Y[_name]_thresh[_rising|falling]_en.
 533                 If separate attributes exist for the two directions, but
 534                 direction is not specified for this attribute, then a single
 535                 threshold value applies to both directions.
 536                 The raw or input element of the name indicates whether the
 537                 value is in raw device units or in processed units (as _raw
 538                 and _input do on sysfs direct channel read attributes).
 539
 540 What:           /sys/.../events/in_accel_x_raw_roc_rising_value
 541 What:           /sys/.../events/in_accel_x_raw_roc_falling_value
 542 What:           /sys/.../events/in_accel_y_raw_roc_rising_value
 543 What:           /sys/.../events/in_accel_y_raw_roc_falling_value
 544 What:           /sys/.../events/in_accel_z_raw_roc_rising_value
 545 What:           /sys/.../events/in_accel_z_raw_roc_falling_value
 546 What:           /sys/.../events/in_anglvel_x_raw_roc_rising_value
 547 What:           /sys/.../events/in_anglvel_x_raw_roc_falling_value
 548 What:           /sys/.../events/in_anglvel_y_raw_roc_rising_value
 549 What:           /sys/.../events/in_anglvel_y_raw_roc_falling_value
 550 What:           /sys/.../events/in_anglvel_z_raw_roc_rising_value
 551 What:           /sys/.../events/in_anglvel_z_raw_roc_falling_value
 552 What:           /sys/.../events/in_magn_x_raw_roc_rising_value
 553 What:           /sys/.../events/in_magn_x_raw_roc_falling_value
 554 What:           /sys/.../events/in_magn_y_raw_roc_rising_value
 555 What:           /sys/.../events/in_magn_y_raw_roc_falling_value
 556 What:           /sys/.../events/in_magn_z_raw_roc_rising_value
 557 What:           /sys/.../events/in_magn_z_raw_roc_falling_value
 558 What:           /sys/.../events/in_voltageY_supply_raw_roc_rising_value
 559 What:           /sys/.../events/in_voltageY_supply_raw_roc_falling_value
 560 What:           /sys/.../events/in_voltageY_raw_roc_rising_value
 561 What:           /sys/.../events/in_voltageY_raw_roc_falling_value
 562 What:           /sys/.../events/in_tempY_raw_roc_rising_value
 563 What:           /sys/.../events/in_tempY_raw_roc_falling_value
 564 KernelVersion:  2.6.37
 565 Contact:        linux-iio@vger.kernel.org
 566 Description:
 567                 Specifies the value of rate of change threshold that the
 568                 device is comparing against for the events enabled by
 569                 <type>[Y][_name]_roc[_rising|falling]_en.
 570                 If separate attributes exist for the two directions,
 571                 but direction is not specified for this attribute,
 572                 then a single threshold value applies to both directions.
 573                 The raw or input element of the name indicates whether the
 574                 value is in raw device units or in processed units (as _raw
 575                 and _input do on sysfs direct channel read attributes).
 576
 577 What:           /sys/.../events/in_accel_x_thresh_rising_period
 578 What:           /sys/.../events/in_accel_x_thresh_falling_period
 579 hat:            /sys/.../events/in_accel_x_roc_rising_period
 580 What:           /sys/.../events/in_accel_x_roc_falling_period
 581 What:           /sys/.../events/in_accel_y_thresh_rising_period
 582 What:           /sys/.../events/in_accel_y_thresh_falling_period
 583 What:           /sys/.../events/in_accel_y_roc_rising_period
 584 What:           /sys/.../events/in_accel_y_roc_falling_period
 585 What:           /sys/.../events/in_accel_z_thresh_rising_period
 586 What:           /sys/.../events/in_accel_z_thresh_falling_period
 587 What:           /sys/.../events/in_accel_z_roc_rising_period
 588 What:           /sys/.../events/in_accel_z_roc_falling_period
 589 What:           /sys/.../events/in_anglvel_x_thresh_rising_period
 590 What:           /sys/.../events/in_anglvel_x_thresh_falling_period
 591 What:           /sys/.../events/in_anglvel_x_roc_rising_period
 592 What:           /sys/.../events/in_anglvel_x_roc_falling_period
 593 What:           /sys/.../events/in_anglvel_y_thresh_rising_period
 594 What:           /sys/.../events/in_anglvel_y_thresh_falling_period
 595 What:           /sys/.../events/in_anglvel_y_roc_rising_period
 596 What:           /sys/.../events/in_anglvel_y_roc_falling_period
 597 What:           /sys/.../events/in_anglvel_z_thresh_rising_period
 598 What:           /sys/.../events/in_anglvel_z_thresh_falling_period
 599 What:           /sys/.../events/in_anglvel_z_roc_rising_period
 600 What:           /sys/.../events/in_anglvel_z_roc_falling_period
 601 What:           /sys/.../events/in_magn_x_thresh_rising_period
 602 What:           /sys/.../events/in_magn_x_thresh_falling_period
 603 What:           /sys/.../events/in_magn_x_roc_rising_period
 604 What:           /sys/.../events/in_magn_x_roc_falling_period
 605 What:           /sys/.../events/in_magn_y_thresh_rising_period
 606 What:           /sys/.../events/in_magn_y_thresh_falling_period
 607 What:           /sys/.../events/in_magn_y_roc_rising_period
 608 What:           /sys/.../events/in_magn_y_roc_falling_period
 609 What:           /sys/.../events/in_magn_z_thresh_rising_period
 610 What:           /sys/.../events/in_magn_z_thresh_falling_period
 611 What:           /sys/.../events/in_magn_z_roc_rising_period
 612 What:           /sys/.../events/in_magn_z_roc_falling_period
 613 What:           /sys/.../events/in_voltageY_supply_thresh_rising_period
 614 What:           /sys/.../events/in_voltageY_supply_thresh_falling_period
 615 What:           /sys/.../events/in_voltageY_supply_roc_rising_period
 616 What:           /sys/.../events/in_voltageY_supply_roc_falling_period
 617 What:           /sys/.../events/in_voltageY_thresh_rising_period
 618 What:           /sys/.../events/in_voltageY_thresh_falling_period
 619 What:           /sys/.../events/in_voltageY_roc_rising_period
 620 What:           /sys/.../events/in_voltageY_roc_falling_period
 621 What:           /sys/.../events/in_tempY_thresh_rising_period
 622 What:           /sys/.../events/in_tempY_thresh_falling_period
 623 What:           /sys/.../events/in_tempY_roc_rising_period
 624 What:           /sys/.../events/in_tempY_roc_falling_period
 625 What:           /sys/.../events/in_accel_x&y&z_mag_falling_period
 626 What:           /sys/.../events/in_intensity0_thresh_period
 627 What:           /sys/.../events/in_proximity0_thresh_period
 628 KernelVersion:  2.6.37
 629 Contact:        linux-iio@vger.kernel.org
 630 Description:
 631                 Period of time (in seconds) for which the condition must be
 632                 met before an event is generated. If direction is not
 633                 specified then this period applies to both directions.
 634
 635 What:           /sys/.../iio:deviceX/events/in_accel_mag_en
 636 What:           /sys/.../iio:deviceX/events/in_accel_mag_rising_en
 637 What:           /sys/.../iio:deviceX/events/in_accel_mag_falling_en
 638 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_en
 639 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
 640 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
 641 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_en
 642 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
 643 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
 644 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_en
 645 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
 646 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
 647 What:           /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
 648 What:           /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
 649 KernelVersion:  2.6.37
 650 Contact:        linux-iio@vger.kernel.org
 651 Description:
 652                 Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
 653                 magnitude of the channel is compared to the threshold, not its
 654                 signed value.
 655
 656 What:           /sys/.../events/in_accel_raw_mag_value
 657 What:           /sys/.../events/in_accel_x_raw_mag_rising_value
 658 What:           /sys/.../events/in_accel_y_raw_mag_rising_value
 659 What:           /sys/.../events/in_accel_z_raw_mag_rising_value
 660 KernelVersion:  2.6.37
 661 Contact:        linux-iio@vger.kernel.org
 662 Description:
 663                 The value to which the magnitude of the channel is compared. If
 664                 number or direction is not specified, applies to all channels of
 665                 this type.
 666
 667 What:           /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
 668 KernelVersion:  2.6.35
 669 Contact:        linux-iio@vger.kernel.org
 670 Description:
 671                 The name of the trigger source being used, as per string given
 672                 in /sys/class/iio/triggerY/name.
 673
 674 What:           /sys/bus/iio/devices/iio:deviceX/buffer/length
 675 KernelVersion:  2.6.35
 676 Contact:        linux-iio@vger.kernel.org
 677 Description:
 678                 Number of scans contained by the buffer.
 679
 680 What:           /sys/bus/iio/devices/iio:deviceX/buffer/bytes_per_datum
 681 KernelVersion:  2.6.37
 682 Contact:        linux-iio@vger.kernel.org
 683 Description:
 684                 Bytes per scan.  Due to alignment fun, the scan may be larger
 685                 than implied directly by the scan_element parameters.
 686
 687 What:           /sys/bus/iio/devices/iio:deviceX/buffer/enable
 688 KernelVersion:  2.6.35
 689 Contact:        linux-iio@vger.kernel.org
 690 Description:
 691                 Actually start the buffer capture up.  Will start trigger
 692                 if first device and appropriate.
 693
 694 What:           /sys/bus/iio/devices/iio:deviceX/scan_elements
 695 KernelVersion:  2.6.37
 696 Contact:        linux-iio@vger.kernel.org
 697 Description:
 698                 Directory containing interfaces for elements that will be
 699                 captured for a single triggered sample set in the buffer.
 700
 701 What:           /sys/.../iio:deviceX/scan_elements/in_accel_x_en
 702 What:           /sys/.../iio:deviceX/scan_elements/in_accel_y_en
 703 What:           /sys/.../iio:deviceX/scan_elements/in_accel_z_en
 704 What:           /sys/.../iio:deviceX/scan_elements/in_anglvel_x_en
 705 What:           /sys/.../iio:deviceX/scan_elements/in_anglvel_y_en
 706 What:           /sys/.../iio:deviceX/scan_elements/in_anglvel_z_en
 707 What:           /sys/.../iio:deviceX/scan_elements/in_magn_x_en
 708 What:           /sys/.../iio:deviceX/scan_elements/in_magn_y_en
 709 What:           /sys/.../iio:deviceX/scan_elements/in_magn_z_en
 710 What:           /sys/.../iio:deviceX/scan_elements/in_timestamp_en
 711 What:           /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_en
 712 What:           /sys/.../iio:deviceX/scan_elements/in_voltageY_en
 713 What:           /sys/.../iio:deviceX/scan_elements/in_voltageY-voltageZ_en
 714 What:           /sys/.../iio:deviceX/scan_elements/in_incli_x_en
 715 What:           /sys/.../iio:deviceX/scan_elements/in_incli_y_en
 716 What:           /sys/.../iio:deviceX/scan_elements/in_pressureY_en
 717 What:           /sys/.../iio:deviceX/scan_elements/in_pressure_en
 718 KernelVersion:  2.6.37
 719 Contact:        linux-iio@vger.kernel.org
 720 Description:
 721                 Scan element control for triggered data capture.
 722
 723 What:           /sys/.../iio:deviceX/scan_elements/in_accel_type
 724 What:           /sys/.../iio:deviceX/scan_elements/in_anglvel_type
 725 What:           /sys/.../iio:deviceX/scan_elements/in_magn_type
 726 What:           /sys/.../iio:deviceX/scan_elements/in_incli_type
 727 What:           /sys/.../iio:deviceX/scan_elements/in_voltageY_type
 728 What:           /sys/.../iio:deviceX/scan_elements/in_voltage_type
 729 What:           /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_type
 730 What:           /sys/.../iio:deviceX/scan_elements/in_timestamp_type
 731 What:           /sys/.../iio:deviceX/scan_elements/in_pressureY_type
 732 What:           /sys/.../iio:deviceX/scan_elements/in_pressure_type
 733 KernelVersion:  2.6.37
 734 Contact:        linux-iio@vger.kernel.org
 735 Description:
 736                 Description of the scan element data storage within the buffer
 737                 and hence the form in which it is read from user-space.
 738                 Form is [be|le]:[s|u]bits/storagebits[>>shift].
 739                 be or le specifies big or little endian. s or u specifies if
 740                 signed (2's complement) or unsigned. bits is the number of bits
 741                 of data and storagebits is the space (after padding) that it
 742                 occupies in the buffer. shift if specified, is the shift that
 743                 needs to be applied prior to masking out unused bits. Some
 744                 devices put their data in the middle of the transferred elements
 745                 with additional information on both sides.  Note that some
 746                 devices will have additional information in the unused bits
 747                 so to get a clean value, the bits value must be used to mask
 748                 the buffer output value appropriately.  The storagebits value
 749                 also specifies the data alignment.  So s48/64>>2 will be a
 750                 signed 48 bit integer stored in a 64 bit location aligned to
 751                 a 64 bit boundary. To obtain the clean value, shift right 2
 752                 and apply a mask to zero the top 16 bits of the result.
 753                 For other storage combinations this attribute will be extended
 754                 appropriately.
 755
 756 What:           /sys/.../iio:deviceX/scan_elements/in_accel_type_available
 757 KernelVersion:  2.6.37
 758 Contact:        linux-iio@vger.kernel.org
 759 Description:
 760                 If the type parameter can take one of a small set of values,
 761                 this attribute lists them.
 762
 763 What:           /sys/.../iio:deviceX/scan_elements/in_voltageY_index
 764 What:           /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_index
 765 What:           /sys/.../iio:deviceX/scan_elements/in_accel_x_index
 766 What:           /sys/.../iio:deviceX/scan_elements/in_accel_y_index
 767 What:           /sys/.../iio:deviceX/scan_elements/in_accel_z_index
 768 What:           /sys/.../iio:deviceX/scan_elements/in_anglvel_x_index
 769 What:           /sys/.../iio:deviceX/scan_elements/in_anglvel_y_index
 770 What:           /sys/.../iio:deviceX/scan_elements/in_anglvel_z_index
 771 What:           /sys/.../iio:deviceX/scan_elements/in_magn_x_index
 772 What:           /sys/.../iio:deviceX/scan_elements/in_magn_y_index
 773 What:           /sys/.../iio:deviceX/scan_elements/in_magn_z_index
 774 What:           /sys/.../iio:deviceX/scan_elements/in_incli_x_index
 775 What:           /sys/.../iio:deviceX/scan_elements/in_incli_y_index
 776 What:           /sys/.../iio:deviceX/scan_elements/in_timestamp_index
 777 What:           /sys/.../iio:deviceX/scan_elements/in_pressureY_index
 778 What:           /sys/.../iio:deviceX/scan_elements/in_pressure_index
 779 KernelVersion:  2.6.37
 780 Contact:        linux-iio@vger.kernel.org
 781 Description:
 782                 A single positive integer specifying the position of this
 783                 scan element in the buffer. Note these are not dependent on
 784                 what is enabled and may not be contiguous. Thus for user-space
 785                 to establish the full layout these must be used in conjunction
 786                 with all _en attributes to establish which channels are present,
 787                 and the relevant _type attributes to establish the data storage
 788                 format.
 789
 790 What:           /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
 791 KernelVersion:  2.6.38
 792 Contact:        linux-iio@vger.kernel.org
 793 Description:
 794                 This attribute is used to read the amount of quadrature error
 795                 present in the device at a given time.
 796
 797 What:           /sys/.../iio:deviceX/in_accelX_power_mode
 798 KernelVersion:  3.11
 799 Contact:        linux-iio@vger.kernel.org
 800 Description:
 801                 Specifies the chip power mode.
 802                 low_noise: reduce noise level from ADC,
 803                 low_power: enable low current consumption.
 804                 For a list of available output power modes read
 805                 in_accel_power_mode_available.
 806
 807 What:           /sys/bus/iio/devices/iio:deviceX/store_eeprom
 808 KernelVersion:  3.4.0
 809 Contact:        linux-iio@vger.kernel.org
 810 Description:
 811                 Writing '1' stores the current device configuration into
 812                 on-chip EEPROM. After power-up or chip reset the device will
 813                 automatically load the saved configuration.