org.lsst.ccs.drivers.iocard

Class PciCard

java.lang.Object

org.lsst.ccs.drivers.iocard.PciCard

public final class PciCard
extends Object

Represents an I/O card on the PCI/PCIe/MPCIe bus.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PciCard.Error Represents errors that occur when searching for a card or discovering the resources assigned to it.
static class	PciCard.Resource Represents a bus resource allocated to a card.

Method Summary

Modifier and Type	Method and Description
static Optional<PciCard>	fromGeographicAddress(String geo) Reads the "irq" and "resource" files from a directory under /sys/bus/pci/devices.
static Optional<PciCard>	fromVendorId(int vid) Searches the directories under PCI_DEVICES for any one which has a "vendor" file containing the desired vendor ID, then calls fromGeographic().
int	getIrq() Gets the IRQ assigned to the card.
List<PciCard.Resource>	getResources()
static void	main(String[] arg) Prints the information about two PCI/PCIe/mPCIe devices.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

getResources

public List<PciCard.Resource> getResources()

getIrq

public int getIrq()

Gets the IRQ assigned to the card.

fromGeographicAddress

public static Optional<PciCard> fromGeographicAddress(String geo)

Reads the "irq" and "resource" files from a directory under /sys/bus/pci/devices. Each directory name is a geographic address domain:bus:device.function, e.g., 0000:02:05.0.

Parameters:

geo - A geographic address that must exactly match the name of a device directory.

Returns:

An Optional which if nonempty contains the device info. If empty then the requested device was not found.

fromVendorId

public static Optional<PciCard> fromVendorId(int vid)

Searches the directories under PCI_DEVICES for any one which has a "vendor" file containing the desired vendor ID, then calls fromGeographic(). There is no guaranteed search order.

Returns:

An Optional which if nonempty contains the device info. If empty then the no matching device.

toString

public String toString()

Overrides:

toString in class Object

main

public static void main(String[] arg)

Prints the information about two PCI/PCIe/mPCIe devices.

Parameters:

arg - The first element is the geographic address string of the first device. The second element is a vendor ID number.