1What: /sys/bus/iio/devices/iio:deviceX 2KernelVersion: 2.6.35 3Contact: linux-iio@vger.kernel.org 4Description: 5 Hardware chip or device accessed by one communication port. 6 Corresponds to a grouping of sensor channels. X is the IIO 7 index of the device. 8 9What: /sys/bus/iio/devices/triggerX 10KernelVersion: 2.6.35 11Contact: linux-iio@vger.kernel.org 12Description: 13 An event driven driver of data capture to an in kernel buffer. 14 May be provided by a device driver that also has an IIO device 15 based on hardware generated events (e.g. data ready) or 16 provided by a separate driver for other hardware (e.g. 17 periodic timer, GPIO or high resolution timer). 18 19 Contains trigger type specific elements. These do not 20 generalize well and hence are not documented in this file. 21 X is the IIO index of the trigger. 22 23What: /sys/bus/iio/devices/iio:deviceX/buffer 24KernelVersion: 2.6.35 25Contact: linux-iio@vger.kernel.org 26Description: 27 Directory of attributes relating to the buffer for the device. 28 29What: /sys/bus/iio/devices/iio:deviceX/name 30KernelVersion: 2.6.35 31Contact: linux-iio@vger.kernel.org 32Description: 33 Description of the physical chip / device for device X. 34 Typically a part number. 35 36What: /sys/bus/iio/devices/iio:deviceX/label 37KernelVersion: 5.8 38Contact: linux-iio@vger.kernel.org 39Description: 40 Optional symbolic label for a device. 41 This is useful for userspace to be able to better identify an 42 individual device. 43 44 The contents of the label are free-form, but there are some 45 standardized uses: 46 47 For proximity sensors which give the proximity (of a person) to 48 a certain wlan or wwan antenna the following standardized labels 49 are used: 50 51 * "proximity-wifi" 52 * "proximity-lte" 53 * "proximity-wifi-lte" 54 * "proximity-wifi-left" 55 * "proximity-wifi-right" 56 57 These are used to indicate to userspace that these proximity 58 sensors may be used to tune transmit power to ensure that 59 Specific Absorption Rate (SAR) limits are honored. 60 The "-left" and "-right" labels are for devices with multiple 61 antennas. 62 63 In some laptops/tablets the standardized proximity sensor labels 64 instead indicate proximity to a specific part of the device: 65 66 * "proximity-palmrest" indicates proximity to the keyboard's palmrest 67 * "proximity-palmrest-left" indicates proximity to the left part of the palmrest 68 * "proximity-palmrest-right" indicates proximity to the right part of the palmrest 69 * "proximity-lap" indicates the device is being used on someone's lap 70 71 Note "proximity-lap" is special in that its value may be 72 calculated by firmware from other sensor readings, rather then 73 being a raw sensor reading. 74 75 For accelerometers used in 2-in-1s with 360° (yoga-style) hinges, 76 which have an accelerometer in both their base and their display, 77 the following standardized labels are used: 78 79 * "accel-base" 80 * "accel-display" 81 82 For devices where an accelerometer is housed in the swivel camera subassembly 83 (for AR application), the following standardized label is used: 84 85 * "accel-camera" 86 87What: /sys/bus/iio/devices/iio:deviceX/current_timestamp_clock 88KernelVersion: 4.5 89Contact: linux-iio@vger.kernel.org 90Description: 91 String identifying current posix clock used to timestamp 92 buffered samples and events for device X. 93 94What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency 95What: /sys/bus/iio/devices/iio:deviceX/in_intensity_sampling_frequency 96What: /sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency 97What: /sys/bus/iio/devices/triggerX/sampling_frequency 98KernelVersion: 2.6.35 99Contact: linux-iio@vger.kernel.org 100Description: 101 Some devices have internal clocks. This parameter sets the 102 resulting sampling frequency. In many devices this 103 parameter has an effect on input filters etc. rather than 104 simply controlling when the input is sampled. As this 105 affects data ready triggers, hardware buffers and the sysfs 106 direct access interfaces, it may be found in any of the 107 relevant directories. If it affects all of the above 108 then it is to be found in the base device directory. 109 110 The stm32-timer-trigger has the additional characteristic that 111 a sampling_frequency of 0 is defined to stop sampling. 112 113What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency_available 114What: /sys/bus/iio/devices/iio:deviceX/in_intensity_sampling_frequency_available 115What: /sys/bus/iio/devices/iio:deviceX/in_proximity_sampling_frequency_available 116What: /sys/.../iio:deviceX/buffer/sampling_frequency_available 117What: /sys/bus/iio/devices/triggerX/sampling_frequency_available 118KernelVersion: 2.6.35 119Contact: linux-iio@vger.kernel.org 120Description: 121 When the internal sampling clock can only take a specific set of 122 frequencies, we can specify the available values with: 123 124 - a small discrete set of values like "0 2 4 6 8" 125 - a range with minimum, step and maximum frequencies like 126 "[min step max]" 127 128What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio 129KernelVersion: 2.6.38 130Contact: linux-iio@vger.kernel.org 131Description: 132 Hardware dependent ADC oversampling. Controls the sampling ratio 133 of the digital filter if available. 134 135What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available 136KernelVersion: 2.6.38 137Contact: linux-iio@vger.kernel.org 138Description: 139 Hardware dependent values supported by the oversampling filter. 140 141What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw 142What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw 143What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_raw 144What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_raw 145KernelVersion: 2.6.35 146Contact: linux-iio@vger.kernel.org 147Description: 148 Raw (unscaled no bias removal etc.) voltage measurement from 149 channel Y. In special cases where the channel does not 150 correspond to externally available input one of the named 151 versions may be used. The number must always be specified and 152 unique to allow association with event codes. Units after 153 application of scale and offset are millivolts. 154 155 Channels with 'i' and 'q' modifiers always exist in pairs and both 156 channels refer to the same signal. The 'i' channel contains the in-phase 157 component of the signal while the 'q' channel contains the quadrature 158 component. 159 160What: /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw 161KernelVersion: 2.6.35 162Contact: linux-iio@vger.kernel.org 163Description: 164 Raw (unscaled) differential voltage measurement equivalent to 165 channel Y - channel Z where these channel numbers apply to the 166 physically equivalent inputs when non differential readings are 167 separately available. In differential only parts, then all that 168 is required is a consistent labeling. Units after application 169 of scale and offset are millivolts. 170 171What: /sys/bus/iio/devices/iio:deviceX/in_currentY_raw 172What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_raw 173KernelVersion: 3.17 174Contact: linux-iio@vger.kernel.org 175Description: 176 Raw (unscaled no bias removal etc.) current measurement from 177 channel Y. In special cases where the channel does not 178 correspond to externally available input one of the named 179 versions may be used. The number must always be specified and 180 unique to allow association with event codes. Units after 181 application of scale and offset are milliamps. 182 183What: /sys/bus/iio/devices/iio:deviceX/in_powerY_raw 184KernelVersion: 4.5 185Contact: linux-iio@vger.kernel.org 186Description: 187 Raw (unscaled no bias removal etc.) power measurement from 188 channel Y. The number must always be specified and 189 unique to allow association with event codes. Units after 190 application of scale and offset are milliwatts. 191 192What: /sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw 193KernelVersion: 3.2 194Contact: linux-iio@vger.kernel.org 195Description: 196 Raw capacitance measurement from channel Y. Units after 197 application of scale and offset are nanofarads. 198 199What: /sys/.../iio:deviceX/in_capacitanceY-capacitanceZ_raw 200KernelVersion: 3.2 201Contact: linux-iio@vger.kernel.org 202Description: 203 Raw differential capacitance measurement equivalent to 204 channel Y - channel Z where these channel numbers apply to the 205 physically equivalent inputs when non differential readings are 206 separately available. In differential only parts, then all that 207 is required is a consistent labeling. Units after application 208 of scale and offset are nanofarads. 209 210What: /sys/.../iio:deviceX/in_capacitanceY-capacitanceZ_zeropoint 211KernelVersion: 6.1 212Contact: linux-iio@vger.kernel.org 213Description: 214 For differential channels, this an offset that is applied 215 equally to both inputs. As the reading is of the difference 216 between the two inputs, this should not be applied to the _raw 217 reading by userspace (unlike _offset) and unlike calibbias 218 it does not affect the differential value measured because 219 the effect of _zeropoint cancels out across the two inputs 220 that make up the differential pair. It's purpose is to bring 221 the individual signals, before the differential is measured, 222 within the measurement range of the device. The naming is 223 chosen because if the separate inputs that make the 224 differential pair are drawn on a graph in their 225 _raw units, this is the value that the zero point on the 226 measurement axis represents. It is expressed with the 227 same scaling as _raw. 228 229What: /sys/bus/iio/devices/iio:deviceX/in_temp_raw 230What: /sys/bus/iio/devices/iio:deviceX/in_tempX_raw 231What: /sys/bus/iio/devices/iio:deviceX/in_temp_x_raw 232What: /sys/bus/iio/devices/iio:deviceX/in_temp_y_raw 233What: /sys/bus/iio/devices/iio:deviceX/in_temp_ambient_raw 234What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_raw 235KernelVersion: 2.6.35 236Contact: linux-iio@vger.kernel.org 237Description: 238 Raw (unscaled no bias removal etc.) temperature measurement. 239 If an axis is specified it generally means that the temperature 240 sensor is associated with one part of a compound device (e.g. 241 a gyroscope axis). The ambient and object modifiers distinguish 242 between ambient (reference) and distant temperature for contact- 243 less measurements. Units after application of scale and offset 244 are milli degrees Celsius. 245 246What: /sys/bus/iio/devices/iio:deviceX/in_tempX_input 247KernelVersion: 2.6.38 248Contact: linux-iio@vger.kernel.org 249Description: 250 Scaled temperature measurement in milli degrees Celsius. 251 252What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw 253What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_raw 254What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_raw 255KernelVersion: 2.6.35 256Contact: linux-iio@vger.kernel.org 257Description: 258 Acceleration in direction x, y or z (may be arbitrarily assigned 259 but should match other such assignments on device). 260 Has all of the equivalent parameters as per voltageY. Units 261 after application of scale and offset are m/s^2. 262 263What: /sys/bus/iio/devices/iio:deviceX/in_accel_linear_x_raw 264What: /sys/bus/iio/devices/iio:deviceX/in_accel_linear_y_raw 265What: /sys/bus/iio/devices/iio:deviceX/in_accel_linear_z_raw 266KernelVersion: 6.1 267Contact: linux-iio@vger.kernel.org 268Description: 269 As per in_accel_X_raw attributes, but minus the 270 acceleration due to gravity. 271 272What: /sys/bus/iio/devices/iio:deviceX/in_gravity_x_raw 273What: /sys/bus/iio/devices/iio:deviceX/in_gravity_y_raw 274What: /sys/bus/iio/devices/iio:deviceX/in_gravity_z_raw 275KernelVersion: 4.11 276Contact: linux-iio@vger.kernel.org 277Description: 278 Gravity in direction x, y or z (may be arbitrarily assigned 279 but should match other such assignments on device). 280 Units after application of scale and offset are m/s^2. 281 282What: /sys/bus/iio/devices/iio:deviceX/in_deltaangl_x_raw 283What: /sys/bus/iio/devices/iio:deviceX/in_deltaangl_y_raw 284What: /sys/bus/iio/devices/iio:deviceX/in_deltaangl_z_raw 285KernelVersion: 6.5 286Contact: linux-iio@vger.kernel.org 287Description: 288 Angular displacement between two consecutive samples on x, y or 289 z (may be arbitrarily assigned but should match other such 290 assignments on device). 291 In order to compute the total angular displacement during a 292 desired period of time, the application should sum-up the delta 293 angle samples acquired during that time. 294 Units after application of scale and offset are radians. 295 296What: /sys/bus/iio/devices/iio:deviceX/in_deltavelocity_x_raw 297What: /sys/bus/iio/devices/iio:deviceX/in_deltavelocity_y_raw 298What: /sys/bus/iio/devices/iio:deviceX/in_deltavelocity_z_raw 299KernelVersion: 6.5 300Contact: linux-iio@vger.kernel.org 301Description: 302 The linear velocity change between two consecutive samples on x, 303 y or z (may be arbitrarily assigned but should match other such 304 assignments on device). 305 In order to compute the total linear velocity change during a 306 desired period of time, the application should sum-up the delta 307 velocity samples acquired during that time. 308 Units after application of scale and offset are meters per 309 second. 310 311What: /sys/bus/iio/devices/iio:deviceX/in_angl_raw 312What: /sys/bus/iio/devices/iio:deviceX/in_anglY_raw 313KernelVersion: 4.17 314Contact: linux-iio@vger.kernel.org 315Description: 316 Angle of rotation. Units after application of scale and offset 317 are radians. 318 319What: /sys/bus/iio/devices/iio:deviceX/in_positionrelative_x_raw 320What: /sys/bus/iio/devices/iio:deviceX/in_positionrelative_y_raw 321KernelVersion: 4.19 322Contact: linux-iio@vger.kernel.org 323Description: 324 Relative position in direction x or y on a pad (may be 325 arbitrarily assigned but should match other such assignments on 326 device). 327 Units after application of scale and offset are milli percents 328 from the pad's size in both directions. Should be calibrated by 329 the consumer. 330 331What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw 332What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw 333What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw 334KernelVersion: 2.6.35 335Contact: linux-iio@vger.kernel.org 336Description: 337 Angular velocity about axis x, y or z (may be arbitrarily 338 assigned). Has all the equivalent parameters as per voltageY. 339 Units after application of scale and offset are radians per 340 second. 341 342What: /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw 343What: /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw 344What: /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw 345KernelVersion: 2.6.35 346Contact: linux-iio@vger.kernel.org 347Description: 348 Inclination raw reading about axis x, y or z (may be 349 arbitrarily assigned). Data converted by application of offset 350 and scale to degrees. 351 352What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw 353What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw 354What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw 355KernelVersion: 2.6.35 356Contact: linux-iio@vger.kernel.org 357Description: 358 Magnetic field along axis x, y or z (may be arbitrarily 359 assigned). Data converted by application of offset 360 then scale to Gauss. 361 362What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw 363What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw 364What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw 365KernelVersion: 2.6.36 366Contact: linux-iio@vger.kernel.org 367Description: 368 Highest value since some reset condition. These 369 attributes allow access to this and are otherwise 370 the direct equivalent of the <type>Y[_name]_raw attributes. 371 372What: /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw 373KernelVersion: 2.6.36 374Contact: linux-iio@vger.kernel.org 375Description: 376 A computed peak value based on the sum squared magnitude of 377 the underlying value in the specified directions. 378 379What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_raw 380What: /sys/bus/iio/devices/iio:deviceX/in_pressure_raw 381KernelVersion: 3.8 382Contact: linux-iio@vger.kernel.org 383Description: 384 Raw pressure measurement from channel Y. Units after 385 application of scale and offset are kilopascal. 386 387What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_input 388What: /sys/bus/iio/devices/iio:deviceX/in_pressure_input 389KernelVersion: 3.8 390Contact: linux-iio@vger.kernel.org 391Description: 392 Scaled pressure measurement from channel Y, in kilopascal. 393 394What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_raw 395KernelVersion: 3.14 396Contact: linux-iio@vger.kernel.org 397Description: 398 Raw humidity measurement of air. Units after application of 399 scale and offset are milli percent. 400 401What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_input 402KernelVersion: 3.14 403Contact: linux-iio@vger.kernel.org 404Description: 405 Scaled humidity measurement in milli percent. 406 407What: /sys/bus/iio/devices/iio:deviceX/in_X_mean_raw 408KernelVersion: 3.5 409Contact: linux-iio@vger.kernel.org 410Description: 411 Averaged raw measurement from channel X. The number of values 412 used for averaging is device specific. The converting rules for 413 normal raw values also applies to the averaged raw values. 414 415What: /sys/bus/iio/devices/iio:deviceX/in_accel_offset 416What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset 417What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset 418What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset 419What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset 420What: /sys/bus/iio/devices/iio:deviceX/in_voltage_offset 421What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_offset 422What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_offset 423What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_offset 424What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_offset 425What: /sys/bus/iio/devices/iio:deviceX/in_currentY_offset 426What: /sys/bus/iio/devices/iio:deviceX/in_current_offset 427What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_offset 428What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_offset 429What: /sys/bus/iio/devices/iio:deviceX/in_current_q_offset 430What: /sys/bus/iio/devices/iio:deviceX/in_current_i_offset 431What: /sys/bus/iio/devices/iio:deviceX/in_tempY_offset 432What: /sys/bus/iio/devices/iio:deviceX/in_temp_offset 433What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_offset 434What: /sys/bus/iio/devices/iio:deviceX/in_pressure_offset 435What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_offset 436What: /sys/bus/iio/devices/iio:deviceX/in_magn_offset 437What: /sys/bus/iio/devices/iio:deviceX/in_rot_offset 438What: /sys/bus/iio/devices/iio:deviceX/in_angl_offset 439What: /sys/bus/iio/devices/iio:deviceX/in_capacitanceX_offset 440KernelVersion: 2.6.35 441Contact: linux-iio@vger.kernel.org 442Description: 443 If known for a device, offset to be added to <type>[Y]_raw prior 444 to scaling by <type>[Y]_scale in order to obtain value in the 445 <type> units as specified in <type>[Y]_raw documentation. 446 Not present if the offset is always 0 or unknown. If Y or 447 axis <x|y|z> is not present, then the offset applies to all 448 in channels of <type>. 449 May be writable if a variable offset can be applied on the 450 device. Note that this is different to calibbias which 451 is for devices (or drivers) that apply offsets to compensate 452 for variation between different instances of the part, typically 453 adjusted by using some hardware supported calibration procedure. 454 Calibbias is applied internally, offset is applied in userspace 455 to the _raw output. 456 457What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale 458What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_scale 459What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_scale 460What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale 461What: /sys/bus/iio/devices/iio:deviceX/in_voltage_scale 462What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_scale 463What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_scale 464What: /sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_scale 465What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale 466What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale 467What: /sys/bus/iio/devices/iio:deviceX/in_currentY_scale 468What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_scale 469What: /sys/bus/iio/devices/iio:deviceX/in_current_scale 470What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_scale 471What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_scale 472What: /sys/bus/iio/devices/iio:deviceX/in_current_i_scale 473What: /sys/bus/iio/devices/iio:deviceX/in_current_q_scale 474What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale 475What: /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale 476What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale 477What: /sys/bus/iio/devices/iio:deviceX/in_energy_scale 478What: /sys/bus/iio/devices/iio:deviceX/in_distance_scale 479What: /sys/bus/iio/devices/iio:deviceX/in_magn_scale 480What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale 481What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale 482What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale 483What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_scale 484What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_scale 485What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_scale 486What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_scale 487What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_scale 488What: /sys/bus/iio/devices/iio:deviceX/in_pressure_scale 489What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_scale 490What: /sys/bus/iio/devices/iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_scale 491What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_scale 492What: /sys/bus/iio/devices/iio:deviceX/in_countY_scale 493What: /sys/bus/iio/devices/iio:deviceX/in_deltaangl_scale 494What: /sys/bus/iio/devices/iio:deviceX/in_deltavelocity_scale 495What: /sys/bus/iio/devices/iio:deviceX/in_angl_scale 496What: /sys/bus/iio/devices/iio:deviceX/in_intensity_x_scale 497What: /sys/bus/iio/devices/iio:deviceX/in_intensity_y_scale 498What: /sys/bus/iio/devices/iio:deviceX/in_intensity_z_scale 499What: /sys/bus/iio/devices/iio:deviceX/in_concentration_co2_scale 500KernelVersion: 2.6.35 501Contact: linux-iio@vger.kernel.org 502Description: 503 If known for a device, scale to be applied to <type>Y[_name]_raw 504 post addition of <type>[Y][_name]_offset in order to obtain the 505 measured value in <type> units as specified in 506 <type>[Y][_name]_raw documentation. If shared across all in 507 channels then Y and <x|y|z> are not present and the value is 508 called <type>[Y][_name]_scale. The peak modifier means this 509 value is applied to <type>Y[_name]_peak_raw values. 510 511What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias 512What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias 513What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias 514What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias 515What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias 516What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias 517What: /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias 518What: /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias 519What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibbias 520What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibbias 521KernelVersion: 2.6.35 522Contact: linux-iio@vger.kernel.org 523Description: 524 Hardware applied calibration offset (assumed to fix production 525 inaccuracies). 526 icm42600: For this device values are real physical offsets 527 expressed in SI units (m/s^2 for accelerometers and rad/s 528 for gyroscope)/ 529 530What: /sys/bus/iio/devices/iio:deviceX/in_accel_calibbias_available 531What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_calibbias_available 532KernelVersion: 5.8 533Contact: linux-iio@vger.kernel.org 534Description: 535 Available values of calibbias. Maybe expressed as either of: 536 537 - a small discrete set of values like "0 2 4 6 8" 538 - a range specified as "[min step max]" 539 540What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale 541What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale 542What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_calibscale 543What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_calibscale 544What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_calibscale 545What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_calibscale 546What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage_calibscale 547What: /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale 548What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale 549What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale 550What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale 551What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale 552What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale 553What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale 554What: /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale 555What: /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale 556What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibscale 557What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibscale 558What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_calibscale 559KernelVersion: 2.6.35 560Contact: linux-iio@vger.kernel.org 561Description: 562 Hardware applied calibration scale factor (assumed to fix 563 production inaccuracies). If shared across all channels, 564 <type>_calibscale is used. 565 566What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender 567What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender 568What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender 569What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender 570KernelVersion: 4.0 571Contact: linux-iio@vger.kernel.org 572Description: 573 Gender of the user (e.g.: male, female) used by some pedometers 574 to compute the stride length, distance, speed and activity 575 type. 576 577What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender_available 578What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender_available 579What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender_available 580What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender_available 581KernelVersion: 4.0 582Contact: linux-iio@vger.kernel.org 583Description: 584 Lists all available gender values (e.g.: male, female). 585 586What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibheight 587What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibheight 588What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibheight 589What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibheight 590KernelVersion: 3.19 591Contact: linux-iio@vger.kernel.org 592Description: 593 Height of the user (in meters) used by some pedometers 594 to compute the stride length, distance, speed and activity 595 type. 596 597What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibweight 598KernelVersion: 4.0 599Contact: linux-iio@vger.kernel.org 600Description: 601 Weight of the user (in kg). It is needed by some pedometers 602 to compute the calories burnt by the user. 603 604What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available 605What: /sys/.../iio:deviceX/in_anglvel_scale_available 606What: /sys/.../iio:deviceX/in_magn_scale_available 607What: /sys/.../iio:deviceX/in_illuminance_scale_available 608What: /sys/.../iio:deviceX/in_intensity_scale_available 609What: /sys/.../iio:deviceX/in_proximity_scale_available 610What: /sys/.../iio:deviceX/in_voltageX_scale_available 611What: /sys/.../iio:deviceX/in_voltage-voltage_scale_available 612What: /sys/.../iio:deviceX/out_voltageX_scale_available 613What: /sys/.../iio:deviceX/out_altvoltageX_scale_available 614What: /sys/.../iio:deviceX/in_capacitance_scale_available 615What: /sys/.../iio:deviceX/in_pressure_scale_available 616What: /sys/.../iio:deviceX/in_pressureY_scale_available 617KernelVersion: 2.6.35 618Contact: linux-iio@vger.kernel.org 619Description: 620 If a discrete set of scale values is available, they 621 are listed in this attribute. 622 623What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain 624What: /sys/bus/iio/devices/iio:deviceX/in_intensity_hardwaregain 625What: /sys/bus/iio/devices/iio:deviceX/in_intensity_red_hardwaregain 626What: /sys/bus/iio/devices/iio:deviceX/in_intensity_green_hardwaregain 627What: /sys/bus/iio/devices/iio:deviceX/in_intensity_blue_hardwaregain 628What: /sys/bus/iio/devices/iio:deviceX/in_intensity_clear_hardwaregain 629KernelVersion: 2.6.35 630Contact: linux-iio@vger.kernel.org 631Description: 632 Hardware applied gain factor. If shared across all channels, 633 <type>_hardwaregain is used. 634 635What: /sys/bus/iio/devices/iio:deviceX/in_intensity_hardwaregain_available 636KernelVersion: 5.10 637Contact: linux-iio@vger.kernel.org 638Description: 639 Lists all available hardware applied gain factors. Shared across all 640 channels. 641 642What: /sys/.../in_accel_filter_low_pass_3db_frequency 643What: /sys/.../in_magn_filter_low_pass_3db_frequency 644What: /sys/.../in_anglvel_filter_low_pass_3db_frequency 645KernelVersion: 3.2 646Contact: linux-iio@vger.kernel.org 647Description: 648 If a known or controllable low pass filter is applied 649 to the underlying data channel, then this parameter 650 gives the 3dB frequency of the filter in Hz. 651 652What: /sys/.../in_accel_filter_high_pass_3db_frequency 653What: /sys/.../in_anglvel_filter_high_pass_3db_frequency 654What: /sys/.../in_magn_filter_high_pass_3db_frequency 655KernelVersion: 4.2 656Contact: linux-iio@vger.kernel.org 657Description: 658 If a known or controllable high pass filter is applied 659 to the underlying data channel, then this parameter 660 gives the 3dB frequency of the filter in Hz. 661 662What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw 663What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw 664KernelVersion: 2.6.37 665Contact: linux-iio@vger.kernel.org 666Description: 667 Raw (unscaled, no bias etc.) output voltage for 668 channel Y. The number must always be specified and 669 unique if the output corresponds to a single channel. 670 While DAC like devices typically use out_voltage, 671 a continuous frequency generating device, such as 672 a DDS or PLL should use out_altvoltage. 673 674What: /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw 675What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw 676KernelVersion: 2.6.37 677Contact: linux-iio@vger.kernel.org 678Description: 679 Raw (unscaled, no bias etc.) output voltage for an aggregate of 680 channel Y, channel Z, etc. This interface is available in cases 681 where a single output sets the value for multiple channels 682 simultaneously. 683 684What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode 685What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode 686What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode 687What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode 688KernelVersion: 2.6.38 689Contact: linux-iio@vger.kernel.org 690Description: 691 Specifies the output powerdown mode. 692 DAC output stage is disconnected from the amplifier and 693 1kohm_to_gnd: connected to ground via an 1kOhm resistor, 694 2.5kohm_to_gnd: connected to ground via a 2.5kOhm resistor, 695 6kohm_to_gnd: connected to ground via a 6kOhm resistor, 696 20kohm_to_gnd: connected to ground via a 20kOhm resistor, 697 90kohm_to_gnd: connected to ground via a 90kOhm resistor, 698 100kohm_to_gnd: connected to ground via an 100kOhm resistor, 699 125kohm_to_gnd: connected to ground via an 125kOhm resistor, 700 500kohm_to_gnd: connected to ground via a 500kOhm resistor, 701 640kohm_to_gnd: connected to ground via a 640kOhm resistor, 702 three_state: left floating. 703 For a list of available output power down options read 704 outX_powerdown_mode_available. If Y is not present the 705 mode is shared across all outputs. 706 707What: /sys/.../iio:deviceX/out_voltageY_powerdown_mode_available 708What: /sys/.../iio:deviceX/out_voltage_powerdown_mode_available 709What: /sys/.../iio:deviceX/out_altvoltageY_powerdown_mode_available 710What: /sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available 711KernelVersion: 2.6.38 712Contact: linux-iio@vger.kernel.org 713Description: 714 Lists all available output power down modes. 715 If Y is not present the mode is shared across all outputs. 716 717What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown 718What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown 719What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown 720What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown 721KernelVersion: 2.6.38 722Contact: linux-iio@vger.kernel.org 723Description: 724 Writing 1 causes output Y to enter the power down mode specified 725 by the corresponding outY_powerdown_mode. DAC output stage is 726 disconnected from the amplifier. Clearing returns to normal 727 operation. Y may be suppressed if all outputs are controlled 728 together. 729 730What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency 731KernelVersion: 3.4.0 732Contact: linux-iio@vger.kernel.org 733Description: 734 Output frequency for channel Y in Hz. The number must always be 735 specified and unique if the output corresponds to a single 736 channel. 737 Some drivers have additional constraints: 738 ADF4371 has an integrated VCO with fundamendal output 739 frequency ranging from 4000000000 Hz 8000000000 Hz. 740 741 out_altvoltage0_frequency: 742 A divide by 1, 2, 4, 8, 16, 32 or circuit generates 743 frequencies from 62500000 Hz to 8000000000 Hz. 744 out_altvoltage1_frequency: 745 This channel duplicates the channel 0 frequency 746 out_altvoltage2_frequency: 747 A frequency doubler generates frequencies from 748 8000000000 Hz to 16000000000 Hz. 749 out_altvoltage3_frequency: 750 A frequency quadrupler generates frequencies from 751 16000000000 Hz to 32000000000 Hz. 752 753 Note: writes to one of the channels will affect the frequency of 754 all the other channels, since it involves changing the VCO 755 fundamental output frequency. 756 757What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase 758KernelVersion: 3.4.0 759Contact: linux-iio@vger.kernel.org 760Description: 761 Phase in radians of one frequency/clock output Y 762 (out_altvoltageY) relative to another frequency/clock output 763 (out_altvoltageZ) of the device X. The number must always be 764 specified and unique if the output corresponds to a single 765 channel. 766 767What: /sys/bus/iio/devices/iio:deviceX/out_currentY_raw 768Date: May 2012 769KernelVersion: 3.5 770Contact: Johan Hovold <jhovold@gmail.com> 771Description: 772 Set/get output current for channel Y. Units after application 773 of scale and offset are milliamps. 774 For some devices current channels are used to specify 775 current supplied to elements used in taking a measurement 776 of a different type. E.g. LED currents. 777 778What: /sys/bus/iio/devices/iio:deviceX/events 779KernelVersion: 2.6.35 780Contact: linux-iio@vger.kernel.org 781Description: 782 Configuration of which hardware generated events are passed up 783 to user-space. 784 785What: /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en 786What: /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en 787What: /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en 788What: /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en 789What: /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en 790What: /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en 791What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en 792What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en 793What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en 794What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en 795What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en 796What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en 797What: /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en 798What: /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en 799What: /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en 800What: /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en 801What: /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en 802What: /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en 803What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_rising_en 804What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_falling_en 805What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_rising_en 806What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_falling_en 807What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_en 808What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_en 809What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_rising_en 810What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_falling_en 811What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en 812What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en 813What: /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en 814What: /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en 815What: /sys/.../iio:deviceX/events/in_voltageY_thresh_either_en 816What: /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en 817What: /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en 818What: /sys/.../iio:deviceX/events/in_capacitanceY_thresh_rising_en 819What: /sys/.../iio:deviceX/events/in_capacitanceY_thresh_falling_en 820KernelVersion: 2.6.37 821Contact: linux-iio@vger.kernel.org 822Description: 823 Event generated when channel passes a threshold in the specified 824 (_rising|_falling) direction. If the direction is not specified, 825 then either the device will report an event which ever direction 826 a single threshold value is passed in (e.g. 827 <type>[Y][_name]_<raw|input>_thresh_value) or 828 <type>[Y][_name]_<raw|input>_thresh_rising_value and 829 <type>[Y][_name]_<raw|input>_thresh_falling_value may take 830 different values, but the device can only enable both thresholds 831 or neither. 832 833 Note the driver will assume the last p events requested are 834 to be enabled where p is how many it supports (which may vary 835 depending on the exact set requested. So if you want to be 836 sure you have set what you think you have, check the contents of 837 these attributes after everything is configured. Drivers may 838 have to buffer any parameters so that they are consistent when 839 a given event type is enabled at a future point (and not those for 840 whatever event was previously enabled). 841 842What: /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en 843What: /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en 844What: /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en 845What: /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en 846What: /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en 847What: /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en 848What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en 849What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en 850What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en 851What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en 852What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en 853What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en 854What: /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en 855What: /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en 856What: /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en 857What: /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en 858What: /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en 859What: /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en 860What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_rising_en 861What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_falling_en 862What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_rising_en 863What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_falling_en 864What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_rising_en 865What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_falling_en 866What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_rising_en 867What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_falling_en 868What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en 869What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en 870What: /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en 871What: /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en 872What: /sys/.../iio:deviceX/events/in_tempY_roc_rising_en 873What: /sys/.../iio:deviceX/events/in_tempY_roc_falling_en 874KernelVersion: 2.6.37 875Contact: linux-iio@vger.kernel.org 876Description: 877 Event generated when channel passes a threshold on the rate of 878 change (1st differential) in the specified (_rising|_falling) 879 direction. If the direction is not specified, then either the 880 device will report an event which ever direction a single 881 threshold value is passed in (e.g. 882 <type>[Y][_name]_<raw|input>_roc_value) or 883 <type>[Y][_name]_<raw|input>_roc_rising_value and 884 <type>[Y][_name]_<raw|input>_roc_falling_value may take 885 different values, but the device can only enable both rate of 886 change thresholds or neither. 887 888 Note the driver will assume the last p events requested are 889 to be enabled where p is however many it supports (which may 890 vary depending on the exact set requested. So if you want to be 891 sure you have set what you think you have, check the contents of 892 these attributes after everything is configured. Drivers may 893 have to buffer any parameters so that they are consistent when 894 a given event type is enabled a future point (and not those for 895 whatever event was previously enabled). 896 897What: /sys/.../events/in_capacitanceY_adaptive_thresh_rising_en 898What: /sys/.../events/in_capacitanceY_adaptive_thresh_falling_en 899KernelVersion: 5.13 900Contact: linux-iio@vger.kernel.org 901Description: 902 Adaptive thresholds are similar to normal fixed thresholds 903 but the value is expressed as an offset from a value which 904 provides a low frequency approximation of the channel itself. 905 Thus these detect if a rapid change occurs in the specified 906 direction which crosses tracking value + offset. 907 Tracking value calculation is devices specific. 908 909What: /sys/.../in_capacitanceY_adaptive_thresh_rising_timeout 910What: /sys/.../in_capacitanceY_adaptive_thresh_falling_timeout 911KernelVersion: 5.11 912Contact: linux-iio@vger.kernel.org 913Description: 914 When adaptive thresholds are used, the tracking signal 915 may adjust too slowly to step changes in the raw signal. 916 Thus these specify the time in seconds for which the 917 difference between the slow tracking signal and the raw 918 signal is allowed to remain out-of-range before a reset 919 event occurs in which the tracking signal is made equal 920 to the raw signal, allowing slow tracking to resume and the 921 adaptive threshold event detection to function as expected. 922 923What: /sys/.../events/in_accel_thresh_rising_value 924What: /sys/.../events/in_accel_thresh_falling_value 925What: /sys/.../events/in_accel_x_raw_thresh_rising_value 926What: /sys/.../events/in_accel_x_raw_thresh_falling_value 927What: /sys/.../events/in_accel_y_raw_thresh_rising_value 928What: /sys/.../events/in_accel_y_raw_thresh_falling_value 929What: /sys/.../events/in_accel_z_raw_thresh_rising_value 930What: /sys/.../events/in_accel_z_raw_thresh_falling_value 931What: /sys/.../events/in_anglvel_x_raw_thresh_rising_value 932What: /sys/.../events/in_anglvel_x_raw_thresh_falling_value 933What: /sys/.../events/in_anglvel_y_raw_thresh_rising_value 934What: /sys/.../events/in_anglvel_y_raw_thresh_falling_value 935What: /sys/.../events/in_anglvel_z_raw_thresh_rising_value 936What: /sys/.../events/in_anglvel_z_raw_thresh_falling_value 937What: /sys/.../events/in_magn_x_raw_thresh_rising_value 938What: /sys/.../events/in_magn_x_raw_thresh_falling_value 939What: /sys/.../events/in_magn_y_raw_thresh_rising_value 940What: /sys/.../events/in_magn_y_raw_thresh_falling_value 941What: /sys/.../events/in_magn_z_raw_thresh_rising_value 942What: /sys/.../events/in_magn_z_raw_thresh_falling_value 943What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_rising_value 944What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_falling_value 945What: /sys/.../events/in_rot_from_north_true_raw_thresh_rising_value 946What: /sys/.../events/in_rot_from_north_true_raw_thresh_falling_value 947What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_rising_value 948What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_falling_value 949What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_rising_value 950What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_falling_value 951What: /sys/.../events/in_voltageY_supply_raw_thresh_rising_value 952What: /sys/.../events/in_voltageY_supply_raw_thresh_falling_value 953What: /sys/.../events/in_voltageY_raw_thresh_rising_value 954What: /sys/.../events/in_voltageY_raw_thresh_falling_value 955What: /sys/.../events/in_tempY_raw_thresh_rising_value 956What: /sys/.../events/in_tempY_raw_thresh_falling_value 957What: /sys/.../events/in_illuminance0_thresh_falling_value 958What: /sys/.../events/in_illuminance0_thresh_rising_value 959What: /sys/.../events/in_proximity0_thresh_falling_value 960What: /sys/.../events/in_proximity0_thresh_rising_value 961What: /sys/.../events/in_illuminance_thresh_rising_value 962What: /sys/.../events/in_illuminance_thresh_falling_value 963What: /sys/.../events/in_capacitanceY_thresh_rising_value 964What: /sys/.../events/in_capacitanceY_thresh_falling_value 965What: /sys/.../events/in_capacitanceY_thresh_adaptive_rising_value 966What: /sys/.../events/in_capacitanceY_thresh_falling_rising_value 967KernelVersion: 2.6.37 968Contact: linux-iio@vger.kernel.org 969Description: 970 Specifies the value of threshold that the device is comparing 971 against for the events enabled by 972 <type>Y[_name]_thresh[_rising|falling]_en. 973 974 If separate attributes exist for the two directions, but 975 direction is not specified for this attribute, then a single 976 threshold value applies to both directions. 977 978 The raw or input element of the name indicates whether the 979 value is in raw device units or in processed units (as _raw 980 and _input do on sysfs direct channel read attributes). 981 982What: /sys/.../events/in_accel_scale 983What: /sys/.../events/in_accel_peak_scale 984What: /sys/.../events/in_anglvel_scale 985What: /sys/.../events/in_magn_scale 986What: /sys/.../events/in_rot_from_north_magnetic_scale 987What: /sys/.../events/in_rot_from_north_true_scale 988What: /sys/.../events/in_voltage_scale 989What: /sys/.../events/in_voltage_supply_scale 990What: /sys/.../events/in_temp_scale 991What: /sys/.../events/in_illuminance_scale 992What: /sys/.../events/in_proximity_scale 993KernelVersion: 3.21 994Contact: linux-iio@vger.kernel.org 995Description: 996 Specifies the conversion factor from the standard units 997 to device specific units used to set the event trigger 998 threshold. 999 1000What: /sys/.../events/in_accel_x_thresh_rising_hysteresis 1001What: /sys/.../events/in_accel_x_thresh_falling_hysteresis 1002What: /sys/.../events/in_accel_x_thresh_either_hysteresis 1003What: /sys/.../events/in_accel_y_thresh_rising_hysteresis 1004What: /sys/.../events/in_accel_y_thresh_falling_hysteresis 1005What: /sys/.../events/in_accel_y_thresh_either_hysteresis 1006What: /sys/.../events/in_accel_z_thresh_rising_hysteresis 1007What: /sys/.../events/in_accel_z_thresh_falling_hysteresis 1008What: /sys/.../events/in_accel_z_thresh_either_hysteresis 1009What: /sys/.../events/in_anglvel_x_thresh_rising_hysteresis 1010What: /sys/.../events/in_anglvel_x_thresh_falling_hysteresis 1011What: /sys/.../events/in_anglvel_x_thresh_either_hysteresis 1012What: /sys/.../events/in_anglvel_y_thresh_rising_hysteresis 1013What: /sys/.../events/in_anglvel_y_thresh_falling_hysteresis 1014What: /sys/.../events/in_anglvel_y_thresh_either_hysteresis 1015What: /sys/.../events/in_anglvel_z_thresh_rising_hysteresis 1016What: /sys/.../events/in_anglvel_z_thresh_falling_hysteresis 1017What: /sys/.../events/in_anglvel_z_thresh_either_hysteresis 1018What: /sys/.../events/in_magn_x_thresh_rising_hysteresis 1019What: /sys/.../events/in_magn_x_thresh_falling_hysteresis 1020What: /sys/.../events/in_magn_x_thresh_either_hysteresis 1021What: /sys/.../events/in_magn_y_thresh_rising_hysteresis 1022What: /sys/.../events/in_magn_y_thresh_falling_hysteresis 1023What: /sys/.../events/in_magn_y_thresh_either_hysteresis 1024What: /sys/.../events/in_magn_z_thresh_rising_hysteresis 1025What: /sys/.../events/in_magn_z_thresh_falling_hysteresis 1026What: /sys/.../events/in_magn_z_thresh_either_hysteresis 1027What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_hysteresis 1028What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_hysteresis 1029What: /sys/.../events/in_rot_from_north_magnetic_thresh_either_hysteresis 1030What: /sys/.../events/in_rot_from_north_true_thresh_rising_hysteresis 1031What: /sys/.../events/in_rot_from_north_true_thresh_falling_hysteresis 1032What: /sys/.../events/in_rot_from_north_true_thresh_either_hysteresis 1033What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_hysteresis 1034What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_hysteresis 1035What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_either_hysteresis 1036What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_hysteresis 1037What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_hysteresis 1038What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_either_hysteresis 1039What: /sys/.../events/in_voltageY_thresh_rising_hysteresis 1040What: /sys/.../events/in_voltageY_thresh_falling_hysteresis 1041What: /sys/.../events/in_voltageY_thresh_either_hysteresis 1042What: /sys/.../events/in_tempY_thresh_rising_hysteresis 1043What: /sys/.../events/in_tempY_thresh_falling_hysteresis 1044What: /sys/.../events/in_tempY_thresh_either_hysteresis 1045What: /sys/.../events/in_illuminance0_thresh_falling_hysteresis 1046What: /sys/.../events/in_illuminance0_thresh_rising_hysteresis 1047What: /sys/.../events/in_illuminance0_thresh_either_hysteresis 1048What: /sys/.../events/in_proximity0_thresh_falling_hysteresis 1049What: /sys/.../events/in_proximity0_thresh_rising_hysteresis 1050What: /sys/.../events/in_proximity0_thresh_either_hysteresis 1051KernelVersion: 3.13 1052Contact: linux-iio@vger.kernel.org 1053Description: 1054 Specifies the hysteresis of threshold that the device is comparing 1055 against for the events enabled by 1056 <type>Y[_name]_thresh[_(rising|falling)]_hysteresis. 1057 If separate attributes exist for the two directions, but 1058 direction is not specified for this attribute, then a single 1059 hysteresis value applies to both directions. 1060 1061 For falling events the hysteresis is added to the _value attribute for 1062 this event to get the upper threshold for when the event goes back to 1063 normal, for rising events the hysteresis is subtracted from the _value 1064 attribute. E.g. if in_voltage0_raw_thresh_rising_value is set to 1200 1065 and in_voltage0_raw_thresh_rising_hysteresis is set to 50. The event 1066 will get activated once in_voltage0_raw goes above 1200 and will become 1067 deactivated again once the value falls below 1150. 1068 1069What: /sys/.../events/in_accel_x_raw_roc_rising_value 1070What: /sys/.../events/in_accel_x_raw_roc_falling_value 1071What: /sys/.../events/in_accel_y_raw_roc_rising_value 1072What: /sys/.../events/in_accel_y_raw_roc_falling_value 1073What: /sys/.../events/in_accel_z_raw_roc_rising_value 1074What: /sys/.../events/in_accel_z_raw_roc_falling_value 1075What: /sys/.../events/in_anglvel_x_raw_roc_rising_value 1076What: /sys/.../events/in_anglvel_x_raw_roc_falling_value 1077What: /sys/.../events/in_anglvel_y_raw_roc_rising_value 1078What: /sys/.../events/in_anglvel_y_raw_roc_falling_value 1079What: /sys/.../events/in_anglvel_z_raw_roc_rising_value 1080What: /sys/.../events/in_anglvel_z_raw_roc_falling_value 1081What: /sys/.../events/in_magn_x_raw_roc_rising_value 1082What: /sys/.../events/in_magn_x_raw_roc_falling_value 1083What: /sys/.../events/in_magn_y_raw_roc_rising_value 1084What: /sys/.../events/in_magn_y_raw_roc_falling_value 1085What: /sys/.../events/in_magn_z_raw_roc_rising_value 1086What: /sys/.../events/in_magn_z_raw_roc_falling_value 1087What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_rising_value 1088What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_falling_value 1089What: /sys/.../events/in_rot_from_north_true_raw_roc_rising_value 1090What: /sys/.../events/in_rot_from_north_true_raw_roc_falling_value 1091What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_rising_value 1092What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_falling_value 1093What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_rising_value 1094What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_falling_value 1095What: /sys/.../events/in_voltageY_supply_raw_roc_rising_value 1096What: /sys/.../events/in_voltageY_supply_raw_roc_falling_value 1097What: /sys/.../events/in_voltageY_raw_roc_rising_value 1098What: /sys/.../events/in_voltageY_raw_roc_falling_value 1099What: /sys/.../events/in_tempY_raw_roc_rising_value 1100What: /sys/.../events/in_tempY_raw_roc_falling_value 1101KernelVersion: 2.6.37 1102Contact: linux-iio@vger.kernel.org 1103Description: 1104 Specifies the value of rate of change threshold that the 1105 device is comparing against for the events enabled by 1106 <type>[Y][_name]_roc[_rising|falling]_en. 1107 1108 If separate attributes exist for the two directions, 1109 but direction is not specified for this attribute, 1110 then a single threshold value applies to both directions. 1111 The raw or input element of the name indicates whether the 1112 value is in raw device units or in processed units (as _raw 1113 and _input do on sysfs direct channel read attributes). 1114 1115What: /sys/.../events/in_accel_x_thresh_rising_period 1116What: /sys/.../events/in_accel_x_thresh_falling_period 1117What: /sys/.../events/in_accel_x_roc_rising_period 1118What: /sys/.../events/in_accel_x_roc_falling_period 1119What: /sys/.../events/in_accel_y_thresh_rising_period 1120What: /sys/.../events/in_accel_y_thresh_falling_period 1121What: /sys/.../events/in_accel_y_roc_rising_period 1122What: /sys/.../events/in_accel_y_roc_falling_period 1123What: /sys/.../events/in_accel_z_thresh_rising_period 1124What: /sys/.../events/in_accel_z_thresh_falling_period 1125What: /sys/.../events/in_accel_z_roc_rising_period 1126What: /sys/.../events/in_accel_z_roc_falling_period 1127What: /sys/.../events/in_anglvel_x_thresh_rising_period 1128What: /sys/.../events/in_anglvel_x_thresh_falling_period 1129What: /sys/.../events/in_anglvel_x_roc_rising_period 1130What: /sys/.../events/in_anglvel_x_roc_falling_period 1131What: /sys/.../events/in_anglvel_y_thresh_rising_period 1132What: /sys/.../events/in_anglvel_y_thresh_falling_period 1133What: /sys/.../events/in_anglvel_y_roc_rising_period 1134What: /sys/.../events/in_anglvel_y_roc_falling_period 1135What: /sys/.../events/in_anglvel_z_thresh_rising_period 1136What: /sys/.../events/in_anglvel_z_thresh_falling_period 1137What: /sys/.../events/in_anglvel_z_roc_rising_period 1138What: /sys/.../events/in_anglvel_z_roc_falling_period 1139What: /sys/.../events/in_magn_x_thresh_rising_period 1140What: /sys/.../events/in_magn_x_thresh_falling_period 1141What: /sys/.../events/in_magn_x_roc_rising_period 1142What: /sys/.../events/in_magn_x_roc_falling_period 1143What: /sys/.../events/in_magn_y_thresh_rising_period 1144What: /sys/.../events/in_magn_y_thresh_falling_period 1145What: /sys/.../events/in_magn_y_roc_rising_period 1146What: /sys/.../events/in_magn_y_roc_falling_period 1147What: /sys/.../events/in_magn_z_thresh_rising_period 1148What: /sys/.../events/in_magn_z_thresh_falling_period 1149What: /sys/.../events/in_magn_z_roc_rising_period 1150What: /sys/.../events/in_magn_z_roc_falling_period 1151What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_period 1152What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_period 1153What: /sys/.../events/in_rot_from_north_magnetic_roc_rising_period 1154What: /sys/.../events/in_rot_from_north_magnetic_roc_falling_period 1155What: /sys/.../events/in_rot_from_north_true_thresh_rising_period 1156What: /sys/.../events/in_rot_from_north_true_thresh_falling_period 1157What: /sys/.../events/in_rot_from_north_true_roc_rising_period 1158What: /sys/.../events/in_rot_from_north_true_roc_falling_period 1159What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_period 1160What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_period 1161What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_rising_period 1162What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_falling_period 1163What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_period 1164What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_period 1165What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_rising_period 1166What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_falling_period 1167What: /sys/.../events/in_voltageY_supply_thresh_rising_period 1168What: /sys/.../events/in_voltageY_supply_thresh_falling_period 1169What: /sys/.../events/in_voltageY_supply_roc_rising_period 1170What: /sys/.../events/in_voltageY_supply_roc_falling_period 1171What: /sys/.../events/in_voltageY_thresh_rising_period 1172What: /sys/.../events/in_voltageY_thresh_falling_period 1173What: /sys/.../events/in_voltageY_roc_rising_period 1174What: /sys/.../events/in_voltageY_roc_falling_period 1175What: /sys/.../events/in_tempY_thresh_rising_period 1176What: /sys/.../events/in_tempY_thresh_falling_period 1177What: /sys/.../events/in_tempY_roc_rising_period 1178What: /sys/.../events/in_tempY_roc_falling_period 1179What: /sys/.../events/in_accel_x&y&z_mag_falling_period 1180What: /sys/.../events/in_intensity0_thresh_period 1181What: /sys/.../events/in_proximity0_thresh_period 1182What: /sys/.../events/in_activity_still_thresh_rising_period 1183What: /sys/.../events/in_activity_still_thresh_falling_period 1184What: /sys/.../events/in_activity_walking_thresh_rising_period 1185What: /sys/.../events/in_activity_walking_thresh_falling_period 1186What: /sys/.../events/in_activity_jogging_thresh_rising_period 1187What: /sys/.../events/in_activity_jogging_thresh_falling_period 1188What: /sys/.../events/in_activity_running_thresh_rising_period 1189What: /sys/.../events/in_activity_running_thresh_falling_period 1190What: /sys/.../events/in_illuminance_thresh_either_period 1191KernelVersion: 2.6.37 1192Contact: linux-iio@vger.kernel.org 1193Description: 1194 Period of time (in seconds) for which the condition must be 1195 met before an event is generated. If direction is not 1196 specified then this period applies to both directions. 1197 1198What: /sys/.../events/in_accel_thresh_rising_low_pass_filter_3db 1199What: /sys/.../events/in_anglvel_thresh_rising_low_pass_filter_3db 1200What: /sys/.../events/in_magn_thresh_rising_low_pass_filter_3db 1201KernelVersion: 4.2 1202Contact: linux-iio@vger.kernel.org 1203Description: 1204 If a low pass filter can be applied to the event generation 1205 this property gives its 3db frequency in Hz. 1206 A value of zero disables the filter. 1207 1208What: /sys/.../events/in_accel_thresh_rising_high_pass_filter_3db 1209What: /sys/.../events/in_anglvel_thresh_rising_high_pass_filter_3db 1210What: /sys/.../events/in_magn_thresh_rising_high_pass_filter_3db 1211KernelVersion: 4.2 1212Contact: linux-iio@vger.kernel.org 1213Description: 1214 If a high pass filter can be applied to the event generation 1215 this property gives its 3db frequency in Hz. 1216 A value of zero disables the filter. 1217 1218What: /sys/.../events/in_activity_still_thresh_rising_en 1219What: /sys/.../events/in_activity_still_thresh_falling_en 1220What: /sys/.../events/in_activity_walking_thresh_rising_en 1221What: /sys/.../events/in_activity_walking_thresh_falling_en 1222What: /sys/.../events/in_activity_jogging_thresh_rising_en 1223What: /sys/.../events/in_activity_jogging_thresh_falling_en 1224What: /sys/.../events/in_activity_running_thresh_rising_en 1225What: /sys/.../events/in_activity_running_thresh_falling_en 1226KernelVersion: 3.19 1227Contact: linux-iio@vger.kernel.org 1228Description: 1229 Enables or disables activity events. Depending on direction 1230 an event is generated when sensor ENTERS or LEAVES a given state. 1231 1232What: /sys/.../events/in_activity_still_thresh_rising_value 1233What: /sys/.../events/in_activity_still_thresh_falling_value 1234What: /sys/.../events/in_activity_walking_thresh_rising_value 1235What: /sys/.../events/in_activity_walking_thresh_falling_value 1236What: /sys/.../events/in_activity_jogging_thresh_rising_value 1237What: /sys/.../events/in_activity_jogging_thresh_falling_value 1238What: /sys/.../events/in_activity_running_thresh_rising_value 1239What: /sys/.../events/in_activity_running_thresh_falling_value 1240KernelVersion: 3.19 1241Contact: linux-iio@vger.kernel.org 1242Description: 1243 Confidence value (in units as percentage) to be used 1244 for deciding when an event should be generated. E.g for 1245 running: If the confidence value reported by the sensor 1246 is greater than in_activity_running_thresh_rising_value 1247 then the sensor ENTERS running state. Conversely, if the 1248 confidence value reported by the sensor is lower than 1249 in_activity_running_thresh_falling_value then the sensor 1250 is LEAVING running state. 1251 1252What: /sys/.../iio:deviceX/events/in_accel_mag_en 1253What: /sys/.../iio:deviceX/events/in_accel_mag_rising_en 1254What: /sys/.../iio:deviceX/events/in_accel_mag_falling_en 1255What: /sys/.../iio:deviceX/events/in_accel_x_mag_en 1256What: /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en 1257What: /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en 1258What: /sys/.../iio:deviceX/events/in_accel_y_mag_en 1259What: /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en 1260What: /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en 1261What: /sys/.../iio:deviceX/events/in_accel_z_mag_en 1262What: /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en 1263What: /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en 1264What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en 1265What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en 1266KernelVersion: 2.6.37 1267Contact: linux-iio@vger.kernel.org 1268Description: 1269 Similar to in_accel_x_thresh[_rising|_falling]_en, but here the 1270 magnitude of the channel is compared to the threshold, not its 1271 signed value. 1272 1273What: /sys/.../events/in_accel_raw_mag_value 1274What: /sys/.../events/in_accel_x_raw_mag_rising_value 1275What: /sys/.../events/in_accel_y_raw_mag_rising_value 1276What: /sys/.../events/in_accel_z_raw_mag_rising_value 1277KernelVersion: 2.6.37 1278Contact: linux-iio@vger.kernel.org 1279Description: 1280 The value to which the magnitude of the channel is compared. If 1281 number or direction is not specified, applies to all channels of 1282 this type. 1283 1284What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_en 1285What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_rising_en 1286What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_falling_en 1287What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_en 1288What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_rising_en 1289What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_falling_en 1290KernelVersion: 5.18 1291Contact: linux-iio@vger.kernel.org 1292Description: 1293 Similar to in_accel_mag[_y][_rising|_falling]_en, but the event 1294 value is relative to a reference magnitude. The reference magnitude 1295 includes the graviational acceleration. 1296 1297What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_value 1298What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_rising_value 1299What: /sys/.../iio:deviceX/events/in_accel_mag_referenced_falling_value 1300What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_value 1301What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_rising_value 1302What: /sys/.../iio:deviceX/events/in_accel_y_mag_referenced_falling_value 1303KernelVersion: 5.18 1304Contact: linux-iio@vger.kernel.org 1305Description: 1306 The value to which the reference magnitude of the channel is 1307 compared. If the axis is not specified, it applies to all channels 1308 of this type. 1309 1310What: /sys/.../events/in_steps_change_en 1311KernelVersion: 4.0 1312Contact: linux-iio@vger.kernel.org 1313Description: 1314 Event generated when channel passes a threshold on the absolute 1315 change in value. E.g. for steps: a step change event is 1316 generated each time the user takes N steps, where N is set using 1317 in_steps_change_value. 1318 1319What: /sys/.../events/in_steps_change_value 1320KernelVersion: 4.0 1321Contact: linux-iio@vger.kernel.org 1322Description: 1323 Specifies the value of change threshold that the 1324 device is comparing against for the events enabled by 1325 <type>[Y][_name]_roc[_rising|falling|]_en. E.g. for steps: 1326 if set to 3, a step change event will be generated every 3 1327 steps. 1328 1329What: /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger 1330KernelVersion: 2.6.35 1331Contact: linux-iio@vger.kernel.org 1332Description: 1333 The name of the trigger source being used, as per string given 1334 in /sys/class/iio/triggerY/name. 1335 1336What: /sys/bus/iio/devices/iio:deviceX/bufferY/length 1337KernelVersion: 5.11 1338Contact: linux-iio@vger.kernel.org 1339Description: 1340 Number of scans contained by the buffer. 1341 1342What: /sys/bus/iio/devices/iio:deviceX/bufferY/enable 1343KernelVersion: 5.11 1344Contact: linux-iio@vger.kernel.org 1345Description: 1346 Actually start the buffer capture up. Will start trigger 1347 if first device and appropriate. 1348 1349 Note that it might be impossible to configure other attributes, 1350 (e.g.: events, scale, sampling rate) if they impact the currently 1351 active buffer capture session. 1352 1353What: /sys/bus/iio/devices/iio:deviceX/bufferY 1354KernelVersion: 5.11 1355Contact: linux-iio@vger.kernel.org 1356Description: 1357 Directory containing interfaces for elements that will be 1358 captured for a single triggered sample set in the buffer. 1359 1360 Since kernel 5.11 the scan_elements attributes are merged into 1361 the bufferY directory, to be configurable per buffer. 1362 1363What: /sys/.../iio:deviceX/bufferY/in_accel_x_en 1364What: /sys/.../iio:deviceX/bufferY/in_accel_y_en 1365What: /sys/.../iio:deviceX/bufferY/in_accel_z_en 1366What: /sys/.../iio:deviceX/bufferY/in_deltaangl_x_en 1367What: /sys/.../iio:deviceX/bufferY/in_deltaangl_y_en 1368What: /sys/.../iio:deviceX/bufferY/in_deltaangl_z_en 1369What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_x_en 1370What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_y_en 1371What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_z_en 1372What: /sys/.../iio:deviceX/bufferY/in_anglvel_x_en 1373What: /sys/.../iio:deviceX/bufferY/in_anglvel_y_en 1374What: /sys/.../iio:deviceX/bufferY/in_anglvel_z_en 1375What: /sys/.../iio:deviceX/bufferY/in_magn_x_en 1376What: /sys/.../iio:deviceX/bufferY/in_magn_y_en 1377What: /sys/.../iio:deviceX/bufferY/in_magn_z_en 1378What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_en 1379What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_en 1380What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_tilt_comp_en 1381What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_tilt_comp_en 1382What: /sys/.../iio:deviceX/bufferY/in_timestamp_en 1383What: /sys/.../iio:deviceX/bufferY/in_voltageY_supply_en 1384What: /sys/.../iio:deviceX/bufferY/in_voltageY_en 1385What: /sys/.../iio:deviceX/bufferY/in_voltageY-voltageZ_en 1386What: /sys/.../iio:deviceX/bufferY/in_voltageY_i_en 1387What: /sys/.../iio:deviceX/bufferY/in_voltageY_q_en 1388What: /sys/.../iio:deviceX/bufferY/in_voltage_i_en 1389What: /sys/.../iio:deviceX/bufferY/in_voltage_q_en 1390What: /sys/.../iio:deviceX/bufferY/in_incli_x_en 1391What: /sys/.../iio:deviceX/bufferY/in_incli_y_en 1392What: /sys/.../iio:deviceX/bufferY/in_pressureY_en 1393What: /sys/.../iio:deviceX/bufferY/in_pressure_en 1394What: /sys/.../iio:deviceX/bufferY/in_rot_quaternion_en 1395What: /sys/.../iio:deviceX/bufferY/in_proximity_en 1396KernelVersion: 5.11 1397Contact: linux-iio@vger.kernel.org 1398Description: 1399 Scan element control for triggered data capture. 1400 1401What: /sys/.../iio:deviceX/bufferY/in_accel_type 1402What: /sys/.../iio:deviceX/bufferY/in_deltaangl_type 1403What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_type 1404What: /sys/.../iio:deviceX/bufferY/in_anglvel_type 1405What: /sys/.../iio:deviceX/bufferY/in_magn_type 1406What: /sys/.../iio:deviceX/bufferY/in_incli_type 1407What: /sys/.../iio:deviceX/bufferY/in_voltageY_type 1408What: /sys/.../iio:deviceX/bufferY/in_voltage_type 1409What: /sys/.../iio:deviceX/bufferY/in_voltageY_supply_type 1410What: /sys/.../iio:deviceX/bufferY/in_voltageY_i_type 1411What: /sys/.../iio:deviceX/bufferY/in_voltageY_q_type 1412What: /sys/.../iio:deviceX/bufferY/in_voltage_i_type 1413What: /sys/.../iio:deviceX/bufferY/in_voltage_q_type 1414What: /sys/.../iio:deviceX/bufferY/in_timestamp_type 1415What: /sys/.../iio:deviceX/bufferY/in_pressureY_type 1416What: /sys/.../iio:deviceX/bufferY/in_pressure_type 1417What: /sys/.../iio:deviceX/bufferY/in_rot_quaternion_type 1418What: /sys/.../iio:deviceX/bufferY/in_proximity_type 1419KernelVersion: 5.11 1420Contact: linux-iio@vger.kernel.org 1421Description: 1422 Description of the scan element data storage within the buffer 1423 and hence the form in which it is read from user-space. 1424 Form is [be|le]:[s|u]bits/storagebits[>>shift]. 1425 be or le specifies big or little endian. s or u specifies if 1426 signed (2's complement) or unsigned. bits is the number of bits 1427 of data and storagebits is the space (after padding) that it 1428 occupies in the buffer. shift if specified, is the shift that 1429 needs to be applied prior to masking out unused bits. Some 1430 devices put their data in the middle of the transferred elements 1431 with additional information on both sides. Note that some 1432 devices will have additional information in the unused bits 1433 so to get a clean value, the bits value must be used to mask 1434 the buffer output value appropriately. The storagebits value 1435 also specifies the data alignment. So s48/64>>2 will be a 1436 signed 48 bit integer stored in a 64 bit location aligned to 1437 a 64 bit boundary. To obtain the clean value, shift right 2 1438 and apply a mask to zero the top 16 bits of the result. 1439 For other storage combinations this attribute will be extended 1440 appropriately. 1441 1442What: /sys/.../iio:deviceX/scan_elements/in_accel_type_available 1443KernelVersion: 2.6.37 1444Contact: linux-iio@vger.kernel.org 1445Description: 1446 If the type parameter can take one of a small set of values, 1447 this attribute lists them. 1448 1449What: /sys/.../iio:deviceX/bufferY/in_voltageY_index 1450What: /sys/.../iio:deviceX/bufferY/in_voltageY_supply_index 1451What: /sys/.../iio:deviceX/bufferY/in_voltageY_i_index 1452What: /sys/.../iio:deviceX/bufferY/in_voltageY_q_index 1453What: /sys/.../iio:deviceX/bufferY/in_voltage_i_index 1454What: /sys/.../iio:deviceX/bufferY/in_voltage_q_index 1455What: /sys/.../iio:deviceX/bufferY/in_accel_x_index 1456What: /sys/.../iio:deviceX/bufferY/in_accel_y_index 1457What: /sys/.../iio:deviceX/bufferY/in_accel_z_index 1458What: /sys/.../iio:deviceX/bufferY/in_deltaangl_x_index 1459What: /sys/.../iio:deviceX/bufferY/in_deltaangl_y_index 1460What: /sys/.../iio:deviceX/bufferY/in_deltaangl_z_index 1461What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_x_index 1462What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_y_index 1463What: /sys/.../iio:deviceX/bufferY/in_deltavelocity_z_index 1464What: /sys/.../iio:deviceX/bufferY/in_anglvel_x_index 1465What: /sys/.../iio:deviceX/bufferY/in_anglvel_y_index 1466What: /sys/.../iio:deviceX/bufferY/in_anglvel_z_index 1467What: /sys/.../iio:deviceX/bufferY/in_magn_x_index 1468What: /sys/.../iio:deviceX/bufferY/in_magn_y_index 1469What: /sys/.../iio:deviceX/bufferY/in_magn_z_index 1470What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_index 1471What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_index 1472What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_tilt_comp_index 1473What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_tilt_comp_index 1474What: /sys/.../iio:deviceX/bufferY/in_incli_x_index 1475What: /sys/.../iio:deviceX/bufferY/in_incli_y_index 1476What: /sys/.../iio:deviceX/bufferY/in_timestamp_index 1477What: /sys/.../iio:deviceX/bufferY/in_pressureY_index 1478What: /sys/.../iio:deviceX/bufferY/in_pressure_index 1479What: /sys/.../iio:deviceX/bufferY/in_rot_quaternion_index 1480What: /sys/.../iio:deviceX/bufferY/in_proximity_index 1481KernelVersion: 5.11 1482Contact: linux-iio@vger.kernel.org 1483Description: 1484 A single positive integer specifying the position of this 1485 scan element in the buffer. Note these are not dependent on 1486 what is enabled and may not be contiguous. Thus for user-space 1487 to establish the full layout these must be used in conjunction 1488 with all _en attributes to establish which channels are present, 1489 and the relevant _type attributes to establish the data storage 1490 format. 1491 1492What: /sys/.../iio:deviceX/in_activity_still_input 1493What: /sys/.../iio:deviceX/in_activity_walking_input 1494What: /sys/.../iio:deviceX/in_activity_jogging_input 1495What: /sys/.../iio:deviceX/in_activity_running_input 1496KernelVersion: 3.19 1497Contact: linux-iio@vger.kernel.org 1498Description: 1499 This attribute is used to read the confidence for an activity 1500 expressed in units as percentage. 1501 1502What: /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw 1503KernelVersion: 2.6.38 1504Contact: linux-iio@vger.kernel.org 1505Description: 1506 This attribute is used to read the amount of quadrature error 1507 present in the device at a given time. 1508 1509What: /sys/.../iio:deviceX/in_accelX_power_mode 1510KernelVersion: 3.11 1511Contact: linux-iio@vger.kernel.org 1512Description: 1513 Specifies the chip power mode. 1514 low_noise: reduce noise level from ADC, 1515 low_power: enable low current consumption. 1516 For a list of available output power modes read 1517 in_accel_power_mode_available. 1518 1519What: /sys/.../iio:deviceX/in_energy_input 1520What: /sys/.../iio:deviceX/in_energy_raw 1521KernelVersion: 4.0 1522Contact: linux-iio@vger.kernel.org 1523Description: 1524 This attribute is used to read the energy value reported by the 1525 device (e.g.: human activity sensors report energy burnt by the 1526 user). Units after application of scale are Joules. 1527 1528What: /sys/.../iio:deviceX/in_distance_input 1529What: /sys/.../iio:deviceX/in_distance_raw 1530KernelVersion: 4.0 1531Contact: linux-iio@vger.kernel.org 1532Description: 1533 This attribute is used to read the measured distance to an object 1534 or the distance covered by the user since the last reboot while 1535 activated. Units after application of scale are meters. 1536 1537What: /sys/bus/iio/devices/iio:deviceX/store_eeprom 1538KernelVersion: 3.4.0 1539Contact: linux-iio@vger.kernel.org 1540Description: 1541 Writing '1' stores the current device configuration into 1542 on-chip EEPROM. After power-up or chip reset the device will 1543 automatically load the saved configuration. 1544 1545What: /sys/.../iio:deviceX/in_proximity_raw 1546What: /sys/.../iio:deviceX/in_proximity_input 1547What: /sys/.../iio:deviceX/in_proximityY_raw 1548KernelVersion: 3.4 1549Contact: linux-iio@vger.kernel.org 1550Description: 1551 Proximity measurement indicating that some 1552 object is near the sensor, usually by observing 1553 reflectivity of infrared or ultrasound emitted. 1554 1555 Often these sensors are unit less and as such conversion 1556 to SI units is not possible. Higher proximity measurements 1557 indicate closer objects, and vice versa. Units after 1558 application of scale and offset are meters. 1559 1560What: /sys/.../iio:deviceX/in_illuminance_input 1561What: /sys/.../iio:deviceX/in_illuminance_raw 1562What: /sys/.../iio:deviceX/in_illuminanceY_input 1563What: /sys/.../iio:deviceX/in_illuminanceY_raw 1564What: /sys/.../iio:deviceX/in_illuminanceY_mean_raw 1565What: /sys/.../iio:deviceX/in_illuminance_ir_raw 1566What: /sys/.../iio:deviceX/in_illuminance_clear_raw 1567KernelVersion: 3.4 1568Contact: linux-iio@vger.kernel.org 1569Description: 1570 Illuminance measurement, units after application of scale 1571 and offset are lux. 1572 1573What: /sys/.../iio:deviceX/in_intensityY_raw 1574What: /sys/.../iio:deviceX/in_intensityY_ir_raw 1575What: /sys/.../iio:deviceX/in_intensityY_both_raw 1576What: /sys/.../iio:deviceX/in_intensityY_uv_raw 1577What: /sys/.../iio:deviceX/in_intensityY_duv_raw 1578KernelVersion: 3.4 1579Contact: linux-iio@vger.kernel.org 1580Description: 1581 Unit-less light intensity. Modifiers both and ir indicate 1582 that measurements contain visible and infrared light 1583 components or just infrared light, respectively. Modifier 1584 uv indicates that measurements contain ultraviolet light 1585 components. Modifier duv indicates that measurements 1586 contain deep ultraviolet light components. 1587 1588What: /sys/.../iio:deviceX/in_uvindex_input 1589KernelVersion: 4.6 1590Contact: linux-iio@vger.kernel.org 1591Description: 1592 UV light intensity index measuring the human skin's response to 1593 different wavelength of sunlight weighted according to the 1594 standardised CIE Erythemal Action Spectrum. UV index values range 1595 from 0 (low) to >=11 (extreme). 1596 1597What: /sys/.../iio:deviceX/in_intensity_integration_time 1598What: /sys/.../iio:deviceX/in_intensity_red_integration_time 1599What: /sys/.../iio:deviceX/in_intensity_green_integration_time 1600What: /sys/.../iio:deviceX/in_intensity_blue_integration_time 1601What: /sys/.../iio:deviceX/in_intensity_clear_integration_time 1602What: /sys/.../iio:deviceX/in_illuminance_integration_time 1603KernelVersion: 3.12 1604Contact: linux-iio@vger.kernel.org 1605Description: 1606 This attribute is used to get/set the integration time in 1607 seconds. If shared across all channels of a given type, 1608 <type>_integration_time is used. 1609 1610What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_integration_time 1611KernelVersion: 4.0 1612Contact: linux-iio@vger.kernel.org 1613Description: 1614 Number of seconds in which to compute speed. 1615 1616What: /sys/bus/iio/devices/iio:deviceX/in_rot_quaternion_raw 1617KernelVersion: 3.15 1618Contact: linux-iio@vger.kernel.org 1619Description: 1620 Raw value of quaternion components using a format 1621 x y z w. Here x, y, and z component represents the axis about 1622 which a rotation will occur and w component represents the 1623 amount of rotation. 1624 1625What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_raw 1626What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_raw 1627What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_raw 1628What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_raw 1629KernelVersion: 3.15 1630Contact: linux-iio@vger.kernel.org 1631Description: 1632 Raw value of rotation from true/magnetic north measured with 1633 or without compensation from tilt sensors. 1634 1635What: /sys/bus/iio/devices/iio:deviceX/in_currentX_raw 1636What: /sys/bus/iio/devices/iio:deviceX/in_currentX_i_raw 1637What: /sys/bus/iio/devices/iio:deviceX/in_currentX_q_raw 1638KernelVersion: 3.18 1639Contact: linux-iio@vger.kernel.org 1640Description: 1641 Raw current measurement from channel X. Units are in milliamps 1642 after application of scale and offset. If no offset or scale is 1643 present, output should be considered as processed with the 1644 unit in milliamps. 1645 1646 Channels with 'i' and 'q' modifiers always exist in pairs and both 1647 channels refer to the same signal. The 'i' channel contains the in-phase 1648 component of the signal while the 'q' channel contains the quadrature 1649 component. 1650 1651What: /sys/.../iio:deviceX/in_energy_en 1652What: /sys/.../iio:deviceX/in_distance_en 1653What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_en 1654What: /sys/.../iio:deviceX/in_steps_en 1655KernelVersion: 3.19 1656Contact: linux-iio@vger.kernel.org 1657Description: 1658 Activates a device feature that runs in firmware/hardware. 1659 E.g. for steps: the pedometer saves power while not used; 1660 when activated, it will count the steps taken by the user in 1661 firmware and export them through in_steps_input. 1662 1663What: /sys/.../iio:deviceX/in_steps_input 1664KernelVersion: 3.19 1665Contact: linux-iio@vger.kernel.org 1666Description: 1667 This attribute is used to read the number of steps taken by the user 1668 since the last reboot while activated. 1669 1670What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_input 1671What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_raw 1672KernelVersion: 3.19 1673Contact: linux-iio@vger.kernel.org 1674Description: 1675 This attribute is used to read the current speed value of the 1676 user (which is the norm or magnitude of the velocity vector). 1677 Units after application of scale are m/s. 1678 1679What: /sys/.../iio:deviceX/in_steps_debounce_count 1680KernelVersion: 4.0 1681Contact: linux-iio@vger.kernel.org 1682Description: 1683 Specifies the number of steps that must occur within 1684 in_steps_filter_debounce_time for the pedometer to decide the 1685 consumer is making steps. 1686 1687What: /sys/.../iio:deviceX/in_steps_debounce_time 1688KernelVersion: 4.0 1689Contact: linux-iio@vger.kernel.org 1690Description: 1691 Specifies number of seconds in which we compute the steps 1692 that occur in order to decide if the consumer is making steps. 1693 1694What: /sys/bus/iio/devices/iio:deviceX/bufferY/watermark 1695KernelVersion: 5.11 1696Contact: linux-iio@vger.kernel.org 1697Description: 1698 A single positive integer specifying the maximum number of scan 1699 elements to wait for. 1700 1701 Poll will block until the watermark is reached. 1702 1703 Blocking read will wait until the minimum between the requested 1704 read amount or the low water mark is available. 1705 1706 Non-blocking read will retrieve the available samples from the 1707 buffer even if there are less samples then watermark level. This 1708 allows the application to block on poll with a timeout and read 1709 the available samples after the timeout expires and thus have a 1710 maximum delay guarantee. 1711 1712What: /sys/bus/iio/devices/iio:deviceX/bufferY/data_available 1713KernelVersion: 5.11 1714Contact: linux-iio@vger.kernel.org 1715Description: 1716 A read-only value indicating the bytes of data available in the 1717 buffer. In the case of an output buffer, this indicates the 1718 amount of empty space available to write data to. In the case of 1719 an input buffer, this indicates the amount of data available for 1720 reading. 1721 1722What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_enabled 1723KernelVersion: 4.2 1724Contact: linux-iio@vger.kernel.org 1725Description: 1726 A read-only boolean value that indicates if the hardware fifo is 1727 currently enabled or disabled. If the device does not have a 1728 hardware fifo this entry is not present. 1729 The hardware fifo is enabled when the buffer is enabled if the 1730 current hardware fifo watermark level is set and other current 1731 device settings allows it (e.g. if a trigger is set that samples 1732 data differently that the hardware fifo does then hardware fifo 1733 will not enabled). 1734 1735 If the hardware fifo is enabled and the level of the hardware 1736 fifo reaches the hardware fifo watermark level the device will 1737 flush its hardware fifo to the device buffer. Doing a non 1738 blocking read on the device when no samples are present in the 1739 device buffer will also force a flush. 1740 1741 When the hardware fifo is enabled there is no need to use a 1742 trigger to use buffer mode since the watermark settings 1743 guarantees that the hardware fifo is flushed to the device 1744 buffer. 1745 1746What: /sys/bus/iio/devices/iio:device*/buffer/hwfifo_timeout 1747KernelVersion: 4.12 1748Contact: linux-iio@vger.kernel.org 1749Description: 1750 A read/write property to provide capability to delay reporting of 1751 samples till a timeout is reached. This allows host processors to 1752 sleep, while the sensor is storing samples in its internal fifo. 1753 The maximum timeout in seconds can be specified by setting 1754 hwfifo_timeout.The current delay can be read by reading 1755 hwfifo_timeout. A value of 0 means that there is no timeout. 1756 1757What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark 1758KernelVersion: 4.2 1759Contact: linux-iio@vger.kernel.org 1760Description: 1761 Read-only entry that contains a single integer specifying the 1762 current watermark level for the hardware fifo. If the device 1763 does not have a hardware fifo this entry is not present. 1764 The watermark level for the hardware fifo is set by the driver 1765 based on the value set by the user in buffer/watermark but 1766 taking into account hardware limitations (e.g. most hardware 1767 buffers are limited to 32-64 samples, some hardware buffers 1768 watermarks are fixed or have minimum levels). A value of 0 1769 means that the hardware watermark is unset. 1770 1771What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_min 1772KernelVersion: 4.2 1773Contact: linux-iio@vger.kernel.org 1774Description: 1775 A single positive integer specifying the minimum watermark level 1776 for the hardware fifo of this device. If the device does not 1777 have a hardware fifo this entry is not present. 1778 1779 If the user sets buffer/watermark to a value less than this one, 1780 then the hardware watermark will remain unset. 1781 1782What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_max 1783KernelVersion: 4.2 1784Contact: linux-iio@vger.kernel.org 1785Description: 1786 A single positive integer specifying the maximum watermark level 1787 for the hardware fifo of this device. If the device does not 1788 have a hardware fifo this entry is not present. 1789 1790 If the user sets buffer/watermark to a value greater than this 1791 one, then the hardware watermark will be capped at this value. 1792 1793What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_available 1794KernelVersion: 4.2 1795Contact: linux-iio@vger.kernel.org 1796Description: 1797 A list of positive integers specifying the available watermark 1798 levels for the hardware fifo. This entry is optional and if it 1799 is not present it means that all the values between 1800 hwfifo_watermark_min and hwfifo_watermark_max are supported. 1801 1802 If the user sets buffer/watermark to a value greater than 1803 hwfifo_watermak_min but not equal to any of the values in this 1804 list, the driver will chose an appropriate value for the 1805 hardware fifo watermark level. 1806 1807What: /sys/bus/iio/devices/iio:deviceX/in_temp_calibemissivity 1808What: /sys/bus/iio/devices/iio:deviceX/in_tempX_calibemissivity 1809What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_calibemissivity 1810What: /sys/bus/iio/devices/iio:deviceX/in_tempX_object_calibemissivity 1811KernelVersion: 4.1 1812Contact: linux-iio@vger.kernel.org 1813Description: 1814 The emissivity ratio of the surface in the field of view of the 1815 contactless temperature sensor. Emissivity varies from 0 to 1, 1816 with 1 being the emissivity of a black body. 1817 1818What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_oversampling_ratio 1819What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_oversampling_ratio 1820What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_oversampling_ratio 1821KernelVersion: 4.2 1822Contact: linux-iio@vger.kernel.org 1823Description: 1824 Hardware applied number of measurements for acquiring one 1825 data point. The HW will do <type>[_name]_oversampling_ratio 1826 measurements and return the average value as output data. Each 1827 value resulted from <type>[_name]_oversampling_ratio measurements 1828 is considered as one sample for <type>[_name]_sampling_frequency. 1829 1830What: /sys/bus/iio/devices/iio:deviceX/in_concentration_raw 1831What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_raw 1832What: /sys/bus/iio/devices/iio:deviceX/in_concentration_co2_raw 1833What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_co2_raw 1834What: /sys/bus/iio/devices/iio:deviceX/in_concentration_ethanol_raw 1835What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_ethanol_raw 1836What: /sys/bus/iio/devices/iio:deviceX/in_concentration_h2_raw 1837What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_h2_raw 1838What: /sys/bus/iio/devices/iio:deviceX/in_concentration_o2_raw 1839What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_o2_raw 1840What: /sys/bus/iio/devices/iio:deviceX/in_concentration_voc_raw 1841What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_voc_raw 1842KernelVersion: 4.3 1843Contact: linux-iio@vger.kernel.org 1844Description: 1845 Raw (unscaled no offset etc.) reading of a substance. Units 1846 after application of scale and offset are percents. 1847 1848What: /sys/bus/iio/devices/iio:deviceX/in_resistance_raw 1849What: /sys/bus/iio/devices/iio:deviceX/in_resistanceX_raw 1850What: /sys/bus/iio/devices/iio:deviceX/out_resistance_raw 1851What: /sys/bus/iio/devices/iio:deviceX/out_resistanceX_raw 1852KernelVersion: 4.3 1853Contact: linux-iio@vger.kernel.org 1854Description: 1855 Raw (unscaled no offset etc.) resistance reading. 1856 Units after application of scale and offset are ohms. 1857 1858What: /sys/bus/iio/devices/iio:deviceX/heater_enable 1859KernelVersion: 4.1.0 1860Contact: linux-iio@vger.kernel.org 1861Description: 1862 '1' (enable) or '0' (disable) specifying the enable 1863 of heater function. Same reading values apply. 1864 1865 This ABI is especially applicable for humidity sensors 1866 to heatup the device and get rid of any condensation 1867 in some humidity environment 1868 1869What: /sys/bus/iio/devices/iio:deviceX/in_ph_raw 1870KernelVersion: 4.5 1871Contact: linux-iio@vger.kernel.org 1872Description: 1873 Raw (unscaled no offset etc.) pH reading of a substance as a negative 1874 base-10 logarithm of hydrodium ions in a litre of water. 1875 1876What: /sys/bus/iio/devices/iio:deviceX/mount_matrix 1877What: /sys/bus/iio/devices/iio:deviceX/in_mount_matrix 1878What: /sys/bus/iio/devices/iio:deviceX/out_mount_matrix 1879What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_mount_matrix 1880What: /sys/bus/iio/devices/iio:deviceX/in_accel_mount_matrix 1881KernelVersion: 4.6 1882Contact: linux-iio@vger.kernel.org 1883Description: 1884 Mounting matrix for IIO sensors. This is a rotation matrix which 1885 informs userspace about sensor chip's placement relative to the 1886 main hardware it is mounted on. 1887 1888 Main hardware placement is defined according to the local 1889 reference frame related to the physical quantity the sensor 1890 measures. 1891 1892 Given that the rotation matrix is defined in a board specific 1893 way (platform data and / or device-tree), the main hardware 1894 reference frame definition is left to the implementor's choice 1895 (see below for a magnetometer example). 1896 1897 Applications should apply this rotation matrix to samples so 1898 that when main hardware reference frame is aligned onto local 1899 reference frame, then sensor chip reference frame is also 1900 perfectly aligned with it. 1901 1902 Matrix is a 3x3 unitary matrix and typically looks like 1903 [0, 1, 0; 1, 0, 0; 0, 0, -1]. Identity matrix 1904 [1, 0, 0; 0, 1, 0; 0, 0, 1] means sensor chip and main hardware 1905 are perfectly aligned with each other. 1906 1907 For example, a mounting matrix for a magnetometer sensor informs 1908 userspace about sensor chip's ORIENTATION relative to the main 1909 hardware. 1910 1911 More specifically, main hardware orientation is defined with 1912 respect to the LOCAL EARTH GEOMAGNETIC REFERENCE FRAME where : 1913 1914 * Y is in the ground plane and positive towards magnetic North ; 1915 * X is in the ground plane, perpendicular to the North axis and 1916 positive towards the East ; 1917 * Z is perpendicular to the ground plane and positive upwards. 1918 1919 An implementor might consider that for a hand-held device, a 1920 'natural' orientation would be 'front facing camera at the top'. 1921 The main hardware reference frame could then be described as : 1922 1923 * Y is in the plane of the screen and is positive towards the 1924 top of the screen ; 1925 * X is in the plane of the screen, perpendicular to Y axis, and 1926 positive towards the right hand side of the screen ; 1927 * Z is perpendicular to the screen plane and positive out of the 1928 screen. 1929 1930 Another example for a quadrotor UAV might be : 1931 1932 * Y is in the plane of the propellers and positive towards the 1933 front-view camera; 1934 * X is in the plane of the propellers, perpendicular to Y axis, 1935 and positive towards the starboard side of the UAV ; 1936 * Z is perpendicular to propellers plane and positive upwards. 1937 1938What: /sys/bus/iio/devices/iio:deviceX/in_electricalconductivity_raw 1939KernelVersion: 4.8 1940Contact: linux-iio@vger.kernel.org 1941Description: 1942 Raw (unscaled no offset etc.) electric conductivity reading. 1943 Units after application of scale and offset are siemens per 1944 meter. 1945 1946What: /sys/bus/iio/devices/iio:deviceX/in_countY_raw 1947KernelVersion: 4.10 1948Contact: linux-iio@vger.kernel.org 1949Description: 1950 This interface is deprecated; please use the Counter subsystem. 1951 1952 Raw counter device counts from channel Y. For quadrature 1953 counters, multiplication by an available [Y]_scale results in 1954 the counts of a single quadrature signal phase from channel Y. 1955 1956What: /sys/bus/iio/devices/iio:deviceX/in_indexY_raw 1957KernelVersion: 4.10 1958Contact: linux-iio@vger.kernel.org 1959Description: 1960 This interface is deprecated; please use the Counter subsystem. 1961 1962 Raw counter device index value from channel Y. This attribute 1963 provides an absolute positional reference (e.g. a pulse once per 1964 revolution) which may be used to home positional systems as 1965 required. 1966 1967What: /sys/bus/iio/devices/iio:deviceX/in_count_count_direction_available 1968KernelVersion: 4.12 1969Contact: linux-iio@vger.kernel.org 1970Description: 1971 This interface is deprecated; please use the Counter subsystem. 1972 1973 A list of possible counting directions which are: 1974 1975 - "up" : counter device is increasing. 1976 - "down": counter device is decreasing. 1977 1978What: /sys/bus/iio/devices/iio:deviceX/in_countY_count_direction 1979KernelVersion: 4.12 1980Contact: linux-iio@vger.kernel.org 1981Description: 1982 This interface is deprecated; please use the Counter subsystem. 1983 1984 Raw counter device counters direction for channel Y. 1985 1986What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_label 1987What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_label 1988KernelVersion: 5.8 1989Contact: linux-iio@vger.kernel.org 1990Description: 1991 Optional symbolic label to a device channel. 1992 If a label is defined for this channel add that to the channel 1993 specific attributes. This is useful for userspace to be able to 1994 better identify an individual channel. 1995 1996What: /sys/bus/iio/devices/iio:deviceX/in_phaseY_raw 1997KernelVersion: 4.18 1998Contact: linux-iio@vger.kernel.org 1999Description: 2000 Raw (unscaled) phase difference reading from channel Y. 2001 Units after application of scale and offset are radians. 2002 2003What: /sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm1_input 2004What: /sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm1_input 2005What: /sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm2p5_input 2006What: /sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm2p5_input 2007What: /sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm4_input 2008What: /sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm4_input 2009What: /sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm10_input 2010What: /sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm10_input 2011KernelVersion: 4.22 2012Contact: linux-iio@vger.kernel.org 2013Description: 2014 Mass concentration reading of particulate matter in ug / m3. 2015 pmX consists of particles with aerodynamic diameter less or 2016 equal to X micrometers. 2017 2018What: /sys/bus/iio/devices/iio:deviceX/events/in_illuminance_period_available 2019Date: November 2019 2020KernelVersion: 5.4 2021Contact: linux-iio@vger.kernel.org 2022Description: 2023 List of valid periods (in seconds) for which the light intensity 2024 must be above the threshold level before interrupt is asserted. 2025 2026What: /sys/bus/iio/devices/iio:deviceX/in_filter_notch_center_frequency 2027KernelVersion: 5.5 2028Contact: linux-iio@vger.kernel.org 2029Description: 2030 Center frequency in Hz for a notch filter. Used i.e. for line 2031 noise suppression. 2032 2033What: /sys/bus/iio/devices/iio:deviceX/in_temp_thermocouple_type 2034KernelVersion: 5.5 2035Contact: linux-iio@vger.kernel.org 2036Description: 2037 One of the following thermocouple types: B, E, J, K, N, R, S, T. 2038 2039What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_calibambient 2040What: /sys/bus/iio/devices/iio:deviceX/in_tempX_object_calibambient 2041KernelVersion: 5.10 2042Contact: linux-iio@vger.kernel.org 2043Description: 2044 Calibrated ambient temperature for object temperature 2045 calculation in milli degrees Celsius. 2046 2047What: /sys/bus/iio/devices/iio:deviceX/in_intensity_x_raw 2048What: /sys/bus/iio/devices/iio:deviceX/in_intensity_y_raw 2049What: /sys/bus/iio/devices/iio:deviceX/in_intensity_z_raw 2050KernelVersion: 5.10 2051Contact: linux-iio@vger.kernel.org 2052Description: 2053 Unscaled light intensity according to CIE 1931/DIN 5033 color space. 2054 Units after application of scale are nano nanowatts per square meter. 2055 2056What: /sys/bus/iio/devices/iio:deviceX/in_anglY_label 2057KernelVersion: 5.12 2058Contact: linux-iio@vger.kernel.org 2059Description: 2060 Optional symbolic label for channel Y. 2061 For Intel hid hinge sensor, the label values are: 2062 hinge, keyboard, screen. It means the three channels 2063 each correspond respectively to hinge angle, keyboard angle, 2064 and screen angle. 2065 2066What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_hysteresis_relative 2067What: /sys/bus/iio/devices/iio:deviceX/in_intensity_hysteresis_relative 2068KernelVersion: 5.12 2069Contact: linux-iio@vger.kernel.org 2070Description: 2071 Specify the percent for light sensor relative to the channel 2072 absolute value that a data field should change before an event 2073 is generated. Units are a percentage of the prior reading. 2074 2075What: /sys/bus/iio/devices/iio:deviceX/calibration_auto_enable 2076Date: June 2020 2077KernelVersion: 5.8 2078Contact: linux-iio@vger.kernel.org 2079Description: 2080 Some sensors have the ability to apply auto calibration at 2081 runtime. For example, it may be necessary to compensate for 2082 contaminant build-up in a measurement chamber or optical 2083 element deterioration that would otherwise lead to sensor drift. 2084 2085 Writing 1 or 0 to this attribute will respectively activate or 2086 deactivate this auto calibration function. 2087 2088 Upon reading, the current status is returned. 2089 2090What: /sys/bus/iio/devices/iio:deviceX/calibration_forced_value 2091Date: June 2020 2092KernelVersion: 5.8 2093Contact: linux-iio@vger.kernel.org 2094Description: 2095 Some sensors have the ability to apply a manual calibration using 2096 a known measurement value, perhaps obtained from an external 2097 reference device. 2098 2099 Writing a value to this function will force such a calibration 2100 change. For the scd30 the value should be from the range 2101 [400 1 2000]. 2102 2103 Note for the scd30 that a valid value may only be obtained once 2104 it is has been written. Until then any read back of this value 2105 should be ignored. As for the scd4x an error will be returned 2106 immediately if the manual calibration has failed. 2107 2108What: /sys/bus/iio/devices/iio:deviceX/calibration_forced_value_available 2109KernelVersion: 5.15 2110Contact: linux-iio@vger.kernel.org 2111Description: 2112 Available range for the forced calibration value, expressed as: 2113 2114 - a range specified as "[min step max]" 2115 2116What: /sys/bus/iio/devices/iio:deviceX/in_voltageX_sampling_frequency 2117What: /sys/bus/iio/devices/iio:deviceX/in_powerY_sampling_frequency 2118What: /sys/bus/iio/devices/iio:deviceX/in_currentZ_sampling_frequency 2119KernelVersion: 5.20 2120Contact: linux-iio@vger.kernel.org 2121Description: 2122 Some devices have separate controls of sampling frequency for 2123 individual channels. If multiple channels are enabled in a scan, 2124 then the sampling_frequency of the scan may be computed from the 2125 per channel sampling frequencies. 2126 2127What: /sys/.../events/in_accel_gesture_singletap_en 2128What: /sys/.../events/in_accel_gesture_doubletap_en 2129KernelVersion: 6.1 2130Contact: linux-iio@vger.kernel.org 2131Description: 2132 Device generates an event on a single or double tap. 2133 2134What: /sys/.../events/in_accel_gesture_singletap_value 2135What: /sys/.../events/in_accel_gesture_doubletap_value 2136KernelVersion: 6.1 2137Contact: linux-iio@vger.kernel.org 2138Description: 2139 Specifies the threshold value that the device is comparing 2140 against to generate the tap gesture event. The lower 2141 threshold value increases the sensitivity of tap detection. 2142 Units and the exact meaning of value are device-specific. 2143 2144What: /sys/.../events/in_accel_gesture_tap_value_available 2145KernelVersion: 6.1 2146Contact: linux-iio@vger.kernel.org 2147Description: 2148 Lists all available threshold values which can be used to 2149 modify the sensitivity of the tap detection. 2150 2151What: /sys/.../events/in_accel_gesture_singletap_reset_timeout 2152What: /sys/.../events/in_accel_gesture_doubletap_reset_timeout 2153KernelVersion: 6.1 2154Contact: linux-iio@vger.kernel.org 2155Description: 2156 Specifies the timeout value in seconds for the tap detector 2157 to not to look for another tap event after the event as 2158 occurred. Basically the minimum quiet time between the two 2159 single-tap's or two double-tap's. 2160 2161What: /sys/.../events/in_accel_gesture_tap_reset_timeout_available 2162KernelVersion: 6.1 2163Contact: linux-iio@vger.kernel.org 2164Description: 2165 Lists all available tap reset timeout values. Units in seconds. 2166 2167What: /sys/.../events/in_accel_gesture_doubletap_tap2_min_delay 2168KernelVersion: 6.1 2169Contact: linux-iio@vger.kernel.org 2170Description: 2171 Specifies the minimum quiet time in seconds between the two 2172 taps of a double tap. 2173 2174What: /sys/.../events/in_accel_gesture_doubletap_tap2_min_delay_available 2175KernelVersion: 6.1 2176Contact: linux-iio@vger.kernel.org 2177Description: 2178 Lists all available delay values between two taps in the double 2179 tap. Units in seconds. 2180 2181What: /sys/.../events/in_accel_gesture_tap_maxtomin_time 2182KernelVersion: 6.1 2183Contact: linux-iio@vger.kernel.org 2184Description: 2185 Specifies the maximum time difference allowed between upper 2186 and lower peak of tap to consider it as the valid tap event. 2187 Units in seconds. 2188 2189What: /sys/.../events/in_accel_gesture_tap_maxtomin_time_available 2190KernelVersion: 6.1 2191Contact: linux-iio@vger.kernel.org 2192Description: 2193 Lists all available time values between upper peak to lower 2194 peak. Units in seconds. 2195 2196What: /sys/bus/iio/devices/iio:deviceX/in_rot_yaw_raw 2197What: /sys/bus/iio/devices/iio:deviceX/in_rot_pitch_raw 2198What: /sys/bus/iio/devices/iio:deviceX/in_rot_roll_raw 2199KernelVersion: 6.1 2200Contact: linux-iio@vger.kernel.org 2201Description: 2202 Raw (unscaled) euler angles readings. Units after 2203 application of scale are deg. 2204 2205What: /sys/bus/iio/devices/iio:deviceX/serialnumber 2206KernelVersion: 6.1 2207Contact: linux-iio@vger.kernel.org 2208Description: 2209 An example format is 16-bytes, 2-digits-per-byte, HEX-string 2210 representing the sensor unique ID number. 2211 2212What: /sys/.../events/in_proximity_thresh_either_runningperiod 2213KernelVersion: 6.6 2214Contact: linux-iio@vger.kernel.org 2215Description: 2216 A running period of time (in seconds) for which 2217 in_proximity_thresh_either_runningcount amount of conditions 2218 must occur before an event is generated. If direction is not 2219 specified then this period applies to both directions. 2220 2221What: /sys/.../events/in_proximity_thresh_either_runningcount 2222KernelVersion: 6.6 2223Contact: linux-iio@vger.kernel.org 2224Description: 2225 Number of conditions that must occur, during a running 2226 period, before an event is generated. 2227 2228What: /sys/bus/iio/devices/iio:deviceX/in_colortemp_raw 2229KernelVersion: 6.7 2230Contact: linux-iio@vger.kernel.org 2231Description: 2232 Represents light color temperature, which measures light color 2233 temperature in Kelvin. 2234 2235What: /sys/bus/iio/devices/iio:deviceX/in_chromaticity_x_raw 2236What: /sys/bus/iio/devices/iio:deviceX/in_chromaticity_y_raw 2237KernelVersion: 6.7 2238Contact: linux-iio@vger.kernel.org 2239Description: 2240 The x and y light color coordinate on the CIE 1931 chromaticity 2241 diagram. 2242 2243What: /sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_mag_either_label 2244What: /sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_mag_rising_label 2245What: /sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_thresh_falling_label 2246What: /sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_thresh_rising_label 2247What: /sys/bus/iio/devices/iio:deviceX/events/in_anglvelY_mag_rising_label 2248What: /sys/bus/iio/devices/iio:deviceX/events/in_anglY_thresh_rising_label 2249What: /sys/bus/iio/devices/iio:deviceX/events/in_phaseY_mag_rising_label 2250KernelVersion: 6.7 2251Contact: linux-iio@vger.kernel.org 2252Description: 2253 Optional symbolic label to a device channel event. 2254 If a label is defined for this event add that to the event 2255 specific attributes. This is useful for userspace to be able to 2256 better identify an individual event. 2257