pcicloud.c File Reference

Cloud VM PCI configuration space access. More...

#include <stdint.h>
#include <ipxe/init.h>
#include <ipxe/pci.h>
#include <ipxe/ecam.h>
#include <ipxe/pcibios.h>
#include <ipxe/pcidirect.h>
#include <ipxe/pcicloud.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static void	pcicloud_discover (uint32_t busdevfn, struct pci_range *range)
	Find next PCI bus:dev.fn address range in system. More...
static int	pcicloud_read_config_byte (struct pci_device *pci, unsigned int where, uint8_t *value)
	Read byte from PCI configuration space. More...
static int	pcicloud_read_config_word (struct pci_device *pci, unsigned int where, uint16_t *value)
	Read 16-bit word from PCI configuration space. More...
static int	pcicloud_read_config_dword (struct pci_device *pci, unsigned int where, uint32_t *value)
	Read 32-bit dword from PCI configuration space. More...
static int	pcicloud_write_config_byte (struct pci_device *pci, unsigned int where, uint8_t value)
	Write byte to PCI configuration space. More...
static int	pcicloud_write_config_word (struct pci_device *pci, unsigned int where, uint16_t value)
	Write 16-bit word to PCI configuration space. More...
static int	pcicloud_write_config_dword (struct pci_device *pci, unsigned int where, uint32_t value)
	Write 32-bit dword to PCI configuration space. More...
static void *	pcicloud_ioremap (struct pci_device *pci, unsigned long bus_addr, size_t len)
	Map PCI bus address as an I/O address. More...
	PROVIDE_PCIAPI (cloud, pci_discover, pcicloud_discover)
	PROVIDE_PCIAPI (cloud, pci_read_config_byte, pcicloud_read_config_byte)
	PROVIDE_PCIAPI (cloud, pci_read_config_word, pcicloud_read_config_word)
	PROVIDE_PCIAPI (cloud, pci_read_config_dword, pcicloud_read_config_dword)
	PROVIDE_PCIAPI (cloud, pci_write_config_byte, pcicloud_write_config_byte)
	PROVIDE_PCIAPI (cloud, pci_write_config_word, pcicloud_write_config_word)
	PROVIDE_PCIAPI (cloud, pci_write_config_dword, pcicloud_write_config_dword)
	PROVIDE_PCIAPI (cloud, pci_ioremap, pcicloud_ioremap)
static void	pcicloud_init (void)
	Initialise cloud VM PCI configuration space access. More...
struct init_fn pcicloud_init_fn	__init_fn (INIT_EARLY)
	Cloud VM PCI configuration space access initialisation function. More...

Variables
static struct pci_api *	pcicloud = &ecam_api
	Selected PCI configuration space access API. More...

Detailed Description

Cloud VM PCI configuration space access.

Definition in file pcicloud.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

pcicloud_discover()

static void pcicloud_discover ( uint32_t  busdevfn, struct pci_range *  range  )

static

Find next PCI bus:dev.fn address range in system.

Parameters

busdevfn	Starting PCI bus:dev.fn address
range	PCI bus:dev.fn address range to fill in

Definition at line 49 of file pcicloud.c.

                                                                             {

        pcicloud->pci_discover ( busdevfn, range );
}

References busdevfn, pci_api::pci_discover, pcicloud, and range.

pcicloud_read_config_byte()

static int pcicloud_read_config_byte ( struct pci_device *  pci, unsigned int  where, uint8_t *  value  )

static

Read byte from PCI configuration space.

Parameters

pci	PCI device
where	Location within PCI configuration space
value	Value read

Return values

rc	Return status code

Definition at line 62 of file pcicloud.c.

                                                                            {

        return pcicloud->pci_read_config_byte ( pci, where, value );
}

References pci_api::pci_read_config_byte, pcicloud, value, and where.

pcicloud_read_config_word()

static int pcicloud_read_config_word ( struct pci_device *  pci, unsigned int  where, uint16_t *  value  )

static

Read 16-bit word from PCI configuration space.

Parameters

pci	PCI device
where	Location within PCI configuration space
value	Value read

Return values

rc	Return status code

Definition at line 76 of file pcicloud.c.

                                                                             {

        return pcicloud->pci_read_config_word ( pci, where, value );
}

References pci_api::pci_read_config_word, pcicloud, value, and where.

pcicloud_read_config_dword()

static int pcicloud_read_config_dword ( struct pci_device *  pci, unsigned int  where, uint32_t *  value  )

static

Read 32-bit dword from PCI configuration space.

Parameters

pci	PCI device
where	Location within PCI configuration space
value	Value read

Return values

rc	Return status code

Definition at line 90 of file pcicloud.c.

                                                                              {

        return pcicloud->pci_read_config_dword ( pci, where, value );
}

References pci_api::pci_read_config_dword, pcicloud, value, and where.

pcicloud_write_config_byte()

static int pcicloud_write_config_byte ( struct pci_device *  pci, unsigned int  where, uint8_t  value  )

static

Write byte to PCI configuration space.

Parameters

pci	PCI device
where	Location within PCI configuration space
value	Value to be written

Return values

rc	Return status code

Definition at line 104 of file pcicloud.c.

                                                                            {

        return pcicloud->pci_write_config_byte ( pci, where, value );
}

References pci_api::pci_write_config_byte, pcicloud, value, and where.

pcicloud_write_config_word()

static int pcicloud_write_config_word ( struct pci_device *  pci, unsigned int  where, uint16_t  value  )

static

Write 16-bit word to PCI configuration space.

Parameters

pci	PCI device
where	Location within PCI configuration space
value	Value to be written

Return values

rc	Return status code

Definition at line 118 of file pcicloud.c.

                                                                             {

        return pcicloud->pci_write_config_word ( pci, where, value );
}

References pci_api::pci_write_config_word, pcicloud, value, and where.

pcicloud_write_config_dword()

static int pcicloud_write_config_dword ( struct pci_device *  pci, unsigned int  where, uint32_t  value  )

static

Write 32-bit dword to PCI configuration space.

Parameters

pci	PCI device
where	Location within PCI configuration space
value	Value to be written

Return values

rc	Return status code

Definition at line 132 of file pcicloud.c.

                                                                              {

        return pcicloud->pci_write_config_dword ( pci, where, value );
}

References pci_api::pci_write_config_dword, pcicloud, value, and where.

pcicloud_ioremap()

static void* pcicloud_ioremap ( struct pci_device *  pci, unsigned long  bus_addr, size_t  len  )

static

Map PCI bus address as an I/O address.

Parameters

bus_addr	PCI bus address
len	Length of region

Return values

io_addr

I/O address, or NULL on error

Definition at line 145 of file pcicloud.c.

                                                                      {

        return pcicloud->pci_ioremap ( pci, bus_addr, len );
}

References bus_addr, len, pci_api::pci_ioremap, and pcicloud.

PROVIDE_PCIAPI() [1/8]

PROVIDE_PCIAPI	(	cloud	,
		pci_discover	,
		pcicloud_discover
	)

PROVIDE_PCIAPI() [2/8]

PROVIDE_PCIAPI	(	cloud	,
		pci_read_config_byte	,
		pcicloud_read_config_byte
	)

PROVIDE_PCIAPI() [3/8]

PROVIDE_PCIAPI	(	cloud	,
		pci_read_config_word	,
		pcicloud_read_config_word
	)

PROVIDE_PCIAPI() [4/8]

PROVIDE_PCIAPI	(	cloud	,
		pci_read_config_dword	,
		pcicloud_read_config_dword
	)

PROVIDE_PCIAPI() [5/8]

PROVIDE_PCIAPI	(	cloud	,
		pci_write_config_byte	,
		pcicloud_write_config_byte
	)

PROVIDE_PCIAPI() [6/8]

PROVIDE_PCIAPI	(	cloud	,
		pci_write_config_word	,
		pcicloud_write_config_word
	)

PROVIDE_PCIAPI() [7/8]

PROVIDE_PCIAPI	(	cloud	,
		pci_write_config_dword	,
		pcicloud_write_config_dword
	)

PROVIDE_PCIAPI() [8/8]

PROVIDE_PCIAPI	(	cloud	,
		pci_ioremap	,
		pcicloud_ioremap
	)

pcicloud_init()

static void pcicloud_init ( void  )

static

Initialise cloud VM PCI configuration space access.

Definition at line 164 of file pcicloud.c.

                                   {
        static struct pci_api *apis[] = {
                &ecam_api, &pcibios_api, &pcidirect_api
        };
        struct pci_device pci;
        uint32_t busdevfn;
        unsigned int i;
        int rc;

        /* Select first API that successfully discovers a PCI device */
        for ( i = 0 ; i < ( sizeof ( apis ) / sizeof ( apis[0] ) ) ; i++ ) {
                pcicloud = apis[i];
                busdevfn = 0;
                if ( ( rc = pci_find_next ( &pci, &busdevfn ) ) == 0 ) {
                        DBGC ( pcicloud, "PCICLOUD selected %s API (found "
                               PCI_FMT ")\n", pcicloud->name,
                               PCI_ARGS ( &pci ) );
                        return;
                }
        }

        /* Fall back to using final attempted API if no devices found */
        pcicloud = apis[ i - 1 ];
        DBGC ( pcicloud, "PCICLOUD selected %s API (nothing detected)\n",
               pcicloud->name );
}

References busdevfn, DBGC, ecam_api, pci_api::name, PCI_ARGS, pci_find_next(), PCI_FMT, pcibios_api, pcicloud, pcidirect_api, and rc.

__init_fn()

struct init_fn pcicloud_init_fn __init_fn

(

INIT_EARLY

)

Cloud VM PCI configuration space access initialisation function.

Variable Documentation

pcicloud

struct pci_api* pcicloud = &ecam_api

static

Selected PCI configuration space access API.

Definition at line 41 of file pcicloud.c.

Referenced by pcicloud_discover(), pcicloud_init(), pcicloud_ioremap(), pcicloud_read_config_byte(), pcicloud_read_config_dword(), pcicloud_read_config_word(), pcicloud_write_config_byte(), pcicloud_write_config_dword(), and pcicloud_write_config_word().