sysfs-bus-iio 35 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768
  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/sampling_frequency
  32. What: /sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency
  33. What: /sys/bus/iio/devices/triggerX/sampling_frequency
  34. KernelVersion: 2.6.35
  35. Contact: linux-iio@vger.kernel.org
  36. Description:
  37. Some devices have internal clocks. This parameter sets the
  38. resulting sampling frequency. In many devices this
  39. parameter has an effect on input filters etc rather than
  40. simply controlling when the input is sampled. As this
  41. effects datardy triggers, hardware buffers and the sysfs
  42. direct access interfaces, it may be found in any of the
  43. relevant directories. If it effects all of the above
  44. then it is to be found in the base device directory.
  45. What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency_available
  46. What: /sys/.../iio:deviceX/buffer/sampling_frequency_available
  47. What: /sys/bus/iio/devices/triggerX/sampling_frequency_available
  48. KernelVersion: 2.6.35
  49. Contact: linux-iio@vger.kernel.org
  50. Description:
  51. When the internal sampling clock can only take a small
  52. discrete set of values, this file lists those available.
  53. What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio
  54. KernelVersion: 2.6.38
  55. Contact: linux-iio@vger.kernel.org
  56. Description:
  57. Hardware dependent ADC oversampling. Controls the sampling ratio
  58. of the digital filter if available.
  59. What: /sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available
  60. KernelVersion: 2.6.38
  61. Contact: linux-iio@vger.kernel.org
  62. Description:
  63. Hardware dependent values supported by the oversampling filter.
  64. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
  65. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
  66. KernelVersion: 2.6.35
  67. Contact: linux-iio@vger.kernel.org
  68. Description:
  69. Raw (unscaled no bias removal etc) voltage measurement from
  70. channel Y. In special cases where the channel does not
  71. correspond to externally available input one of the named
  72. versions may be used. The number must always be specified and
  73. unique to allow association with event codes. Units after
  74. application of scale and offset are microvolts.
  75. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw
  76. KernelVersion: 2.6.35
  77. Contact: linux-iio@vger.kernel.org
  78. Description:
  79. Raw (unscaled) differential voltage measurement equivalent to
  80. channel Y - channel Z where these channel numbers apply to the
  81. physically equivalent inputs when non differential readings are
  82. separately available. In differential only parts, then all that
  83. is required is a consistent labeling. Units after application
  84. of scale and offset are microvolts.
  85. What: /sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw
  86. KernelVersion: 3.2
  87. Contact: linux-iio@vger.kernel.org
  88. Description:
  89. Raw capacitance measurement from channel Y. Units after
  90. application of scale and offset are nanofarads.
  91. What: /sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw
  92. KernelVersion: 3.2
  93. Contact: linux-iio@vger.kernel.org
  94. Description:
  95. Raw differential capacitance measurement equivalent to
  96. channel Y - channel Z where these channel numbers apply to the
  97. physically equivalent inputs when non differential readings are
  98. separately available. In differential only parts, then all that
  99. is required is a consistent labeling. Units after application
  100. of scale and offset are nanofarads.
  101. What: /sys/bus/iio/devices/iio:deviceX/in_temp_raw
  102. What: /sys/bus/iio/devices/iio:deviceX/in_tempX_raw
  103. What: /sys/bus/iio/devices/iio:deviceX/in_temp_x_raw
  104. What: /sys/bus/iio/devices/iio:deviceX/in_temp_y_raw
  105. What: /sys/bus/iio/devices/iio:deviceX/in_temp_z_raw
  106. KernelVersion: 2.6.35
  107. Contact: linux-iio@vger.kernel.org
  108. Description:
  109. Raw (unscaled no bias removal etc) temperature measurement.
  110. If an axis is specified it generally means that the temperature
  111. sensor is associated with one part of a compound device (e.g.
  112. a gyroscope axis). Units after application of scale and offset
  113. are milli degrees Celsuis.
  114. What: /sys/bus/iio/devices/iio:deviceX/in_tempX_input
  115. KernelVersion: 2.6.38
  116. Contact: linux-iio@vger.kernel.org
  117. Description:
  118. Scaled temperature measurement in milli degrees Celsius.
  119. What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw
  120. What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_raw
  121. What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_raw
  122. KernelVersion: 2.6.35
  123. Contact: linux-iio@vger.kernel.org
  124. Description:
  125. Acceleration in direction x, y or z (may be arbitrarily assigned
  126. but should match other such assignments on device).
  127. Has all of the equivalent parameters as per voltageY. Units
  128. after application of scale and offset are m/s^2.
  129. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw
  130. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw
  131. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw
  132. KernelVersion: 2.6.35
  133. Contact: linux-iio@vger.kernel.org
  134. Description:
  135. Angular velocity about axis x, y or z (may be arbitrarily
  136. assigned) Data converted by application of offset then scale to
  137. radians per second. Has all the equivalent parameters as
  138. per voltageY. Units after application of scale and offset are
  139. radians per second.
  140. What: /sys/bus/iio/devices/iio:deviceX/in_incli_x_raw
  141. What: /sys/bus/iio/devices/iio:deviceX/in_incli_y_raw
  142. What: /sys/bus/iio/devices/iio:deviceX/in_incli_z_raw
  143. KernelVersion: 2.6.35
  144. Contact: linux-iio@vger.kernel.org
  145. Description:
  146. Inclination raw reading about axis x, y or z (may be
  147. arbitrarily assigned). Data converted by application of offset
  148. and scale to Degrees.
  149. What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
  150. What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
  151. What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
  152. KernelVersion: 2.6.35
  153. Contact: linux-iio@vger.kernel.org
  154. Description:
  155. Magnetic field along axis x, y or z (may be arbitrarily
  156. assigned). Data converted by application of offset
  157. then scale to Gauss.
  158. What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw
  159. What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw
  160. What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw
  161. KernelVersion: 2.6.36
  162. Contact: linux-iio@vger.kernel.org
  163. Description:
  164. Highest value since some reset condition. These
  165. attributes allow access to this and are otherwise
  166. the direct equivalent of the <type>Y[_name]_raw attributes.
  167. What: /sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw
  168. KernelVersion: 2.6.36
  169. Contact: linux-iio@vger.kernel.org
  170. Description:
  171. A computed peak value based on the sum squared magnitude of
  172. the underlying value in the specified directions.
  173. What: /sys/bus/iio/devices/iio:deviceX/in_accel_offset
  174. What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_offset
  175. What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_offset
  176. What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_offset
  177. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_offset
  178. What: /sys/bus/iio/devices/iio:deviceX/in_voltage_offset
  179. What: /sys/bus/iio/devices/iio:deviceX/in_tempY_offset
  180. What: /sys/bus/iio/devices/iio:deviceX/in_temp_offset
  181. KernelVersion: 2.6.35
  182. Contact: linux-iio@vger.kernel.org
  183. Description:
  184. If known for a device, offset to be added to <type>[Y]_raw prior
  185. to scaling by <type>[Y]_scale in order to obtain value in the
  186. <type> units as specified in <type>[y]_raw documentation.
  187. Not present if the offset is always 0 or unknown. If Y or
  188. axis <x|y|z> is not present, then the offset applies to all
  189. in channels of <type>.
  190. May be writable if a variable offset can be applied on the
  191. device. Note that this is different to calibbias which
  192. is for devices (or drivers) that apply offsets to compensate
  193. for variation between different instances of the part, typically
  194. adjusted by using some hardware supported calibration procedure.
  195. Calibbias is applied internally, offset is applied in userspace
  196. to the _raw output.
  197. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_scale
  198. What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale
  199. What: /sys/bus/iio/devices/iio:deviceX/in_voltage_scale
  200. What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_scale
  201. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale
  202. What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale
  203. What: /sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale
  204. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale
  205. What: /sys/bus/iio/devices/iio:deviceX/in_magn_scale
  206. What: /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
  207. What: /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
  208. What: /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
  209. KernelVersion: 2.6.35
  210. Contact: linux-iio@vger.kernel.org
  211. Description:
  212. If known for a device, scale to be applied to <type>Y[_name]_raw
  213. post addition of <type>[Y][_name]_offset in order to obtain the
  214. measured value in <type> units as specified in
  215. <type>[Y][_name]_raw documentation. If shared across all in
  216. channels then Y and <x|y|z> are not present and the value is
  217. called <type>[Y][_name]_scale. The peak modifier means this
  218. value is applied to <type>Y[_name]_peak_raw values.
  219. What: /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias
  220. What: /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias
  221. What: /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias
  222. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias
  223. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias
  224. What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias
  225. What: /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias
  226. What: /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias
  227. KernelVersion: 2.6.35
  228. Contact: linux-iio@vger.kernel.org
  229. Description:
  230. Hardware applied calibration offset. (assumed to fix production
  231. inaccuracies).
  232. What /sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale
  233. What /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale
  234. What /sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale
  235. What /sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale
  236. What /sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale
  237. What /sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale
  238. What /sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale
  239. What /sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale
  240. What /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale
  241. what /sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale
  242. what /sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale
  243. KernelVersion: 2.6.35
  244. Contact: linux-iio@vger.kernel.org
  245. Description:
  246. Hardware applied calibration scale factor. (assumed to fix
  247. production inaccuracies). If shared across all channels,
  248. <type>_calibscale is used.
  249. What: /sys/bus/iio/devices/iio:deviceX/in_accel_scale_available
  250. What: /sys/.../iio:deviceX/in_voltageX_scale_available
  251. What: /sys/.../iio:deviceX/in_voltage-voltage_scale_available
  252. What: /sys/.../iio:deviceX/out_voltageX_scale_available
  253. What: /sys/.../iio:deviceX/out_altvoltageX_scale_available
  254. What: /sys/.../iio:deviceX/in_capacitance_scale_available
  255. KernelVersion: 2.635
  256. Contact: linux-iio@vger.kernel.org
  257. Description:
  258. If a discrete set of scale values are available, they
  259. are listed in this attribute.
  260. What /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
  261. KernelVersion: 2.6.35
  262. Contact: linux-iio@vger.kernel.org
  263. Description:
  264. Hardware applied gain factor. If shared across all channels,
  265. <type>_hardwaregain is used.
  266. What: /sys/.../in_accel_filter_low_pass_3db_frequency
  267. What: /sys/.../in_magn_filter_low_pass_3db_frequency
  268. What: /sys/.../in_anglvel_filter_low_pass_3db_frequency
  269. KernelVersion: 3.2
  270. Contact: linux-iio@vger.kernel.org
  271. Description:
  272. If a known or controllable low pass filter is applied
  273. to the underlying data channel, then this parameter
  274. gives the 3dB frequency of the filter in Hz.
  275. What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_raw
  276. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw
  277. KernelVersion: 2.6.37
  278. Contact: linux-iio@vger.kernel.org
  279. Description:
  280. Raw (unscaled, no bias etc.) output voltage for
  281. channel Y. The number must always be specified and
  282. unique if the output corresponds to a single channel.
  283. While DAC like devices typically use out_voltage,
  284. a continuous frequency generating device, such as
  285. a DDS or PLL should use out_altvoltage.
  286. What: /sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw
  287. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw
  288. KernelVersion: 2.6.37
  289. Contact: linux-iio@vger.kernel.org
  290. Description:
  291. Raw (unscaled, no bias etc.) output voltage for an aggregate of
  292. channel Y, channel Z, etc. This interface is available in cases
  293. where a single output sets the value for multiple channels
  294. simultaneously.
  295. What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode
  296. What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode
  297. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode
  298. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode
  299. KernelVersion: 2.6.38
  300. Contact: linux-iio@vger.kernel.org
  301. Description:
  302. Specifies the output powerdown mode.
  303. DAC output stage is disconnected from the amplifier and
  304. 1kohm_to_gnd: connected to ground via an 1kOhm resistor
  305. 100kohm_to_gnd: connected to ground via an 100kOhm resistor
  306. three_state: left floating
  307. For a list of available output power down options read
  308. outX_powerdown_mode_available. If Y is not present the
  309. mode is shared across all outputs.
  310. What: /sys/.../iio:deviceX/out_votlageY_powerdown_mode_available
  311. What: /sys/.../iio:deviceX/out_voltage_powerdown_mode_available
  312. What: /sys/.../iio:deviceX/out_altvotlageY_powerdown_mode_available
  313. What: /sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available
  314. KernelVersion: 2.6.38
  315. Contact: linux-iio@vger.kernel.org
  316. Description:
  317. Lists all available output power down modes.
  318. If Y is not present the mode is shared across all outputs.
  319. What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown
  320. What: /sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown
  321. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
  322. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown
  323. KernelVersion: 2.6.38
  324. Contact: linux-iio@vger.kernel.org
  325. Description:
  326. Writing 1 causes output Y to enter the power down mode specified
  327. by the corresponding outY_powerdown_mode. Clearing returns to
  328. normal operation. Y may be suppressed if all outputs are
  329. controlled together.
  330. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency
  331. KernelVersion: 3.4.0
  332. Contact: linux-iio@vger.kernel.org
  333. Description:
  334. Output frequency for channel Y in Hz. The number must always be
  335. specified and unique if the output corresponds to a single
  336. channel.
  337. What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase
  338. KernelVersion: 3.4.0
  339. Contact: linux-iio@vger.kernel.org
  340. Description:
  341. Phase in radians of one frequency/clock output Y
  342. (out_altvoltageY) relative to another frequency/clock output
  343. (out_altvoltageZ) of the device X. The number must always be
  344. specified and unique if the output corresponds to a single
  345. channel.
  346. What: /sys/bus/iio/devices/iio:deviceX/events
  347. KernelVersion: 2.6.35
  348. Contact: linux-iio@vger.kernel.org
  349. Description:
  350. Configuration of which hardware generated events are passed up
  351. to user-space.
  352. What: /sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en
  353. What: /sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en
  354. What: /sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en
  355. What: /sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en
  356. What: /sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en
  357. What: /sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en
  358. What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en
  359. What: /sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en
  360. What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en
  361. What: /sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en
  362. What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en
  363. What: /sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en
  364. What: /sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en
  365. What: /sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en
  366. What: /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
  367. What: /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
  368. What: /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
  369. What: /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
  370. What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
  371. What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
  372. What: /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
  373. What: /sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
  374. What: /sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
  375. What: /sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
  376. KernelVersion: 2.6.37
  377. Contact: linux-iio@vger.kernel.org
  378. Description:
  379. Event generated when channel passes a threshold in the specified
  380. (_rising|_falling) direction. If the direction is not specified,
  381. then either the device will report an event which ever direction
  382. a single threshold value is passed in (e.g.
  383. <type>[Y][_name]_<raw|input>_thresh_value) or
  384. <type>[Y][_name]_<raw|input>_thresh_rising_value and
  385. <type>[Y][_name]_<raw|input>_thresh_falling_value may take
  386. different values, but the device can only enable both thresholds
  387. or neither.
  388. Note the driver will assume the last p events requested are
  389. to be enabled where p is however many it supports (which may
  390. vary depending on the exact set requested. So if you want to be
  391. sure you have set what you think you have, check the contents of
  392. these attributes after everything is configured. Drivers may
  393. have to buffer any parameters so that they are consistent when
  394. a given event type is enabled a future point (and not those for
  395. whatever event was previously enabled).
  396. What: /sys/.../iio:deviceX/events/in_accel_x_roc_rising_en
  397. What: /sys/.../iio:deviceX/events/in_accel_x_roc_falling_en
  398. What: /sys/.../iio:deviceX/events/in_accel_y_roc_rising_en
  399. What: /sys/.../iio:deviceX/events/in_accel_y_roc_falling_en
  400. What: /sys/.../iio:deviceX/events/in_accel_z_roc_rising_en
  401. What: /sys/.../iio:deviceX/events/in_accel_z_roc_falling_en
  402. What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en
  403. What: /sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en
  404. What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en
  405. What: /sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en
  406. What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en
  407. What: /sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en
  408. What: /sys/.../iio:deviceX/events/in_magn_x_roc_rising_en
  409. What: /sys/.../iio:deviceX/events/in_magn_x_roc_falling_en
  410. What: /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
  411. What: /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
  412. What: /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
  413. What: /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
  414. What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
  415. What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
  416. What: /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
  417. What: /sys/.../iio:deviceX/events/in_voltageY_roc_falling_en
  418. What: /sys/.../iio:deviceX/events/in_tempY_roc_rising_en
  419. What: /sys/.../iio:deviceX/events/in_tempY_roc_falling_en
  420. KernelVersion: 2.6.37
  421. Contact: linux-iio@vger.kernel.org
  422. Description:
  423. Event generated when channel passes a threshold on the rate of
  424. change (1st differential) in the specified (_rising|_falling)
  425. direction. If the direction is not specified, then either the
  426. device will report an event which ever direction a single
  427. threshold value is passed in (e.g.
  428. <type>[Y][_name]_<raw|input>_roc_value) or
  429. <type>[Y][_name]_<raw|input>_roc_rising_value and
  430. <type>[Y][_name]_<raw|input>_roc_falling_value may take
  431. different values, but the device can only enable both rate of
  432. change thresholds or neither.
  433. Note the driver will assume the last p events requested are
  434. to be enabled where p is however many it supports (which may
  435. vary depending on the exact set requested. So if you want to be
  436. sure you have set what you think you have, check the contents of
  437. these attributes after everything is configured. Drivers may
  438. have to buffer any parameters so that they are consistent when
  439. a given event type is enabled a future point (and not those for
  440. whatever event was previously enabled).
  441. What: /sys/.../events/in_accel_x_raw_thresh_rising_value
  442. What: /sys/.../events/in_accel_x_raw_thresh_falling_value
  443. What: /sys/.../events/in_accel_y_raw_thresh_rising_value
  444. What: /sys/.../events/in_accel_y_raw_thresh_falling_value
  445. What: /sys/.../events/in_accel_z_raw_thresh_rising_value
  446. What: /sys/.../events/in_accel_z_raw_thresh_falling_value
  447. What: /sys/.../events/in_anglvel_x_raw_thresh_rising_value
  448. What: /sys/.../events/in_anglvel_x_raw_thresh_falling_value
  449. What: /sys/.../events/in_anglvel_y_raw_thresh_rising_value
  450. What: /sys/.../events/in_anglvel_y_raw_thresh_falling_value
  451. What: /sys/.../events/in_anglvel_z_raw_thresh_rising_value
  452. What: /sys/.../events/in_anglvel_z_raw_thresh_falling_value
  453. What: /sys/.../events/in_magn_x_raw_thresh_rising_value
  454. What: /sys/.../events/in_magn_x_raw_thresh_falling_value
  455. What: /sys/.../events/in_magn_y_raw_thresh_rising_value
  456. What: /sys/.../events/in_magn_y_raw_thresh_falling_value
  457. What: /sys/.../events/in_magn_z_raw_thresh_rising_value
  458. What: /sys/.../events/in_magn_z_raw_thresh_falling_value
  459. What: /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
  460. What: /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
  461. What: /sys/.../events/in_voltageY_raw_thresh_rising_value
  462. What: /sys/.../events/in_voltageY_raw_thresh_falling_value
  463. What: /sys/.../events/in_tempY_raw_thresh_rising_value
  464. What: /sys/.../events/in_tempY_raw_thresh_falling_value
  465. What: /sys/.../events/in_illuminance0_thresh_falling_value
  466. what: /sys/.../events/in_illuminance0_thresh_rising_value
  467. what: /sys/.../events/in_proximity0_thresh_falling_value
  468. what: /sys/.../events/in_proximity0_thresh_rising_value
  469. KernelVersion: 2.6.37
  470. Contact: linux-iio@vger.kernel.org
  471. Description:
  472. Specifies the value of threshold that the device is comparing
  473. against for the events enabled by
  474. <type>Y[_name]_thresh[_rising|falling]_en.
  475. If separate attributes exist for the two directions, but
  476. direction is not specified for this attribute, then a single
  477. threshold value applies to both directions.
  478. The raw or input element of the name indicates whether the
  479. value is in raw device units or in processed units (as _raw
  480. and _input do on sysfs direct channel read attributes).
  481. What: /sys/.../events/in_accel_x_raw_roc_rising_value
  482. What: /sys/.../events/in_accel_x_raw_roc_falling_value
  483. What: /sys/.../events/in_accel_y_raw_roc_rising_value
  484. What: /sys/.../events/in_accel_y_raw_roc_falling_value
  485. What: /sys/.../events/in_accel_z_raw_roc_rising_value
  486. What: /sys/.../events/in_accel_z_raw_roc_falling_value
  487. What: /sys/.../events/in_anglvel_x_raw_roc_rising_value
  488. What: /sys/.../events/in_anglvel_x_raw_roc_falling_value
  489. What: /sys/.../events/in_anglvel_y_raw_roc_rising_value
  490. What: /sys/.../events/in_anglvel_y_raw_roc_falling_value
  491. What: /sys/.../events/in_anglvel_z_raw_roc_rising_value
  492. What: /sys/.../events/in_anglvel_z_raw_roc_falling_value
  493. What: /sys/.../events/in_magn_x_raw_roc_rising_value
  494. What: /sys/.../events/in_magn_x_raw_roc_falling_value
  495. What: /sys/.../events/in_magn_y_raw_roc_rising_value
  496. What: /sys/.../events/in_magn_y_raw_roc_falling_value
  497. What: /sys/.../events/in_magn_z_raw_roc_rising_value
  498. What: /sys/.../events/in_magn_z_raw_roc_falling_value
  499. What: /sys/.../events/in_voltageY_supply_raw_roc_rising_value
  500. What: /sys/.../events/in_voltageY_supply_raw_roc_falling_value
  501. What: /sys/.../events/in_voltageY_raw_roc_rising_value
  502. What: /sys/.../events/in_voltageY_raw_roc_falling_value
  503. What: /sys/.../events/in_tempY_raw_roc_rising_value
  504. What: /sys/.../events/in_tempY_raw_roc_falling_value
  505. KernelVersion: 2.6.37
  506. Contact: linux-iio@vger.kernel.org
  507. Description:
  508. Specifies the value of rate of change threshold that the
  509. device is comparing against for the events enabled by
  510. <type>[Y][_name]_roc[_rising|falling]_en.
  511. If separate attributes exist for the two directions,
  512. but direction is not specified for this attribute,
  513. then a single threshold value applies to both directions.
  514. The raw or input element of the name indicates whether the
  515. value is in raw device units or in processed units (as _raw
  516. and _input do on sysfs direct channel read attributes).
  517. What: /sys/.../events/in_accel_x_thresh_rising_period
  518. What: /sys/.../events/in_accel_x_thresh_falling_period
  519. hat: /sys/.../events/in_accel_x_roc_rising_period
  520. What: /sys/.../events/in_accel_x_roc_falling_period
  521. What: /sys/.../events/in_accel_y_thresh_rising_period
  522. What: /sys/.../events/in_accel_y_thresh_falling_period
  523. What: /sys/.../events/in_accel_y_roc_rising_period
  524. What: /sys/.../events/in_accel_y_roc_falling_period
  525. What: /sys/.../events/in_accel_z_thresh_rising_period
  526. What: /sys/.../events/in_accel_z_thresh_falling_period
  527. What: /sys/.../events/in_accel_z_roc_rising_period
  528. What: /sys/.../events/in_accel_z_roc_falling_period
  529. What: /sys/.../events/in_anglvel_x_thresh_rising_period
  530. What: /sys/.../events/in_anglvel_x_thresh_falling_period
  531. What: /sys/.../events/in_anglvel_x_roc_rising_period
  532. What: /sys/.../events/in_anglvel_x_roc_falling_period
  533. What: /sys/.../events/in_anglvel_y_thresh_rising_period
  534. What: /sys/.../events/in_anglvel_y_thresh_falling_period
  535. What: /sys/.../events/in_anglvel_y_roc_rising_period
  536. What: /sys/.../events/in_anglvel_y_roc_falling_period
  537. What: /sys/.../events/in_anglvel_z_thresh_rising_period
  538. What: /sys/.../events/in_anglvel_z_thresh_falling_period
  539. What: /sys/.../events/in_anglvel_z_roc_rising_period
  540. What: /sys/.../events/in_anglvel_z_roc_falling_period
  541. What: /sys/.../events/in_magn_x_thresh_rising_period
  542. What: /sys/.../events/in_magn_x_thresh_falling_period
  543. What: /sys/.../events/in_magn_x_roc_rising_period
  544. What: /sys/.../events/in_magn_x_roc_falling_period
  545. What: /sys/.../events/in_magn_y_thresh_rising_period
  546. What: /sys/.../events/in_magn_y_thresh_falling_period
  547. What: /sys/.../events/in_magn_y_roc_rising_period
  548. What: /sys/.../events/in_magn_y_roc_falling_period
  549. What: /sys/.../events/in_magn_z_thresh_rising_period
  550. What: /sys/.../events/in_magn_z_thresh_falling_period
  551. What: /sys/.../events/in_magn_z_roc_rising_period
  552. What: /sys/.../events/in_magn_z_roc_falling_period
  553. What: /sys/.../events/in_voltageY_supply_thresh_rising_period
  554. What: /sys/.../events/in_voltageY_supply_thresh_falling_period
  555. What: /sys/.../events/in_voltageY_supply_roc_rising_period
  556. What: /sys/.../events/in_voltageY_supply_roc_falling_period
  557. What: /sys/.../events/in_voltageY_thresh_rising_period
  558. What: /sys/.../events/in_voltageY_thresh_falling_period
  559. What: /sys/.../events/in_voltageY_roc_rising_period
  560. What: /sys/.../events/in_voltageY_roc_falling_period
  561. What: /sys/.../events/in_tempY_thresh_rising_period
  562. What: /sys/.../events/in_tempY_thresh_falling_period
  563. What: /sys/.../events/in_tempY_roc_rising_period
  564. What: /sys/.../events/in_tempY_roc_falling_period
  565. What: /sys/.../events/in_accel_x&y&z_mag_falling_period
  566. What: /sys/.../events/in_intensity0_thresh_period
  567. What: /sys/.../events/in_proximity0_thresh_period
  568. KernelVersion: 2.6.37
  569. Contact: linux-iio@vger.kernel.org
  570. Description:
  571. Period of time (in seconds) for which the condition must be
  572. met before an event is generated. If direction is not
  573. specified then this period applies to both directions.
  574. What: /sys/.../iio:deviceX/events/in_accel_mag_en
  575. What: /sys/.../iio:deviceX/events/in_accel_mag_rising_en
  576. What: /sys/.../iio:deviceX/events/in_accel_mag_falling_en
  577. What: /sys/.../iio:deviceX/events/in_accel_x_mag_en
  578. What: /sys/.../iio:deviceX/events/in_accel_x_mag_rising_en
  579. What: /sys/.../iio:deviceX/events/in_accel_x_mag_falling_en
  580. What: /sys/.../iio:deviceX/events/in_accel_y_mag_en
  581. What: /sys/.../iio:deviceX/events/in_accel_y_mag_rising_en
  582. What: /sys/.../iio:deviceX/events/in_accel_y_mag_falling_en
  583. What: /sys/.../iio:deviceX/events/in_accel_z_mag_en
  584. What: /sys/.../iio:deviceX/events/in_accel_z_mag_rising_en
  585. What: /sys/.../iio:deviceX/events/in_accel_z_mag_falling_en
  586. What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en
  587. What: /sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en
  588. KernelVersion: 2.6.37
  589. Contact: linux-iio@vger.kernel.org
  590. Description:
  591. Similar to in_accel_x_thresh[_rising|_falling]_en, but here the
  592. magnitude of the channel is compared to the threshold, not its
  593. signed value.
  594. What: /sys/.../events/in_accel_raw_mag_value
  595. What: /sys/.../events/in_accel_x_raw_mag_rising_value
  596. What: /sys/.../events/in_accel_y_raw_mag_rising_value
  597. What: /sys/.../events/in_accel_z_raw_mag_rising_value
  598. KernelVersion: 2.6.37
  599. Contact: linux-iio@vger.kernel.org
  600. Description:
  601. The value to which the magnitude of the channel is compared. If
  602. number or direction is not specified, applies to all channels of
  603. this type.
  604. What: /sys/bus/iio/devices/iio:deviceX/trigger/current_trigger
  605. KernelVersion: 2.6.35
  606. Contact: linux-iio@vger.kernel.org
  607. Description:
  608. The name of the trigger source being used, as per string given
  609. in /sys/class/iio/triggerY/name.
  610. What: /sys/bus/iio/devices/iio:deviceX/buffer/length
  611. KernelVersion: 2.6.35
  612. Contact: linux-iio@vger.kernel.org
  613. Description:
  614. Number of scans contained by the buffer.
  615. What: /sys/bus/iio/devices/iio:deviceX/buffer/bytes_per_datum
  616. KernelVersion: 2.6.37
  617. Contact: linux-iio@vger.kernel.org
  618. Description:
  619. Bytes per scan. Due to alignment fun, the scan may be larger
  620. than implied directly by the scan_element parameters.
  621. What: /sys/bus/iio/devices/iio:deviceX/buffer/enable
  622. KernelVersion: 2.6.35
  623. Contact: linux-iio@vger.kernel.org
  624. Description:
  625. Actually start the buffer capture up. Will start trigger
  626. if first device and appropriate.
  627. What: /sys/bus/iio/devices/iio:deviceX/buffer/scan_elements
  628. KernelVersion: 2.6.37
  629. Contact: linux-iio@vger.kernel.org
  630. Description:
  631. Directory containing interfaces for elements that will be
  632. captured for a single triggered sample set in the buffer.
  633. What: /sys/.../buffer/scan_elements/in_accel_x_en
  634. What: /sys/.../buffer/scan_elements/in_accel_y_en
  635. What: /sys/.../buffer/scan_elements/in_accel_z_en
  636. What: /sys/.../buffer/scan_elements/in_anglvel_x_en
  637. What: /sys/.../buffer/scan_elements/in_anglvel_y_en
  638. What: /sys/.../buffer/scan_elements/in_anglvel_z_en
  639. What: /sys/.../buffer/scan_elements/in_magn_x_en
  640. What: /sys/.../buffer/scan_elements/in_magn_y_en
  641. What: /sys/.../buffer/scan_elements/in_magn_z_en
  642. What: /sys/.../buffer/scan_elements/in_timestamp_en
  643. What: /sys/.../buffer/scan_elements/in_voltageY_supply_en
  644. What: /sys/.../buffer/scan_elements/in_voltageY_en
  645. What: /sys/.../buffer/scan_elements/in_voltageY-voltageZ_en
  646. What: /sys/.../buffer/scan_elements/in_incli_x_en
  647. What: /sys/.../buffer/scan_elements/in_incli_y_en
  648. KernelVersion: 2.6.37
  649. Contact: linux-iio@vger.kernel.org
  650. Description:
  651. Scan element control for triggered data capture.
  652. What: /sys/.../buffer/scan_elements/in_accel_type
  653. What: /sys/.../buffer/scan_elements/in_anglvel_type
  654. What: /sys/.../buffer/scan_elements/in_magn_type
  655. What: /sys/.../buffer/scan_elements/in_incli_type
  656. What: /sys/.../buffer/scan_elements/in_voltageY_type
  657. What: /sys/.../buffer/scan_elements/in_voltage-in_type
  658. What: /sys/.../buffer/scan_elements/in_voltageY_supply_type
  659. What: /sys/.../buffer/scan_elements/in_timestamp_type
  660. KernelVersion: 2.6.37
  661. Contact: linux-iio@vger.kernel.org
  662. Description:
  663. Description of the scan element data storage within the buffer
  664. and hence the form in which it is read from user-space.
  665. Form is [be|le]:[s|u]bits/storagebits[>>shift].
  666. be or le specifies big or little endian. s or u specifies if
  667. signed (2's complement) or unsigned. bits is the number of bits
  668. of data and storagebits is the space (after padding) that it
  669. occupies in the buffer. shift if specified, is the shift that
  670. needs to be applied prior to masking out unused bits. Some
  671. devices put their data in the middle of the transferred elements
  672. with additional information on both sides. Note that some
  673. devices will have additional information in the unused bits
  674. so to get a clean value, the bits value must be used to mask
  675. the buffer output value appropriately. The storagebits value
  676. also specifies the data alignment. So s48/64>>2 will be a
  677. signed 48 bit integer stored in a 64 bit location aligned to
  678. a a64 bit boundary. To obtain the clean value, shift right 2
  679. and apply a mask to zero the top 16 bits of the result.
  680. For other storage combinations this attribute will be extended
  681. appropriately.
  682. What: /sys/.../buffer/scan_elements/in_accel_type_available
  683. KernelVersion: 2.6.37
  684. Contact: linux-iio@vger.kernel.org
  685. Description:
  686. If the type parameter can take one of a small set of values,
  687. this attribute lists them.
  688. What: /sys/.../buffer/scan_elements/in_voltageY_index
  689. What: /sys/.../buffer/scan_elements/in_voltageY_supply_index
  690. What: /sys/.../buffer/scan_elements/in_accel_x_index
  691. What: /sys/.../buffer/scan_elements/in_accel_y_index
  692. What: /sys/.../buffer/scan_elements/in_accel_z_index
  693. What: /sys/.../buffer/scan_elements/in_anglvel_x_index
  694. What: /sys/.../buffer/scan_elements/in_anglvel_y_index
  695. What: /sys/.../buffer/scan_elements/in_anglvel_z_index
  696. What: /sys/.../buffer/scan_elements/in_magn_x_index
  697. What: /sys/.../buffer/scan_elements/in_magn_y_index
  698. What: /sys/.../buffer/scan_elements/in_magn_z_index
  699. What: /sys/.../buffer/scan_elements/in_incli_x_index
  700. What: /sys/.../buffer/scan_elements/in_incli_y_index
  701. What: /sys/.../buffer/scan_elements/in_timestamp_index
  702. KernelVersion: 2.6.37
  703. Contact: linux-iio@vger.kernel.org
  704. Description:
  705. A single positive integer specifying the position of this
  706. scan element in the buffer. Note these are not dependent on
  707. what is enabled and may not be contiguous. Thus for user-space
  708. to establish the full layout these must be used in conjunction
  709. with all _en attributes to establish which channels are present,
  710. and the relevant _type attributes to establish the data storage
  711. format.
  712. What: /sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw
  713. KernelVersion: 2.6.38
  714. Contact: linux-iio@vger.kernel.org
  715. Description:
  716. This attribute is used to read the amount of quadrature error
  717. present in the device at a given time.