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