sysfs-bus-i3c 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148
  1. What: /sys/bus/i3c/devices/i3c-<bus-id>
  2. KernelVersion: 5.0
  3. Contact: linux-i3c@vger.kernel.org
  4. Description:
  5. An I3C bus. This directory will contain one sub-directory per
  6. I3C device present on the bus.
  7. What: /sys/bus/i3c/devices/i3c-<bus-id>/current_master
  8. KernelVersion: 5.0
  9. Contact: linux-i3c@vger.kernel.org
  10. Description:
  11. Expose the master that owns the bus (<bus-id>-<master-pid>) at
  12. the time this file is read. Note that bus ownership can change
  13. overtime, so there's no guarantee that when the read() call
  14. returns, the value returned is still valid.
  15. What: /sys/bus/i3c/devices/i3c-<bus-id>/mode
  16. KernelVersion: 5.0
  17. Contact: linux-i3c@vger.kernel.org
  18. Description:
  19. I3C bus mode. Can be "pure", "mixed-fast" or "mixed-slow". See
  20. the I3C specification for a detailed description of what each
  21. of these modes implies.
  22. What: /sys/bus/i3c/devices/i3c-<bus-id>/i3c_scl_frequency
  23. KernelVersion: 5.0
  24. Contact: linux-i3c@vger.kernel.org
  25. Description:
  26. The frequency (expressed in Hz) of the SCL signal when
  27. operating in I3C SDR mode.
  28. What: /sys/bus/i3c/devices/i3c-<bus-id>/i2c_scl_frequency
  29. KernelVersion: 5.0
  30. Contact: linux-i3c@vger.kernel.org
  31. Description:
  32. The frequency (expressed in Hz) of the SCL signal when
  33. operating in I2C mode.
  34. What: /sys/bus/i3c/devices/i3c-<bus-id>/dynamic_address
  35. KernelVersion: 5.0
  36. Contact: linux-i3c@vger.kernel.org
  37. Description:
  38. Dynamic address assigned to the master controller. This
  39. address may change if the bus is re-initialized.
  40. What: /sys/bus/i3c/devices/i3c-<bus-id>/bcr
  41. KernelVersion: 5.0
  42. Contact: linux-i3c@vger.kernel.org
  43. Description:
  44. BCR stands for Bus Characteristics Register and express the
  45. device capabilities in term of speed, maximum read/write
  46. length, etc. See the I3C specification for more details.
  47. This entry describes the BCR of the master controller driving
  48. the bus.
  49. What: /sys/bus/i3c/devices/i3c-<bus-id>/dcr
  50. KernelVersion: 5.0
  51. Contact: linux-i3c@vger.kernel.org
  52. Description:
  53. DCR stands for Device Characteristics Register and express the
  54. device capabilities in term of exposed features. See the I3C
  55. specification for more details.
  56. This entry describes the DCR of the master controller driving
  57. the bus.
  58. What: /sys/bus/i3c/devices/i3c-<bus-id>/pid
  59. KernelVersion: 5.0
  60. Contact: linux-i3c@vger.kernel.org
  61. Description:
  62. PID stands for Provisional ID and is used to uniquely identify
  63. a device on a bus. This PID contains information about the
  64. vendor, the part and an instance ID so that several devices of
  65. the same type can be connected on the same bus.
  66. See the I3C specification for more details.
  67. This entry describes the PID of the master controller driving
  68. the bus.
  69. What: /sys/bus/i3c/devices/i3c-<bus-id>/hdrcap
  70. KernelVersion: 5.0
  71. Contact: linux-i3c@vger.kernel.org
  72. Description:
  73. Expose the HDR (High Data Rate) capabilities of a device.
  74. Returns a list of supported HDR mode, each element is separated
  75. by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".
  76. See the I3C specification for more details about these HDR
  77. modes.
  78. This entry describes the HDRCAP of the master controller
  79. driving the bus.
  80. What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>
  81. KernelVersion: 5.0
  82. Contact: linux-i3c@vger.kernel.org
  83. Description:
  84. An I3C device present on I3C bus identified by <bus-id>. Note
  85. that all devices are represented including the master driving
  86. the bus.
  87. What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dynamic_address
  88. KernelVersion: 5.0
  89. Contact: linux-i3c@vger.kernel.org
  90. Description:
  91. Dynamic address assigned to device <bus-id>-<device-pid>. This
  92. address may change if the bus is re-initialized.
  93. What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/bcr
  94. KernelVersion: 5.0
  95. Contact: linux-i3c@vger.kernel.org
  96. Description:
  97. BCR stands for Bus Characteristics Register and express the
  98. device capabilities in term of speed, maximum read/write
  99. length, etc. See the I3C specification for more details.
  100. What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dcr
  101. KernelVersion: 5.0
  102. Contact: linux-i3c@vger.kernel.org
  103. Description:
  104. DCR stands for Device Characteristics Register and express the
  105. device capabilities in term of exposed features. See the I3C
  106. specification for more details.
  107. What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/pid
  108. KernelVersion: 5.0
  109. Contact: linux-i3c@vger.kernel.org
  110. Description:
  111. PID stands for Provisional ID and is used to uniquely identify
  112. a device on a bus. This PID contains information about the
  113. vendor, the part and an instance ID so that several devices of
  114. the same type can be connected on the same bus.
  115. See the I3C specification for more details.
  116. What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/hdrcap
  117. KernelVersion: 5.0
  118. Contact: linux-i3c@vger.kernel.org
  119. Description:
  120. Expose the HDR (High Data Rate) capabilities of a device.
  121. Returns a list of supported HDR mode, each element is separated
  122. by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".
  123. See the I3C specification for more details about these HDR
  124. modes.
  125. What: /sys/bus/i3c/devices/<bus-id>-<device-pid>
  126. KernelVersion: 5.0
  127. Contact: linux-i3c@vger.kernel.org
  128. Description:
  129. These directories are just symbolic links to
  130. /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>.