VxWorks API Reference : Driver Libraries

pciConfigShow

NAME

pciConfigShow - Show routines of PCI bus(IO mapped) library

ROUTINES

pciDeviceShow( ) - print information about PCI devices
pciHeaderShow( ) - print a header of the specified PCI device
pciFindDeviceShow( ) - find a device by deviceId, then print an information.
pciFindClassShow( ) - find a device by 24-bit class code
pciConfigStatusWordShow( ) - show the decoded value of the status word
pciConfigCmdWordShow( ) - show the decoded value of the command word
pciConfigFuncShow( ) - show configuration details about a function
pciConfigTopoShow( ) - show PCI topology

DESCRIPTION

This module contains show routines to see all devices and bridges on the PCI bus. This module works in conjunction with pciConfigLib.o. There are two ways to find out an empty device.

-
check Master Abort bit after the access.
-
check whether the read value is 0xffff.

It uses the second method, since I didn't see the Master Abort bit of the host/PCI bridge changing.


Driver Libraries : Routines

pciDeviceShow( )

NAME

pciDeviceShow( ) - print information about PCI devices

SYNOPSIS

STATUS pciDeviceShow
    (
    int busNo                 /* bus number */
    )

DESCRIPTION

This routine prints information about PCI devices There are two ways to find out an empty device.

-
check Master Abort bit after the access.
-
check whether the read value is 0xffff.

It uses the second method, since I didn't see the Master Abort bit of the host/PCI bridge changing.

RETURNS

OK, or ERROR if the library is not initialized.

SEE ALSO

pciConfigShow


Driver Libraries : Routines

pciHeaderShow( )

NAME

pciHeaderShow( ) - print a header of the specified PCI device

SYNOPSIS

STATUS pciHeaderShow
    (
    int busNo,                /* bus number */
    int deviceNo,             /* device number */
    int funcNo                /* function number */
    )

DESCRIPTION

This routine prints a header of the PCI device specified by busNo, deviceNo, and funcNo.

RETURNS

OK, or ERROR if this library is not initialized.

SEE ALSO

pciConfigShow


Driver Libraries : Routines

pciFindDeviceShow( )

NAME

pciFindDeviceShow( ) - find a device by deviceId, then print an information.

SYNOPSIS

STATUS pciFindDeviceShow
    (
    int vendorId,             /* vendor ID */
    int deviceId,             /* device ID */
    int index                 /* desired instance of device */
    )

DESCRIPTION

This routine finds a device by deviceId, then print an information.

RETURNS

OK, or ERROR if this library is not initialized.

SEE ALSO

pciConfigShow


Driver Libraries : Routines

pciFindClassShow( )

NAME

pciFindClassShow( ) - find a device by 24-bit class code

SYNOPSIS

STATUS pciFindClassShow
    (
    int classCode,            /* 24-bit class code */
    int index                 /* desired instance of device */
    )

DESCRIPTION

This routine finds a device by its 24-bit PCI class code, then prints its information.

RETURNS

OK, or ERROR if this library is not initialized.

SEE ALSO

pciConfigShow


Driver Libraries : Routines

pciConfigStatusWordShow( )

NAME

pciConfigStatusWordShow( ) - show the decoded value of the status word

SYNOPSIS

STATUS pciConfigStatusWordShow
    (
    int    bus,               /* bus */
    int    device,            /* device */
    int    function,          /* function */
    void * pArg               /* ignored */
    )

DESCRIPTION

This routine reads the value of the status word for the specified bus,device,function and prints the value in a human-readable format.

RETURNS

OK, always.

SEE ALSO

pciConfigShow


Driver Libraries : Routines

pciConfigCmdWordShow( )

NAME

pciConfigCmdWordShow( ) - show the decoded value of the command word

SYNOPSIS

STATUS pciConfigCmdWordShow
    (
    int    bus,               /* bus */
    int    device,            /* device */
    int    function,          /* function */
    void * pArg               /* ignored */
    )

DESCRIPTION

This routine reads the value of the command word for the specified bus,device,function and prints the value in a human-readable format.

RETURNS

OK, always.

SEE ALSO

pciConfigShow


Driver Libraries : Routines

pciConfigFuncShow( )

NAME

pciConfigFuncShow( ) - show configuration details about a function

SYNOPSIS

STATUS pciConfigFuncShow
    (
    int    bus,               /* bus */
    int    device,            /* device */
    int    function,          /* function */
    void * pArg               /* ignored */
    )

DESCRIPTION

This routine reads various information from the specified bus,device,function, and prints the information in a human-readable format.

RETURNS

OK, always.

SEE ALSO

pciConfigShow


Driver Libraries : Routines

pciConfigTopoShow( )

NAME

pciConfigTopoShow( ) - show PCI topology

SYNOPSIS

void pciConfigTopoShow ()

DESCRIPTION

This routine traverses the PCI bus and prints assorted information about every device found. The information is intended to present the topology of the PCI bus. In includes: (1) the device type, (2) the command and status words, (3) for PCI to PCI bridges the memory and I/O space configuration, and (4) the values of all implemented BARs.

RETURNS

N/A.

SEE ALSO

pciConfigShow