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