164 lines · plain
1What: /sys/bus/i3c/devices/i3c-<bus-id>2KernelVersion: 5.03Contact: linux-i3c@vger.kernel.org4Description:5 An I3C bus. This directory will contain one sub-directory per6 I3C device present on the bus.7 8What: /sys/bus/i3c/devices/i3c-<bus-id>/current_master9KernelVersion: 5.010Contact: linux-i3c@vger.kernel.org11Description:12 Expose the master that owns the bus (<bus-id>-<master-pid>) at13 the time this file is read. Note that bus ownership can change14 overtime, so there's no guarantee that when the read() call15 returns, the value returned is still valid.16 17What: /sys/bus/i3c/devices/i3c-<bus-id>/mode18KernelVersion: 5.019Contact: linux-i3c@vger.kernel.org20Description:21 I3C bus mode. Can be "pure", "mixed-fast" or "mixed-slow". See22 the I3C specification for a detailed description of what each23 of these modes implies.24 25What: /sys/bus/i3c/devices/i3c-<bus-id>/i3c_scl_frequency26KernelVersion: 5.027Contact: linux-i3c@vger.kernel.org28Description:29 The frequency (expressed in Hz) of the SCL signal when30 operating in I3C SDR mode.31 32What: /sys/bus/i3c/devices/i3c-<bus-id>/i2c_scl_frequency33KernelVersion: 5.034Contact: linux-i3c@vger.kernel.org35Description:36 The frequency (expressed in Hz) of the SCL signal when37 operating in I2C mode.38 39What: /sys/bus/i3c/devices/i3c-<bus-id>/dynamic_address40KernelVersion: 5.041Contact: linux-i3c@vger.kernel.org42Description:43 Dynamic address assigned to the master controller. This44 address may change if the bus is re-initialized.45 46What: /sys/bus/i3c/devices/i3c-<bus-id>/bcr47KernelVersion: 5.048Contact: linux-i3c@vger.kernel.org49Description:50 BCR stands for Bus Characteristics Register and express the51 device capabilities in term of speed, maximum read/write52 length, etc. See the I3C specification for more details.53 This entry describes the BCR of the master controller driving54 the bus.55 56What: /sys/bus/i3c/devices/i3c-<bus-id>/dcr57KernelVersion: 5.058Contact: linux-i3c@vger.kernel.org59Description:60 DCR stands for Device Characteristics Register and express the61 device capabilities in term of exposed features. See the I3C62 specification for more details.63 This entry describes the DCR of the master controller driving64 the bus.65 66What: /sys/bus/i3c/devices/i3c-<bus-id>/pid67KernelVersion: 5.068Contact: linux-i3c@vger.kernel.org69Description:70 PID stands for Provisioned ID and is used to uniquely identify71 a device on a bus. This PID contains information about the72 vendor, the part and an instance ID so that several devices of73 the same type can be connected on the same bus.74 See the I3C specification for more details.75 This entry describes the PID of the master controller driving76 the bus.77 78What: /sys/bus/i3c/devices/i3c-<bus-id>/hdrcap79KernelVersion: 5.080Contact: linux-i3c@vger.kernel.org81Description:82 Expose the HDR (High Data Rate) capabilities of a device.83 Returns a list of supported HDR mode, each element is separated84 by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".85 See the I3C specification for more details about these HDR86 modes.87 88 This entry describes the HDRCAP of the master controller89 driving the bus.90 91What: /sys/bus/i3c/devices/i3c-<bus-id>/hotjoin92KernelVersion: 6.893Contact: linux-i3c@vger.kernel.org94Description:95 I3C’s Hot-Join mechanism allows an I3C Device to inform the96 Active Controller that a newly-joined Target is present on the97 I3C Bus and is ready to receive a Dynamic Address, in order to98 become fully functional on the Bus. Hot-Join is used when the99 Target is mounted on the same I3C bus and remains depowered100 until needed or until the Target is physically inserted into the101 I3C bus102 103 This entry allows to enable or disable Hot-join of the Current104 Controller driving the bus.105 106What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>107KernelVersion: 5.0108Contact: linux-i3c@vger.kernel.org109Description:110 An I3C device present on I3C bus identified by <bus-id>. Note111 that all devices are represented including the master driving112 the bus.113 114What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dynamic_address115KernelVersion: 5.0116Contact: linux-i3c@vger.kernel.org117Description:118 Dynamic address assigned to device <bus-id>-<device-pid>. This119 address may change if the bus is re-initialized.120 121What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/bcr122KernelVersion: 5.0123Contact: linux-i3c@vger.kernel.org124Description:125 BCR stands for Bus Characteristics Register and express the126 device capabilities in term of speed, maximum read/write127 length, etc. See the I3C specification for more details.128 129What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dcr130KernelVersion: 5.0131Contact: linux-i3c@vger.kernel.org132Description:133 DCR stands for Device Characteristics Register and express the134 device capabilities in term of exposed features. See the I3C135 specification for more details.136 137What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/pid138KernelVersion: 5.0139Contact: linux-i3c@vger.kernel.org140Description:141 PID stands for Provisioned ID and is used to uniquely identify142 a device on a bus. This PID contains information about the143 vendor, the part and an instance ID so that several devices of144 the same type can be connected on the same bus.145 See the I3C specification for more details.146 147What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/hdrcap148KernelVersion: 5.0149Contact: linux-i3c@vger.kernel.org150Description:151 Expose the HDR (High Data Rate) capabilities of a device.152 Returns a list of supported HDR mode, each element is separated153 by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".154 155 See the I3C specification for more details about these HDR156 modes.157 158What: /sys/bus/i3c/devices/<bus-id>-<device-pid>159KernelVersion: 5.0160Contact: linux-i3c@vger.kernel.org161Description:162 These directories are just symbolic links to163 /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>.164