€•ÜÒ      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ./translations/zh_CN/driver-api/rapidio/rapidio”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/zh_TW/driver-api/rapidio/rapidio”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/it_IT/driver-api/rapidio/rapidio”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ja_JP/driver-api/rapidio/rapidio”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ko_KR/driver-api/rapidio/rapidio”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/sp_SP/driver-api/rapidio/rapidio”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒIntroduction”h]”hŒIntroduction”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒH/var/lib/git/docbuild/linux/Documentation/driver-api/rapidio/rapidio.rst”h KubhŒ	paragraph”“”)”}”(hX0  The RapidIO standard is a packet-based fabric interconnect standard designed for
use in embedded systems. Development of the RapidIO standard is directed by the
RapidIO Trade Association (RTA). The current version of the RapidIO specification
is publicly available for download from the RTA web-site [1].”h]”hX0  The RapidIO standard is a packet-based fabric interconnect standard designed for
use in embedded systems. Development of the RapidIO standard is directed by the
RapidIO Trade Association (RTA). The current version of the RapidIO specification
is publicly available for download from the RTA web-site [1].”…””}”(hh¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hŒsThis document describes the basics of the Linux RapidIO subsystem and provides
information on its major components.”h]”hŒsThis document describes the basics of the Linux RapidIO subsystem and provides
information on its major components.”…””}”(hhÇhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K
hh£hžhubh¢)”}”(hhh]”(h§)”}”(hŒ
1 Overview”h]”hŒ
1 Overview”…””}”(hhØhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hhÕhžhhŸh¶h Kubh¸)”}”(hŒÖBecause the RapidIO subsystem follows the Linux device model it is integrated
into the kernel similarly to other buses by defining RapidIO-specific device and
bus types and registering them within the device model.”h]”hŒÖBecause the RapidIO subsystem follows the Linux device model it is integrated
into the kernel similarly to other buses by defining RapidIO-specific device and
bus types and registering them within the device model.”…””}”(hhæhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhhÕhžhubh¸)”}”(hŒ¬The Linux RapidIO subsystem is architecture independent and therefore defines
architecture-specific interfaces that provide support for common RapidIO
subsystem operations.”h]”hŒ¬The Linux RapidIO subsystem is architecture independent and therefore defines
architecture-specific interfaces that provide support for common RapidIO
subsystem operations.”…””}”(hhôhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhhÕhžhubeh}”(h]”Œoverview”ah ]”h"]”Œ
1 overview”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒ2. Core Components”h]”hŒ2. Core Components”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj
  hžhhŸh¶h Kubh¸)”}”(hŒýA typical RapidIO network is a combination of endpoints and switches.
Each of these components is represented in the subsystem by an associated data
structure. The core logical components of the RapidIO subsystem are defined
in include/linux/rio.h file.”h]”hŒýA typical RapidIO network is a combination of endpoints and switches.
Each of these components is represented in the subsystem by an associated data
structure. The core logical components of the RapidIO subsystem are defined
in include/linux/rio.h file.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj
  hžhubh¢)”}”(hhh]”(h§)”}”(hŒ2.1 Master Port”h]”hŒ2.1 Master Port”…””}”(hj,  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj)  hžhhŸh¶h K!ubh¸)”}”(hXã  A master port (or mport) is a RapidIO interface controller that is local to the
processor executing the Linux code. A master port generates and receives RapidIO
packets (transactions). In the RapidIO subsystem each master port is represented
by a rio_mport data structure. This structure contains master port specific
resources such as mailboxes and doorbells. The rio_mport also includes a unique
host device ID that is valid when a master port is configured as an enumerating
host.”h]”hXã  A master port (or mport) is a RapidIO interface controller that is local to the
processor executing the Linux code. A master port generates and receives RapidIO
packets (transactions). In the RapidIO subsystem each master port is represented
by a rio_mport data structure. This structure contains master port specific
resources such as mailboxes and doorbells. The rio_mport also includes a unique
host device ID that is valid when a master port is configured as an enumerating
host.”…””}”(hj:  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K#hj)  hžhubh¸)”}”(hXX  RapidIO master ports are serviced by subsystem specific mport device drivers
that provide functionality defined for this subsystem. To provide a hardware
independent interface for RapidIO subsystem operations, rio_mport structure
includes rio_ops data structure which contains pointers to hardware specific
implementations of RapidIO functions.”h]”hXX  RapidIO master ports are serviced by subsystem specific mport device drivers
that provide functionality defined for this subsystem. To provide a hardware
independent interface for RapidIO subsystem operations, rio_mport structure
includes rio_ops data structure which contains pointers to hardware specific
implementations of RapidIO functions.”…””}”(hjH  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K+hj)  hžhubeh}”(h]”Œmaster-port”ah ]”h"]”Œ2.1 master port”ah$]”h&]”uh1h¡hj
  hžhhŸh¶h K!ubh¢)”}”(hhh]”(h§)”}”(hŒ
2.2 Device”h]”hŒ
2.2 Device”…””}”(hja  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj^  hžhhŸh¶h K2ubh¸)”}”(hX"  A RapidIO device is any endpoint (other than mport) or switch in the network.
All devices are presented in the RapidIO subsystem by corresponding rio_dev data
structure. Devices form one global device list and per-network device lists
(depending on number of available mports and networks).”h]”hX"  A RapidIO device is any endpoint (other than mport) or switch in the network.
All devices are presented in the RapidIO subsystem by corresponding rio_dev data
structure. Devices form one global device list and per-network device lists
(depending on number of available mports and networks).”…””}”(hjo  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K4hj^  hžhubeh}”(h]”Œdevice”ah ]”h"]”Œ
2.2 device”ah$]”h&]”uh1h¡hj
  hžhhŸh¶h K2ubh¢)”}”(hhh]”(h§)”}”(hŒ
2.3 Switch”h]”hŒ
2.3 Switch”…””}”(hjˆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj…  hžhhŸh¶h K:ubh¸)”}”(hX¼  A RapidIO switch is a special class of device that routes packets between its
ports towards their final destination. The packet destination port within a
switch is defined by an internal routing table. A switch is presented in the
RapidIO subsystem by rio_dev data structure expanded by additional rio_switch
data structure, which contains switch specific information such as copy of the
routing table and pointers to switch specific functions.”h]”hX¼  A RapidIO switch is a special class of device that routes packets between its
ports towards their final destination. The packet destination port within a
switch is defined by an internal routing table. A switch is presented in the
RapidIO subsystem by rio_dev data structure expanded by additional rio_switch
data structure, which contains switch specific information such as copy of the
routing table and pointers to switch specific functions.”…””}”(hj–  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K<hj…  hžhubh¸)”}”(hŒÌThe RapidIO subsystem defines the format and initialization method for subsystem
specific switch drivers that are designed to provide hardware-specific
implementation of common switch management routines.”h]”hŒÌThe RapidIO subsystem defines the format and initialization method for subsystem
specific switch drivers that are designed to provide hardware-specific
implementation of common switch management routines.”…””}”(hj¤  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KChj…  hžhubeh}”(h]”Œswitch”ah ]”h"]”Œ
2.3 switch”ah$]”h&]”uh1h¡hj
  hžhhŸh¶h K:ubh¢)”}”(hhh]”(h§)”}”(hŒ2.4 Network”h]”hŒ2.4 Network”…””}”(hj½  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjº  hžhhŸh¶h KHubh¸)”}”(hX…  A RapidIO network is a combination of interconnected endpoint and switch devices.
Each RapidIO network known to the system is represented by corresponding rio_net
data structure. This structure includes lists of all devices and local master
ports that form the same network. It also contains a pointer to the default
master port that is used to communicate with devices within the network.”h]”hX…  A RapidIO network is a combination of interconnected endpoint and switch devices.
Each RapidIO network known to the system is represented by corresponding rio_net
data structure. This structure includes lists of all devices and local master
ports that form the same network. It also contains a pointer to the default
master port that is used to communicate with devices within the network.”…””}”(hjË  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KJhjº  hžhubeh}”(h]”Œnetwork”ah ]”h"]”Œ2.4 network”ah$]”h&]”uh1h¡hj
  hžhhŸh¶h KHubh¢)”}”(hhh]”(h§)”}”(hŒ2.5 Device Drivers”h]”hŒ2.5 Device Drivers”…””}”(hjä  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjá  hžhhŸh¶h KQubh¸)”}”(hŒ–RapidIO device-specific drivers follow Linux Kernel Driver Model and are
intended to support specific RapidIO devices attached to the RapidIO network.”h]”hŒ–RapidIO device-specific drivers follow Linux Kernel Driver Model and are
intended to support specific RapidIO devices attached to the RapidIO network.”…””}”(hjò  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KShjá  hžhubeh}”(h]”Œdevice-drivers”ah ]”h"]”Œ2.5 device drivers”ah$]”h&]”uh1h¡hj
  hžhhŸh¶h KQubh¢)”}”(hhh]”(h§)”}”(hŒ2.6 Subsystem Interfaces”h]”hŒ2.6 Subsystem Interfaces”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h KWubh¸)”}”(hXr  RapidIO interconnect specification defines features that may be used to provide
one or more common service layers for all participating RapidIO devices. These
common services may act separately from device-specific drivers or be used by
device-specific drivers. Example of such service provider is the RIONET driver
which implements Ethernet-over-RapidIO interface. Because only one driver can be
registered for a device, all common RapidIO services have to be registered as
subsystem interfaces. This allows to have multiple common services attached to
the same device without blocking attachment of a device-specific driver.”h]”hXr  RapidIO interconnect specification defines features that may be used to provide
one or more common service layers for all participating RapidIO devices. These
common services may act separately from device-specific drivers or be used by
device-specific drivers. Example of such service provider is the RIONET driver
which implements Ethernet-over-RapidIO interface. Because only one driver can be
registered for a device, all common RapidIO services have to be registered as
subsystem interfaces. This allows to have multiple common services attached to
the same device without blocking attachment of a device-specific driver.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KYhj  hžhubeh}”(h]”Œsubsystem-interfaces”ah ]”h"]”Œ2.6 subsystem interfaces”ah$]”h&]”uh1h¡hj
  hžhhŸh¶h KWubeh}”(h]”Œcore-components”ah ]”h"]”Œ2. core components”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒ3. Subsystem Initialization”h]”hŒ3. Subsystem Initialization”…””}”(hj:  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj7  hžhhŸh¶h Kcubh¸)”}”(hX  In order to initialize the RapidIO subsystem, a platform must initialize and
register at least one master port within the RapidIO network. To register mport
within the subsystem controller driver's initialization code calls function
rio_register_mport() for each available master port.”h]”hX  In order to initialize the RapidIO subsystem, a platform must initialize and
register at least one master port within the RapidIO network. To register mport
within the subsystem controller driverâ€™s initialization code calls function
rio_register_mport() for each available master port.”…””}”(hjH  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kehj7  hžhubh¸)”}”(hŒ¤After all active master ports are registered with a RapidIO subsystem,
an enumeration and/or discovery routine may be called automatically or
by user-space command.”h]”hŒ¤After all active master ports are registered with a RapidIO subsystem,
an enumeration and/or discovery routine may be called automatically or
by user-space command.”…””}”(hjV  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kjhj7  hžhubh¸)”}”(hŒ~RapidIO subsystem can be configured to be built as a statically linked or
modular component of the kernel (see details below).”h]”hŒ~RapidIO subsystem can be configured to be built as a statically linked or
modular component of the kernel (see details below).”…””}”(hjd  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Knhj7  hžhubeh}”(h]”Œsubsystem-initialization”ah ]”h"]”Œ3. subsystem initialization”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kcubh¢)”}”(hhh]”(h§)”}”(hŒ4. Enumeration and Discovery”h]”hŒ4. Enumeration and Discovery”…””}”(hj}  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjz  hžhhŸh¶h Krubh¢)”}”(hhh]”(h§)”}”(hŒ4.1 Overview”h]”hŒ4.1 Overview”…””}”(hjŽ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj‹  hžhhŸh¶h Kuubh¸)”}”(hXx  RapidIO subsystem configuration options allow users to build enumeration and
discovery methods as statically linked components or loadable modules.
An enumeration/discovery method implementation and available input parameters
define how any given method can be attached to available RapidIO mports:
simply to all available mports OR individually to the specified mport device.”h]”hXx  RapidIO subsystem configuration options allow users to build enumeration and
discovery methods as statically linked components or loadable modules.
An enumeration/discovery method implementation and available input parameters
define how any given method can be attached to available RapidIO mports:
simply to all available mports OR individually to the specified mport device.”…””}”(hjœ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kwhj‹  hžhubh¸)”}”(hŒDepending on selected enumeration/discovery build configuration, there are
several methods to initiate an enumeration and/or discovery process:”h]”hŒDepending on selected enumeration/discovery build configuration, there are
several methods to initiate an enumeration and/or discovery process:”…””}”(hjª  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K}hj‹  hžhubhŒblock_quote”“”)”}”(hX>  (a) Statically linked enumeration and discovery process can be started
automatically during kernel initialization time using corresponding module
parameters. This was the original method used since introduction of RapidIO
subsystem. Now this method relies on enumerator module parameter which is
'rio-scan.scan' for existing basic enumeration/discovery method.
When automatic start of enumeration/discovery is used a user has to ensure
that all discovering endpoints are started before the enumerating endpoint
and are waiting for enumeration to be completed.
Configuration option CONFIG_RAPIDIO_DISC_TIMEOUT defines time that discovering
endpoint waits for enumeration to be completed. If the specified timeout
expires the discovery process is terminated without obtaining RapidIO network
information. NOTE: a timed out discovery process may be restarted later using
a user-space command as it is described below (if the given endpoint was
enumerated successfully).

(b) Statically linked enumeration and discovery process can be started by
a command from user space. This initiation method provides more flexibility
for a system startup compared to the option (a) above. After all participating
endpoints have been successfully booted, an enumeration process shall be
started first by issuing a user-space command, after an enumeration is
completed a discovery process can be started on all remaining endpoints.

(c) Modular enumeration and discovery process can be started by a command from
user space. After an enumeration/discovery module is loaded, a network scan
process can be started by issuing a user-space command.
Similar to the option (b) above, an enumerator has to be started first.

(d) Modular enumeration and discovery process can be started by a module
initialization routine. In this case an enumerating module shall be loaded
first.
”h]”(h¸)”}”(hXÆ  (a) Statically linked enumeration and discovery process can be started
automatically during kernel initialization time using corresponding module
parameters. This was the original method used since introduction of RapidIO
subsystem. Now this method relies on enumerator module parameter which is
'rio-scan.scan' for existing basic enumeration/discovery method.
When automatic start of enumeration/discovery is used a user has to ensure
that all discovering endpoints are started before the enumerating endpoint
and are waiting for enumeration to be completed.
Configuration option CONFIG_RAPIDIO_DISC_TIMEOUT defines time that discovering
endpoint waits for enumeration to be completed. If the specified timeout
expires the discovery process is terminated without obtaining RapidIO network
information. NOTE: a timed out discovery process may be restarted later using
a user-space command as it is described below (if the given endpoint was
enumerated successfully).”h]”hXÊ  (a) Statically linked enumeration and discovery process can be started
automatically during kernel initialization time using corresponding module
parameters. This was the original method used since introduction of RapidIO
subsystem. Now this method relies on enumerator module parameter which is
â€˜rio-scan.scanâ€™ for existing basic enumeration/discovery method.
When automatic start of enumeration/discovery is used a user has to ensure
that all discovering endpoints are started before the enumerating endpoint
and are waiting for enumeration to be completed.
Configuration option CONFIG_RAPIDIO_DISC_TIMEOUT defines time that discovering
endpoint waits for enumeration to be completed. If the specified timeout
expires the discovery process is terminated without obtaining RapidIO network
information. NOTE: a timed out discovery process may be restarted later using
a user-space command as it is described below (if the given endpoint was
enumerated successfully).”…””}”(hj¾  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K€hjº  ubh¸)”}”(hX½  (b) Statically linked enumeration and discovery process can be started by
a command from user space. This initiation method provides more flexibility
for a system startup compared to the option (a) above. After all participating
endpoints have been successfully booted, an enumeration process shall be
started first by issuing a user-space command, after an enumeration is
completed a discovery process can be started on all remaining endpoints.”h]”hX½  (b) Statically linked enumeration and discovery process can be started by
a command from user space. This initiation method provides more flexibility
for a system startup compared to the option (a) above. After all participating
endpoints have been successfully booted, an enumeration process shall be
started first by issuing a user-space command, after an enumeration is
completed a discovery process can be started on all remaining endpoints.”…””}”(hjÌ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khjº  ubh¸)”}”(hX  (c) Modular enumeration and discovery process can be started by a command from
user space. After an enumeration/discovery module is loaded, a network scan
process can be started by issuing a user-space command.
Similar to the option (b) above, an enumerator has to be started first.”h]”hX  (c) Modular enumeration and discovery process can be started by a command from
user space. After an enumeration/discovery module is loaded, a network scan
process can be started by issuing a user-space command.
Similar to the option (b) above, an enumerator has to be started first.”…””}”(hjÚ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K–hjº  ubh¸)”}”(hŒš(d) Modular enumeration and discovery process can be started by a module
initialization routine. In this case an enumerating module shall be loaded
first.”h]”hŒš(d) Modular enumeration and discovery process can be started by a module
initialization routine. In this case an enumerating module shall be loaded
first.”…””}”(hjè  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K›hjº  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hŸh¶h K€hj‹  hžhubh¸)”}”(hŒ•When a network scan process is started it calls an enumeration or discovery
routine depending on the configured role of a master port: host or agent.”h]”hŒ•When a network scan process is started it calls an enumeration or discovery
routine depending on the configured role of a master port: host or agent.”…””}”(hjü  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KŸhj‹  hžhubh¸)”}”(hX  Enumeration is performed by a master port if it is configured as a host port by
assigning a host destination ID greater than or equal to zero. The host
destination ID can be assigned to a master port using various methods depending
on RapidIO subsystem build configuration:”h]”hX  Enumeration is performed by a master port if it is configured as a host port by
assigning a host destination ID greater than or equal to zero. The host
destination ID can be assigned to a master port using various methods depending
on RapidIO subsystem build configuration:”…””}”(hj
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K¢hj‹  hžhubj¹  )”}”(hX  (a) For a statically linked RapidIO subsystem core use command line parameter
"rapidio.hdid=" with a list of destination ID assignments in order of mport
device registration. For example, in a system with two RapidIO controllers
the command line parameter "rapidio.hdid=-1,7" will result in assignment of
the host destination ID=7 to the second RapidIO controller, while the first
one will be assigned destination ID=-1.

(b) If the RapidIO subsystem core is built as a loadable module, in addition
to the method shown above, the host destination ID(s) can be specified using
traditional methods of passing module parameter "hdid=" during its loading:

- from command line: "modprobe rapidio hdid=-1,7", or
- from modprobe configuration file using configuration command "options",
  like in this example: "options rapidio hdid=-1,7". An example of modprobe
  configuration file is provided in the section below.
”h]”(h¸)”}”(hX¤  (a) For a statically linked RapidIO subsystem core use command line parameter
"rapidio.hdid=" with a list of destination ID assignments in order of mport
device registration. For example, in a system with two RapidIO controllers
the command line parameter "rapidio.hdid=-1,7" will result in assignment of
the host destination ID=7 to the second RapidIO controller, while the first
one will be assigned destination ID=-1.”h]”hX¬  (a) For a statically linked RapidIO subsystem core use command line parameter
â€œrapidio.hdid=â€ with a list of destination ID assignments in order of mport
device registration. For example, in a system with two RapidIO controllers
the command line parameter â€œrapidio.hdid=-1,7â€ will result in assignment of
the host destination ID=7 to the second RapidIO controller, while the first
one will be assigned destination ID=-1.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K§hj  ubh¸)”}”(hŒå(b) If the RapidIO subsystem core is built as a loadable module, in addition
to the method shown above, the host destination ID(s) can be specified using
traditional methods of passing module parameter "hdid=" during its loading:”h]”hŒé(b) If the RapidIO subsystem core is built as a loadable module, in addition
to the method shown above, the host destination ID(s) can be specified using
traditional methods of passing module parameter â€œhdid=â€ during its loading:”…””}”(hj*  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K®hj  ubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ3from command line: "modprobe rapidio hdid=-1,7", or”h]”h¸)”}”(hjA  h]”hŒ7from command line: â€œmodprobe rapidio hdid=-1,7â€, or”…””}”(hjC  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K²hj?  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j=  hj:  ubj>  )”}”(hŒÇfrom modprobe configuration file using configuration command "options",
like in this example: "options rapidio hdid=-1,7". An example of modprobe
configuration file is provided in the section below.
”h]”h¸)”}”(hŒÆfrom modprobe configuration file using configuration command "options",
like in this example: "options rapidio hdid=-1,7". An example of modprobe
configuration file is provided in the section below.”h]”hŒÎfrom modprobe configuration file using configuration command â€œoptionsâ€,
like in this example: â€œoptions rapidio hdid=-1,7â€. An example of modprobe
configuration file is provided in the section below.”…””}”(hjZ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K³hjV  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j=  hj:  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j8  hŸh¶h K²hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hŸh¶h K§hj‹  hžhubhŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hŒòNOTES:
(i) if "hdid=" parameter is omitted all available mport will be assigned
destination ID = -1;

(ii) the "hdid=" parameter in systems with multiple mports can have
destination ID assignments omitted from the end of list (default = -1).
”h]”(hŒterm”“”)”}”(hŒNOTES:”h]”hŒNOTES:”…””}”(hj‰  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‡  hŸh¶h K¼hjƒ  ubhŒ
definition”“”)”}”(hhh]”(h¸)”}”(hŒ](i) if "hdid=" parameter is omitted all available mport will be assigned
destination ID = -1;”h]”hŒa(i) if â€œhdid=â€ parameter is omitted all available mport will be assigned
destination ID = -1;”…””}”(hjœ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K¸hj™  ubh¸)”}”(hŒ‹(ii) the "hdid=" parameter in systems with multiple mports can have
destination ID assignments omitted from the end of list (default = -1).”h]”hŒ(ii) the â€œhdid=â€ parameter in systems with multiple mports can have
destination ID assignments omitted from the end of list (default = -1).”…””}”(hjª  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K»hj™  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j—  hjƒ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh¶h K¼hj~  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j|  hj‹  hžhhŸh¶h Nubh¸)”}”(hŒnIf the host device ID for a specific master port is set to -1, the discovery
process will be performed for it.”h]”hŒnIf the host device ID for a specific master port is set to -1, the discovery
process will be performed for it.”…””}”(hjÊ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K¾hj‹  hžhubh¸)”}”(hŒyThe enumeration and discovery routines use RapidIO maintenance transactions
to access the configuration space of devices.”h]”hŒyThe enumeration and discovery routines use RapidIO maintenance transactions
to access the configuration space of devices.”…””}”(hjØ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÁhj‹  hžhubh¸)”}”(hX	  NOTE: If RapidIO switch-specific device drivers are built as loadable modules
they must be loaded before enumeration/discovery process starts.
This requirement is cased by the fact that enumeration/discovery methods invoke
vendor-specific callbacks on early stages.”h]”hX	  NOTE: If RapidIO switch-specific device drivers are built as loadable modules
they must be loaded before enumeration/discovery process starts.
This requirement is cased by the fact that enumeration/discovery methods invoke
vendor-specific callbacks on early stages.”…””}”(hjæ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÄhj‹  hžhubeh}”(h]”Œid1”ah ]”h"]”Œ4.1 overview”ah$]”h&]”uh1h¡hjz  hžhhŸh¶h Kuubh¢)”}”(hhh]”(h§)”}”(hŒ04.2 Automatic Start of Enumeration and Discovery”h]”hŒ04.2 Automatic Start of Enumeration and Discovery”…””}”(hjÿ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjü  hžhhŸh¶h KÊubh¸)”}”(hX  Automatic enumeration/discovery start method is applicable only to built-in
enumeration/discovery RapidIO configuration selection. To enable automatic
enumeration/discovery start by existing basic enumerator method set use boot
command line parameter "rio-scan.scan=1".”h]”hX  Automatic enumeration/discovery start method is applicable only to built-in
enumeration/discovery RapidIO configuration selection. To enable automatic
enumeration/discovery start by existing basic enumerator method set use boot
command line parameter â€œrio-scan.scan=1â€.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÌhjü  hžhubh¸)”}”(hX¹  This configuration requires synchronized start of all RapidIO endpoints that
form a network which will be enumerated/discovered. Discovering endpoints have
to be started before an enumeration starts to ensure that all RapidIO
controllers have been initialized and are ready to be discovered. Configuration
parameter CONFIG_RAPIDIO_DISC_TIMEOUT defines time (in seconds) which
a discovering endpoint will wait for enumeration to be completed.”h]”hX¹  This configuration requires synchronized start of all RapidIO endpoints that
form a network which will be enumerated/discovered. Discovering endpoints have
to be started before an enumeration starts to ensure that all RapidIO
controllers have been initialized and are ready to be discovered. Configuration
parameter CONFIG_RAPIDIO_DISC_TIMEOUT defines time (in seconds) which
a discovering endpoint will wait for enumeration to be completed.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÑhjü  hžhubh¸)”}”(hŒ¶When automatic enumeration/discovery start is selected, basic method's
initialization routine calls rio_init_mports() to perform enumeration or
discovery for all known mport devices.”h]”hŒ¸When automatic enumeration/discovery start is selected, basic methodâ€™s
initialization routine calls rio_init_mports() to perform enumeration or
discovery for all known mport devices.”…””}”(hj)  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KØhjü  hžhubh¸)”}”(hŒ½Depending on RapidIO network size and configuration this automatic
enumeration/discovery start method may be difficult to use due to the
requirement for synchronized start of all endpoints.”h]”hŒ½Depending on RapidIO network size and configuration this automatic
enumeration/discovery start method may be difficult to use due to the
requirement for synchronized start of all endpoints.”…””}”(hj7  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÜhjü  hžhubeh}”(h]”Œ,automatic-start-of-enumeration-and-discovery”ah ]”h"]”Œ04.2 automatic start of enumeration and discovery”ah$]”h&]”uh1h¡hjz  hžhhŸh¶h KÊubh¢)”}”(hhh]”(h§)”}”(hŒ14.3 User-space Start of Enumeration and Discovery”h]”hŒ14.3 User-space Start of Enumeration and Discovery”…””}”(hjP  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjM  hžhhŸh¶h Káubh¸)”}”(hXC  User-space start of enumeration and discovery can be used with built-in and
modular build configurations. For user-space controlled start RapidIO subsystem
creates the sysfs write-only attribute file '/sys/bus/rapidio/scan'. To initiate
an enumeration or discovery process on specific mport device, a user needs to
write mport_ID (not RapidIO destination ID) into that file. The mport_ID is a
sequential number (0 ... RIO_MAX_MPORTS) assigned during mport device
registration. For example for machine with single RapidIO controller, mport_ID
for that controller always will be 0.”h]”hXG  User-space start of enumeration and discovery can be used with built-in and
modular build configurations. For user-space controlled start RapidIO subsystem
creates the sysfs write-only attribute file â€˜/sys/bus/rapidio/scanâ€™. To initiate
an enumeration or discovery process on specific mport device, a user needs to
write mport_ID (not RapidIO destination ID) into that file. The mport_ID is a
sequential number (0 ... RIO_MAX_MPORTS) assigned during mport device
registration. For example for machine with single RapidIO controller, mport_ID
for that controller always will be 0.”…””}”(hj^  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KãhjM  hžhubh¸)”}”(hŒˆTo initiate RapidIO enumeration/discovery on all available mports a user may
write '-1' (or RIO_MPORT_ANY) into the scan attribute file.”h]”hŒŒTo initiate RapidIO enumeration/discovery on all available mports a user may
write â€˜-1â€™ (or RIO_MPORT_ANY) into the scan attribute file.”…””}”(hjl  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KìhjM  hžhubeh}”(h]”Œ-user-space-start-of-enumeration-and-discovery”ah ]”h"]”Œ14.3 user-space start of enumeration and discovery”ah$]”h&]”uh1h¡hjz  hžhhŸh¶h Káubh¢)”}”(hhh]”(h§)”}”(hŒ4.4 Basic Enumeration Method”h]”hŒ4.4 Basic Enumeration Method”…””}”(hj…  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj‚  hžhhŸh¶h Kðubh¸)”}”(hX  This is an original enumeration/discovery method which is available since
first release of RapidIO subsystem code. The enumeration process is
implemented according to the enumeration algorithm outlined in the RapidIO
Interconnect Specification: Annex I [1].”h]”hX  This is an original enumeration/discovery method which is available since
first release of RapidIO subsystem code. The enumeration process is
implemented according to the enumeration algorithm outlined in the RapidIO
Interconnect Specification: Annex I [1].”…””}”(hj“  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kòhj‚  hžhubh¸)”}”(hŒÃThis method can be configured as statically linked or loadable module.
The method's single parameter "scan" allows to trigger the enumeration/discovery
process from module initialization routine.”h]”hŒÉThis method can be configured as statically linked or loadable module.
The methodâ€™s single parameter â€œscanâ€ allows to trigger the enumeration/discovery
process from module initialization routine.”…””}”(hj¡  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K÷hj‚  hžhubh¸)”}”(hŒuThis enumeration/discovery method can be started only once and does not support
unloading if it is built as a module.”h]”hŒuThis enumeration/discovery method can be started only once and does not support
unloading if it is built as a module.”…””}”(hj¯  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kûhj‚  hžhubh¸)”}”(hX¹  The enumeration process traverses the network using a recursive depth-first
algorithm. When a new device is found, the enumerator takes ownership of that
device by writing into the Host Device ID Lock CSR. It does this to ensure that
the enumerator has exclusive right to enumerate the device. If device ownership
is successfully acquired, the enumerator allocates a new rio_dev structure and
initializes it according to device capabilities.”h]”hX¹  The enumeration process traverses the network using a recursive depth-first
algorithm. When a new device is found, the enumerator takes ownership of that
device by writing into the Host Device ID Lock CSR. It does this to ensure that
the enumerator has exclusive right to enumerate the device. If device ownership
is successfully acquired, the enumerator allocates a new rio_dev structure and
initializes it according to device capabilities.”…””}”(hj½  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kþhj‚  hžhubh¸)”}”(hŒIf the device is an endpoint, a unique device ID is assigned to it and its value
is written into the device's Base Device ID CSR.”h]”hŒƒIf the device is an endpoint, a unique device ID is assigned to it and its value
is written into the deviceâ€™s Base Device ID CSR.”…””}”(hjË  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mhj‚  hžhubh¸)”}”(hX½  If the device is a switch, the enumerator allocates an additional rio_switch
structure to store switch specific information. Then the switch's vendor ID and
device ID are queried against a table of known RapidIO switches. Each switch
table entry contains a pointer to a switch-specific initialization routine that
initializes pointers to the rest of switch specific operations, and performs
hardware initialization if necessary. A RapidIO switch does not have a unique
device ID; it relies on hopcount and routing for device ID of an attached
endpoint if access to its configuration registers is required. If a switch (or
chain of switches) does not have any endpoint (except enumerator) attached to
it, a fake device ID will be assigned to configure a route to that switch.
In the case of a chain of switches without endpoint, one fake device ID is used
to configure a route through the entire chain and switches are differentiated by
their hopcount value.”h]”hX¿  If the device is a switch, the enumerator allocates an additional rio_switch
structure to store switch specific information. Then the switchâ€™s vendor ID and
device ID are queried against a table of known RapidIO switches. Each switch
table entry contains a pointer to a switch-specific initialization routine that
initializes pointers to the rest of switch specific operations, and performs
hardware initialization if necessary. A RapidIO switch does not have a unique
device ID; it relies on hopcount and routing for device ID of an attached
endpoint if access to its configuration registers is required. If a switch (or
chain of switches) does not have any endpoint (except enumerator) attached to
it, a fake device ID will be assigned to configure a route to that switch.
In the case of a chain of switches without endpoint, one fake device ID is used
to configure a route through the entire chain and switches are differentiated by
their hopcount value.”…””}”(hjÙ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mhj‚  hžhubh¸)”}”(hŒøFor both endpoints and switches the enumerator writes a unique component tag
into device's Component Tag CSR. That unique value is used by the error
management notification mechanism to identify a device that is reporting an
error management event.”h]”hŒúFor both endpoints and switches the enumerator writes a unique component tag
into deviceâ€™s Component Tag CSR. That unique value is used by the error
management notification mechanism to identify a device that is reporting an
error management event.”…””}”(hjç  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mhj‚  hžhubh¸)”}”(hX‚  Enumeration beyond a switch is completed by iterating over each active egress
port of that switch. For each active link, a route to a default device ID
(0xFF for 8-bit systems and 0xFFFF for 16-bit systems) is temporarily written
into the routing table. The algorithm recurs by calling itself with hopcount + 1
and the default device ID in order to access the device on the active port.”h]”hX‚  Enumeration beyond a switch is completed by iterating over each active egress
port of that switch. For each active link, a route to a default device ID
(0xFF for 8-bit systems and 0xFFFF for 16-bit systems) is temporarily written
into the routing table. The algorithm recurs by calling itself with hopcount + 1
and the default device ID in order to access the device on the active port.”…””}”(hjõ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mhj‚  hžhubh¸)”}”(hXS  After the host has completed enumeration of the entire network it releases
devices by clearing device ID locks (calls rio_clear_locks()). For each endpoint
in the system, it sets the Discovered bit in the Port General Control CSR
to indicate that enumeration is completed and agents are allowed to execute
passive discovery of the network.”h]”hXS  After the host has completed enumeration of the entire network it releases
devices by clearing device ID locks (calls rio_clear_locks()). For each endpoint
in the system, it sets the Discovered bit in the Port General Control CSR
to indicate that enumeration is completed and agents are allowed to execute
passive discovery of the network.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h M!hj‚  hžhubh¸)”}”(hX  The discovery process is performed by agents and is similar to the enumeration
process that is described above. However, the discovery process is performed
without changes to the existing routing because agents only gather information
about RapidIO network structure and are building an internal map of discovered
devices. This way each Linux-based component of the RapidIO subsystem has
a complete view of the network. The discovery process can be performed
simultaneously by several agents. After initializing its RapidIO master port
each agent waits for enumeration completion by the host for the configured wait
time period. If this wait time period expires before enumeration is completed,
an agent skips RapidIO discovery and continues with remaining kernel
initialization.”h]”hX  The discovery process is performed by agents and is similar to the enumeration
process that is described above. However, the discovery process is performed
without changes to the existing routing because agents only gather information
about RapidIO network structure and are building an internal map of discovered
devices. This way each Linux-based component of the RapidIO subsystem has
a complete view of the network. The discovery process can be performed
simultaneously by several agents. After initializing its RapidIO master port
each agent waits for enumeration completion by the host for the configured wait
time period. If this wait time period expires before enumeration is completed,
an agent skips RapidIO discovery and continues with remaining kernel
initialization.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h M'hj‚  hžhubeh}”(h]”Œbasic-enumeration-method”ah ]”h"]”Œ4.4 basic enumeration method”ah$]”h&]”uh1h¡hjz  hžhhŸh¶h Kðubh¢)”}”(hhh]”(h§)”}”(hŒ+4.5 Adding New Enumeration/Discovery Method”h]”hŒ+4.5 Adding New Enumeration/Discovery Method”…””}”(hj*  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj'  hžhhŸh¶h M4ubh¸)”}”(hŒªRapidIO subsystem code organization allows addition of new enumeration/discovery
methods as new configuration options without significant impact to the core
RapidIO code.”h]”hŒªRapidIO subsystem code organization allows addition of new enumeration/discovery
methods as new configuration options without significant impact to the core
RapidIO code.”…””}”(hj8  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h M6hj'  hžhubh¸)”}”(hXV  A new enumeration/discovery method has to be attached to one or more mport
devices before an enumeration/discovery process can be started. Normally,
method's module initialization routine calls rio_register_scan() to attach
an enumerator to a specified mport device (or devices). The basic enumerator
implementation demonstrates this process.”h]”hXX  A new enumeration/discovery method has to be attached to one or more mport
devices before an enumeration/discovery process can be started. Normally,
methodâ€™s module initialization routine calls rio_register_scan() to attach
an enumerator to a specified mport device (or devices). The basic enumerator
implementation demonstrates this process.”…””}”(hjF  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h M:hj'  hžhubeh}”(h]”Œ'adding-new-enumeration-discovery-method”ah ]”h"]”Œ+4.5 adding new enumeration/discovery method”ah$]”h&]”uh1h¡hjz  hžhhŸh¶h M4ubh¢)”}”(hhh]”(h§)”}”(hŒ)4.6 Using Loadable RapidIO Switch Drivers”h]”hŒ)4.6 Using Loadable RapidIO Switch Drivers”…””}”(hj_  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj\  hžhhŸh¶h MAubh¸)”}”(hX0  In the case when RapidIO switch drivers are built as loadable modules a user
must ensure that they are loaded before the enumeration/discovery starts.
This process can be automated by specifying pre- or post- dependencies in the
RapidIO-specific modprobe configuration file as shown in the example below.”h]”hX0  In the case when RapidIO switch drivers are built as loadable modules a user
must ensure that they are loaded before the enumeration/discovery starts.
This process can be automated by specifying pre- or post- dependencies in the
RapidIO-specific modprobe configuration file as shown in the example below.”…””}”(hjm  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h MChj\  hžhubh¸)”}”(hŒ#File /etc/modprobe.d/rapidio.conf::”h]”hŒ"File /etc/modprobe.d/rapidio.conf:”…””}”(hj{  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h MHhj\  hžhubhŒliteral_block”“”)”}”(hXª  # Configure RapidIO subsystem modules

# Set enumerator host destination ID (overrides kernel command line option)
options rapidio hdid=-1,2

# Load RapidIO switch drivers immediately after rapidio core module was loaded
softdep rapidio post: idt_gen2 idtcps tsi57x

# OR :

# Load RapidIO switch drivers just before rio-scan enumerator module is loaded
softdep rio-scan pre: idt_gen2 idtcps tsi57x

--------------------------”h]”hXª  # Configure RapidIO subsystem modules

# Set enumerator host destination ID (overrides kernel command line option)
options rapidio hdid=-1,2

# Load RapidIO switch drivers immediately after rapidio core module was loaded
softdep rapidio post: idt_gen2 idtcps tsi57x

# OR :

# Load RapidIO switch drivers just before rio-scan enumerator module is loaded
softdep rio-scan pre: idt_gen2 idtcps tsi57x

--------------------------”…””}”hj‹  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1j‰  hŸh¶h MJhj\  hžhubj}  )”}”(hhh]”j‚  )”}”(hŒNOTE:
In the example above, one of "softdep" commands must be removed or
commented out to keep required module loading sequence.
”h]”(jˆ  )”}”(hŒNOTE:”h]”hŒNOTE:”…””}”(hj¢  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‡  hŸh¶h M[hjž  ubj˜  )”}”(hhh]”h¸)”}”(hŒzIn the example above, one of "softdep" commands must be removed or
commented out to keep required module loading sequence.”h]”hŒ~In the example above, one of â€œsoftdepâ€ commands must be removed or
commented out to keep required module loading sequence.”…””}”(hj³  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h MZhj°  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hjž  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh¶h M[hj›  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j|  hj\  hžhhŸh¶h Nubeh}”(h]”Œ%using-loadable-rapidio-switch-drivers”ah ]”h"]”Œ)4.6 using loadable rapidio switch drivers”ah$]”h&]”uh1h¡hjz  hžhhŸh¶h MAubeh}”(h]”Œenumeration-and-discovery”ah ]”h"]”Œ4. enumeration and discovery”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Krubh¢)”}”(hhh]”(h§)”}”(hŒ5. References”h]”hŒ5. References”…””}”(hjæ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjã  hžhhŸh¶h M^ubj}  )”}”(hhh]”(j‚  )”}”(hŒ\[1] RapidIO Trade Association. RapidIO Interconnect Specifications.
http://www.rapidio.org.
”h]”(jˆ  )”}”(hŒC[1] RapidIO Trade Association. RapidIO Interconnect Specifications.”h]”hŒC[1] RapidIO Trade Association. RapidIO Interconnect Specifications.”…””}”(hjû  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‡  hŸh¶h Mahj÷  ubj˜  )”}”(hhh]”h¸)”}”(hŒhttp://www.rapidio.org.”h]”(hŒ	reference”“”)”}”(hŒhttp://www.rapidio.org”h]”hŒhttp://www.rapidio.org”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j  uh1j  hj  ubhŒ.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mahj	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj÷  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh¶h Mahjô  ubj‚  )”}”(hŒa[2] Rapidio TA. Technology Comparisons.
http://www.rapidio.org/education/technology_comparisons/
”h]”(jˆ  )”}”(hŒ'[2] Rapidio TA. Technology Comparisons.”h]”hŒ'[2] Rapidio TA. Technology Comparisons.”…””}”(hj;  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‡  hŸh¶h Mdhj7  ubj˜  )”}”(hhh]”h¸)”}”(hŒ8http://www.rapidio.org/education/technology_comparisons/”h]”j  )”}”(hjN  h]”hŒ8http://www.rapidio.org/education/technology_comparisons/”…””}”(hjP  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jN  uh1j  hjL  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h MdhjI  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj7  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh¶h Mdhjô  hžhubj‚  )”}”(hŒ@[3] RapidIO support for Linux.
https://lwn.net/Articles/139118/
”h]”(jˆ  )”}”(hŒ[3] RapidIO support for Linux.”h]”hŒ[3] RapidIO support for Linux.”…””}”(hjt  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‡  hŸh¶h Mghjp  ubj˜  )”}”(hhh]”h¸)”}”(hŒ https://lwn.net/Articles/139118/”h]”j  )”}”(hj‡  h]”hŒ https://lwn.net/Articles/139118/”…””}”(hj‰  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j‡  uh1j  hj…  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mghj‚  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hjp  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh¶h Mghjô  hžhubj‚  )”}”(hŒ~[4] Matt Porter. RapidIO for Linux. Ottawa Linux Symposium, 2005
https://www.kernel.org/doc/ols/2005/ols2005v2-pages-43-56.pdf”h]”(jˆ  )”}”(hŒ@[4] Matt Porter. RapidIO for Linux. Ottawa Linux Symposium, 2005”h]”hŒ@[4] Matt Porter. RapidIO for Linux. Ottawa Linux Symposium, 2005”…””}”(hj­  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‡  hŸh¶h Mihj©  ubj˜  )”}”(hhh]”h¸)”}”(hŒ=https://www.kernel.org/doc/ols/2005/ols2005v2-pages-43-56.pdf”h]”j  )”}”(hjÀ  h]”hŒ=https://www.kernel.org/doc/ols/2005/ols2005v2-pages-43-56.pdf”…””}”(hjÂ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jÀ  uh1j  hj¾  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Mjhj»  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj©  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh¶h Mihjô  hžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1j|  hjã  hžhhŸh¶h Nubeh}”(h]”Œ
references”ah ]”h"]”Œ5. references”ah$]”h&]”uh1h¡hh£hžhhŸh¶h M^ubeh}”(h]”Œintroduction”ah ]”h"]”Œintroduction”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h¶uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¦NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h¶Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jõ  jò  j  j  j4  j1  j[  jX  j‚  j  j·  j´  jÞ  jÛ  j  j  j,  j)  jw  jt  jà  jÝ  jù  jö  jJ  jG  j  j|  j$  j!  jY  jV  jØ  jÕ  jí  jê  uŒ	nametypes”}”(jõ  ‰j  ‰j4  ‰j[  ‰j‚  ‰j·  ‰jÞ  ‰j  ‰j,  ‰jw  ‰jà  ‰jù  ‰jJ  ‰j  ‰j$  ‰jY  ‰jØ  ‰jí  ‰uh}”(jò  h£j  hÕj1  j
  jX  j)  j  j^  j´  j…  jÛ  jº  j  já  j)  j  jt  j7  jÝ  jz  jö  j‹  jG  jü  j|  jM  j!  j‚  jV  j'  jÕ  j\  jê  jã  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”j)  Ks…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.