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