sysfs-bus-rapidio 6.9 KB

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