sysfs-bus-rapidio (7156B)
1What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii> 2Description: 3 For each RapidIO device, the RapidIO subsystem creates files in 4 an individual subdirectory with the following name format of 5 device_name "nn:d:iiii", where: 6 7 ==== ======================================================== 8 nn two-digit hexadecimal ID of RapidIO network where the 9 device resides 10 d device type: 'e' - for endpoint or 's' - for switch 11 iiii four-digit device destID for endpoints, or switchID for 12 switches 13 ==== ======================================================== 14 15 For example, below is a list of device directories that 16 represents a typical RapidIO network with one switch, one host, 17 and two agent endpoints, as it is seen by the enumerating host 18 (with destID = 1):: 19 20 /sys/bus/rapidio/devices/00:e:0000 21 /sys/bus/rapidio/devices/00:e:0002 22 /sys/bus/rapidio/devices/00:s:0001 23 24 NOTE: 25 An enumerating or discovering endpoint does not create a 26 sysfs entry for itself, this is why an endpoint with destID=1 27 is not shown in the list. 28 29Attributes Common for All RapidIO Devices 30----------------------------------------- 31 32What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/did 33Date: Nov, 2005 34KernelVersion: v2.6.15 35Contact: Matt Porter <mporter@kernel.crashing.org>, 36 Alexandre Bounine <alexandre.bounine@idt.com> 37Description: 38 (RO) returns the device identifier 39 40What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/vid 41Date: Nov, 2005 42KernelVersion: v2.6.15 43Contact: Matt Porter <mporter@kernel.crashing.org>, 44 Alexandre Bounine <alexandre.bounine@idt.com> 45Description: 46 (RO) returns the device vendor identifier 47 48What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/device_rev 49Date: Nov, 2005 50KernelVersion: v2.6.15 51Contact: Matt Porter <mporter@kernel.crashing.org>, 52 Alexandre Bounine <alexandre.bounine@idt.com> 53Description: 54 (RO) returns the device revision level 55 56What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_did 57Date: Nov, 2005 58KernelVersion: v2.6.15 59Contact: Matt Porter <mporter@kernel.crashing.org>, 60 Alexandre Bounine <alexandre.bounine@idt.com> 61Description: 62 (RO) returns identifier for the assembly containing the device 63 64What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_rev 65Date: Nov, 2005 66KernelVersion: v2.6.15 67Contact: Matt Porter <mporter@kernel.crashing.org>, 68 Alexandre Bounine <alexandre.bounine@idt.com> 69Description: 70 (RO) returns revision level of the assembly containing the 71 device 72 73What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_vid 74Date: Nov, 2005 75KernelVersion: v2.6.15 76Contact: Matt Porter <mporter@kernel.crashing.org>, 77 Alexandre Bounine <alexandre.bounine@idt.com> 78Description: 79 (RO) returns vendor identifier of the assembly containing the 80 device 81 82What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/destid 83Date: Mar, 2011 84KernelVersion: v2.6.3 85Contact: Matt Porter <mporter@kernel.crashing.org>, 86 Alexandre Bounine <alexandre.bounine@idt.com> 87Description: 88 (RO) returns device destination ID assigned by the enumeration 89 routine 90 91What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/lprev 92Date: Mar, 2011 93KernelVersion: v2.6.39 94Contact: Matt Porter <mporter@kernel.crashing.org>, 95 Alexandre Bounine <alexandre.bounine@idt.com> 96Description: 97 (RO) returns name of previous device (switch) on the path to the 98 device that that owns this attribute 99 100What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/modalias 101Date: Jul, 2013 102KernelVersion: v3.11 103Contact: Matt Porter <mporter@kernel.crashing.org>, 104 Alexandre Bounine <alexandre.bounine@idt.com> 105Description: 106 (RO) returns the device modalias 107 108What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/config 109Date: Nov, 2005 110KernelVersion: v2.6.15 111Contact: Matt Porter <mporter@kernel.crashing.org>, 112 Alexandre Bounine <alexandre.bounine@idt.com> 113Description: 114 (RW) Binary attribute to read from and write to the device 115 configuration registers using the RapidIO maintenance 116 transactions. This attribute is similar in behaviour to the 117 "config" attribute of PCI devices and provides an access to the 118 RapidIO device registers using standard file read and write 119 operations. 120 121RapidIO Switch Device Attributes 122-------------------------------- 123 124RapidIO switches have additional attributes in sysfs. RapidIO subsystem supports 125common and device-specific sysfs attributes for switches. Because switches are 126integrated into the RapidIO subsystem, it offers a method to create 127device-specific sysfs attributes by specifying a callback function that may be 128set by the switch initialization routine during enumeration or discovery 129process. 130 131What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/routes 132Date: Nov, 2005 133KernelVersion: v2.6.15 134Contact: Matt Porter <mporter@kernel.crashing.org>, 135 Alexandre Bounine <alexandre.bounine@idt.com> 136Description: 137 (RO) reports switch routing information in "destID port" format. 138 This attribute reports only valid routing table entries, one 139 line for each entry. 140 141What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/destid 142Date: Mar, 2011 143KernelVersion: v2.6.3 144Contact: Matt Porter <mporter@kernel.crashing.org>, 145 Alexandre Bounine <alexandre.bounine@idt.com> 146Description: 147 (RO) device destination ID of the associated device that defines 148 a route to the switch 149 150What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/hopcount 151Date: Mar, 2011 152KernelVersion: v2.6.39 153Contact: Matt Porter <mporter@kernel.crashing.org>, 154 Alexandre Bounine <alexandre.bounine@idt.com> 155Description: 156 (RO) number of hops on the path to the switch 157 158What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/lnext 159Date: Mar, 2011 160KernelVersion: v2.6.39 161Contact: Matt Porter <mporter@kernel.crashing.org>, 162 Alexandre Bounine <alexandre.bounine@idt.com> 163Description: 164 (RO) returns names of devices linked to the switch except one of 165 a device linked to the ingress port (reported as "lprev"). This 166 is an array names with number of lines equal to number of ports 167 in switch. If a switch port has no attached device, returns 168 "null" instead of a device name. 169 170Device-specific Switch Attributes 171--------------------------------- 172 173IDT_GEN2- 174 175What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/errlog 176Date: Oct, 2010 177KernelVersion: v2.6.37 178Contact: Matt Porter <mporter@kernel.crashing.org>, 179 Alexandre Bounine <alexandre.bounine@idt.com> 180Description: 181 (RO) reads contents of device error log until it is empty. 182 183RapidIO Bus Attributes 184---------------------- 185 186What: /sys/bus/rapidio/scan 187Date: May, 2013 188KernelVersion: v3.11 189Contact: Matt Porter <mporter@kernel.crashing.org>, 190 Alexandre Bounine <alexandre.bounine@idt.com> 191Description: 192 (WO) Allows to trigger enumeration discovery process from user 193 space. To initiate an enumeration or discovery process on 194 specific mport device, a user needs to write mport_ID (not 195 RapidIO destination ID) into this file. The mport_ID is a 196 sequential number (0 ... RIO_MAX_MPORTS) assigned to the mport 197 device. For example, for a machine with a single RapidIO 198 controller, mport_ID for that controller always will be 0. To 199 initiate RapidIO enumeration/discovery on all available mports a 200 user must write '-1' (or RIO_MPORT_ANY) into this attribute 201 file.