mirror of https://github.com/ipxe/ipxe.git
153 lines
3.7 KiB
C
153 lines
3.7 KiB
C
#ifndef _IPXE_PCI_IO_H
|
|
#define _IPXE_PCI_IO_H
|
|
|
|
/** @file
|
|
*
|
|
* PCI I/O API
|
|
*
|
|
*/
|
|
|
|
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
|
|
|
|
#include <stdint.h>
|
|
#include <ipxe/api.h>
|
|
#include <ipxe/iomap.h>
|
|
#include <config/ioapi.h>
|
|
|
|
struct pci_device;
|
|
|
|
/** A PCI bus:dev.fn address range */
|
|
struct pci_range {
|
|
/** Starting bus:dev.fn address */
|
|
uint32_t start;
|
|
/** Number of bus:dev.fn addresses within this range */
|
|
unsigned int count;
|
|
};
|
|
|
|
#define PCI_BUSDEVFN( segment, bus, slot, func ) \
|
|
( ( (segment) << 16 ) | ( (bus) << 8 ) | \
|
|
( (slot) << 3 ) | ( (func) << 0 ) )
|
|
|
|
/**
|
|
* Calculate static inline PCI I/O API function name
|
|
*
|
|
* @v _prefix Subsystem prefix
|
|
* @v _api_func API function
|
|
* @ret _subsys_func Subsystem API function
|
|
*/
|
|
#define PCIAPI_INLINE( _subsys, _api_func ) \
|
|
SINGLE_API_INLINE ( PCIAPI_PREFIX_ ## _subsys, _api_func )
|
|
|
|
/**
|
|
* Provide a PCI I/O API implementation
|
|
*
|
|
* @v _prefix Subsystem prefix
|
|
* @v _api_func API function
|
|
* @v _func Implementing function
|
|
*/
|
|
#define PROVIDE_PCIAPI( _subsys, _api_func, _func ) \
|
|
PROVIDE_SINGLE_API ( PCIAPI_PREFIX_ ## _subsys, _api_func, _func )
|
|
|
|
/**
|
|
* Provide a static inline PCI I/O API implementation
|
|
*
|
|
* @v _prefix Subsystem prefix
|
|
* @v _api_func API function
|
|
*/
|
|
#define PROVIDE_PCIAPI_INLINE( _subsys, _api_func ) \
|
|
PROVIDE_SINGLE_API_INLINE ( PCIAPI_PREFIX_ ## _subsys, _api_func )
|
|
|
|
/* Include all architecture-independent I/O API headers */
|
|
#include <ipxe/ecam_io.h>
|
|
#include <ipxe/efi/efi_pci_api.h>
|
|
#include <ipxe/linux/linux_pci.h>
|
|
|
|
/* Include all architecture-dependent I/O API headers */
|
|
#include <bits/pci_io.h>
|
|
|
|
/**
|
|
* Find next PCI bus:dev.fn address range in system
|
|
*
|
|
* @v busdevfn Starting PCI bus:dev.fn address
|
|
* @v range PCI bus:dev.fn address range to fill in
|
|
*/
|
|
void pci_discover ( uint32_t busdevfn, struct pci_range *range );
|
|
|
|
/**
|
|
* Read byte from PCI configuration space
|
|
*
|
|
* @v pci PCI device
|
|
* @v where Location within PCI configuration space
|
|
* @v value Value read
|
|
* @ret rc Return status code
|
|
*/
|
|
int pci_read_config_byte ( struct pci_device *pci, unsigned int where,
|
|
uint8_t *value );
|
|
|
|
/**
|
|
* Read 16-bit word from PCI configuration space
|
|
*
|
|
* @v pci PCI device
|
|
* @v where Location within PCI configuration space
|
|
* @v value Value read
|
|
* @ret rc Return status code
|
|
*/
|
|
int pci_read_config_word ( struct pci_device *pci, unsigned int where,
|
|
uint16_t *value );
|
|
|
|
/**
|
|
* Read 32-bit dword from PCI configuration space
|
|
*
|
|
* @v pci PCI device
|
|
* @v where Location within PCI configuration space
|
|
* @v value Value read
|
|
* @ret rc Return status code
|
|
*/
|
|
int pci_read_config_dword ( struct pci_device *pci, unsigned int where,
|
|
uint32_t *value );
|
|
|
|
/**
|
|
* Write byte to PCI configuration space
|
|
*
|
|
* @v pci PCI device
|
|
* @v where Location within PCI configuration space
|
|
* @v value Value to be written
|
|
* @ret rc Return status code
|
|
*/
|
|
int pci_write_config_byte ( struct pci_device *pci, unsigned int where,
|
|
uint8_t value );
|
|
|
|
/**
|
|
* Write 16-bit word to PCI configuration space
|
|
*
|
|
* @v pci PCI device
|
|
* @v where Location within PCI configuration space
|
|
* @v value Value to be written
|
|
* @ret rc Return status code
|
|
*/
|
|
int pci_write_config_word ( struct pci_device *pci, unsigned int where,
|
|
uint16_t value );
|
|
|
|
/**
|
|
* Write 32-bit dword to PCI configuration space
|
|
*
|
|
* @v pci PCI device
|
|
* @v where Location within PCI configuration space
|
|
* @v value Value to be written
|
|
* @ret rc Return status code
|
|
*/
|
|
int pci_write_config_dword ( struct pci_device *pci, unsigned int where,
|
|
uint32_t value );
|
|
|
|
/**
|
|
* Map PCI bus address as an I/O address
|
|
*
|
|
* @v bus_addr PCI bus address
|
|
* @v len Length of region
|
|
* @ret io_addr I/O address, or NULL on error
|
|
*/
|
|
void * pci_ioremap ( struct pci_device *pci, unsigned long bus_addr,
|
|
size_t len );
|
|
|
|
#endif /* _IPXE_PCI_IO_H */
|