Loading...
Note: File does not exist in v3.1.
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 <mporter@kernel.crashing.org>,
33 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
41 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
49 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
57 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
65 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
74 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
83 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
92 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
101 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
109 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
132 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
142 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
151 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
159 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
176 Alexandre Bounine <alexandre.bounine@idt.com>
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 <mporter@kernel.crashing.org>,
187 Alexandre Bounine <alexandre.bounine@idt.com>
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.