Lines Matching +full:function +full:- +full:enumerator
5 The RapidIO standard is a packet-based fabric interconnect standard designed for
8 is publicly available for download from the RTA web-site [1].
14 ----------
17 into the kernel similarly to other buses by defining RapidIO-specific device and
21 architecture-specific interfaces that provide support for common RapidIO
25 ------------------
52 structure. Devices form one global device list and per-network device lists
65 specific switch drivers that are designed to provide hardware-specific
78 RapidIO device-specific drivers follow Linux Kernel Driver Model and are
85 common services may act separately from device-specific drivers or be used by
86 device-specific drivers. Example of such service provider is the RIONET driver
87 which implements Ethernet-over-RapidIO interface. Because only one driver can be
90 the same device without blocking attachment of a device-specific driver.
93 ---------------------------
97 within the subsystem controller driver's initialization code calls function
102 by user-space command.
108 ----------------------------
111 ------------
125 subsystem. Now this method relies on enumerator module parameter which is
126 'rio-scan.scan' for existing basic enumeration/discovery method.
134 a user-space command as it is described below (if the given endpoint was
141 started first by issuing a user-space command, after an enumeration is
146 process can be started by issuing a user-space command.
147 Similar to the option (b) above, an enumerator has to be started first.
164 the command line parameter "rapidio.hdid=-1,7" will result in assignment of
166 one will be assigned destination ID=-1.
171 - from command line: "modprobe rapidio hdid=-1,7", or
172 - from modprobe configuration file using configuration command "options",
173 like in this example: "options rapidio hdid=-1,7". An example of modprobe
178 destination ID = -1;
180 destination ID assignments omitted from the end of list (default = -1).
182 If the host device ID for a specific master port is set to -1, the discovery
188 NOTE: If RapidIO switch-specific device drivers are built as loadable modules
191 vendor-specific callbacks on early stages.
194 ------------------------------------------------
196 Automatic enumeration/discovery start method is applicable only to built-in
198 enumeration/discovery start by existing basic enumerator method set use boot
199 command line parameter "rio-scan.scan=1".
216 4.3 User-space Start of Enumeration and Discovery
217 -------------------------------------------------
219 User-space start of enumeration and discovery can be used with built-in and
220 modular build configurations. For user-space controlled start RapidIO subsystem
221 creates the sysfs write-only attribute file '/sys/bus/rapidio/scan'. To initiate
229 write '-1' (or RIO_MPORT_ANY) into the scan attribute file.
232 ----------------------------
246 The enumeration process traverses the network using a recursive depth-first
247 algorithm. When a new device is found, the enumerator takes ownership of that
249 the enumerator has exclusive right to enumerate the device. If device ownership
250 is successfully acquired, the enumerator allocates a new rio_dev structure and
256 If the device is a switch, the enumerator allocates an additional rio_switch
259 table entry contains a pointer to a switch-specific initialization routine that
264 chain of switches) does not have any endpoint (except enumerator) attached to
270 For both endpoints and switches the enumerator writes a unique component tag
277 (0xFF for 8-bit systems and 0xFFFF for 16-bit systems) is temporarily written
291 devices. This way each Linux-based component of the RapidIO subsystem has
300 -------------------------------------------
309 an enumerator to a specified mport device (or devices). The basic enumerator
313 -----------------------------------------
317 This process can be automated by specifying pre- or post- dependencies in the
318 RapidIO-specific modprobe configuration file as shown in the example below.
321 ----------------------------------
325 # Set enumerator host destination ID (overrides kernel command line option)
326 options rapidio hdid=-1,2
333 # Load RapidIO switch drivers just before rio-scan enumerator module is loaded
334 softdep rio-scan pre: idt_gen2 idtcps tsi57x
336 --------------------------
342 -------------
351 http://www.kernel.org/doc/ols/2005/ols2005v2-pages-43-56.pdf