202 lines · plain
1What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>2Description:3 For each RapidIO device, the RapidIO subsystem creates files in4 an individual subdirectory with the following name format of5 device_name "nn:d:iiii", where:6 7 ==== ========================================================8 nn two-digit hexadecimal ID of RapidIO network where the9 device resides10 d device type: 'e' - for endpoint or 's' - for switch11 iiii four-digit device destID for endpoints, or switchID for12 switches13 ==== ========================================================14 15 For example, below is a list of device directories that16 represents a typical RapidIO network with one switch, one host,17 and two agent endpoints, as it is seen by the enumerating host18 (with destID = 1)::19 20 /sys/bus/rapidio/devices/00:e:000021 /sys/bus/rapidio/devices/00:e:000222 /sys/bus/rapidio/devices/00:s:000123 24 NOTE:25 An enumerating or discovering endpoint does not create a26 sysfs entry for itself, this is why an endpoint with destID=127 is not shown in the list.28 29Attributes Common for All RapidIO Devices30-----------------------------------------31 32What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/did33Date: Nov, 200534KernelVersion: v2.6.1535Contact: Matt Porter <mporter@kernel.crashing.org>,36 Alexandre Bounine <alexandre.bounine@idt.com>37Description:38 (RO) returns the device identifier39 40What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/vid41Date: Nov, 200542KernelVersion: v2.6.1543Contact: Matt Porter <mporter@kernel.crashing.org>,44 Alexandre Bounine <alexandre.bounine@idt.com>45Description:46 (RO) returns the device vendor identifier47 48What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/device_rev49Date: Nov, 200550KernelVersion: v2.6.1551Contact: Matt Porter <mporter@kernel.crashing.org>,52 Alexandre Bounine <alexandre.bounine@idt.com>53Description:54 (RO) returns the device revision level55 56What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_did57Date: Nov, 200558KernelVersion: v2.6.1559Contact: Matt Porter <mporter@kernel.crashing.org>,60 Alexandre Bounine <alexandre.bounine@idt.com>61Description:62 (RO) returns identifier for the assembly containing the device63 64What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_rev65Date: Nov, 200566KernelVersion: v2.6.1567Contact: Matt Porter <mporter@kernel.crashing.org>,68 Alexandre Bounine <alexandre.bounine@idt.com>69Description:70 (RO) returns revision level of the assembly containing the71 device72 73What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_vid74Date: Nov, 200575KernelVersion: v2.6.1576Contact: Matt Porter <mporter@kernel.crashing.org>,77 Alexandre Bounine <alexandre.bounine@idt.com>78Description:79 (RO) returns vendor identifier of the assembly containing the80 device81 82What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/destid83Date: Mar, 201184KernelVersion: v2.6.385Contact: Matt Porter <mporter@kernel.crashing.org>,86 Alexandre Bounine <alexandre.bounine@idt.com>87Description:88 (RO) returns device destination ID assigned by the enumeration89 routine90 91What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/lprev92Date: Mar, 201193KernelVersion: v2.6.3994Contact: 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 the98 device that that owns this attribute99 100What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/modalias101Date: Jul, 2013102KernelVersion: v3.11103Contact: Matt Porter <mporter@kernel.crashing.org>,104 Alexandre Bounine <alexandre.bounine@idt.com>105Description:106 (RO) returns the device modalias107 108What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/config109Date: Nov, 2005110KernelVersion: v2.6.15111Contact: 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 device115 configuration registers using the RapidIO maintenance116 transactions. This attribute is similar in behaviour to the117 "config" attribute of PCI devices and provides an access to the118 RapidIO device registers using standard file read and write119 operations.120 121RapidIO Switch Device Attributes122--------------------------------123 124RapidIO switches have additional attributes in sysfs. RapidIO subsystem supports125common and device-specific sysfs attributes for switches. Because switches are126integrated into the RapidIO subsystem, it offers a method to create127device-specific sysfs attributes by specifying a callback function that may be128set by the switch initialization routine during enumeration or discovery129process.130 131What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/routes132Date: Nov, 2005133KernelVersion: v2.6.15134Contact: 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, one139 line for each entry.140 141What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/destid142Date: Mar, 2011143KernelVersion: v2.6.3144Contact: Matt Porter <mporter@kernel.crashing.org>,145 Alexandre Bounine <alexandre.bounine@idt.com>146Description:147 (RO) device destination ID of the associated device that defines148 a route to the switch149 150What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/hopcount151Date: Mar, 2011152KernelVersion: v2.6.39153Contact: Matt Porter <mporter@kernel.crashing.org>,154 Alexandre Bounine <alexandre.bounine@idt.com>155Description:156 (RO) number of hops on the path to the switch157 158What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/lnext159Date: Mar, 2011160KernelVersion: v2.6.39161Contact: 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 of165 a device linked to the ingress port (reported as "lprev"). This166 is an array names with number of lines equal to number of ports167 in switch. If a switch port has no attached device, returns168 "null" instead of a device name.169 170Device-specific Switch Attributes171---------------------------------172 173IDT_GEN2-174 175What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/errlog176Date: Oct, 2010177KernelVersion: v2.6.37178Contact: 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 Attributes184----------------------185 186What: /sys/bus/rapidio/scan187Date: May, 2013188KernelVersion: v3.11189Contact: Matt Porter <mporter@kernel.crashing.org>,190 Alexandre Bounine <alexandre.bounine@idt.com>191Description:192 (WO) Allows to trigger enumeration discovery process from user193 space. To initiate an enumeration or discovery process on194 specific mport device, a user needs to write mport_ID (not195 RapidIO destination ID) into this file. The mport_ID is a196 sequential number (0 ... RIO_MAX_MPORTS) assigned to the mport197 device. For example, for a machine with a single RapidIO198 controller, mport_ID for that controller always will be 0. To199 initiate RapidIO enumeration/discovery on all available mports a200 user must write '-1' (or RIO_MPORT_ANY) into this attribute201 file.202