202 lines
		
	
	
		
			7.0 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			202 lines
		
	
	
		
			7.0 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
What:		/sys/bus/rapidio/devices/<nn>:<d>:<iiii>
 | 
						|
Description:
 | 
						|
		For each RapidIO device, the RapidIO subsystem creates files in
 | 
						|
		an individual subdirectory with the following name format of
 | 
						|
		device_name "nn:d:iiii", where:
 | 
						|
 | 
						|
		====   ========================================================
 | 
						|
		nn     two-digit hexadecimal ID of RapidIO network where the
 | 
						|
		       device resides
 | 
						|
		d      device type: 'e' - for endpoint or 's' - for switch
 | 
						|
		iiii   four-digit device destID for endpoints, or switchID for
 | 
						|
		       switches
 | 
						|
		====   ========================================================
 | 
						|
 | 
						|
		For example, below is a list of device directories that
 | 
						|
		represents a typical RapidIO network with one switch, one host,
 | 
						|
		and two agent endpoints, as it is seen by the enumerating host
 | 
						|
		(with destID = 1)::
 | 
						|
 | 
						|
		  /sys/bus/rapidio/devices/00:e:0000
 | 
						|
		  /sys/bus/rapidio/devices/00:e:0002
 | 
						|
		  /sys/bus/rapidio/devices/00:s:0001
 | 
						|
 | 
						|
		NOTE:
 | 
						|
		  An enumerating or discovering endpoint does not create a
 | 
						|
		  sysfs entry for itself, this is why an endpoint with destID=1
 | 
						|
		  is not shown in the list.
 | 
						|
 | 
						|
Attributes Common for All RapidIO Devices
 | 
						|
-----------------------------------------
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/did
 | 
						|
Date:		Nov, 2005
 | 
						|
KernelVersion:	v2.6.15
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) returns the device identifier
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/vid
 | 
						|
Date:		Nov, 2005
 | 
						|
KernelVersion:	v2.6.15
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) returns the device vendor identifier
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/device_rev
 | 
						|
Date:		Nov, 2005
 | 
						|
KernelVersion:	v2.6.15
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) returns the device revision level
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_did
 | 
						|
Date:		Nov, 2005
 | 
						|
KernelVersion:	v2.6.15
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) returns identifier for the assembly containing the device
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_rev
 | 
						|
Date:		Nov, 2005
 | 
						|
KernelVersion:	v2.6.15
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) returns revision level of the assembly containing the
 | 
						|
		device
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_vid
 | 
						|
Date:		Nov, 2005
 | 
						|
KernelVersion:	v2.6.15
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) returns vendor identifier of the assembly containing the
 | 
						|
		device
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/destid
 | 
						|
Date:		Mar, 2011
 | 
						|
KernelVersion:	v2.6.3
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) returns device destination ID assigned by the enumeration
 | 
						|
		routine
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/lprev
 | 
						|
Date:		Mar, 2011
 | 
						|
KernelVersion:	v2.6.39
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) returns name of previous device (switch) on the path to the
 | 
						|
		device that that owns this attribute
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/modalias
 | 
						|
Date:		Jul, 2013
 | 
						|
KernelVersion:	v3.11
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) returns the device modalias
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/config
 | 
						|
Date:		Nov, 2005
 | 
						|
KernelVersion:	v2.6.15
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RW) Binary attribute to read from and write to the device
 | 
						|
		configuration registers using the RapidIO maintenance
 | 
						|
		transactions. This attribute is similar in behaviour to the
 | 
						|
		"config" attribute of PCI devices and provides an access to the
 | 
						|
		RapidIO device registers using standard file read and write
 | 
						|
		operations.
 | 
						|
 | 
						|
RapidIO Switch Device Attributes
 | 
						|
--------------------------------
 | 
						|
 | 
						|
RapidIO switches have additional attributes in sysfs. RapidIO subsystem supports
 | 
						|
common and device-specific sysfs attributes for switches. Because switches are
 | 
						|
integrated into the RapidIO subsystem, it offers a method to create
 | 
						|
device-specific sysfs attributes by specifying a callback function that may be
 | 
						|
set by the switch initialization routine during enumeration or discovery
 | 
						|
process.
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/routes
 | 
						|
Date:		Nov, 2005
 | 
						|
KernelVersion:	v2.6.15
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) reports switch routing information in "destID port" format.
 | 
						|
		This attribute reports only valid routing table entries, one
 | 
						|
		line for each entry.
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/destid
 | 
						|
Date:		Mar, 2011
 | 
						|
KernelVersion:	v2.6.3
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) device destination ID of the associated device that defines
 | 
						|
		a route to the switch
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/hopcount
 | 
						|
Date:		Mar, 2011
 | 
						|
KernelVersion:	v2.6.39
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) number of hops on the path to the switch
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/lnext
 | 
						|
Date:		Mar, 2011
 | 
						|
KernelVersion:	v2.6.39
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) returns names of devices linked to the switch except one of
 | 
						|
		a device linked to the ingress port (reported as "lprev"). This
 | 
						|
		is an array names with number of lines equal to number of ports
 | 
						|
		in switch. If a switch port has no attached device, returns
 | 
						|
		"null" instead of a device name.
 | 
						|
 | 
						|
Device-specific Switch Attributes
 | 
						|
---------------------------------
 | 
						|
 | 
						|
IDT_GEN2-
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/errlog
 | 
						|
Date:		Oct, 2010
 | 
						|
KernelVersion:	v2.6.37
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(RO) reads contents of device error log until it is empty.
 | 
						|
 | 
						|
RapidIO Bus Attributes
 | 
						|
----------------------
 | 
						|
 | 
						|
What:		/sys/bus/rapidio/scan
 | 
						|
Date:		May, 2013
 | 
						|
KernelVersion:	v3.11
 | 
						|
Contact:	Matt Porter <mporter@kernel.crashing.org>,
 | 
						|
		Alexandre Bounine <alexandre.bounine@idt.com>
 | 
						|
Description:
 | 
						|
		(WO) Allows to trigger enumeration discovery process from user
 | 
						|
		space. To initiate an enumeration or discovery process on
 | 
						|
		specific mport device, a user needs to write mport_ID (not
 | 
						|
		RapidIO destination ID) into this file. The mport_ID is a
 | 
						|
		sequential number (0 ...  RIO_MAX_MPORTS) assigned to the mport
 | 
						|
		device. For example, for a machine with a single RapidIO
 | 
						|
		controller, mport_ID for that controller always will be 0. To
 | 
						|
		initiate RapidIO enumeration/discovery on all available mports a
 | 
						|
		user must write '-1' (or RIO_MPORT_ANY) into this attribute
 | 
						|
		file.
 |