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