Documentation/ABI/testing/sysfs-bus-i3c

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