sysfs-bus-iio 78 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687
  1. What: /sys/bus/iio/devices/iio:deviceX
  2. KernelVersion: 2.6.35
  3. Contact: linux-iio@vger.kernel.org
  4. Description:
  5. Hardware chip or device accessed by one communication port.
  6. Corresponds to a grouping of sensor channels. X is the IIO
  7. index of the device.
  8. What: /sys/bus/iio/devices/triggerX
  9. KernelVersion: 2.6.35
  10. Contact: linux-iio@vger.kernel.org
  11. Description:
  12. An event driven driver of data capture to an in kernel buffer.
  13. May be provided by a device driver that also has an IIO device
  14. based on hardware generated events (e.g. data ready) or
  15. provided by a separate driver for other hardware (e.g.
  16. periodic timer, GPIO or high resolution timer).
  17. Contains trigger type specific elements. These do not
  18. generalize well and hence are not documented in this file.
  19. X is the IIO index of the trigger.
  20. What: /sys/bus/iio/devices/iio:deviceX/buffer
  21. KernelVersion: 2.6.35
  22. Contact: linux-iio@vger.kernel.org
  23. Description:
  24. Directory of attributes relating to the buffer for the device.
  25. What: /sys/bus/iio/devices/iio:deviceX/name
  26. KernelVersion: 2.6.35
  27. Contact: linux-iio@vger.kernel.org
  28. Description:
  29. Description of the physical chip / device for device X.
  30. Typically a part number.
  31. What: /sys/bus/iio/devices/iio:deviceX/current_timestamp_clock
  32. KernelVersion: 4.5
  33. Contact: linux-iio@vger.kernel.org
  34. Description:
  35. String identifying current posix clock used to timestamp
  36. buffered samples and events for device X.
  37. What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency
  38. What: /sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency
  39. What: /sys/bus/iio/devices/triggerX/sampling_frequency
  40. KernelVersion: 2.6.35
  41. Contact: linux-iio@vger.kernel.org
  42. Description:
  43. Some devices have internal clocks. This parameter sets the
  44. resulting sampling frequency. In many devices this
  45. parameter has an effect on input filters etc. rather than
  46. simply controlling when the input is sampled. As this
  47. effects data ready triggers, hardware buffers and the sysfs
  48. direct access interfaces, it may be found in any of the
  49. relevant directories. If it effects all of the above
  50. then it is to be found in the base device directory.
  51. What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency_available
  52. What: /sys/bus/iio/devices/iio:deviceX/in_proximity_sampling_frequency_available
  53. What: /sys/.../iio:deviceX/buffer/sampling_frequency_available
  54. What: /sys/bus/iio/devices/triggerX/sampling_frequency_available
  55. KernelVersion: 2.6.35
  56. Contact: linux-iio@vger.kernel.org
  57. Description:
  58. When the internal sampling clock can only take a small
  59. discrete set of values, this file lists those available.
  60. What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio
  61. KernelVersion: 2.6.38
  62. Contact: linux-iio@vger.kernel.org
  63. Description:
  64. Hardware dependent ADC oversampling. Controls the sampling ratio
  65. of the digital filter if available.
  66. What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available
  67. KernelVersion: 2.6.38
  68. Contact: linux-iio@vger.kernel.org
  69. Description:
  70. Hardware dependent values supported by the oversampling filter.
  71. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
  72. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
  73. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_raw
  74. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_raw
  75. KernelVersion: 2.6.35
  76. Contact: linux-iio@vger.kernel.org
  77. Description:
  78. Raw (unscaled no bias removal etc.) voltage measurement from
  79. channel Y. In special cases where the channel does not
  80. correspond to externally available input one of the named
  81. versions may be used. The number must always be specified and
  82. unique to allow association with event codes. Units after
  83. application of scale and offset are millivolts.
  84. Channels with 'i' and 'q' modifiers always exist in pairs and both
  85. channels refer to the same signal. The 'i' channel contains the in-phase
  86. component of the signal while the 'q' channel contains the quadrature
  87. component.
  88. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw
  89. KernelVersion: 2.6.35
  90. Contact: linux-iio@vger.kernel.org
  91. Description:
  92. Raw (unscaled) differential voltage measurement equivalent to
  93. channel Y - channel Z where these channel numbers apply to the
  94. physically equivalent inputs when non differential readings are
  95. separately available. In differential only parts, then all that
  96. is required is a consistent labeling. Units after application
  97. of scale and offset are millivolts.
  98. What: /sys/bus/iio/devices/iio:deviceX/in_currentY_raw
  99. What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_raw
  100. KernelVersion: 3.17
  101. Contact: linux-iio@vger.kernel.org
  102. Description:
  103. Raw (unscaled no bias removal etc.) current measurement from
  104. channel Y. In special cases where the channel does not
  105. correspond to externally available input one of the named
  106. versions may be used. The number must always be specified and
  107. unique to allow association with event codes. Units after
  108. application of scale and offset are milliamps.
  109. What: /sys/bus/iio/devices/iio:deviceX/in_powerY_raw
  110. KernelVersion: 4.5
  111. Contact: linux-iio@vger.kernel.org
  112. Description:
  113. Raw (unscaled no bias removal etc.) power measurement from
  114. channel Y. The number must always be specified and
  115. unique to allow association with event codes. Units after
  116. application of scale and offset are milliwatts.
  117. What: /sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw
  118. KernelVersion: 3.2
  119. Contact: linux-iio@vger.kernel.org
  120. Description:
  121. Raw capacitance measurement from channel Y. Units after
  122. application of scale and offset are nanofarads.
  123. What: /sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw
  124. KernelVersion: 3.2
  125. Contact: linux-iio@vger.kernel.org
  126. Description:
  127. Raw differential capacitance measurement equivalent to
  128. channel Y - channel Z where these channel numbers apply to the
  129. physically equivalent inputs when non differential readings are
  130. separately available. In differential only parts, then all that
  131. is required is a consistent labeling. Units after application
  132. of scale and offset are nanofarads.
  133. What: /sys/bus/iio/devices/iio:deviceX/in_temp_raw
  134. What: /sys/bus/iio/devices/iio:deviceX/in_tempX_raw
  135. What: /sys/bus/iio/devices/iio:deviceX/in_temp_x_raw
  136. What: /sys/bus/iio/devices/iio:deviceX/in_temp_y_raw
  137. What: /sys/bus/iio/devices/iio:deviceX/in_temp_ambient_raw
  138. What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_raw
  139. KernelVersion: 2.6.35
  140. Contact: linux-iio@vger.kernel.org
  141. Description:
  142. Raw (unscaled no bias removal etc.) temperature measurement.
  143. If an axis is specified it generally means that the temperature
  144. sensor is associated with one part of a compound device (e.g.
  145. a gyroscope axis). The ambient and object modifiers distinguish
  146. between ambient (reference) and distant temperature for contact-
  147. less measurements. Units after application of scale and offset
  148. are milli degrees Celsius.
  149. What: /sys/bus/iio/devices/iio:deviceX/in_tempX_input
  150. KernelVersion: 2.6.38
  151. Contact: linux-iio@vger.kernel.org
  152. Description:
  153. Scaled temperature measurement in milli degrees Celsius.
  154. What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw
  155. What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_raw
  156. What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_raw
  157. KernelVersion: 2.6.35
  158. Contact: linux-iio@vger.kernel.org
  159. Description:
  160. Acceleration in direction x, y or z (may be arbitrarily assigned
  161. but should match other such assignments on device).
  162. Has all of the equivalent parameters as per voltageY. Units
  163. after application of scale and offset are m/s^2.
  164. What: /sys/bus/iio/devices/iio:deviceX/in_gravity_x_raw
  165. What: /sys/bus/iio/devices/iio:deviceX/in_gravity_y_raw
  166. What: /sys/bus/iio/devices/iio:deviceX/in_gravity_z_raw
  167. KernelVersion: 4.11
  168. Contact: linux-iio@vger.kernel.org
  169. Description:
  170. Gravity in direction x, y or z (may be arbitrarily assigned
  171. but should match other such assignments on device).
  172. Units after application of scale and offset are m/s^2.
  173. What: /sys/bus/iio/devices/iio:deviceX/in_angl_raw
  174. KernelVersion: 4.17
  175. Contact: linux-iio@vger.kernel.org
  176. Description:
  177. Angle of rotation. Units after application of scale and offset
  178. are radians.
  179. What: /sys/bus/iio/devices/iio:deviceX/in_positionrelative_x_raw
  180. What: /sys/bus/iio/devices/iio:deviceX/in_positionrelative_y_raw
  181. KernelVersion: 4.18
  182. Contact: linux-iio@vger.kernel.org
  183. Description:
  184. Relative position in direction x or y on a pad (may be
  185. arbitrarily assigned but should match other such assignments on
  186. device).
  187. Units after application of scale and offset are milli percents
  188. from the pad's size in both directions. Should be calibrated by
  189. the consumer.
  190. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw
  191. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw
  192. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw
  193. KernelVersion: 2.6.35
  194. Contact: linux-iio@vger.kernel.org
  195. Description:
  196. Angular velocity about axis x, y or z (may be arbitrarily
  197. assigned). Has all the equivalent parameters as per voltageY.
  198. Units after application of scale and offset are radians per
  199. second.
  200. What: /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
  201. What: /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
  202. What: /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
  203. KernelVersion: 2.6.35
  204. Contact: linux-iio@vger.kernel.org
  205. Description:
  206. Inclination raw reading about axis x, y or z (may be
  207. arbitrarily assigned). Data converted by application of offset
  208. and scale to degrees.
  209. What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
  210. What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
  211. What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
  212. KernelVersion: 2.6.35
  213. Contact: linux-iio@vger.kernel.org
  214. Description:
  215. Magnetic field along axis x, y or z (may be arbitrarily
  216. assigned). Data converted by application of offset
  217. then scale to Gauss.
  218. What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
  219. What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
  220. What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
  221. KernelVersion: 2.6.36
  222. Contact: linux-iio@vger.kernel.org
  223. Description:
  224. Highest value since some reset condition. These
  225. attributes allow access to this and are otherwise
  226. the direct equivalent of the <type>Y[_name]_raw attributes.
  227. What: /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
  228. KernelVersion: 2.6.36
  229. Contact: linux-iio@vger.kernel.org
  230. Description:
  231. A computed peak value based on the sum squared magnitude of
  232. the underlying value in the specified directions.
  233. What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_raw
  234. What: /sys/bus/iio/devices/iio:deviceX/in_pressure_raw
  235. KernelVersion: 3.8
  236. Contact: linux-iio@vger.kernel.org
  237. Description:
  238. Raw pressure measurement from channel Y. Units after
  239. application of scale and offset are kilopascal.
  240. What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_input
  241. What: /sys/bus/iio/devices/iio:deviceX/in_pressure_input
  242. KernelVersion: 3.8
  243. Contact: linux-iio@vger.kernel.org
  244. Description:
  245. Scaled pressure measurement from channel Y, in kilopascal.
  246. What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_raw
  247. KernelVersion: 3.14
  248. Contact: linux-iio@vger.kernel.org
  249. Description:
  250. Raw humidity measurement of air. Units after application of
  251. scale and offset are milli percent.
  252. What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_input
  253. KernelVersion: 3.14
  254. Contact: linux-iio@vger.kernel.org
  255. Description:
  256. Scaled humidity measurement in milli percent.
  257. What: /sys/bus/iio/devices/iio:deviceX/in_X_mean_raw
  258. KernelVersion: 3.5
  259. Contact: linux-iio@vger.kernel.org
  260. Description:
  261. Averaged raw measurement from channel X. The number of values
  262. used for averaging is device specific. The converting rules for
  263. normal raw values also applies to the averaged raw values.
  264. What: /sys/bus/iio/devices/iio:deviceX/in_accel_offset
  265. What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
  266. What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
  267. What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
  268. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
  269. What: /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
  270. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_offset
  271. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_offset
  272. What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_offset
  273. What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_offset
  274. What: /sys/bus/iio/devices/iio:deviceX/in_currentY_offset
  275. What: /sys/bus/iio/devices/iio:deviceX/in_current_offset
  276. What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_offset
  277. What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_offset
  278. What: /sys/bus/iio/devices/iio:deviceX/in_current_q_offset
  279. What: /sys/bus/iio/devices/iio:deviceX/in_current_i_offset
  280. What: /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
  281. What: /sys/bus/iio/devices/iio:deviceX/in_temp_offset
  282. What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_offset
  283. What: /sys/bus/iio/devices/iio:deviceX/in_pressure_offset
  284. What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_offset
  285. What: /sys/bus/iio/devices/iio:deviceX/in_magn_offset
  286. What: /sys/bus/iio/devices/iio:deviceX/in_rot_offset
  287. What: /sys/bus/iio/devices/iio:deviceX/in_angl_offset
  288. KernelVersion: 2.6.35
  289. Contact: linux-iio@vger.kernel.org
  290. Description:
  291. If known for a device, offset to be added to <type>[Y]_raw prior
  292. to scaling by <type>[Y]_scale in order to obtain value in the
  293. <type> units as specified in <type>[Y]_raw documentation.
  294. Not present if the offset is always 0 or unknown. If Y or
  295. axis <x|y|z> is not present, then the offset applies to all
  296. in channels of <type>.
  297. May be writable if a variable offset can be applied on the
  298. device. Note that this is different to calibbias which
  299. is for devices (or drivers) that apply offsets to compensate
  300. for variation between different instances of the part, typically
  301. adjusted by using some hardware supported calibration procedure.
  302. Calibbias is applied internally, offset is applied in userspace
  303. to the _raw output.
  304. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
  305. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_scale
  306. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_scale
  307. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
  308. What: /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
  309. What: /sys/bus/iio/devices/iio:deviceX/in_voltage_i_scale
  310. What: /sys/bus/iio/devices/iio:deviceX/in_voltage_q_scale
  311. What: /sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_scale
  312. What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
  313. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale
  314. What: /sys/bus/iio/devices/iio:deviceX/in_currentY_scale
  315. What: /sys/bus/iio/devices/iio:deviceX/in_currentY_supply_scale
  316. What: /sys/bus/iio/devices/iio:deviceX/in_current_scale
  317. What: /sys/bus/iio/devices/iio:deviceX/in_currentY_i_scale
  318. What: /sys/bus/iio/devices/iio:deviceX/in_currentY_q_scale
  319. What: /sys/bus/iio/devices/iio:deviceX/in_current_i_scale
  320. What: /sys/bus/iio/devices/iio:deviceX/in_current_q_scale
  321. What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale
  322. What: /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
  323. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale
  324. What: /sys/bus/iio/devices/iio:deviceX/in_energy_scale
  325. What: /sys/bus/iio/devices/iio:deviceX/in_distance_scale
  326. What: /sys/bus/iio/devices/iio:deviceX/in_magn_scale
  327. What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
  328. What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
  329. What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
  330. What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_scale
  331. What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_scale
  332. What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_scale
  333. What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_scale
  334. What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_scale
  335. What: /sys/bus/iio/devices/iio:deviceX/in_pressure_scale
  336. What: /sys/bus/iio/devices/iio:deviceX/in_humidityrelative_scale
  337. What: /sys/bus/iio/devices/iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_scale
  338. What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_scale
  339. What: /sys/bus/iio/devices/iio:deviceX/in_countY_scale
  340. What: /sys/bus/iio/devices/iio:deviceX/in_angl_scale
  341. KernelVersion: 2.6.35
  342. Contact: linux-iio@vger.kernel.org
  343. Description:
  344. If known for a device, scale to be applied to <type>Y[_name]_raw
  345. post addition of <type>[Y][_name]_offset in order to obtain the
  346. measured value in <type> units as specified in
  347. <type>[Y][_name]_raw documentation. If shared across all in
  348. channels then Y and <x|y|z> are not present and the value is
  349. called <type>[Y][_name]_scale. The peak modifier means this
  350. value is applied to <type>Y[_name]_peak_raw values.
  351. What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
  352. What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
  353. What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
  354. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias
  355. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
  356. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
  357. What: /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
  358. What: /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
  359. What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibbias
  360. What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibbias
  361. KernelVersion: 2.6.35
  362. Contact: linux-iio@vger.kernel.org
  363. Description:
  364. Hardware applied calibration offset (assumed to fix production
  365. inaccuracies).
  366. What /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
  367. What /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
  368. What /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_calibscale
  369. What /sys/bus/iio/devices/iio:deviceX/in_voltageY_q_calibscale
  370. What /sys/bus/iio/devices/iio:deviceX/in_voltage_i_calibscale
  371. What /sys/bus/iio/devices/iio:deviceX/in_voltage_q_calibscale
  372. What /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
  373. What /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
  374. What /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
  375. What /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
  376. What /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
  377. What /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
  378. What /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
  379. what /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
  380. what /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
  381. What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_calibscale
  382. What: /sys/bus/iio/devices/iio:deviceX/in_pressure_calibscale
  383. What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_calibscale
  384. KernelVersion: 2.6.35
  385. Contact: linux-iio@vger.kernel.org
  386. Description:
  387. Hardware applied calibration scale factor (assumed to fix
  388. production inaccuracies). If shared across all channels,
  389. <type>_calibscale is used.
  390. What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender
  391. What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender
  392. What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender
  393. What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender
  394. KernelVersion: 4.0
  395. Contact: linux-iio@vger.kernel.org
  396. Description:
  397. Gender of the user (e.g.: male, female) used by some pedometers
  398. to compute the stride length, distance, speed and activity
  399. type.
  400. What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibgender_available
  401. What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibgender_available
  402. What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibgender_available
  403. What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender_available
  404. KernelVersion: 4.0
  405. Contact: linux-iio@vger.kernel.org
  406. Description:
  407. Lists all available gender values (e.g.: male, female).
  408. What: /sys/bus/iio/devices/iio:deviceX/in_activity_calibheight
  409. What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibheight
  410. What: /sys/bus/iio/devices/iio:deviceX/in_distance_calibheight
  411. What: /sys/bus/iio/devices/iio:deviceX/in_velocity_calibheight
  412. KernelVersion: 3.19
  413. Contact: linux-iio@vger.kernel.org
  414. Description:
  415. Height of the user (in meters) used by some pedometers
  416. to compute the stride length, distance, speed and activity
  417. type.
  418. What: /sys/bus/iio/devices/iio:deviceX/in_energy_calibweight
  419. KernelVersion: 4.0
  420. Contact: linux-iio@vger.kernel.org
  421. Description:
  422. Weight of the user (in kg). It is needed by some pedometers
  423. to compute the calories burnt by the user.
  424. What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
  425. What: /sys/.../iio:deviceX/in_anglvel_scale_available
  426. What: /sys/.../iio:deviceX/in_magn_scale_available
  427. What: /sys/.../iio:deviceX/in_illuminance_scale_available
  428. What: /sys/.../iio:deviceX/in_intensity_scale_available
  429. What: /sys/.../iio:deviceX/in_proximity_scale_available
  430. What: /sys/.../iio:deviceX/in_voltageX_scale_available
  431. What: /sys/.../iio:deviceX/in_voltage-voltage_scale_available
  432. What: /sys/.../iio:deviceX/out_voltageX_scale_available
  433. What: /sys/.../iio:deviceX/out_altvoltageX_scale_available
  434. What: /sys/.../iio:deviceX/in_capacitance_scale_available
  435. What: /sys/.../iio:deviceX/in_pressure_scale_available
  436. What: /sys/.../iio:deviceX/in_pressureY_scale_available
  437. KernelVersion: 2.6.35
  438. Contact: linux-iio@vger.kernel.org
  439. Description:
  440. If a discrete set of scale values is available, they
  441. are listed in this attribute.
  442. What /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
  443. What: /sys/bus/iio/devices/iio:deviceX/in_intensity_red_hardwaregain
  444. What: /sys/bus/iio/devices/iio:deviceX/in_intensity_green_hardwaregain
  445. What: /sys/bus/iio/devices/iio:deviceX/in_intensity_blue_hardwaregain
  446. What: /sys/bus/iio/devices/iio:deviceX/in_intensity_clear_hardwaregain
  447. KernelVersion: 2.6.35
  448. Contact: linux-iio@vger.kernel.org
  449. Description:
  450. Hardware applied gain factor. If shared across all channels,
  451. <type>_hardwaregain is used.
  452. What: /sys/.../in_accel_filter_low_pass_3db_frequency
  453. What: /sys/.../in_magn_filter_low_pass_3db_frequency
  454. What: /sys/.../in_anglvel_filter_low_pass_3db_frequency
  455. KernelVersion: 3.2
  456. Contact: linux-iio@vger.kernel.org
  457. Description:
  458. If a known or controllable low pass filter is applied
  459. to the underlying data channel, then this parameter
  460. gives the 3dB frequency of the filter in Hz.
  461. What: /sys/.../in_accel_filter_high_pass_3db_frequency
  462. What: /sys/.../in_anglvel_filter_high_pass_3db_frequency
  463. What: /sys/.../in_magn_filter_high_pass_3db_frequency
  464. KernelVersion: 4.2
  465. Contact: linux-iio@vger.kernel.org
  466. Description:
  467. If a known or controllable high pass filter is applied
  468. to the underlying data channel, then this parameter
  469. gives the 3dB frequency of the filter in Hz.
  470. What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
  471. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw
  472. KernelVersion: 2.6.37
  473. Contact: linux-iio@vger.kernel.org
  474. Description:
  475. Raw (unscaled, no bias etc.) output voltage for
  476. channel Y. The number must always be specified and
  477. unique if the output corresponds to a single channel.
  478. While DAC like devices typically use out_voltage,
  479. a continuous frequency generating device, such as
  480. a DDS or PLL should use out_altvoltage.
  481. What: /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
  482. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw
  483. KernelVersion: 2.6.37
  484. Contact: linux-iio@vger.kernel.org
  485. Description:
  486. Raw (unscaled, no bias etc.) output voltage for an aggregate of
  487. channel Y, channel Z, etc. This interface is available in cases
  488. where a single output sets the value for multiple channels
  489. simultaneously.
  490. What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
  491. What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
  492. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode
  493. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode
  494. KernelVersion: 2.6.38
  495. Contact: linux-iio@vger.kernel.org
  496. Description:
  497. Specifies the output powerdown mode.
  498. DAC output stage is disconnected from the amplifier and
  499. 1kohm_to_gnd: connected to ground via an 1kOhm resistor,
  500. 2.5kohm_to_gnd: connected to ground via a 2.5kOhm resistor,
  501. 6kohm_to_gnd: connected to ground via a 6kOhm resistor,
  502. 20kohm_to_gnd: connected to ground via a 20kOhm resistor,
  503. 90kohm_to_gnd: connected to ground via a 90kOhm resistor,
  504. 100kohm_to_gnd: connected to ground via an 100kOhm resistor,
  505. 125kohm_to_gnd: connected to ground via an 125kOhm resistor,
  506. 500kohm_to_gnd: connected to ground via a 500kOhm resistor,
  507. 640kohm_to_gnd: connected to ground via a 640kOhm resistor,
  508. three_state: left floating.
  509. For a list of available output power down options read
  510. outX_powerdown_mode_available. If Y is not present the
  511. mode is shared across all outputs.
  512. What: /sys/.../iio:deviceX/out_voltageY_powerdown_mode_available
  513. What: /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
  514. What: /sys/.../iio:deviceX/out_altvoltageY_powerdown_mode_available
  515. What: /sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available
  516. KernelVersion: 2.6.38
  517. Contact: linux-iio@vger.kernel.org
  518. Description:
  519. Lists all available output power down modes.
  520. If Y is not present the mode is shared across all outputs.
  521. What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
  522. What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
  523. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
  524. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown
  525. KernelVersion: 2.6.38
  526. Contact: linux-iio@vger.kernel.org
  527. Description:
  528. Writing 1 causes output Y to enter the power down mode specified
  529. by the corresponding outY_powerdown_mode. DAC output stage is
  530. disconnected from the amplifier. Clearing returns to normal
  531. operation. Y may be suppressed if all outputs are controlled
  532. together.
  533. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency
  534. KernelVersion: 3.4.0
  535. Contact: linux-iio@vger.kernel.org
  536. Description:
  537. Output frequency for channel Y in Hz. The number must always be
  538. specified and unique if the output corresponds to a single
  539. channel.
  540. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase
  541. KernelVersion: 3.4.0
  542. Contact: linux-iio@vger.kernel.org
  543. Description:
  544. Phase in radians of one frequency/clock output Y
  545. (out_altvoltageY) relative to another frequency/clock output
  546. (out_altvoltageZ) of the device X. The number must always be
  547. specified and unique if the output corresponds to a single
  548. channel.
  549. What: /sys/bus/iio/devices/iio:deviceX/events
  550. KernelVersion: 2.6.35
  551. Contact: linux-iio@vger.kernel.org
  552. Description:
  553. Configuration of which hardware generated events are passed up
  554. to user-space.
  555. What: /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
  556. What: /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
  557. What: /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
  558. What: /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
  559. What: /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
  560. What: /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
  561. What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
  562. What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
  563. What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
  564. What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
  565. What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
  566. What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
  567. What: /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
  568. What: /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
  569. What: /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
  570. What: /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
  571. What: /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
  572. What: /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
  573. What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_rising_en
  574. What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_falling_en
  575. What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_rising_en
  576. What: /sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_falling_en
  577. What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_en
  578. What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_en
  579. What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_rising_en
  580. What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_falling_en
  581. What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
  582. What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
  583. What: /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
  584. What: /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
  585. What: /sys/.../iio:deviceX/events/in_voltageY_thresh_either_en
  586. What: /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
  587. What: /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
  588. KernelVersion: 2.6.37
  589. Contact: linux-iio@vger.kernel.org
  590. Description:
  591. Event generated when channel passes a threshold in the specified
  592. (_rising|_falling) direction. If the direction is not specified,
  593. then either the device will report an event which ever direction
  594. a single threshold value is passed in (e.g.
  595. <type>[Y][_name]_<raw|input>_thresh_value) or
  596. <type>[Y][_name]_<raw|input>_thresh_rising_value and
  597. <type>[Y][_name]_<raw|input>_thresh_falling_value may take
  598. different values, but the device can only enable both thresholds
  599. or neither.
  600. Note the driver will assume the last p events requested are
  601. to be enabled where p is how many it supports (which may vary
  602. depending on the exact set requested. So if you want to be
  603. sure you have set what you think you have, check the contents of
  604. these attributes after everything is configured. Drivers may
  605. have to buffer any parameters so that they are consistent when
  606. a given event type is enabled at a future point (and not those for
  607. whatever event was previously enabled).
  608. What: /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
  609. What: /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
  610. What: /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
  611. What: /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
  612. What: /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
  613. What: /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
  614. What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
  615. What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
  616. What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
  617. What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
  618. What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
  619. What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
  620. What: /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
  621. What: /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
  622. What: /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
  623. What: /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
  624. What: /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
  625. What: /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
  626. What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_rising_en
  627. What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_falling_en
  628. What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_rising_en
  629. What: /sys/.../iio:deviceX/events/in_rot_from_north_true_roc_falling_en
  630. What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_rising_en
  631. What: /sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_falling_en
  632. What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_rising_en
  633. What: /sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_falling_en
  634. What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
  635. What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
  636. What: /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
  637. What: /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
  638. What: /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
  639. What: /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
  640. KernelVersion: 2.6.37
  641. Contact: linux-iio@vger.kernel.org
  642. Description:
  643. Event generated when channel passes a threshold on the rate of
  644. change (1st differential) in the specified (_rising|_falling)
  645. direction. If the direction is not specified, then either the
  646. device will report an event which ever direction a single
  647. threshold value is passed in (e.g.
  648. <type>[Y][_name]_<raw|input>_roc_value) or
  649. <type>[Y][_name]_<raw|input>_roc_rising_value and
  650. <type>[Y][_name]_<raw|input>_roc_falling_value may take
  651. different values, but the device can only enable both rate of
  652. change thresholds or neither.
  653. Note the driver will assume the last p events requested are
  654. to be enabled where p is however many it supports (which may
  655. vary depending on the exact set requested. So if you want to be
  656. sure you have set what you think you have, check the contents of
  657. these attributes after everything is configured. Drivers may
  658. have to buffer any parameters so that they are consistent when
  659. a given event type is enabled a future point (and not those for
  660. whatever event was previously enabled).
  661. What: /sys/.../events/in_accel_thresh_rising_value
  662. What: /sys/.../events/in_accel_thresh_falling_value
  663. What: /sys/.../events/in_accel_x_raw_thresh_rising_value
  664. What: /sys/.../events/in_accel_x_raw_thresh_falling_value
  665. What: /sys/.../events/in_accel_y_raw_thresh_rising_value
  666. What: /sys/.../events/in_accel_y_raw_thresh_falling_value
  667. What: /sys/.../events/in_accel_z_raw_thresh_rising_value
  668. What: /sys/.../events/in_accel_z_raw_thresh_falling_value
  669. What: /sys/.../events/in_anglvel_x_raw_thresh_rising_value
  670. What: /sys/.../events/in_anglvel_x_raw_thresh_falling_value
  671. What: /sys/.../events/in_anglvel_y_raw_thresh_rising_value
  672. What: /sys/.../events/in_anglvel_y_raw_thresh_falling_value
  673. What: /sys/.../events/in_anglvel_z_raw_thresh_rising_value
  674. What: /sys/.../events/in_anglvel_z_raw_thresh_falling_value
  675. What: /sys/.../events/in_magn_x_raw_thresh_rising_value
  676. What: /sys/.../events/in_magn_x_raw_thresh_falling_value
  677. What: /sys/.../events/in_magn_y_raw_thresh_rising_value
  678. What: /sys/.../events/in_magn_y_raw_thresh_falling_value
  679. What: /sys/.../events/in_magn_z_raw_thresh_rising_value
  680. What: /sys/.../events/in_magn_z_raw_thresh_falling_value
  681. What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_rising_value
  682. What: /sys/.../events/in_rot_from_north_magnetic_raw_thresh_falling_value
  683. What: /sys/.../events/in_rot_from_north_true_raw_thresh_rising_value
  684. What: /sys/.../events/in_rot_from_north_true_raw_thresh_falling_value
  685. What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_rising_value
  686. What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_falling_value
  687. What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_rising_value
  688. What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_falling_value
  689. What: /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
  690. What: /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
  691. What: /sys/.../events/in_voltageY_raw_thresh_rising_value
  692. What: /sys/.../events/in_voltageY_raw_thresh_falling_value
  693. What: /sys/.../events/in_tempY_raw_thresh_rising_value
  694. What: /sys/.../events/in_tempY_raw_thresh_falling_value
  695. What: /sys/.../events/in_illuminance0_thresh_falling_value
  696. what: /sys/.../events/in_illuminance0_thresh_rising_value
  697. what: /sys/.../events/in_proximity0_thresh_falling_value
  698. what: /sys/.../events/in_proximity0_thresh_rising_value
  699. KernelVersion: 2.6.37
  700. Contact: linux-iio@vger.kernel.org
  701. Description:
  702. Specifies the value of threshold that the device is comparing
  703. against for the events enabled by
  704. <type>Y[_name]_thresh[_rising|falling]_en.
  705. If separate attributes exist for the two directions, but
  706. direction is not specified for this attribute, then a single
  707. threshold value applies to both directions.
  708. The raw or input element of the name indicates whether the
  709. value is in raw device units or in processed units (as _raw
  710. and _input do on sysfs direct channel read attributes).
  711. What: /sys/.../events/in_accel_scale
  712. What: /sys/.../events/in_accel_peak_scale
  713. What: /sys/.../events/in_anglvel_scale
  714. What: /sys/.../events/in_magn_scale
  715. What: /sys/.../events/in_rot_from_north_magnetic_scale
  716. What: /sys/.../events/in_rot_from_north_true_scale
  717. What: /sys/.../events/in_voltage_scale
  718. What: /sys/.../events/in_voltage_supply_scale
  719. What: /sys/.../events/in_temp_scale
  720. What: /sys/.../events/in_illuminance_scale
  721. What: /sys/.../events/in_proximity_scale
  722. KernelVersion: 3.21
  723. Contact: linux-iio@vger.kernel.org
  724. Description:
  725. Specifies the conversion factor from the standard units
  726. to device specific units used to set the event trigger
  727. threshold.
  728. What: /sys/.../events/in_accel_x_thresh_rising_hysteresis
  729. What: /sys/.../events/in_accel_x_thresh_falling_hysteresis
  730. What: /sys/.../events/in_accel_x_thresh_either_hysteresis
  731. What: /sys/.../events/in_accel_y_thresh_rising_hysteresis
  732. What: /sys/.../events/in_accel_y_thresh_falling_hysteresis
  733. What: /sys/.../events/in_accel_y_thresh_either_hysteresis
  734. What: /sys/.../events/in_accel_z_thresh_rising_hysteresis
  735. What: /sys/.../events/in_accel_z_thresh_falling_hysteresis
  736. What: /sys/.../events/in_accel_z_thresh_either_hysteresis
  737. What: /sys/.../events/in_anglvel_x_thresh_rising_hysteresis
  738. What: /sys/.../events/in_anglvel_x_thresh_falling_hysteresis
  739. What: /sys/.../events/in_anglvel_x_thresh_either_hysteresis
  740. What: /sys/.../events/in_anglvel_y_thresh_rising_hysteresis
  741. What: /sys/.../events/in_anglvel_y_thresh_falling_hysteresis
  742. What: /sys/.../events/in_anglvel_y_thresh_either_hysteresis
  743. What: /sys/.../events/in_anglvel_z_thresh_rising_hysteresis
  744. What: /sys/.../events/in_anglvel_z_thresh_falling_hysteresis
  745. What: /sys/.../events/in_anglvel_z_thresh_either_hysteresis
  746. What: /sys/.../events/in_magn_x_thresh_rising_hysteresis
  747. What: /sys/.../events/in_magn_x_thresh_falling_hysteresis
  748. What: /sys/.../events/in_magn_x_thresh_either_hysteresis
  749. What: /sys/.../events/in_magn_y_thresh_rising_hysteresis
  750. What: /sys/.../events/in_magn_y_thresh_falling_hysteresis
  751. What: /sys/.../events/in_magn_y_thresh_either_hysteresis
  752. What: /sys/.../events/in_magn_z_thresh_rising_hysteresis
  753. What: /sys/.../events/in_magn_z_thresh_falling_hysteresis
  754. What: /sys/.../events/in_magn_z_thresh_either_hysteresis
  755. What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_hysteresis
  756. What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_hysteresis
  757. What: /sys/.../events/in_rot_from_north_magnetic_thresh_either_hysteresis
  758. What: /sys/.../events/in_rot_from_north_true_thresh_rising_hysteresis
  759. What: /sys/.../events/in_rot_from_north_true_thresh_falling_hysteresis
  760. What: /sys/.../events/in_rot_from_north_true_thresh_either_hysteresis
  761. What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_hysteresis
  762. What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_hysteresis
  763. What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_either_hysteresis
  764. What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_hysteresis
  765. What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_hysteresis
  766. What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_either_hysteresis
  767. What: /sys/.../events/in_voltageY_thresh_rising_hysteresis
  768. What: /sys/.../events/in_voltageY_thresh_falling_hysteresis
  769. What: /sys/.../events/in_voltageY_thresh_either_hysteresis
  770. What: /sys/.../events/in_tempY_thresh_rising_hysteresis
  771. What: /sys/.../events/in_tempY_thresh_falling_hysteresis
  772. What: /sys/.../events/in_tempY_thresh_either_hysteresis
  773. What: /sys/.../events/in_illuminance0_thresh_falling_hysteresis
  774. what: /sys/.../events/in_illuminance0_thresh_rising_hysteresis
  775. what: /sys/.../events/in_illuminance0_thresh_either_hysteresis
  776. what: /sys/.../events/in_proximity0_thresh_falling_hysteresis
  777. what: /sys/.../events/in_proximity0_thresh_rising_hysteresis
  778. what: /sys/.../events/in_proximity0_thresh_either_hysteresis
  779. KernelVersion: 3.13
  780. Contact: linux-iio@vger.kernel.org
  781. Description:
  782. Specifies the hysteresis of threshold that the device is comparing
  783. against for the events enabled by
  784. <type>Y[_name]_thresh[_(rising|falling)]_hysteresis.
  785. If separate attributes exist for the two directions, but
  786. direction is not specified for this attribute, then a single
  787. hysteresis value applies to both directions.
  788. For falling events the hysteresis is added to the _value attribute for
  789. this event to get the upper threshold for when the event goes back to
  790. normal, for rising events the hysteresis is subtracted from the _value
  791. attribute. E.g. if in_voltage0_raw_thresh_rising_value is set to 1200
  792. and in_voltage0_raw_thresh_rising_hysteresis is set to 50. The event
  793. will get activated once in_voltage0_raw goes above 1200 and will become
  794. deactivated again once the value falls below 1150.
  795. What: /sys/.../events/in_accel_x_raw_roc_rising_value
  796. What: /sys/.../events/in_accel_x_raw_roc_falling_value
  797. What: /sys/.../events/in_accel_y_raw_roc_rising_value
  798. What: /sys/.../events/in_accel_y_raw_roc_falling_value
  799. What: /sys/.../events/in_accel_z_raw_roc_rising_value
  800. What: /sys/.../events/in_accel_z_raw_roc_falling_value
  801. What: /sys/.../events/in_anglvel_x_raw_roc_rising_value
  802. What: /sys/.../events/in_anglvel_x_raw_roc_falling_value
  803. What: /sys/.../events/in_anglvel_y_raw_roc_rising_value
  804. What: /sys/.../events/in_anglvel_y_raw_roc_falling_value
  805. What: /sys/.../events/in_anglvel_z_raw_roc_rising_value
  806. What: /sys/.../events/in_anglvel_z_raw_roc_falling_value
  807. What: /sys/.../events/in_magn_x_raw_roc_rising_value
  808. What: /sys/.../events/in_magn_x_raw_roc_falling_value
  809. What: /sys/.../events/in_magn_y_raw_roc_rising_value
  810. What: /sys/.../events/in_magn_y_raw_roc_falling_value
  811. What: /sys/.../events/in_magn_z_raw_roc_rising_value
  812. What: /sys/.../events/in_magn_z_raw_roc_falling_value
  813. What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_rising_value
  814. What: /sys/.../events/in_rot_from_north_magnetic_raw_roc_falling_value
  815. What: /sys/.../events/in_rot_from_north_true_raw_roc_rising_value
  816. What: /sys/.../events/in_rot_from_north_true_raw_roc_falling_value
  817. What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_rising_value
  818. What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_falling_value
  819. What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_rising_value
  820. What: /sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_falling_value
  821. What: /sys/.../events/in_voltageY_supply_raw_roc_rising_value
  822. What: /sys/.../events/in_voltageY_supply_raw_roc_falling_value
  823. What: /sys/.../events/in_voltageY_raw_roc_rising_value
  824. What: /sys/.../events/in_voltageY_raw_roc_falling_value
  825. What: /sys/.../events/in_tempY_raw_roc_rising_value
  826. What: /sys/.../events/in_tempY_raw_roc_falling_value
  827. KernelVersion: 2.6.37
  828. Contact: linux-iio@vger.kernel.org
  829. Description:
  830. Specifies the value of rate of change threshold that the
  831. device is comparing against for the events enabled by
  832. <type>[Y][_name]_roc[_rising|falling]_en.
  833. If separate attributes exist for the two directions,
  834. but direction is not specified for this attribute,
  835. then a single threshold value applies to both directions.
  836. The raw or input element of the name indicates whether the
  837. value is in raw device units or in processed units (as _raw
  838. and _input do on sysfs direct channel read attributes).
  839. What: /sys/.../events/in_accel_x_thresh_rising_period
  840. What: /sys/.../events/in_accel_x_thresh_falling_period
  841. What: /sys/.../events/in_accel_x_roc_rising_period
  842. What: /sys/.../events/in_accel_x_roc_falling_period
  843. What: /sys/.../events/in_accel_y_thresh_rising_period
  844. What: /sys/.../events/in_accel_y_thresh_falling_period
  845. What: /sys/.../events/in_accel_y_roc_rising_period
  846. What: /sys/.../events/in_accel_y_roc_falling_period
  847. What: /sys/.../events/in_accel_z_thresh_rising_period
  848. What: /sys/.../events/in_accel_z_thresh_falling_period
  849. What: /sys/.../events/in_accel_z_roc_rising_period
  850. What: /sys/.../events/in_accel_z_roc_falling_period
  851. What: /sys/.../events/in_anglvel_x_thresh_rising_period
  852. What: /sys/.../events/in_anglvel_x_thresh_falling_period
  853. What: /sys/.../events/in_anglvel_x_roc_rising_period
  854. What: /sys/.../events/in_anglvel_x_roc_falling_period
  855. What: /sys/.../events/in_anglvel_y_thresh_rising_period
  856. What: /sys/.../events/in_anglvel_y_thresh_falling_period
  857. What: /sys/.../events/in_anglvel_y_roc_rising_period
  858. What: /sys/.../events/in_anglvel_y_roc_falling_period
  859. What: /sys/.../events/in_anglvel_z_thresh_rising_period
  860. What: /sys/.../events/in_anglvel_z_thresh_falling_period
  861. What: /sys/.../events/in_anglvel_z_roc_rising_period
  862. What: /sys/.../events/in_anglvel_z_roc_falling_period
  863. What: /sys/.../events/in_magn_x_thresh_rising_period
  864. What: /sys/.../events/in_magn_x_thresh_falling_period
  865. What: /sys/.../events/in_magn_x_roc_rising_period
  866. What: /sys/.../events/in_magn_x_roc_falling_period
  867. What: /sys/.../events/in_magn_y_thresh_rising_period
  868. What: /sys/.../events/in_magn_y_thresh_falling_period
  869. What: /sys/.../events/in_magn_y_roc_rising_period
  870. What: /sys/.../events/in_magn_y_roc_falling_period
  871. What: /sys/.../events/in_magn_z_thresh_rising_period
  872. What: /sys/.../events/in_magn_z_thresh_falling_period
  873. What: /sys/.../events/in_magn_z_roc_rising_period
  874. What: /sys/.../events/in_magn_z_roc_falling_period
  875. What: /sys/.../events/in_rot_from_north_magnetic_thresh_rising_period
  876. What: /sys/.../events/in_rot_from_north_magnetic_thresh_falling_period
  877. What: /sys/.../events/in_rot_from_north_magnetic_roc_rising_period
  878. What: /sys/.../events/in_rot_from_north_magnetic_roc_falling_period
  879. What: /sys/.../events/in_rot_from_north_true_thresh_rising_period
  880. What: /sys/.../events/in_rot_from_north_true_thresh_falling_period
  881. What: /sys/.../events/in_rot_from_north_true_roc_rising_period
  882. What: /sys/.../events/in_rot_from_north_true_roc_falling_period
  883. What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_period
  884. What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_period
  885. What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_rising_period
  886. What: /sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_falling_period
  887. What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_period
  888. What: /sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_period
  889. What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_rising_period
  890. What: /sys/.../events/in_rot_from_north_true_tilt_comp_roc_falling_period
  891. What: /sys/.../events/in_voltageY_supply_thresh_rising_period
  892. What: /sys/.../events/in_voltageY_supply_thresh_falling_period
  893. What: /sys/.../events/in_voltageY_supply_roc_rising_period
  894. What: /sys/.../events/in_voltageY_supply_roc_falling_period
  895. What: /sys/.../events/in_voltageY_thresh_rising_period
  896. What: /sys/.../events/in_voltageY_thresh_falling_period
  897. What: /sys/.../events/in_voltageY_roc_rising_period
  898. What: /sys/.../events/in_voltageY_roc_falling_period
  899. What: /sys/.../events/in_tempY_thresh_rising_period
  900. What: /sys/.../events/in_tempY_thresh_falling_period
  901. What: /sys/.../events/in_tempY_roc_rising_period
  902. What: /sys/.../events/in_tempY_roc_falling_period
  903. What: /sys/.../events/in_accel_x&y&z_mag_falling_period
  904. What: /sys/.../events/in_intensity0_thresh_period
  905. What: /sys/.../events/in_proximity0_thresh_period
  906. What: /sys/.../events/in_activity_still_thresh_rising_period
  907. What: /sys/.../events/in_activity_still_thresh_falling_period
  908. What: /sys/.../events/in_activity_walking_thresh_rising_period
  909. What: /sys/.../events/in_activity_walking_thresh_falling_period
  910. What: /sys/.../events/in_activity_jogging_thresh_rising_period
  911. What: /sys/.../events/in_activity_jogging_thresh_falling_period
  912. What: /sys/.../events/in_activity_running_thresh_rising_period
  913. What: /sys/.../events/in_activity_running_thresh_falling_period
  914. KernelVersion: 2.6.37
  915. Contact: linux-iio@vger.kernel.org
  916. Description:
  917. Period of time (in seconds) for which the condition must be
  918. met before an event is generated. If direction is not
  919. specified then this period applies to both directions.
  920. What: /sys/.../events/in_accel_thresh_rising_low_pass_filter_3db
  921. What: /sys/.../events/in_anglvel_thresh_rising_low_pass_filter_3db
  922. What: /sys/.../events/in_magn_thresh_rising_low_pass_filter_3db
  923. KernelVersion: 4.2
  924. Contact: linux-iio@vger.kernel.org
  925. Description:
  926. If a low pass filter can be applied to the event generation
  927. this property gives its 3db frequency in Hz.
  928. A value of zero disables the filter.
  929. What: /sys/.../events/in_accel_thresh_rising_high_pass_filter_3db
  930. What: /sys/.../events/in_anglvel_thresh_rising_high_pass_filter_3db
  931. What: /sys/.../events/in_magn_thresh_rising_high_pass_filter_3db
  932. KernelVersion: 4.2
  933. Contact: linux-iio@vger.kernel.org
  934. Description:
  935. If a high pass filter can be applied to the event generation
  936. this property gives its 3db frequency in Hz.
  937. A value of zero disables the filter.
  938. What: /sys/.../events/in_activity_still_thresh_rising_en
  939. What: /sys/.../events/in_activity_still_thresh_falling_en
  940. What: /sys/.../events/in_activity_walking_thresh_rising_en
  941. What: /sys/.../events/in_activity_walking_thresh_falling_en
  942. What: /sys/.../events/in_activity_jogging_thresh_rising_en
  943. What: /sys/.../events/in_activity_jogging_thresh_falling_en
  944. What: /sys/.../events/in_activity_running_thresh_rising_en
  945. What: /sys/.../events/in_activity_running_thresh_falling_en
  946. KernelVersion: 3.19
  947. Contact: linux-iio@vger.kernel.org
  948. Description:
  949. Enables or disables activitity events. Depending on direction
  950. an event is generated when sensor ENTERS or LEAVES a given state.
  951. What: /sys/.../events/in_activity_still_thresh_rising_value
  952. What: /sys/.../events/in_activity_still_thresh_falling_value
  953. What: /sys/.../events/in_activity_walking_thresh_rising_value
  954. What: /sys/.../events/in_activity_walking_thresh_falling_value
  955. What: /sys/.../events/in_activity_jogging_thresh_rising_value
  956. What: /sys/.../events/in_activity_jogging_thresh_falling_value
  957. What: /sys/.../events/in_activity_running_thresh_rising_value
  958. What: /sys/.../events/in_activity_running_thresh_falling_value
  959. KernelVersion: 3.19
  960. Contact: linux-iio@vger.kernel.org
  961. Description:
  962. Confidence value (in units as percentage) to be used
  963. for deciding when an event should be generated. E.g for
  964. running: If the confidence value reported by the sensor
  965. is greater than in_activity_running_thresh_rising_value
  966. then the sensor ENTERS running state. Conversely, if the
  967. confidence value reported by the sensor is lower than
  968. in_activity_running_thresh_falling_value then the sensor
  969. is LEAVING running state.
  970. What: /sys/.../iio:deviceX/events/in_accel_mag_en
  971. What: /sys/.../iio:deviceX/events/in_accel_mag_rising_en
  972. What: /sys/.../iio:deviceX/events/in_accel_mag_falling_en
  973. What: /sys/.../iio:deviceX/events/in_accel_x_mag_en
  974. What: /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
  975. What: /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
  976. What: /sys/.../iio:deviceX/events/in_accel_y_mag_en
  977. What: /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
  978. What: /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
  979. What: /sys/.../iio:deviceX/events/in_accel_z_mag_en
  980. What: /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
  981. What: /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
  982. What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
  983. What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
  984. KernelVersion: 2.6.37
  985. Contact: linux-iio@vger.kernel.org
  986. Description:
  987. Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
  988. magnitude of the channel is compared to the threshold, not its
  989. signed value.
  990. What: /sys/.../events/in_accel_raw_mag_value
  991. What: /sys/.../events/in_accel_x_raw_mag_rising_value
  992. What: /sys/.../events/in_accel_y_raw_mag_rising_value
  993. What: /sys/.../events/in_accel_z_raw_mag_rising_value
  994. KernelVersion: 2.6.37
  995. Contact: linux-iio@vger.kernel.org
  996. Description:
  997. The value to which the magnitude of the channel is compared. If
  998. number or direction is not specified, applies to all channels of
  999. this type.
  1000. What: /sys/.../events/in_steps_change_en
  1001. KernelVersion: 4.0
  1002. Contact: linux-iio@vger.kernel.org
  1003. Description:
  1004. Event generated when channel passes a threshold on the absolute
  1005. change in value. E.g. for steps: a step change event is
  1006. generated each time the user takes N steps, where N is set using
  1007. in_steps_change_value.
  1008. What: /sys/.../events/in_steps_change_value
  1009. KernelVersion: 4.0
  1010. Contact: linux-iio@vger.kernel.org
  1011. Description:
  1012. Specifies the value of change threshold that the
  1013. device is comparing against for the events enabled by
  1014. <type>[Y][_name]_roc[_rising|falling|]_en. E.g. for steps:
  1015. if set to 3, a step change event will be generated every 3
  1016. steps.
  1017. What: /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
  1018. KernelVersion: 2.6.35
  1019. Contact: linux-iio@vger.kernel.org
  1020. Description:
  1021. The name of the trigger source being used, as per string given
  1022. in /sys/class/iio/triggerY/name.
  1023. What: /sys/bus/iio/devices/iio:deviceX/buffer/length
  1024. KernelVersion: 2.6.35
  1025. Contact: linux-iio@vger.kernel.org
  1026. Description:
  1027. Number of scans contained by the buffer.
  1028. What: /sys/bus/iio/devices/iio:deviceX/buffer/enable
  1029. KernelVersion: 2.6.35
  1030. Contact: linux-iio@vger.kernel.org
  1031. Description:
  1032. Actually start the buffer capture up. Will start trigger
  1033. if first device and appropriate.
  1034. What: /sys/bus/iio/devices/iio:deviceX/scan_elements
  1035. KernelVersion: 2.6.37
  1036. Contact: linux-iio@vger.kernel.org
  1037. Description:
  1038. Directory containing interfaces for elements that will be
  1039. captured for a single triggered sample set in the buffer.
  1040. What: /sys/.../iio:deviceX/scan_elements/in_accel_x_en
  1041. What: /sys/.../iio:deviceX/scan_elements/in_accel_y_en
  1042. What: /sys/.../iio:deviceX/scan_elements/in_accel_z_en
  1043. What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_en
  1044. What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_en
  1045. What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_en
  1046. What: /sys/.../iio:deviceX/scan_elements/in_magn_x_en
  1047. What: /sys/.../iio:deviceX/scan_elements/in_magn_y_en
  1048. What: /sys/.../iio:deviceX/scan_elements/in_magn_z_en
  1049. What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_en
  1050. What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_en
  1051. What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_en
  1052. What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_en
  1053. What: /sys/.../iio:deviceX/scan_elements/in_timestamp_en
  1054. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_en
  1055. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_en
  1056. What: /sys/.../iio:deviceX/scan_elements/in_voltageY-voltageZ_en
  1057. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_en
  1058. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_en
  1059. What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_en
  1060. What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_en
  1061. What: /sys/.../iio:deviceX/scan_elements/in_incli_x_en
  1062. What: /sys/.../iio:deviceX/scan_elements/in_incli_y_en
  1063. What: /sys/.../iio:deviceX/scan_elements/in_pressureY_en
  1064. What: /sys/.../iio:deviceX/scan_elements/in_pressure_en
  1065. What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_en
  1066. What: /sys/.../iio:deviceX/scan_elements/in_proximity_en
  1067. KernelVersion: 2.6.37
  1068. Contact: linux-iio@vger.kernel.org
  1069. Description:
  1070. Scan element control for triggered data capture.
  1071. What: /sys/.../iio:deviceX/scan_elements/in_accel_type
  1072. What: /sys/.../iio:deviceX/scan_elements/in_anglvel_type
  1073. What: /sys/.../iio:deviceX/scan_elements/in_magn_type
  1074. What: /sys/.../iio:deviceX/scan_elements/in_incli_type
  1075. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_type
  1076. What: /sys/.../iio:deviceX/scan_elements/in_voltage_type
  1077. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_type
  1078. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_type
  1079. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_type
  1080. What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_type
  1081. What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_type
  1082. What: /sys/.../iio:deviceX/scan_elements/in_timestamp_type
  1083. What: /sys/.../iio:deviceX/scan_elements/in_pressureY_type
  1084. What: /sys/.../iio:deviceX/scan_elements/in_pressure_type
  1085. What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_type
  1086. What: /sys/.../iio:deviceX/scan_elements/in_proximity_type
  1087. KernelVersion: 2.6.37
  1088. Contact: linux-iio@vger.kernel.org
  1089. Description:
  1090. Description of the scan element data storage within the buffer
  1091. and hence the form in which it is read from user-space.
  1092. Form is [be|le]:[s|u]bits/storagebits[>>shift].
  1093. be or le specifies big or little endian. s or u specifies if
  1094. signed (2's complement) or unsigned. bits is the number of bits
  1095. of data and storagebits is the space (after padding) that it
  1096. occupies in the buffer. shift if specified, is the shift that
  1097. needs to be applied prior to masking out unused bits. Some
  1098. devices put their data in the middle of the transferred elements
  1099. with additional information on both sides. Note that some
  1100. devices will have additional information in the unused bits
  1101. so to get a clean value, the bits value must be used to mask
  1102. the buffer output value appropriately. The storagebits value
  1103. also specifies the data alignment. So s48/64>>2 will be a
  1104. signed 48 bit integer stored in a 64 bit location aligned to
  1105. a 64 bit boundary. To obtain the clean value, shift right 2
  1106. and apply a mask to zero the top 16 bits of the result.
  1107. For other storage combinations this attribute will be extended
  1108. appropriately.
  1109. What: /sys/.../iio:deviceX/scan_elements/in_accel_type_available
  1110. KernelVersion: 2.6.37
  1111. Contact: linux-iio@vger.kernel.org
  1112. Description:
  1113. If the type parameter can take one of a small set of values,
  1114. this attribute lists them.
  1115. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_index
  1116. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_index
  1117. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_i_index
  1118. What: /sys/.../iio:deviceX/scan_elements/in_voltageY_q_index
  1119. What: /sys/.../iio:deviceX/scan_elements/in_voltage_i_index
  1120. What: /sys/.../iio:deviceX/scan_elements/in_voltage_q_index
  1121. What: /sys/.../iio:deviceX/scan_elements/in_accel_x_index
  1122. What: /sys/.../iio:deviceX/scan_elements/in_accel_y_index
  1123. What: /sys/.../iio:deviceX/scan_elements/in_accel_z_index
  1124. What: /sys/.../iio:deviceX/scan_elements/in_anglvel_x_index
  1125. What: /sys/.../iio:deviceX/scan_elements/in_anglvel_y_index
  1126. What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_index
  1127. What: /sys/.../iio:deviceX/scan_elements/in_magn_x_index
  1128. What: /sys/.../iio:deviceX/scan_elements/in_magn_y_index
  1129. What: /sys/.../iio:deviceX/scan_elements/in_magn_z_index
  1130. What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_index
  1131. What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_index
  1132. What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_magnetic_tilt_comp_index
  1133. What: /sys/.../iio:deviceX/scan_elements/in_rot_from_north_true_tilt_comp_index
  1134. What: /sys/.../iio:deviceX/scan_elements/in_incli_x_index
  1135. What: /sys/.../iio:deviceX/scan_elements/in_incli_y_index
  1136. What: /sys/.../iio:deviceX/scan_elements/in_timestamp_index
  1137. What: /sys/.../iio:deviceX/scan_elements/in_pressureY_index
  1138. What: /sys/.../iio:deviceX/scan_elements/in_pressure_index
  1139. What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_index
  1140. What: /sys/.../iio:deviceX/scan_elements/in_proximity_index
  1141. KernelVersion: 2.6.37
  1142. Contact: linux-iio@vger.kernel.org
  1143. Description:
  1144. A single positive integer specifying the position of this
  1145. scan element in the buffer. Note these are not dependent on
  1146. what is enabled and may not be contiguous. Thus for user-space
  1147. to establish the full layout these must be used in conjunction
  1148. with all _en attributes to establish which channels are present,
  1149. and the relevant _type attributes to establish the data storage
  1150. format.
  1151. What: /sys/.../iio:deviceX/in_activity_still_input
  1152. What: /sys/.../iio:deviceX/in_activity_walking_input
  1153. What: /sys/.../iio:deviceX/in_activity_jogging_input
  1154. What: /sys/.../iio:deviceX/in_activity_running_input
  1155. KernelVersion: 3.19
  1156. Contact: linux-iio@vger.kernel.org
  1157. Description:
  1158. This attribute is used to read the confidence for an activity
  1159. expressed in units as percentage.
  1160. What: /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
  1161. KernelVersion: 2.6.38
  1162. Contact: linux-iio@vger.kernel.org
  1163. Description:
  1164. This attribute is used to read the amount of quadrature error
  1165. present in the device at a given time.
  1166. What: /sys/.../iio:deviceX/in_accelX_power_mode
  1167. KernelVersion: 3.11
  1168. Contact: linux-iio@vger.kernel.org
  1169. Description:
  1170. Specifies the chip power mode.
  1171. low_noise: reduce noise level from ADC,
  1172. low_power: enable low current consumption.
  1173. For a list of available output power modes read
  1174. in_accel_power_mode_available.
  1175. What: /sys/.../iio:deviceX/in_energy_input
  1176. What: /sys/.../iio:deviceX/in_energy_raw
  1177. KernelVersion: 4.0
  1178. Contact: linux-iio@vger.kernel.org
  1179. Description:
  1180. This attribute is used to read the energy value reported by the
  1181. device (e.g.: human activity sensors report energy burnt by the
  1182. user). Units after application of scale are Joules.
  1183. What: /sys/.../iio:deviceX/in_distance_input
  1184. What: /sys/.../iio:deviceX/in_distance_raw
  1185. KernelVersion: 4.0
  1186. Contact: linux-iio@vger.kernel.org
  1187. Description:
  1188. This attribute is used to read the measured distance to an object
  1189. or the distance covered by the user since the last reboot while
  1190. activated. Units after application of scale are meters.
  1191. What: /sys/bus/iio/devices/iio:deviceX/store_eeprom
  1192. KernelVersion: 3.4.0
  1193. Contact: linux-iio@vger.kernel.org
  1194. Description:
  1195. Writing '1' stores the current device configuration into
  1196. on-chip EEPROM. After power-up or chip reset the device will
  1197. automatically load the saved configuration.
  1198. What: /sys/.../iio:deviceX/in_proximity_raw
  1199. What: /sys/.../iio:deviceX/in_proximity_input
  1200. What: /sys/.../iio:deviceX/in_proximityY_raw
  1201. KernelVersion: 3.4
  1202. Contact: linux-iio@vger.kernel.org
  1203. Description:
  1204. Proximity measurement indicating that some
  1205. object is near the sensor, usually by observing
  1206. reflectivity of infrared or ultrasound emitted.
  1207. Often these sensors are unit less and as such conversion
  1208. to SI units is not possible. Higher proximity measurements
  1209. indicate closer objects, and vice versa. Units after
  1210. application of scale and offset are meters.
  1211. What: /sys/.../iio:deviceX/in_illuminance_input
  1212. What: /sys/.../iio:deviceX/in_illuminance_raw
  1213. What: /sys/.../iio:deviceX/in_illuminanceY_input
  1214. What: /sys/.../iio:deviceX/in_illuminanceY_raw
  1215. What: /sys/.../iio:deviceX/in_illuminanceY_mean_raw
  1216. What: /sys/.../iio:deviceX/in_illuminance_ir_raw
  1217. What: /sys/.../iio:deviceX/in_illuminance_clear_raw
  1218. KernelVersion: 3.4
  1219. Contact: linux-iio@vger.kernel.org
  1220. Description:
  1221. Illuminance measurement, units after application of scale
  1222. and offset are lux.
  1223. What: /sys/.../iio:deviceX/in_intensityY_raw
  1224. What: /sys/.../iio:deviceX/in_intensityY_ir_raw
  1225. What: /sys/.../iio:deviceX/in_intensityY_both_raw
  1226. What: /sys/.../iio:deviceX/in_intensityY_uv_raw
  1227. What: /sys/.../iio:deviceX/in_intensityY_duv_raw
  1228. KernelVersion: 3.4
  1229. Contact: linux-iio@vger.kernel.org
  1230. Description:
  1231. Unit-less light intensity. Modifiers both and ir indicate
  1232. that measurements contain visible and infrared light
  1233. components or just infrared light, respectively. Modifier
  1234. uv indicates that measurements contain ultraviolet light
  1235. components. Modifier duv indicates that measurements
  1236. contain deep ultraviolet light components.
  1237. What: /sys/.../iio:deviceX/in_uvindex_input
  1238. KernelVersion: 4.6
  1239. Contact: linux-iio@vger.kernel.org
  1240. Description:
  1241. UV light intensity index measuring the human skin's response to
  1242. different wavelength of sunlight weighted according to the
  1243. standardised CIE Erythemal Action Spectrum. UV index values range
  1244. from 0 (low) to >=11 (extreme).
  1245. What: /sys/.../iio:deviceX/in_intensity_red_integration_time
  1246. What: /sys/.../iio:deviceX/in_intensity_green_integration_time
  1247. What: /sys/.../iio:deviceX/in_intensity_blue_integration_time
  1248. What: /sys/.../iio:deviceX/in_intensity_clear_integration_time
  1249. What: /sys/.../iio:deviceX/in_illuminance_integration_time
  1250. KernelVersion: 3.12
  1251. Contact: linux-iio@vger.kernel.org
  1252. Description:
  1253. This attribute is used to get/set the integration time in
  1254. seconds.
  1255. What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_integration_time
  1256. KernelVersion: 4.0
  1257. Contact: linux-iio@vger.kernel.org
  1258. Description:
  1259. Number of seconds in which to compute speed.
  1260. What: /sys/bus/iio/devices/iio:deviceX/in_rot_quaternion_raw
  1261. KernelVersion: 3.15
  1262. Contact: linux-iio@vger.kernel.org
  1263. Description:
  1264. Raw value of quaternion components using a format
  1265. x y z w. Here x, y, and z component represents the axis about
  1266. which a rotation will occur and w component represents the
  1267. amount of rotation.
  1268. What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_raw
  1269. What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_raw
  1270. What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_raw
  1271. What: /sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_raw
  1272. KernelVersion: 3.15
  1273. Contact: linux-iio@vger.kernel.org
  1274. Description:
  1275. Raw value of rotation from true/magnetic north measured with
  1276. or without compensation from tilt sensors.
  1277. What: /sys/bus/iio/devices/iio:deviceX/in_currentX_raw
  1278. What: /sys/bus/iio/devices/iio:deviceX/in_currentX_i_raw
  1279. What: /sys/bus/iio/devices/iio:deviceX/in_currentX_q_raw
  1280. KernelVersion: 3.18
  1281. Contact: linux-iio@vger.kernel.org
  1282. Description:
  1283. Raw current measurement from channel X. Units are in milliamps
  1284. after application of scale and offset. If no offset or scale is
  1285. present, output should be considered as processed with the
  1286. unit in milliamps.
  1287. Channels with 'i' and 'q' modifiers always exist in pairs and both
  1288. channels refer to the same signal. The 'i' channel contains the in-phase
  1289. component of the signal while the 'q' channel contains the quadrature
  1290. component.
  1291. What: /sys/.../iio:deviceX/in_energy_en
  1292. What: /sys/.../iio:deviceX/in_distance_en
  1293. What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_en
  1294. What: /sys/.../iio:deviceX/in_steps_en
  1295. KernelVersion: 3.19
  1296. Contact: linux-iio@vger.kernel.org
  1297. Description:
  1298. Activates a device feature that runs in firmware/hardware.
  1299. E.g. for steps: the pedometer saves power while not used;
  1300. when activated, it will count the steps taken by the user in
  1301. firmware and export them through in_steps_input.
  1302. What: /sys/.../iio:deviceX/in_steps_input
  1303. KernelVersion: 3.19
  1304. Contact: linux-iio@vger.kernel.org
  1305. Description:
  1306. This attribute is used to read the number of steps taken by the user
  1307. since the last reboot while activated.
  1308. What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_input
  1309. What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_raw
  1310. KernelVersion: 3.19
  1311. Contact: linux-iio@vger.kernel.org
  1312. Description:
  1313. This attribute is used to read the current speed value of the
  1314. user (which is the norm or magnitude of the velocity vector).
  1315. Units after application of scale are m/s.
  1316. What: /sys/.../iio:deviceX/in_steps_debounce_count
  1317. KernelVersion: 4.0
  1318. Contact: linux-iio@vger.kernel.org
  1319. Description:
  1320. Specifies the number of steps that must occur within
  1321. in_steps_filter_debounce_time for the pedometer to decide the
  1322. consumer is making steps.
  1323. What: /sys/.../iio:deviceX/in_steps_debounce_time
  1324. KernelVersion: 4.0
  1325. Contact: linux-iio@vger.kernel.org
  1326. Description:
  1327. Specifies number of seconds in which we compute the steps
  1328. that occur in order to decide if the consumer is making steps.
  1329. What: /sys/bus/iio/devices/iio:deviceX/buffer/watermark
  1330. KernelVersion: 4.2
  1331. Contact: linux-iio@vger.kernel.org
  1332. Description:
  1333. A single positive integer specifying the maximum number of scan
  1334. elements to wait for.
  1335. Poll will block until the watermark is reached.
  1336. Blocking read will wait until the minimum between the requested
  1337. read amount or the low water mark is available.
  1338. Non-blocking read will retrieve the available samples from the
  1339. buffer even if there are less samples then watermark level. This
  1340. allows the application to block on poll with a timeout and read
  1341. the available samples after the timeout expires and thus have a
  1342. maximum delay guarantee.
  1343. What: /sys/bus/iio/devices/iio:deviceX/buffer/data_available
  1344. KernelVersion: 4.16
  1345. Contact: linux-iio@vger.kernel.org
  1346. Description:
  1347. A read-only value indicating the bytes of data available in the
  1348. buffer. In the case of an output buffer, this indicates the
  1349. amount of empty space available to write data to. In the case of
  1350. an input buffer, this indicates the amount of data available for
  1351. reading.
  1352. What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_enabled
  1353. KernelVersion: 4.2
  1354. Contact: linux-iio@vger.kernel.org
  1355. Description:
  1356. A read-only boolean value that indicates if the hardware fifo is
  1357. currently enabled or disabled. If the device does not have a
  1358. hardware fifo this entry is not present.
  1359. The hardware fifo is enabled when the buffer is enabled if the
  1360. current hardware fifo watermark level is set and other current
  1361. device settings allows it (e.g. if a trigger is set that samples
  1362. data differently that the hardware fifo does then hardware fifo
  1363. will not enabled).
  1364. If the hardware fifo is enabled and the level of the hardware
  1365. fifo reaches the hardware fifo watermark level the device will
  1366. flush its hardware fifo to the device buffer. Doing a non
  1367. blocking read on the device when no samples are present in the
  1368. device buffer will also force a flush.
  1369. When the hardware fifo is enabled there is no need to use a
  1370. trigger to use buffer mode since the watermark settings
  1371. guarantees that the hardware fifo is flushed to the device
  1372. buffer.
  1373. What: /sys/bus/iio/devices/iio:device*/buffer/hwfifo_timeout
  1374. KernelVersion: 4.12
  1375. Contact: linux-iio@vger.kernel.org
  1376. Description:
  1377. A read/write property to provide capability to delay reporting of
  1378. samples till a timeout is reached. This allows host processors to
  1379. sleep, while the sensor is storing samples in its internal fifo.
  1380. The maximum timeout in seconds can be specified by setting
  1381. hwfifo_timeout.The current delay can be read by reading
  1382. hwfifo_timeout. A value of 0 means that there is no timeout.
  1383. What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark
  1384. KernelVersion: 4.2
  1385. Contact: linux-iio@vger.kernel.org
  1386. Description:
  1387. Read-only entry that contains a single integer specifying the
  1388. current watermark level for the hardware fifo. If the device
  1389. does not have a hardware fifo this entry is not present.
  1390. The watermark level for the hardware fifo is set by the driver
  1391. based on the value set by the user in buffer/watermark but
  1392. taking into account hardware limitations (e.g. most hardware
  1393. buffers are limited to 32-64 samples, some hardware buffers
  1394. watermarks are fixed or have minimum levels). A value of 0
  1395. means that the hardware watermark is unset.
  1396. What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_min
  1397. KernelVersion: 4.2
  1398. Contact: linux-iio@vger.kernel.org
  1399. Description:
  1400. A single positive integer specifying the minimum watermark level
  1401. for the hardware fifo of this device. If the device does not
  1402. have a hardware fifo this entry is not present.
  1403. If the user sets buffer/watermark to a value less than this one,
  1404. then the hardware watermark will remain unset.
  1405. What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_max
  1406. KernelVersion: 4.2
  1407. Contact: linux-iio@vger.kernel.org
  1408. Description:
  1409. A single positive integer specifying the maximum watermark level
  1410. for the hardware fifo of this device. If the device does not
  1411. have a hardware fifo this entry is not present.
  1412. If the user sets buffer/watermark to a value greater than this
  1413. one, then the hardware watermark will be capped at this value.
  1414. What: /sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_available
  1415. KernelVersion: 4.2
  1416. Contact: linux-iio@vger.kernel.org
  1417. Description:
  1418. A list of positive integers specifying the available watermark
  1419. levels for the hardware fifo. This entry is optional and if it
  1420. is not present it means that all the values between
  1421. hwfifo_watermark_min and hwfifo_watermark_max are supported.
  1422. If the user sets buffer/watermark to a value greater than
  1423. hwfifo_watermak_min but not equal to any of the values in this
  1424. list, the driver will chose an appropriate value for the
  1425. hardware fifo watermark level.
  1426. What: /sys/bus/iio/devices/iio:deviceX/in_temp_calibemissivity
  1427. What: /sys/bus/iio/devices/iio:deviceX/in_tempX_calibemissivity
  1428. What: /sys/bus/iio/devices/iio:deviceX/in_temp_object_calibemissivity
  1429. What: /sys/bus/iio/devices/iio:deviceX/in_tempX_object_calibemissivity
  1430. KernelVersion: 4.1
  1431. Contact: linux-iio@vger.kernel.org
  1432. Description:
  1433. The emissivity ratio of the surface in the field of view of the
  1434. contactless temperature sensor. Emissivity varies from 0 to 1,
  1435. with 1 being the emissivity of a black body.
  1436. What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_oversampling_ratio
  1437. What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_oversampling_ratio
  1438. What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_oversampling_ratio
  1439. KernelVersion: 4.2
  1440. Contact: linux-iio@vger.kernel.org
  1441. Description:
  1442. Hardware applied number of measurements for acquiring one
  1443. data point. The HW will do <type>[_name]_oversampling_ratio
  1444. measurements and return the average value as output data. Each
  1445. value resulted from <type>[_name]_oversampling_ratio measurements
  1446. is considered as one sample for <type>[_name]_sampling_frequency.
  1447. What: /sys/bus/iio/devices/iio:deviceX/in_concentration_raw
  1448. What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_raw
  1449. What: /sys/bus/iio/devices/iio:deviceX/in_concentration_co2_raw
  1450. What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_co2_raw
  1451. What: /sys/bus/iio/devices/iio:deviceX/in_concentration_voc_raw
  1452. What: /sys/bus/iio/devices/iio:deviceX/in_concentrationX_voc_raw
  1453. KernelVersion: 4.3
  1454. Contact: linux-iio@vger.kernel.org
  1455. Description:
  1456. Raw (unscaled no offset etc.) percentage reading of a substance.
  1457. What: /sys/bus/iio/devices/iio:deviceX/in_resistance_raw
  1458. What: /sys/bus/iio/devices/iio:deviceX/in_resistanceX_raw
  1459. What: /sys/bus/iio/devices/iio:deviceX/out_resistance_raw
  1460. What: /sys/bus/iio/devices/iio:deviceX/out_resistanceX_raw
  1461. KernelVersion: 4.3
  1462. Contact: linux-iio@vger.kernel.org
  1463. Description:
  1464. Raw (unscaled no offset etc.) resistance reading that can be processed
  1465. into an ohm value.
  1466. What: /sys/bus/iio/devices/iio:deviceX/heater_enable
  1467. KernelVersion: 4.1.0
  1468. Contact: linux-iio@vger.kernel.org
  1469. Description:
  1470. '1' (enable) or '0' (disable) specifying the enable
  1471. of heater function. Same reading values apply
  1472. This ABI is especially applicable for humidity sensors
  1473. to heatup the device and get rid of any condensation
  1474. in some humidity environment
  1475. What: /sys/bus/iio/devices/iio:deviceX/in_ph_raw
  1476. KernelVersion: 4.5
  1477. Contact: linux-iio@vger.kernel.org
  1478. Description:
  1479. Raw (unscaled no offset etc.) pH reading of a substance as a negative
  1480. base-10 logarithm of hydrodium ions in a litre of water.
  1481. What: /sys/bus/iio/devices/iio:deviceX/mount_matrix
  1482. What: /sys/bus/iio/devices/iio:deviceX/in_mount_matrix
  1483. What: /sys/bus/iio/devices/iio:deviceX/out_mount_matrix
  1484. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_mount_matrix
  1485. What: /sys/bus/iio/devices/iio:deviceX/in_accel_mount_matrix
  1486. KernelVersion: 4.6
  1487. Contact: linux-iio@vger.kernel.org
  1488. Description:
  1489. Mounting matrix for IIO sensors. This is a rotation matrix which
  1490. informs userspace about sensor chip's placement relative to the
  1491. main hardware it is mounted on.
  1492. Main hardware placement is defined according to the local
  1493. reference frame related to the physical quantity the sensor
  1494. measures.
  1495. Given that the rotation matrix is defined in a board specific
  1496. way (platform data and / or device-tree), the main hardware
  1497. reference frame definition is left to the implementor's choice
  1498. (see below for a magnetometer example).
  1499. Applications should apply this rotation matrix to samples so
  1500. that when main hardware reference frame is aligned onto local
  1501. reference frame, then sensor chip reference frame is also
  1502. perfectly aligned with it.
  1503. Matrix is a 3x3 unitary matrix and typically looks like
  1504. [0, 1, 0; 1, 0, 0; 0, 0, -1]. Identity matrix
  1505. [1, 0, 0; 0, 1, 0; 0, 0, 1] means sensor chip and main hardware
  1506. are perfectly aligned with each other.
  1507. For example, a mounting matrix for a magnetometer sensor informs
  1508. userspace about sensor chip's ORIENTATION relative to the main
  1509. hardware.
  1510. More specifically, main hardware orientation is defined with
  1511. respect to the LOCAL EARTH GEOMAGNETIC REFERENCE FRAME where :
  1512. * Y is in the ground plane and positive towards magnetic North ;
  1513. * X is in the ground plane, perpendicular to the North axis and
  1514. positive towards the East ;
  1515. * Z is perpendicular to the ground plane and positive upwards.
  1516. An implementor might consider that for a hand-held device, a
  1517. 'natural' orientation would be 'front facing camera at the top'.
  1518. The main hardware reference frame could then be described as :
  1519. * Y is in the plane of the screen and is positive towards the
  1520. top of the screen ;
  1521. * X is in the plane of the screen, perpendicular to Y axis, and
  1522. positive towards the right hand side of the screen ;
  1523. * Z is perpendicular to the screen plane and positive out of the
  1524. screen.
  1525. Another example for a quadrotor UAV might be :
  1526. * Y is in the plane of the propellers and positive towards the
  1527. front-view camera;
  1528. * X is in the plane of the propellers, perpendicular to Y axis,
  1529. and positive towards the starboard side of the UAV ;
  1530. * Z is perpendicular to propellers plane and positive upwards.
  1531. What: /sys/bus/iio/devices/iio:deviceX/in_electricalconductivity_raw
  1532. KernelVersion: 4.8
  1533. Contact: linux-iio@vger.kernel.org
  1534. Description:
  1535. Raw (unscaled no offset etc.) electric conductivity reading that
  1536. can be processed to siemens per meter.
  1537. What: /sys/bus/iio/devices/iio:deviceX/in_countY_raw
  1538. KernelVersion: 4.10
  1539. Contact: linux-iio@vger.kernel.org
  1540. Description:
  1541. Raw counter device counts from channel Y. For quadrature
  1542. counters, multiplication by an available [Y]_scale results in
  1543. the counts of a single quadrature signal phase from channel Y.
  1544. What: /sys/bus/iio/devices/iio:deviceX/in_indexY_raw
  1545. KernelVersion: 4.10
  1546. Contact: linux-iio@vger.kernel.org
  1547. Description:
  1548. Raw counter device index value from channel Y. This attribute
  1549. provides an absolute positional reference (e.g. a pulse once per
  1550. revolution) which may be used to home positional systems as
  1551. required.
  1552. What: /sys/bus/iio/devices/iio:deviceX/in_count_count_direction_available
  1553. KernelVersion: 4.12
  1554. Contact: linux-iio@vger.kernel.org
  1555. Description:
  1556. A list of possible counting directions which are:
  1557. - "up" : counter device is increasing.
  1558. - "down": counter device is decreasing.
  1559. What: /sys/bus/iio/devices/iio:deviceX/in_countY_count_direction
  1560. KernelVersion: 4.12
  1561. Contact: linux-iio@vger.kernel.org
  1562. Description:
  1563. Raw counter device counters direction for channel Y.
  1564. What: /sys/bus/iio/devices/iio:deviceX/in_phaseY_raw
  1565. KernelVersion: 4.18
  1566. Contact: linux-iio@vger.kernel.org
  1567. Description:
  1568. Raw (unscaled) phase difference reading from channel Y
  1569. that can be processed to radians.