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 datardy 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 Celsuis.
 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) Data converted by application of offset then scale to
 152                 radians per second. Has all the equivalent parameters as
 153                 per voltageY. Units after application of scale and offset are
 154                 radians per second.
 155
 156 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
 157 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
 158 What:           /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
 159 KernelVersion:  2.6.35
 160 Contact:        linux-iio@vger.kernel.org
 161 Description:
 162                 Inclination raw reading about axis x, y or z (may be
 163                 arbitrarily assigned). Data converted by application of offset
 164                 and scale to Degrees.
 165
 166 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
 167 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
 168 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
 169 KernelVersion:  2.6.35
 170 Contact:        linux-iio@vger.kernel.org
 171 Description:
 172                 Magnetic field along axis x, y or z (may be arbitrarily
 173                 assigned).  Data converted by application of offset
 174                 then scale to Gauss.
 175
 176 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
 177 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
 178 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
 179 KernelVersion:  2.6.36
 180 Contact:        linux-iio@vger.kernel.org
 181 Description:
 182                 Highest value since some reset condition.  These
 183                 attributes allow access to this and are otherwise
 184                 the direct equivalent of the <type>Y[_name]_raw attributes.
 185
 186 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
 187 KernelVersion:  2.6.36
 188 Contact:        linux-iio@vger.kernel.org
 189 Description:
 190                 A computed peak value based on the sum squared magnitude of
 191                 the underlying value in the specified directions.
 192
 193 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_offset
 194 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
 195 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
 196 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
 197 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
 198 What:           /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
 199 What:           /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
 200 What:           /sys/bus/iio/devices/iio:deviceX/in_temp_offset
 201 KernelVersion:  2.6.35
 202 Contact:        linux-iio@vger.kernel.org
 203 Description:
 204                 If known for a device, offset to be added to <type>[Y]_raw prior
 205                 to scaling by <type>[Y]_scale in order to obtain value in the
 206                 <type> units as specified in <type>[y]_raw documentation.
 207                 Not present if the offset is always 0 or unknown. If Y or
 208                 axis <x|y|z> is not present, then the offset applies to all
 209                 in channels of <type>.
 210                 May be writable if a variable offset can be applied on the
 211                 device. Note that this is different to calibbias which
 212                 is for devices (or drivers) that apply offsets to compensate
 213                 for variation between different instances of the part, typically
 214                 adjusted by using some hardware supported calibration procedure.
 215                 Calibbias is applied internally, offset is applied in userspace
 216                 to the _raw output.
 217
 218 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
 219 What:           /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
 220 What:           /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
 221 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
 222 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_scale
 223 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
 224 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale
 225 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_scale
 226 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
 227 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
 228 What:           /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
 229 KernelVersion:  2.6.35
 230 Contact:        linux-iio@vger.kernel.org
 231 Description:
 232                 If known for a device, scale to be applied to <type>Y[_name]_raw
 233                 post addition of <type>[Y][_name]_offset in order to obtain the
 234                 measured value in <type> units as specified in
 235                 <type>[Y][_name]_raw documentation.  If shared across all in
 236                 channels then Y and <x|y|z> are not present and the value is
 237                 called <type>[Y][_name]_scale. The peak modifier means this
 238                 value is applied to <type>Y[_name]_peak_raw values.
 239
 240 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
 241 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
 242 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
 243 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias
 244 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
 245 What:           /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
 246 What:           /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
 247 What:           /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
 248 KernelVersion:  2.6.35
 249 Contact:        linux-iio@vger.kernel.org
 250 Description:
 251                 Hardware applied calibration offset. (assumed to fix production
 252                 inaccuracies).
 253
 254 What            /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
 255 What            /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
 256 What            /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
 257 What            /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
 258 What            /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
 259 What            /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
 260 What            /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
 261 What            /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
 262 What            /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
 263 what            /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
 264 what            /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
 265 KernelVersion:  2.6.35
 266 Contact:        linux-iio@vger.kernel.org
 267 Description:
 268                 Hardware applied calibration scale factor. (assumed to fix
 269                 production inaccuracies).  If shared across all channels,
 270                 <type>_calibscale is used.
 271
 272 What:           /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
 273 What:           /sys/.../iio:deviceX/in_voltageX_scale_available
 274 What:           /sys/.../iio:deviceX/in_voltage-voltage_scale_available
 275 What:           /sys/.../iio:deviceX/out_voltageX_scale_available
 276 What:           /sys/.../iio:deviceX/in_capacitance_scale_available
 277 KernelVersion:  2.635
 278 Contact:        linux-iio@vger.kernel.org
 279 Description:
 280                 If a discrete set of scale values are available, they
 281                 are listed in this attribute.
 282
 283 What            /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
 284 KernelVersion:  2.6.35
 285 Contact:        linux-iio@vger.kernel.org
 286 Description:
 287                 Hardware applied gain factor. If shared across all channels,
 288                 <type>_hardwaregain is used.
 289
 290 What:           /sys/.../in_accel_filter_low_pass_3db_frequency
 291 What:           /sys/.../in_magn_filter_low_pass_3db_frequency
 292 What:           /sys/.../in_anglvel_filter_low_pass_3db_frequency
 293 KernelVersion:  3.2
 294 Contact:        linux-iio@vger.kernel.org
 295 Description:
 296                 If a known or controllable low pass filter is applied
 297                 to the underlying data channel, then this parameter
 298                 gives the 3dB frequency of the filter in Hz.
 299
 300 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
 301 KernelVersion:  2.6.37
 302 Contact:        linux-iio@vger.kernel.org
 303 Description:
 304                 Raw (unscaled, no bias etc.) output voltage for
 305                 channel Y.  The number must always be specified and
 306                 unique if the output corresponds to a single channel.
 307
 308 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
 309 KernelVersion:  2.6.37
 310 Contact:        linux-iio@vger.kernel.org
 311 Description:
 312                 Raw (unscaled, no bias etc.) output voltage for an aggregate of
 313                 channel Y, channel Z, etc.  This interface is available in cases
 314                 where a single output sets the value for multiple channels
 315                 simultaneously.
 316
 317 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
 318 What:           /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
 319 KernelVersion:  2.6.38
 320 Contact:        linux-iio@vger.kernel.org
 321 Description:
 322                 Specifies the output powerdown mode.
 323                 DAC output stage is disconnected from the amplifier and
 324                 1kohm_to_gnd: connected to ground via an 1kOhm resistor
 325                 100kohm_to_gnd: connected to ground via an 100kOhm resistor
 326                 three_state: left floating
 327                 For a list of available output power down options read
 328                 outX_powerdown_mode_available. If Y is not present the
 329                 mode is shared across all outputs.
 330
 331 What:           /sys/.../iio:deviceX/out_votlageY_powerdown_mode_available
 332 What:           /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
 333 KernelVersion:  2.6.38
 334 Contact:        linux-iio@vger.kernel.org
 335 Description:
 336                 Lists all available output power down modes.
 337                 If Y is not present the mode is shared across all outputs.
 338
 339 What:           /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
 340 What:           /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
 341 KernelVersion:  2.6.38
 342 Contact:        linux-iio@vger.kernel.org
 343 Description:
 344                 Writing 1 causes output Y to enter the power down mode specified
 345                 by the corresponding outY_powerdown_mode. Clearing returns to
 346                 normal operation. Y may be suppressed if all outputs are
 347                 controlled together.
 348
 349 What:           /sys/bus/iio/devices/iio:deviceX/events
 350 KernelVersion:  2.6.35
 351 Contact:        linux-iio@vger.kernel.org
 352 Description:
 353                 Configuration of which hardware generated events are passed up
 354                 to user-space.
 355
 356 What:           /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
 357 What:           /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
 358 What:           /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
 359 What:           /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
 360 What:           /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
 361 What:           /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
 362 What:           /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
 363 What:           /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
 364 What:           /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
 365 What:           /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
 366 What:           /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
 367 What:           /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
 368 What:           /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
 369 What:           /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
 370 What:           /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
 371 What:           /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
 372 What:           /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
 373 What:           /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
 374 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
 375 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
 376 What:           /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
 377 What:           /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
 378 What:           /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
 379 What:           /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
 380 KernelVersion:  2.6.37
 381 Contact:        linux-iio@vger.kernel.org
 382 Description:
 383                 Event generated when channel passes a threshold in the specified
 384                 (_rising|_falling) direction. If the direction is not specified,
 385                 then either the device will report an event which ever direction
 386                 a single threshold value is passed in (e.g.
 387                 <type>[Y][_name]_<raw|input>_thresh_value) or
 388                 <type>[Y][_name]_<raw|input>_thresh_rising_value and
 389                 <type>[Y][_name]_<raw|input>_thresh_falling_value may take
 390                 different values, but the device can only enable both thresholds
 391                 or neither.
 392                 Note the driver will assume the last p events requested are
 393                 to be enabled where p is however many it supports (which may
 394                 vary depending on the exact set requested. So if you want to be
 395                 sure you have set what you think you have, check the contents of
 396                 these attributes after everything is configured. Drivers may
 397                 have to buffer any parameters so that they are consistent when
 398                 a given event type is enabled a future point (and not those for
 399                 whatever event was previously enabled).
 400
 401 What:           /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
 402 What:           /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
 403 What:           /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
 404 What:           /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
 405 What:           /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
 406 What:           /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
 407 What:           /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
 408 What:           /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
 409 What:           /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
 410 What:           /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
 411 What:           /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
 412 What:           /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
 413 What:           /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
 414 What:           /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
 415 What:           /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
 416 What:           /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
 417 What:           /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
 418 What:           /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
 419 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
 420 What:           /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
 421 What:           /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
 422 What:           /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
 423 What:           /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
 424 What:           /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
 425 KernelVersion:  2.6.37
 426 Contact:        linux-iio@vger.kernel.org
 427 Description:
 428                 Event generated when channel passes a threshold on the rate of
 429                 change (1st differential) in the specified (_rising|_falling)
 430                 direction. If the direction is not specified, then either the
 431                 device will report an event which ever direction a single
 432                 threshold value is passed in (e.g.
 433                 <type>[Y][_name]_<raw|input>_roc_value) or
 434                 <type>[Y][_name]_<raw|input>_roc_rising_value and
 435                 <type>[Y][_name]_<raw|input>_roc_falling_value may take
 436                 different values, but the device can only enable both rate of
 437                 change thresholds or neither.
 438                 Note the driver will assume the last p events requested are
 439                 to be enabled where p is however many it supports (which may
 440                 vary depending on the exact set requested. So if you want to be
 441                 sure you have set what you think you have, check the contents of
 442                 these attributes after everything is configured. Drivers may
 443                 have to buffer any parameters so that they are consistent when
 444                 a given event type is enabled a future point (and not those for
 445                 whatever event was previously enabled).
 446
 447 What:           /sys/.../events/in_accel_x_raw_thresh_rising_value
 448 What:           /sys/.../events/in_accel_x_raw_thresh_falling_value
 449 What:           /sys/.../events/in_accel_y_raw_thresh_rising_value
 450 What:           /sys/.../events/in_accel_y_raw_thresh_falling_value
 451 What:           /sys/.../events/in_accel_z_raw_thresh_rising_value
 452 What:           /sys/.../events/in_accel_z_raw_thresh_falling_value
 453 What:           /sys/.../events/in_anglvel_x_raw_thresh_rising_value
 454 What:           /sys/.../events/in_anglvel_x_raw_thresh_falling_value
 455 What:           /sys/.../events/in_anglvel_y_raw_thresh_rising_value
 456 What:           /sys/.../events/in_anglvel_y_raw_thresh_falling_value
 457 What:           /sys/.../events/in_anglvel_z_raw_thresh_rising_value
 458 What:           /sys/.../events/in_anglvel_z_raw_thresh_falling_value
 459 What:           /sys/.../events/in_magn_x_raw_thresh_rising_value
 460 What:           /sys/.../events/in_magn_x_raw_thresh_falling_value
 461 What:           /sys/.../events/in_magn_y_raw_thresh_rising_value
 462 What:           /sys/.../events/in_magn_y_raw_thresh_falling_value
 463 What:           /sys/.../events/in_magn_z_raw_thresh_rising_value
 464 What:           /sys/.../events/in_magn_z_raw_thresh_falling_value
 465 What:           /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
 466 What:           /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
 467 What:           /sys/.../events/in_voltageY_raw_thresh_rising_value
 468 What:           /sys/.../events/in_voltageY_raw_thresh_falling_value
 469 What:           /sys/.../events/in_tempY_raw_thresh_rising_value
 470 What:           /sys/.../events/in_tempY_raw_thresh_falling_value
 471 What:           /sys/.../events/in_illuminance0_thresh_falling_value
 472 what:           /sys/.../events/in_illuminance0_thresh_rising_value
 473 what:           /sys/.../events/in_proximity0_thresh_falling_value
 474 what:           /sys/.../events/in_proximity0_thresh_rising_value
 475 KernelVersion:  2.6.37
 476 Contact:        linux-iio@vger.kernel.org
 477 Description:
 478                 Specifies the value of threshold that the device is comparing
 479                 against for the events enabled by
 480                 <type>Y[_name]_thresh[_rising|falling]_en.
 481                 If separate attributes exist for the two directions, but
 482                 direction is not specified for this attribute, then a single
 483                 threshold value applies to both directions.
 484                 The raw or input element of the name indicates whether the
 485                 value is in raw device units or in processed units (as _raw
 486                 and _input do on sysfs direct channel read attributes).
 487
 488 What:           /sys/.../events/in_accel_x_raw_roc_rising_value
 489 What:           /sys/.../events/in_accel_x_raw_roc_falling_value
 490 What:           /sys/.../events/in_accel_y_raw_roc_rising_value
 491 What:           /sys/.../events/in_accel_y_raw_roc_falling_value
 492 What:           /sys/.../events/in_accel_z_raw_roc_rising_value
 493 What:           /sys/.../events/in_accel_z_raw_roc_falling_value
 494 What:           /sys/.../events/in_anglvel_x_raw_roc_rising_value
 495 What:           /sys/.../events/in_anglvel_x_raw_roc_falling_value
 496 What:           /sys/.../events/in_anglvel_y_raw_roc_rising_value
 497 What:           /sys/.../events/in_anglvel_y_raw_roc_falling_value
 498 What:           /sys/.../events/in_anglvel_z_raw_roc_rising_value
 499 What:           /sys/.../events/in_anglvel_z_raw_roc_falling_value
 500 What:           /sys/.../events/in_magn_x_raw_roc_rising_value
 501 What:           /sys/.../events/in_magn_x_raw_roc_falling_value
 502 What:           /sys/.../events/in_magn_y_raw_roc_rising_value
 503 What:           /sys/.../events/in_magn_y_raw_roc_falling_value
 504 What:           /sys/.../events/in_magn_z_raw_roc_rising_value
 505 What:           /sys/.../events/in_magn_z_raw_roc_falling_value
 506 What:           /sys/.../events/in_voltageY_supply_raw_roc_rising_value
 507 What:           /sys/.../events/in_voltageY_supply_raw_roc_falling_value
 508 What:           /sys/.../events/in_voltageY_raw_roc_rising_value
 509 What:           /sys/.../events/in_voltageY_raw_roc_falling_value
 510 What:           /sys/.../events/in_tempY_raw_roc_rising_value
 511 What:           /sys/.../events/in_tempY_raw_roc_falling_value
 512 KernelVersion:  2.6.37
 513 Contact:        linux-iio@vger.kernel.org
 514 Description:
 515                 Specifies the value of rate of change threshold that the
 516                 device is comparing against for the events enabled by
 517                 <type>[Y][_name]_roc[_rising|falling]_en.
 518                 If separate attributes exist for the two directions,
 519                 but direction is not specified for this attribute,
 520                 then a single threshold value applies to both directions.
 521                 The raw or input element of the name indicates whether the
 522                 value is in raw device units or in processed units (as _raw
 523                 and _input do on sysfs direct channel read attributes).
 524
 525 What:           /sys/.../events/in_accel_x_thresh_rising_period
 526 What:           /sys/.../events/in_accel_x_thresh_falling_period
 527 hat:            /sys/.../events/in_accel_x_roc_rising_period
 528 What:           /sys/.../events/in_accel_x_roc_falling_period
 529 What:           /sys/.../events/in_accel_y_thresh_rising_period
 530 What:           /sys/.../events/in_accel_y_thresh_falling_period
 531 What:           /sys/.../events/in_accel_y_roc_rising_period
 532 What:           /sys/.../events/in_accel_y_roc_falling_period
 533 What:           /sys/.../events/in_accel_z_thresh_rising_period
 534 What:           /sys/.../events/in_accel_z_thresh_falling_period
 535 What:           /sys/.../events/in_accel_z_roc_rising_period
 536 What:           /sys/.../events/in_accel_z_roc_falling_period
 537 What:           /sys/.../events/in_anglvel_x_thresh_rising_period
 538 What:           /sys/.../events/in_anglvel_x_thresh_falling_period
 539 What:           /sys/.../events/in_anglvel_x_roc_rising_period
 540 What:           /sys/.../events/in_anglvel_x_roc_falling_period
 541 What:           /sys/.../events/in_anglvel_y_thresh_rising_period
 542 What:           /sys/.../events/in_anglvel_y_thresh_falling_period
 543 What:           /sys/.../events/in_anglvel_y_roc_rising_period
 544 What:           /sys/.../events/in_anglvel_y_roc_falling_period
 545 What:           /sys/.../events/in_anglvel_z_thresh_rising_period
 546 What:           /sys/.../events/in_anglvel_z_thresh_falling_period
 547 What:           /sys/.../events/in_anglvel_z_roc_rising_period
 548 What:           /sys/.../events/in_anglvel_z_roc_falling_period
 549 What:           /sys/.../events/in_magn_x_thresh_rising_period
 550 What:           /sys/.../events/in_magn_x_thresh_falling_period
 551 What:           /sys/.../events/in_magn_x_roc_rising_period
 552 What:           /sys/.../events/in_magn_x_roc_falling_period
 553 What:           /sys/.../events/in_magn_y_thresh_rising_period
 554 What:           /sys/.../events/in_magn_y_thresh_falling_period
 555 What:           /sys/.../events/in_magn_y_roc_rising_period
 556 What:           /sys/.../events/in_magn_y_roc_falling_period
 557 What:           /sys/.../events/in_magn_z_thresh_rising_period
 558 What:           /sys/.../events/in_magn_z_thresh_falling_period
 559 What:           /sys/.../events/in_magn_z_roc_rising_period
 560 What:           /sys/.../events/in_magn_z_roc_falling_period
 561 What:           /sys/.../events/in_voltageY_supply_thresh_rising_period
 562 What:           /sys/.../events/in_voltageY_supply_thresh_falling_period
 563 What:           /sys/.../events/in_voltageY_supply_roc_rising_period
 564 What:           /sys/.../events/in_voltageY_supply_roc_falling_period
 565 What:           /sys/.../events/in_voltageY_thresh_rising_period
 566 What:           /sys/.../events/in_voltageY_thresh_falling_period
 567 What:           /sys/.../events/in_voltageY_roc_rising_period
 568 What:           /sys/.../events/in_voltageY_roc_falling_period
 569 What:           /sys/.../events/in_tempY_thresh_rising_period
 570 What:           /sys/.../events/in_tempY_thresh_falling_period
 571 What:           /sys/.../events/in_tempY_roc_rising_period
 572 What:           /sys/.../events/in_tempY_roc_falling_period
 573 What:           /sys/.../events/in_accel_x&y&z_mag_falling_period
 574 What:           /sys/.../events/in_intensity0_thresh_period
 575 What:           /sys/.../events/in_proximity0_thresh_period
 576 KernelVersion:  2.6.37
 577 Contact:        linux-iio@vger.kernel.org
 578 Description:
 579                 Period of time (in seconds) for which the condition must be
 580                 met before an event is generated. If direction is not
 581                 specified then this period applies to both directions.
 582
 583 What:           /sys/.../iio:deviceX/events/in_accel_mag_en
 584 What:           /sys/.../iio:deviceX/events/in_accel_mag_rising_en
 585 What:           /sys/.../iio:deviceX/events/in_accel_mag_falling_en
 586 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_en
 587 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
 588 What:           /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
 589 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_en
 590 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
 591 What:           /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
 592 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_en
 593 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
 594 What:           /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
 595 What:           /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
 596 What:           /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
 597 KernelVersion:  2.6.37
 598 Contact:        linux-iio@vger.kernel.org
 599 Description:
 600                 Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
 601                 magnitude of the channel is compared to the threshold, not its
 602                 signed value.
 603
 604 What:           /sys/.../events/in_accel_raw_mag_value
 605 What:           /sys/.../events/in_accel_x_raw_mag_rising_value
 606 What:           /sys/.../events/in_accel_y_raw_mag_rising_value
 607 What:           /sys/.../events/in_accel_z_raw_mag_rising_value
 608 KernelVersion:  2.6.37
 609 Contact:        linux-iio@vger.kernel.org
 610 Description:
 611                 The value to which the magnitude of the channel is compared. If
 612                 number or direction is not specified, applies to all channels of
 613                 this type.
 614
 615 What:           /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
 616 KernelVersion:  2.6.35
 617 Contact:        linux-iio@vger.kernel.org
 618 Description:
 619                 The name of the trigger source being used, as per string given
 620                 in /sys/class/iio/triggerY/name.
 621
 622 What:           /sys/bus/iio/devices/iio:deviceX/buffer/length
 623 KernelVersion:  2.6.35
 624 Contact:        linux-iio@vger.kernel.org
 625 Description:
 626                 Number of scans contained by the buffer.
 627
 628 What:           /sys/bus/iio/devices/iio:deviceX/buffer/bytes_per_datum
 629 KernelVersion:  2.6.37
 630 Contact:        linux-iio@vger.kernel.org
 631 Description:
 632                 Bytes per scan.  Due to alignment fun, the scan may be larger
 633                 than implied directly by the scan_element parameters.
 634
 635 What:           /sys/bus/iio/devices/iio:deviceX/buffer/enable
 636 KernelVersion:  2.6.35
 637 Contact:        linux-iio@vger.kernel.org
 638 Description:
 639                 Actually start the buffer capture up.  Will start trigger
 640                 if first device and appropriate.
 641
 642 What:           /sys/bus/iio/devices/iio:deviceX/buffer/scan_elements
 643 KernelVersion:  2.6.37
 644 Contact:        linux-iio@vger.kernel.org
 645 Description:
 646                 Directory containing interfaces for elements that will be
 647                 captured for a single triggered sample set in the buffer.
 648
 649 What:           /sys/.../buffer/scan_elements/in_accel_x_en
 650 What:           /sys/.../buffer/scan_elements/in_accel_y_en
 651 What:           /sys/.../buffer/scan_elements/in_accel_z_en
 652 What:           /sys/.../buffer/scan_elements/in_anglvel_x_en
 653 What:           /sys/.../buffer/scan_elements/in_anglvel_y_en
 654 What:           /sys/.../buffer/scan_elements/in_anglvel_z_en
 655 What:           /sys/.../buffer/scan_elements/in_magn_x_en
 656 What:           /sys/.../buffer/scan_elements/in_magn_y_en
 657 What:           /sys/.../buffer/scan_elements/in_magn_z_en
 658 What:           /sys/.../buffer/scan_elements/in_timestamp_en
 659 What:           /sys/.../buffer/scan_elements/in_voltageY_supply_en
 660 What:           /sys/.../buffer/scan_elements/in_voltageY_en
 661 What:           /sys/.../buffer/scan_elements/in_voltageY-voltageZ_en
 662 What:           /sys/.../buffer/scan_elements/in_incli_x_en
 663 What:           /sys/.../buffer/scan_elements/in_incli_y_en
 664 KernelVersion:  2.6.37
 665 Contact:        linux-iio@vger.kernel.org
 666 Description:
 667                 Scan element control for triggered data capture.
 668
 669 What:           /sys/.../buffer/scan_elements/in_accel_type
 670 What:           /sys/.../buffer/scan_elements/in_anglvel_type
 671 What:           /sys/.../buffer/scan_elements/in_magn_type
 672 What:           /sys/.../buffer/scan_elements/in_incli_type
 673 What:           /sys/.../buffer/scan_elements/in_voltageY_type
 674 What:           /sys/.../buffer/scan_elements/in_voltage-in_type
 675 What:           /sys/.../buffer/scan_elements/in_voltageY_supply_type
 676 What:           /sys/.../buffer/scan_elements/in_timestamp_type
 677 KernelVersion:  2.6.37
 678 Contact:        linux-iio@vger.kernel.org
 679 Description:
 680                 Description of the scan element data storage within the buffer
 681                 and hence the form in which it is read from user-space.
 682                 Form is [be|le]:[s|u]bits/storagebits[>>shift].
 683                 be or le specifies big or little endian. s or u specifies if
 684                 signed (2's complement) or unsigned. bits is the number of bits
 685                 of data and storagebits is the space (after padding) that it
 686                 occupies in the buffer. shift if specified, is the shift that
 687                 needs to be applied prior to masking out unused bits. Some
 688                 devices put their data in the middle of the transferred elements
 689                 with additional information on both sides.  Note that some
 690                 devices will have additional information in the unused bits
 691                 so to get a clean value, the bits value must be used to mask
 692                 the buffer output value appropriately.  The storagebits value
 693                 also specifies the data alignment.  So s48/64>>2 will be a
 694                 signed 48 bit integer stored in a 64 bit location aligned to
 695                 a a64 bit boundary. To obtain the clean value, shift right 2
 696                 and apply a mask to zero the top 16 bits of the result.
 697                 For other storage combinations this attribute will be extended
 698                 appropriately.
 699
 700 What:           /sys/.../buffer/scan_elements/in_accel_type_available
 701 KernelVersion:  2.6.37
 702 Contact:        linux-iio@vger.kernel.org
 703 Description:
 704                 If the type parameter can take one of a small set of values,
 705                 this attribute lists them.
 706
 707 What:           /sys/.../buffer/scan_elements/in_voltageY_index
 708 What:           /sys/.../buffer/scan_elements/in_voltageY_supply_index
 709 What:           /sys/.../buffer/scan_elements/in_accel_x_index
 710 What:           /sys/.../buffer/scan_elements/in_accel_y_index
 711 What:           /sys/.../buffer/scan_elements/in_accel_z_index
 712 What:           /sys/.../buffer/scan_elements/in_anglvel_x_index
 713 What:           /sys/.../buffer/scan_elements/in_anglvel_y_index
 714 What:           /sys/.../buffer/scan_elements/in_anglvel_z_index
 715 What:           /sys/.../buffer/scan_elements/in_magn_x_index
 716 What:           /sys/.../buffer/scan_elements/in_magn_y_index
 717 What:           /sys/.../buffer/scan_elements/in_magn_z_index
 718 What:           /sys/.../buffer/scan_elements/in_incli_x_index
 719 What:           /sys/.../buffer/scan_elements/in_incli_y_index
 720 What:           /sys/.../buffer/scan_elements/in_timestamp_index
 721 KernelVersion:  2.6.37
 722 Contact:        linux-iio@vger.kernel.org
 723 Description:
 724                 A single positive integer specifying the position of this
 725                 scan element in the buffer. Note these are not dependent on
 726                 what is enabled and may not be contiguous. Thus for user-space
 727                 to establish the full layout these must be used in conjunction
 728                 with all _en attributes to establish which channels are present,
 729                 and the relevant _type attributes to establish the data storage
 730                 format.
 731
 732 What:           /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
 733 KernelVersion:  2.6.38
 734 Contact:        linux-iio@vger.kernel.org
 735 Description:
 736                 This attribute is used to read the amount of quadrature error
 737                 present in the device at a given time.