| 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. |
