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