0001 What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>
0002 Description:
0003 For each RapidIO device, the RapidIO subsystem creates files in
0004 an individual subdirectory with the following name format of
0005 device_name "nn:d:iiii", where:
0006
0007 ==== ========================================================
0008 nn two-digit hexadecimal ID of RapidIO network where the
0009 device resides
0010 d device type: 'e' - for endpoint or 's' - for switch
0011 iiii four-digit device destID for endpoints, or switchID for
0012 switches
0013 ==== ========================================================
0014
0015 For example, below is a list of device directories that
0016 represents a typical RapidIO network with one switch, one host,
0017 and two agent endpoints, as it is seen by the enumerating host
0018 (with destID = 1)::
0019
0020 /sys/bus/rapidio/devices/00:e:0000
0021 /sys/bus/rapidio/devices/00:e:0002
0022 /sys/bus/rapidio/devices/00:s:0001
0023
0024 NOTE:
0025 An enumerating or discovering endpoint does not create a
0026 sysfs entry for itself, this is why an endpoint with destID=1
0027 is not shown in the list.
0028
0029 Attributes Common for All RapidIO Devices
0030 -----------------------------------------
0031
0032 What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/did
0033 Date: Nov, 2005
0034 KernelVersion: v2.6.15
0035 Contact: Matt Porter <mporter@kernel.crashing.org>,
0036 Alexandre Bounine <alexandre.bounine@idt.com>
0037 Description:
0038 (RO) returns the device identifier
0039
0040 What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/vid
0041 Date: Nov, 2005
0042 KernelVersion: v2.6.15
0043 Contact: Matt Porter <mporter@kernel.crashing.org>,
0044 Alexandre Bounine <alexandre.bounine@idt.com>
0045 Description:
0046 (RO) returns the device vendor identifier
0047
0048 What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/device_rev
0049 Date: Nov, 2005
0050 KernelVersion: v2.6.15
0051 Contact: Matt Porter <mporter@kernel.crashing.org>,
0052 Alexandre Bounine <alexandre.bounine@idt.com>
0053 Description:
0054 (RO) returns the device revision level
0055
0056 What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_did
0057 Date: Nov, 2005
0058 KernelVersion: v2.6.15
0059 Contact: Matt Porter <mporter@kernel.crashing.org>,
0060 Alexandre Bounine <alexandre.bounine@idt.com>
0061 Description:
0062 (RO) returns identifier for the assembly containing the device
0063
0064 What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_rev
0065 Date: Nov, 2005
0066 KernelVersion: v2.6.15
0067 Contact: Matt Porter <mporter@kernel.crashing.org>,
0068 Alexandre Bounine <alexandre.bounine@idt.com>
0069 Description:
0070 (RO) returns revision level of the assembly containing the
0071 device
0072
0073 What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_vid
0074 Date: Nov, 2005
0075 KernelVersion: v2.6.15
0076 Contact: Matt Porter <mporter@kernel.crashing.org>,
0077 Alexandre Bounine <alexandre.bounine@idt.com>
0078 Description:
0079 (RO) returns vendor identifier of the assembly containing the
0080 device
0081
0082 What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/destid
0083 Date: Mar, 2011
0084 KernelVersion: v2.6.3
0085 Contact: Matt Porter <mporter@kernel.crashing.org>,
0086 Alexandre Bounine <alexandre.bounine@idt.com>
0087 Description:
0088 (RO) returns device destination ID assigned by the enumeration
0089 routine
0090
0091 What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/lprev
0092 Date: Mar, 2011
0093 KernelVersion: v2.6.39
0094 Contact: Matt Porter <mporter@kernel.crashing.org>,
0095 Alexandre Bounine <alexandre.bounine@idt.com>
0096 Description:
0097 (RO) returns name of previous device (switch) on the path to the
0098 device that that owns this attribute
0099
0100 What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/modalias
0101 Date: Jul, 2013
0102 KernelVersion: v3.11
0103 Contact: Matt Porter <mporter@kernel.crashing.org>,
0104 Alexandre Bounine <alexandre.bounine@idt.com>
0105 Description:
0106 (RO) returns the device modalias
0107
0108 What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/config
0109 Date: Nov, 2005
0110 KernelVersion: v2.6.15
0111 Contact: Matt Porter <mporter@kernel.crashing.org>,
0112 Alexandre Bounine <alexandre.bounine@idt.com>
0113 Description:
0114 (RW) Binary attribute to read from and write to the device
0115 configuration registers using the RapidIO maintenance
0116 transactions. This attribute is similar in behaviour to the
0117 "config" attribute of PCI devices and provides an access to the
0118 RapidIO device registers using standard file read and write
0119 operations.
0120
0121 RapidIO Switch Device Attributes
0122 --------------------------------
0123
0124 RapidIO switches have additional attributes in sysfs. RapidIO subsystem supports
0125 common and device-specific sysfs attributes for switches. Because switches are
0126 integrated into the RapidIO subsystem, it offers a method to create
0127 device-specific sysfs attributes by specifying a callback function that may be
0128 set by the switch initialization routine during enumeration or discovery
0129 process.
0130
0131 What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/routes
0132 Date: Nov, 2005
0133 KernelVersion: v2.6.15
0134 Contact: Matt Porter <mporter@kernel.crashing.org>,
0135 Alexandre Bounine <alexandre.bounine@idt.com>
0136 Description:
0137 (RO) reports switch routing information in "destID port" format.
0138 This attribute reports only valid routing table entries, one
0139 line for each entry.
0140
0141 What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/destid
0142 Date: Mar, 2011
0143 KernelVersion: v2.6.3
0144 Contact: Matt Porter <mporter@kernel.crashing.org>,
0145 Alexandre Bounine <alexandre.bounine@idt.com>
0146 Description:
0147 (RO) device destination ID of the associated device that defines
0148 a route to the switch
0149
0150 What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/hopcount
0151 Date: Mar, 2011
0152 KernelVersion: v2.6.39
0153 Contact: Matt Porter <mporter@kernel.crashing.org>,
0154 Alexandre Bounine <alexandre.bounine@idt.com>
0155 Description:
0156 (RO) number of hops on the path to the switch
0157
0158 What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/lnext
0159 Date: Mar, 2011
0160 KernelVersion: v2.6.39
0161 Contact: Matt Porter <mporter@kernel.crashing.org>,
0162 Alexandre Bounine <alexandre.bounine@idt.com>
0163 Description:
0164 (RO) returns names of devices linked to the switch except one of
0165 a device linked to the ingress port (reported as "lprev"). This
0166 is an array names with number of lines equal to number of ports
0167 in switch. If a switch port has no attached device, returns
0168 "null" instead of a device name.
0169
0170 Device-specific Switch Attributes
0171 ---------------------------------
0172
0173 IDT_GEN2-
0174
0175 What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/errlog
0176 Date: Oct, 2010
0177 KernelVersion: v2.6.37
0178 Contact: Matt Porter <mporter@kernel.crashing.org>,
0179 Alexandre Bounine <alexandre.bounine@idt.com>
0180 Description:
0181 (RO) reads contents of device error log until it is empty.
0182
0183 RapidIO Bus Attributes
0184 ----------------------
0185
0186 What: /sys/bus/rapidio/scan
0187 Date: May, 2013
0188 KernelVersion: v3.11
0189 Contact: Matt Porter <mporter@kernel.crashing.org>,
0190 Alexandre Bounine <alexandre.bounine@idt.com>
0191 Description:
0192 (WO) Allows to trigger enumeration discovery process from user
0193 space. To initiate an enumeration or discovery process on
0194 specific mport device, a user needs to write mport_ID (not
0195 RapidIO destination ID) into this file. The mport_ID is a
0196 sequential number (0 ... RIO_MAX_MPORTS) assigned to the mport
0197 device. For example, for a machine with a single RapidIO
0198 controller, mport_ID for that controller always will be 0. To
0199 initiate RapidIO enumeration/discovery on all available mports a
0200 user must write '-1' (or RIO_MPORT_ANY) into this attribute
0201 file.
