pciextra.c File Reference

#include <stdint.h>
#include <ipxe/timer.h>
#include <ipxe/pci.h>
#include <ipxe/pcibackup.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static int	pci_find_capability_common (struct pci_device *pci, uint8_t pos, int cap)
int	pci_find_capability (struct pci_device *pci, int cap)
	Look for a PCI capability. More...
int	pci_find_next_capability (struct pci_device *pci, int pos, int cap)
	Look for another PCI capability. More...
unsigned long	pci_bar_size (struct pci_device *pci, unsigned int reg)
	Find the size of a PCI BAR. More...
void	pci_reset (struct pci_device *pci, unsigned int exp)
	Perform PCI Express function-level reset (FLR) More...

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

pci_find_capability_common()

static int pci_find_capability_common ( struct pci_device *  pci, uint8_t  pos, int  cap  )

static

Definition at line 8 of file pciextra.c.

                                                               {
        uint8_t id;
        int ttl = 48;

        while ( ttl-- && pos >= 0x40 ) {
                pos &= ~3;
                pci_read_config_byte ( pci, pos + PCI_CAP_ID, &id );
                DBG ( "PCI Capability: %d\n", id );
                if ( id == 0xff )
                        break;
                if ( id == cap )
                        return pos;
                pci_read_config_byte ( pci, pos + PCI_CAP_NEXT, &pos );
        }
        return 0;
}

References DBG, id, PCI_CAP_ID, PCI_CAP_NEXT, and pci_read_config_byte().

Referenced by pci_find_capability(), and pci_find_next_capability().

pci_find_capability()

int pci_find_capability	(	struct pci_device *	pci,
		int	cap
	)

Look for a PCI capability.

Parameters

pci	PCI device to query
cap	Capability code

Return values

address

Address of capability, or 0 if not found

Determine whether or not a device supports a given PCI capability. Returns the address of the requested capability structure within the device's PCI configuration space, or 0 if the device does not support it.

Definition at line 38 of file pciextra.c.

                                                            {
        uint16_t status;
        uint8_t pos;
        uint8_t hdr_type;

        pci_read_config_word ( pci, PCI_STATUS, &status );
        if ( ! ( status & PCI_STATUS_CAP_LIST ) )
                return 0;

        pci_read_config_byte ( pci, PCI_HEADER_TYPE, &hdr_type );
        switch ( hdr_type & PCI_HEADER_TYPE_MASK ) {
        case PCI_HEADER_TYPE_NORMAL:
        case PCI_HEADER_TYPE_BRIDGE:
        default:
                pci_read_config_byte ( pci, PCI_CAPABILITY_LIST, &pos );
                break;
        case PCI_HEADER_TYPE_CARDBUS:
                pci_read_config_byte ( pci, PCI_CB_CAPABILITY_LIST, &pos );
                break;
        }
        return pci_find_capability_common ( pci, pos, cap );
}

References PCI_CAPABILITY_LIST, PCI_CB_CAPABILITY_LIST, pci_find_capability_common(), PCI_HEADER_TYPE, PCI_HEADER_TYPE_BRIDGE, PCI_HEADER_TYPE_CARDBUS, PCI_HEADER_TYPE_MASK, PCI_HEADER_TYPE_NORMAL, pci_read_config_byte(), pci_read_config_word(), PCI_STATUS, PCI_STATUS_CAP_LIST, and status.

Referenced by ath5k_hw_attach(), ath5k_hw_nic_wakeup(), bnx2_init_board(), ice_probe(), intelxl_probe(), intelxlvf_probe(), myri10ge_pci_probe(), pci_msix_enable(), pci_vpd_init(), pciea_offset(), sky2_reset(), sky2_rx_start(), tg3_get_invariants(), and virtio_pci_find_capability().

pci_find_next_capability()

int pci_find_next_capability	(	struct pci_device *	pci,
		int	pos,
		int	cap
	)

Look for another PCI capability.

Parameters

pci	PCI device to query
pos	Address of the current capability
cap	Capability code

Return values

address

Address of capability, or 0 if not found

Determine whether or not a device supports a given PCI capability starting the search at a given address within the device's PCI configuration space. Returns the address of the next capability structure within the device's PCI configuration space, or 0 if the device does not support another such capability.

Definition at line 75 of file pciextra.c.

                                                                          {
        uint8_t new_pos;

        pci_read_config_byte ( pci, pos + PCI_CAP_NEXT, &new_pos );
        return pci_find_capability_common ( pci, new_pos, cap );
}

References PCI_CAP_NEXT, pci_find_capability_common(), and pci_read_config_byte().

Referenced by virtio_pci_find_capability().

pci_bar_size()

unsigned long pci_bar_size	(	struct pci_device *	pci,
		unsigned int	reg
	)

Find the size of a PCI BAR.

Parameters

pci	PCI device
reg	PCI register number

Return values

size

BAR size

It should not be necessary for any Etherboot code to call this function.

Definition at line 92 of file pciextra.c.

                                                                        {
        uint16_t cmd;
        uint32_t start, size;

        /* Save the original command register */
        pci_read_config_word ( pci, PCI_COMMAND, &cmd );
        /* Save the original bar */
        pci_read_config_dword ( pci, reg, &start );
        /* Compute which bits can be set */
        pci_write_config_dword ( pci, reg, ~0 );
        pci_read_config_dword ( pci, reg, &size );
        /* Restore the original size */
        pci_write_config_dword ( pci, reg, start );
        /* Find the significant bits */
        /* Restore the original command register. This reenables decoding. */
        pci_write_config_word ( pci, PCI_COMMAND, cmd );
        if ( start & PCI_BASE_ADDRESS_SPACE_IO ) {
                size &= ~PCI_BASE_ADDRESS_IO_MASK;
        } else {
                size &= ~PCI_BASE_ADDRESS_MEM_MASK;
        }
        /* Find the lowest bit set */
        size = size & ~( size - 1 );
        return size;
}

References cmd, PCI_BASE_ADDRESS_IO_MASK, PCI_BASE_ADDRESS_MEM_MASK, PCI_BASE_ADDRESS_SPACE_IO, PCI_COMMAND, pci_read_config_dword(), pci_read_config_word(), pci_write_config_dword(), pci_write_config_word(), reg, size, and start.

Referenced by __vxge_hw_device_get_legacy_reg(), amd8111e_probe(), bnxt_pci_base(), efab_probe(), efx_probe(), ehci_probe(), exanic_probe(), forcedeth_map_regs(), gve_probe(), hvm_probe(), igbvf_probe(), phantom_map_crb(), tg3_init_one(), virtio_pci_map_capability(), vxge_probe(), and xhci_probe().

pci_reset()

void pci_reset	(	struct pci_device *	pci,
		unsigned int	exp
	)

Perform PCI Express function-level reset (FLR)

Parameters

pci	PCI device
exp	PCI Express Capability address

Definition at line 124 of file pciextra.c.

                                                            {
        struct pci_config_backup backup;
        uint16_t control;

        /* Back up configuration space */
        pci_backup ( pci, &backup, PCI_CONFIG_BACKUP_STANDARD, NULL );

        /* Perform a PCIe function-level reset */
        pci_read_config_word ( pci, ( exp + PCI_EXP_DEVCTL ), &control );
        control |= PCI_EXP_DEVCTL_FLR;
        pci_write_config_word ( pci, ( exp + PCI_EXP_DEVCTL ), control );

        /* Allow time for reset to complete */
        mdelay ( PCI_EXP_FLR_DELAY_MS );

        /* Restore configuration */
        pci_restore ( pci, &backup, PCI_CONFIG_BACKUP_STANDARD, NULL );
}

References control, mdelay(), NULL, pci_backup(), PCI_CONFIG_BACKUP_STANDARD, PCI_EXP_DEVCTL, PCI_EXP_DEVCTL_FLR, PCI_EXP_FLR_DELAY_MS, pci_read_config_word(), pci_restore(), and pci_write_config_word().

Referenced by ice_probe(), ice_remove(), intelxl_probe(), intelxl_remove(), intelxlvf_probe(), and intelxlvf_remove().