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