0,0 → 1,537 |
/* |
* (C) Copyright IBM Corporation 2006 |
* Copyright 2009 Red Hat, Inc. |
* All Rights Reserved. |
* |
* Permission is hereby granted, free of charge, to any person obtaining a |
* copy of this software and associated documentation files (the "Software"), |
* to deal in the Software without restriction, including without limitation |
* on the rights to use, copy, modify, merge, publish, distribute, sub |
* license, and/or sell copies of the Software, and to permit persons to whom |
* the Software is furnished to do so, subject to the following conditions: |
* |
* The above copyright notice and this permission notice (including the next |
* paragraph) shall be included in all copies or substantial portions of the |
* Software. |
* |
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
* FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL |
* IBM AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
* DEALINGS IN THE SOFTWARE. |
*/ |
/* |
* Copyright (c) 2007 Paulo R. Zanoni, Tiago Vignatti |
* |
* Permission is hereby granted, free of charge, to any person |
* obtaining a copy of this software and associated documentation |
* files (the "Software"), to deal in the Software without |
* restriction, including without limitation the rights to use, |
* copy, modify, merge, publish, distribute, sublicense, and/or sell |
* copies of the Software, and to permit persons to whom the |
* Software is furnished to do so, subject to the following |
* conditions: |
* |
* The above copyright notice and this permission notice shall be |
* included in all copies or substantial portions of the Software. |
* |
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, |
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES |
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND |
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT |
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, |
* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR |
* OTHER DEALINGS IN THE SOFTWARE. |
* |
*/ |
|
/** |
* \file pciaccess.h |
* |
* \author Ian Romanick <idr@us.ibm.com> |
*/ |
|
#ifndef PCIACCESS_H |
#define PCIACCESS_H |
|
#include <inttypes.h> |
|
#if __GNUC__ >= 3 |
#define __deprecated __attribute__((deprecated)) |
#else |
#define __deprecated |
#endif |
|
typedef uint64_t pciaddr_t; |
|
struct pci_device; |
struct pci_device_iterator; |
struct pci_id_match; |
struct pci_slot_match; |
|
#ifdef __cplusplus |
extern "C" { |
#endif |
|
int pci_device_has_kernel_driver(struct pci_device *dev); |
|
int pci_device_is_boot_vga(struct pci_device *dev); |
|
int pci_device_read_rom(struct pci_device *dev, void *buffer); |
|
int __deprecated pci_device_map_region(struct pci_device *dev, |
unsigned region, int write_enable); |
|
int __deprecated pci_device_unmap_region(struct pci_device *dev, |
unsigned region); |
|
int pci_device_map_range(struct pci_device *dev, pciaddr_t base, |
pciaddr_t size, unsigned map_flags, void **addr); |
|
int pci_device_unmap_range(struct pci_device *dev, void *memory, |
pciaddr_t size); |
|
int __deprecated pci_device_map_memory_range(struct pci_device *dev, |
pciaddr_t base, pciaddr_t size, int write_enable, void **addr); |
|
int __deprecated pci_device_unmap_memory_range(struct pci_device *dev, |
void *memory, pciaddr_t size); |
|
int pci_device_probe(struct pci_device *dev); |
|
const struct pci_agp_info *pci_device_get_agp_info(struct pci_device *dev); |
|
const struct pci_bridge_info *pci_device_get_bridge_info( |
struct pci_device *dev); |
|
const struct pci_pcmcia_bridge_info *pci_device_get_pcmcia_bridge_info( |
struct pci_device *dev); |
|
int pci_device_get_bridge_buses(struct pci_device *dev, int *primary_bus, |
int *secondary_bus, int *subordinate_bus); |
|
int pci_system_init(void); |
|
void pci_system_init_dev_mem(int fd); |
|
void pci_system_cleanup(void); |
|
struct pci_device_iterator *pci_slot_match_iterator_create( |
const struct pci_slot_match *match); |
|
struct pci_device_iterator *pci_id_match_iterator_create( |
const struct pci_id_match *match); |
|
void pci_iterator_destroy(struct pci_device_iterator *iter); |
|
struct pci_device *pci_device_next(struct pci_device_iterator *iter); |
|
struct pci_device *pci_device_find_by_slot(uint32_t domain, uint32_t bus, |
uint32_t dev, uint32_t func); |
|
struct pci_device *pci_device_get_parent_bridge(struct pci_device *dev); |
|
void pci_get_strings(const struct pci_id_match *m, |
const char **device_name, const char **vendor_name, |
const char **subdevice_name, const char **subvendor_name); |
const char *pci_device_get_device_name(const struct pci_device *dev); |
const char *pci_device_get_subdevice_name(const struct pci_device *dev); |
const char *pci_device_get_vendor_name(const struct pci_device *dev); |
const char *pci_device_get_subvendor_name(const struct pci_device *dev); |
|
void pci_device_enable(struct pci_device *dev); |
|
int pci_device_cfg_read (struct pci_device *dev, void *data, |
pciaddr_t offset, pciaddr_t size, pciaddr_t *bytes_read); |
int pci_device_cfg_read_u8 (struct pci_device *dev, uint8_t *data, |
pciaddr_t offset); |
int pci_device_cfg_read_u16(struct pci_device *dev, uint16_t *data, |
pciaddr_t offset); |
int pci_device_cfg_read_u32(struct pci_device *dev, uint32_t *data, |
pciaddr_t offset); |
|
int pci_device_cfg_write (struct pci_device *dev, const void *data, |
pciaddr_t offset, pciaddr_t size, pciaddr_t *bytes_written); |
int pci_device_cfg_write_u8 (struct pci_device *dev, uint8_t data, |
pciaddr_t offset); |
int pci_device_cfg_write_u16(struct pci_device *dev, uint16_t data, |
pciaddr_t offset); |
int pci_device_cfg_write_u32(struct pci_device *dev, uint32_t data, |
pciaddr_t offset); |
int pci_device_cfg_write_bits(struct pci_device *dev, uint32_t mask, |
uint32_t data, pciaddr_t offset); |
|
#ifdef __cplusplus |
} |
#endif |
|
/** |
* \name Mapping flags passed to \c pci_device_map_range |
*/ |
/*@{*/ |
#define PCI_DEV_MAP_FLAG_WRITABLE (1U<<0) |
#define PCI_DEV_MAP_FLAG_WRITE_COMBINE (1U<<1) |
#define PCI_DEV_MAP_FLAG_CACHABLE (1U<<2) |
/*@}*/ |
|
|
#define PCI_MATCH_ANY (~0) |
|
/** |
* Compare two PCI ID values (either vendor or device). This is used |
* internally to compare the fields of \c pci_id_match to the fields of |
* \c pci_device. |
*/ |
#define PCI_ID_COMPARE(a, b) \ |
(((a) == PCI_MATCH_ANY) || ((a) == (b))) |
|
/** |
*/ |
struct pci_id_match { |
/** |
* \name Device / vendor matching controls |
* |
* Control the search based on the device, vendor, subdevice, or subvendor |
* IDs. Setting any of these fields to \c PCI_MATCH_ANY will cause the |
* field to not be used in the comparison. |
*/ |
/*@{*/ |
uint32_t vendor_id; |
uint32_t device_id; |
uint32_t subvendor_id; |
uint32_t subdevice_id; |
/*@}*/ |
|
|
/** |
* \name Device class matching controls |
* |
*/ |
/*@{*/ |
uint32_t device_class; |
uint32_t device_class_mask; |
/*@}*/ |
|
intptr_t match_data; |
}; |
|
|
/** |
*/ |
struct pci_slot_match { |
/** |
* \name Device slot matching controls |
* |
* Control the search based on the domain, bus, slot, and function of |
* the device. Setting any of these fields to \c PCI_MATCH_ANY will cause |
* the field to not be used in the comparison. |
*/ |
/*@{*/ |
uint32_t domain; |
uint32_t bus; |
uint32_t dev; |
uint32_t func; |
/*@}*/ |
|
intptr_t match_data; |
}; |
|
/** |
* BAR descriptor for a PCI device. |
*/ |
struct pci_mem_region { |
/** |
* When the region is mapped, this is the pointer to the memory. |
* |
* This field is \b only set when the deprecated \c pci_device_map_region |
* interface is used. Use \c pci_device_map_range instead. |
* |
* \deprecated |
*/ |
void *memory; |
|
|
/** |
* Base physical address of the region within its bus / domain. |
* |
* \warning |
* This address is really only useful to other devices in the same |
* domain. It's probably \b not the address applications will ever |
* use. |
* |
* \warning |
* Most (all?) platform back-ends leave this field unset. |
*/ |
pciaddr_t bus_addr; |
|
|
/** |
* Base physical address of the region from the CPU's point of view. |
* |
* This address is typically passed to \c pci_device_map_range to create |
* a mapping of the region to the CPU's virtual address space. |
*/ |
pciaddr_t base_addr; |
|
|
/** |
* Size, in bytes, of the region. |
*/ |
pciaddr_t size; |
|
|
/** |
* Is the region I/O ports or memory? |
*/ |
unsigned is_IO:1; |
|
/** |
* Is the memory region prefetchable? |
* |
* \note |
* This can only be set if \c is_IO is not set. |
*/ |
unsigned is_prefetchable:1; |
|
|
/** |
* Is the memory at a 64-bit address? |
* |
* \note |
* This can only be set if \c is_IO is not set. |
*/ |
unsigned is_64:1; |
}; |
|
|
/** |
* PCI device. |
* |
* Contains all of the information about a particular PCI device. |
*/ |
struct pci_device { |
/** |
* \name Device bus identification. |
* |
* Complete bus identification, including domain, of the device. On |
* platforms that do not support PCI domains (e.g., 32-bit x86 hardware), |
* the domain will always be zero. |
*/ |
/*@{*/ |
uint16_t domain; |
uint8_t bus; |
uint8_t dev; |
uint8_t func; |
/*@}*/ |
|
|
/** |
* \name Vendor / device ID |
* |
* The vendor ID, device ID, and sub-IDs for the device. |
*/ |
/*@{*/ |
uint16_t vendor_id; |
uint16_t device_id; |
uint16_t subvendor_id; |
uint16_t subdevice_id; |
/*@}*/ |
|
/** |
* Device's class, subclass, and programming interface packed into a |
* single 32-bit value. The class is at bits [23:16], subclass is at |
* bits [15:8], and programming interface is at [7:0]. |
*/ |
uint32_t device_class; |
|
|
/** |
* Device revision number, as read from the configuration header. |
*/ |
uint8_t revision; |
|
|
/** |
* BAR descriptors for the device. |
*/ |
struct pci_mem_region regions[6]; |
|
|
/** |
* Size, in bytes, of the device's expansion ROM. |
*/ |
pciaddr_t rom_size; |
|
|
/** |
* IRQ associated with the device. If there is no IRQ, this value will |
* be -1. |
*/ |
int irq; |
|
|
/** |
* Storage for user data. Users of the library can store arbitrary |
* data in this pointer. The library will not use it for any purpose. |
* It is the user's responsability to free this memory before destroying |
* the \c pci_device structure. |
*/ |
intptr_t user_data; |
|
/** |
* Used by the VGA arbiter. Type of resource decoded by the device and |
* the file descriptor (/dev/vga_arbiter). */ |
int vgaarb_rsrc; |
}; |
|
|
/** |
* Description of the AGP capability of the device. |
* |
* \sa pci_device_get_agp_info |
*/ |
struct pci_agp_info { |
/** |
* Offset of the AGP registers in the devices configuration register |
* space. This is generally used so that the offset of the AGP command |
* register can be determined. |
*/ |
unsigned config_offset; |
|
|
/** |
* \name AGP major / minor version. |
*/ |
/*@{*/ |
uint8_t major_version; |
uint8_t minor_version; |
/*@}*/ |
|
/** |
* Logical OR of the supported AGP rates. For example, a value of 0x07 |
* means that the device can support 1x, 2x, and 4x. A value of 0x0c |
* means that the device can support 8x and 4x. |
*/ |
uint8_t rates; |
|
unsigned int fast_writes:1; /**< Are fast-writes supported? */ |
unsigned int addr64:1; |
unsigned int htrans:1; |
unsigned int gart64:1; |
unsigned int coherent:1; |
unsigned int sideband:1; /**< Is side-band addressing supported? */ |
unsigned int isochronus:1; |
|
uint8_t async_req_size; |
uint8_t calibration_cycle_timing; |
uint8_t max_requests; |
}; |
|
/** |
* Description of a PCI-to-PCI bridge device. |
* |
* \sa pci_device_get_bridge_info |
*/ |
struct pci_bridge_info { |
uint8_t primary_bus; |
uint8_t secondary_bus; |
uint8_t subordinate_bus; |
uint8_t secondary_latency_timer; |
|
uint8_t io_type; |
uint8_t mem_type; |
uint8_t prefetch_mem_type; |
|
uint16_t secondary_status; |
uint16_t bridge_control; |
|
uint32_t io_base; |
uint32_t io_limit; |
|
uint32_t mem_base; |
uint32_t mem_limit; |
|
uint64_t prefetch_mem_base; |
uint64_t prefetch_mem_limit; |
}; |
|
/** |
* Description of a PCI-to-PCMCIA bridge device. |
* |
* \sa pci_device_get_pcmcia_bridge_info |
*/ |
struct pci_pcmcia_bridge_info { |
uint8_t primary_bus; |
uint8_t card_bus; |
uint8_t subordinate_bus; |
uint8_t cardbus_latency_timer; |
|
uint16_t secondary_status; |
uint16_t bridge_control; |
|
struct { |
uint32_t base; |
uint32_t limit; |
} io[2]; |
|
struct { |
uint32_t base; |
uint32_t limit; |
} mem[2]; |
|
}; |
|
|
/** |
* VGA Arbiter definitions, functions and related. |
*/ |
|
/* Legacy VGA regions */ |
#define VGA_ARB_RSRC_NONE 0x00 |
#define VGA_ARB_RSRC_LEGACY_IO 0x01 |
#define VGA_ARB_RSRC_LEGACY_MEM 0x02 |
/* Non-legacy access */ |
#define VGA_ARB_RSRC_NORMAL_IO 0x04 |
#define VGA_ARB_RSRC_NORMAL_MEM 0x08 |
|
int pci_device_vgaarb_init (void); |
void pci_device_vgaarb_fini (void); |
int pci_device_vgaarb_set_target (struct pci_device *dev); |
/* use the targetted device */ |
int pci_device_vgaarb_decodes (int new_vga_rsrc); |
int pci_device_vgaarb_lock (void); |
int pci_device_vgaarb_trylock (void); |
int pci_device_vgaarb_unlock (void); |
/* return the current device count + resource decodes for the device */ |
int pci_device_vgaarb_get_info (struct pci_device *dev, int *vga_count, int *rsrc_decodes); |
|
/* |
* I/O space access. |
*/ |
|
struct pci_io_handle; |
|
struct pci_io_handle *pci_device_open_io(struct pci_device *dev, pciaddr_t base, |
pciaddr_t size); |
struct pci_io_handle *pci_legacy_open_io(struct pci_device *dev, pciaddr_t base, |
pciaddr_t size); |
void pci_device_close_io(struct pci_device *dev, struct pci_io_handle *handle); |
uint32_t pci_io_read32(struct pci_io_handle *handle, uint32_t reg); |
uint16_t pci_io_read16(struct pci_io_handle *handle, uint32_t reg); |
uint8_t pci_io_read8(struct pci_io_handle *handle, uint32_t reg); |
void pci_io_write32(struct pci_io_handle *handle, uint32_t reg, uint32_t data); |
void pci_io_write16(struct pci_io_handle *handle, uint32_t reg, uint16_t data); |
void pci_io_write8(struct pci_io_handle *handle, uint32_t reg, uint8_t data); |
|
/* |
* Legacy memory access |
*/ |
|
int pci_device_map_legacy(struct pci_device *dev, pciaddr_t base, |
pciaddr_t size, unsigned map_flags, void **addr); |
int pci_device_unmap_legacy(struct pci_device *dev, void *addr, pciaddr_t size); |
|
#endif /* PCIACCESS_H */ |