0001 What: /sys/bus/i3c/devices/i3c-<bus-id>
0002 KernelVersion: 5.0
0003 Contact: linux-i3c@vger.kernel.org
0004 Description:
0005 An I3C bus. This directory will contain one sub-directory per
0006 I3C device present on the bus.
0007
0008 What: /sys/bus/i3c/devices/i3c-<bus-id>/current_master
0009 KernelVersion: 5.0
0010 Contact: linux-i3c@vger.kernel.org
0011 Description:
0012 Expose the master that owns the bus (<bus-id>-<master-pid>) at
0013 the time this file is read. Note that bus ownership can change
0014 overtime, so there's no guarantee that when the read() call
0015 returns, the value returned is still valid.
0016
0017 What: /sys/bus/i3c/devices/i3c-<bus-id>/mode
0018 KernelVersion: 5.0
0019 Contact: linux-i3c@vger.kernel.org
0020 Description:
0021 I3C bus mode. Can be "pure", "mixed-fast" or "mixed-slow". See
0022 the I3C specification for a detailed description of what each
0023 of these modes implies.
0024
0025 What: /sys/bus/i3c/devices/i3c-<bus-id>/i3c_scl_frequency
0026 KernelVersion: 5.0
0027 Contact: linux-i3c@vger.kernel.org
0028 Description:
0029 The frequency (expressed in Hz) of the SCL signal when
0030 operating in I3C SDR mode.
0031
0032 What: /sys/bus/i3c/devices/i3c-<bus-id>/i2c_scl_frequency
0033 KernelVersion: 5.0
0034 Contact: linux-i3c@vger.kernel.org
0035 Description:
0036 The frequency (expressed in Hz) of the SCL signal when
0037 operating in I2C mode.
0038
0039 What: /sys/bus/i3c/devices/i3c-<bus-id>/dynamic_address
0040 KernelVersion: 5.0
0041 Contact: linux-i3c@vger.kernel.org
0042 Description:
0043 Dynamic address assigned to the master controller. This
0044 address may change if the bus is re-initialized.
0045
0046 What: /sys/bus/i3c/devices/i3c-<bus-id>/bcr
0047 KernelVersion: 5.0
0048 Contact: linux-i3c@vger.kernel.org
0049 Description:
0050 BCR stands for Bus Characteristics Register and express the
0051 device capabilities in term of speed, maximum read/write
0052 length, etc. See the I3C specification for more details.
0053 This entry describes the BCR of the master controller driving
0054 the bus.
0055
0056 What: /sys/bus/i3c/devices/i3c-<bus-id>/dcr
0057 KernelVersion: 5.0
0058 Contact: linux-i3c@vger.kernel.org
0059 Description:
0060 DCR stands for Device Characteristics Register and express the
0061 device capabilities in term of exposed features. See the I3C
0062 specification for more details.
0063 This entry describes the DCR of the master controller driving
0064 the bus.
0065
0066 What: /sys/bus/i3c/devices/i3c-<bus-id>/pid
0067 KernelVersion: 5.0
0068 Contact: linux-i3c@vger.kernel.org
0069 Description:
0070 PID stands for Provisional ID and is used to uniquely identify
0071 a device on a bus. This PID contains information about the
0072 vendor, the part and an instance ID so that several devices of
0073 the same type can be connected on the same bus.
0074 See the I3C specification for more details.
0075 This entry describes the PID of the master controller driving
0076 the bus.
0077
0078 What: /sys/bus/i3c/devices/i3c-<bus-id>/hdrcap
0079 KernelVersion: 5.0
0080 Contact: linux-i3c@vger.kernel.org
0081 Description:
0082 Expose the HDR (High Data Rate) capabilities of a device.
0083 Returns a list of supported HDR mode, each element is separated
0084 by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".
0085 See the I3C specification for more details about these HDR
0086 modes.
0087
0088 This entry describes the HDRCAP of the master controller
0089 driving the bus.
0090
0091 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>
0092 KernelVersion: 5.0
0093 Contact: linux-i3c@vger.kernel.org
0094 Description:
0095 An I3C device present on I3C bus identified by <bus-id>. Note
0096 that all devices are represented including the master driving
0097 the bus.
0098
0099 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dynamic_address
0100 KernelVersion: 5.0
0101 Contact: linux-i3c@vger.kernel.org
0102 Description:
0103 Dynamic address assigned to device <bus-id>-<device-pid>. This
0104 address may change if the bus is re-initialized.
0105
0106 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/bcr
0107 KernelVersion: 5.0
0108 Contact: linux-i3c@vger.kernel.org
0109 Description:
0110 BCR stands for Bus Characteristics Register and express the
0111 device capabilities in term of speed, maximum read/write
0112 length, etc. See the I3C specification for more details.
0113
0114 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dcr
0115 KernelVersion: 5.0
0116 Contact: linux-i3c@vger.kernel.org
0117 Description:
0118 DCR stands for Device Characteristics Register and express the
0119 device capabilities in term of exposed features. See the I3C
0120 specification for more details.
0121
0122 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/pid
0123 KernelVersion: 5.0
0124 Contact: linux-i3c@vger.kernel.org
0125 Description:
0126 PID stands for Provisional ID and is used to uniquely identify
0127 a device on a bus. This PID contains information about the
0128 vendor, the part and an instance ID so that several devices of
0129 the same type can be connected on the same bus.
0130 See the I3C specification for more details.
0131
0132 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/hdrcap
0133 KernelVersion: 5.0
0134 Contact: linux-i3c@vger.kernel.org
0135 Description:
0136 Expose the HDR (High Data Rate) capabilities of a device.
0137 Returns a list of supported HDR mode, each element is separated
0138 by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".
0139
0140 See the I3C specification for more details about these HDR
0141 modes.
0142
0143 What: /sys/bus/i3c/devices/<bus-id>-<device-pid>
0144 KernelVersion: 5.0
0145 Contact: linux-i3c@vger.kernel.org
0146 Description:
0147 These directories are just symbolic links to
0148 /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>.
