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