Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* |
| 2 | * pci.h |
| 3 | * |
| 4 | * PCI defines and function prototypes |
| 5 | * Copyright 1994, Drew Eckhardt |
| 6 | * Copyright 1997--1999 Martin Mares <mj@ucw.cz> |
| 7 | * |
| 8 | * For more information, please consult the following manuals (look at |
| 9 | * http://www.pcisig.com/ for how to get them): |
| 10 | * |
| 11 | * PCI BIOS Specification |
| 12 | * PCI Local Bus Specification |
| 13 | * PCI to PCI Bridge Specification |
| 14 | * PCI System Design Guide |
| 15 | */ |
| 16 | |
| 17 | #ifndef LINUX_PCI_H |
| 18 | #define LINUX_PCI_H |
| 19 | |
Greg Kroah-Hartman | 4352dfd | 2005-07-28 11:37:33 -0700 | [diff] [blame] | 20 | /* Include the pci register defines */ |
| 21 | #include <linux/pci_regs.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 22 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 23 | /* |
| 24 | * The PCI interface treats multi-function devices as independent |
| 25 | * devices. The slot/function address of each device is encoded |
| 26 | * in a single byte as follows: |
| 27 | * |
| 28 | * 7:3 = slot |
| 29 | * 2:0 = function |
| 30 | */ |
| 31 | #define PCI_DEVFN(slot,func) ((((slot) & 0x1f) << 3) | ((func) & 0x07)) |
| 32 | #define PCI_SLOT(devfn) (((devfn) >> 3) & 0x1f) |
| 33 | #define PCI_FUNC(devfn) ((devfn) & 0x07) |
| 34 | |
| 35 | /* Ioctls for /proc/bus/pci/X/Y nodes. */ |
| 36 | #define PCIIOC_BASE ('P' << 24 | 'C' << 16 | 'I' << 8) |
| 37 | #define PCIIOC_CONTROLLER (PCIIOC_BASE | 0x00) /* Get controller for PCI device. */ |
| 38 | #define PCIIOC_MMAP_IS_IO (PCIIOC_BASE | 0x01) /* Set mmap state to I/O space. */ |
| 39 | #define PCIIOC_MMAP_IS_MEM (PCIIOC_BASE | 0x02) /* Set mmap state to MEM space. */ |
| 40 | #define PCIIOC_WRITE_COMBINE (PCIIOC_BASE | 0x03) /* Enable/disable write-combining. */ |
| 41 | |
| 42 | #ifdef __KERNEL__ |
| 43 | |
David Woodhouse | 778382e | 2006-04-29 01:46:02 +0100 | [diff] [blame] | 44 | #include <linux/mod_devicetable.h> |
| 45 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 46 | #include <linux/types.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 47 | #include <linux/ioport.h> |
| 48 | #include <linux/list.h> |
Andrew Morton | 4a7fb63 | 2006-08-14 22:43:17 -0700 | [diff] [blame] | 49 | #include <linux/compiler.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 50 | #include <linux/errno.h> |
Inaky Perez-Gonzalez | bae94d0 | 2006-11-22 12:40:31 -0800 | [diff] [blame] | 51 | #include <asm/atomic.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 52 | #include <linux/device.h> |
| 53 | |
Adrian Bunk | 7e7a43c | 2006-12-19 13:12:07 -0800 | [diff] [blame] | 54 | /* Include the ID list */ |
| 55 | #include <linux/pci_ids.h> |
| 56 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 57 | /* File state for mmap()s on /proc/bus/pci/X/Y */ |
| 58 | enum pci_mmap_state { |
| 59 | pci_mmap_io, |
| 60 | pci_mmap_mem |
| 61 | }; |
| 62 | |
| 63 | /* This defines the direction arg to the DMA mapping routines. */ |
| 64 | #define PCI_DMA_BIDIRECTIONAL 0 |
| 65 | #define PCI_DMA_TODEVICE 1 |
| 66 | #define PCI_DMA_FROMDEVICE 2 |
| 67 | #define PCI_DMA_NONE 3 |
| 68 | |
| 69 | #define DEVICE_COUNT_COMPATIBLE 4 |
| 70 | #define DEVICE_COUNT_RESOURCE 12 |
| 71 | |
| 72 | typedef int __bitwise pci_power_t; |
| 73 | |
Greg Kroah-Hartman | 4352dfd | 2005-07-28 11:37:33 -0700 | [diff] [blame] | 74 | #define PCI_D0 ((pci_power_t __force) 0) |
| 75 | #define PCI_D1 ((pci_power_t __force) 1) |
| 76 | #define PCI_D2 ((pci_power_t __force) 2) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 77 | #define PCI_D3hot ((pci_power_t __force) 3) |
| 78 | #define PCI_D3cold ((pci_power_t __force) 4) |
Daniel Ritz | 3fe9d19 | 2005-08-17 15:32:19 -0700 | [diff] [blame] | 79 | #define PCI_UNKNOWN ((pci_power_t __force) 5) |
Pavel Machek | 438510f | 2005-04-16 15:25:24 -0700 | [diff] [blame] | 80 | #define PCI_POWER_ERROR ((pci_power_t __force) -1) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 81 | |
linas | 392a1ce | 2005-11-16 17:10:41 -0600 | [diff] [blame] | 82 | /** The pci_channel state describes connectivity between the CPU and |
| 83 | * the pci device. If some PCI bus between here and the pci device |
| 84 | * has crashed or locked up, this info is reflected here. |
| 85 | */ |
| 86 | typedef unsigned int __bitwise pci_channel_state_t; |
| 87 | |
| 88 | enum pci_channel_state { |
| 89 | /* I/O channel is in normal state */ |
| 90 | pci_channel_io_normal = (__force pci_channel_state_t) 1, |
| 91 | |
| 92 | /* I/O to channel is blocked */ |
| 93 | pci_channel_io_frozen = (__force pci_channel_state_t) 2, |
| 94 | |
| 95 | /* PCI card is dead */ |
| 96 | pci_channel_io_perm_failure = (__force pci_channel_state_t) 3, |
| 97 | }; |
| 98 | |
Brian King | f7bdd12 | 2007-04-06 16:39:36 -0500 | [diff] [blame] | 99 | typedef unsigned int __bitwise pcie_reset_state_t; |
| 100 | |
| 101 | enum pcie_reset_state { |
| 102 | /* Reset is NOT asserted (Use to deassert reset) */ |
| 103 | pcie_deassert_reset = (__force pcie_reset_state_t) 1, |
| 104 | |
| 105 | /* Use #PERST to reset PCI-E device */ |
| 106 | pcie_warm_reset = (__force pcie_reset_state_t) 2, |
| 107 | |
| 108 | /* Use PCI-E Hot Reset to reset device */ |
| 109 | pcie_hot_reset = (__force pcie_reset_state_t) 3 |
| 110 | }; |
| 111 | |
Michael S. Tsirkin | 6e325a6 | 2006-02-14 18:52:22 +0200 | [diff] [blame] | 112 | typedef unsigned short __bitwise pci_bus_flags_t; |
| 113 | enum pci_bus_flags { |
Roland Dreier | e778272 | 2006-03-30 12:55:10 -0800 | [diff] [blame] | 114 | PCI_BUS_FLAGS_NO_MSI = (__force pci_bus_flags_t) 1, |
Michael S. Tsirkin | 6e325a6 | 2006-02-14 18:52:22 +0200 | [diff] [blame] | 115 | }; |
| 116 | |
Shaohua Li | 41017f0 | 2006-02-08 17:11:38 +0800 | [diff] [blame] | 117 | struct pci_cap_saved_state { |
| 118 | struct hlist_node next; |
| 119 | char cap_nr; |
| 120 | u32 data[0]; |
| 121 | }; |
| 122 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 123 | /* |
| 124 | * The pci_dev structure is used to describe PCI devices. |
| 125 | */ |
| 126 | struct pci_dev { |
| 127 | struct list_head global_list; /* node in list of all PCI devices */ |
| 128 | struct list_head bus_list; /* node in per-bus list */ |
| 129 | struct pci_bus *bus; /* bus this device is on */ |
| 130 | struct pci_bus *subordinate; /* bus this device bridges to */ |
| 131 | |
| 132 | void *sysdata; /* hook for sys-specific extension */ |
| 133 | struct proc_dir_entry *procent; /* device entry in /proc/bus/pci */ |
| 134 | |
| 135 | unsigned int devfn; /* encoded device & function index */ |
| 136 | unsigned short vendor; |
| 137 | unsigned short device; |
| 138 | unsigned short subsystem_vendor; |
| 139 | unsigned short subsystem_device; |
| 140 | unsigned int class; /* 3 bytes: (base,sub,prog-if) */ |
| 141 | u8 hdr_type; /* PCI header type (`multi' flag masked out) */ |
| 142 | u8 rom_base_reg; /* which config register controls the ROM */ |
Kristen Accardi | ffeff78 | 2005-11-02 16:24:32 -0800 | [diff] [blame] | 143 | u8 pin; /* which interrupt pin this device uses */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 144 | |
| 145 | struct pci_driver *driver; /* which driver has allocated this device */ |
| 146 | u64 dma_mask; /* Mask of the bits of bus address this |
| 147 | device implements. Normally this is |
| 148 | 0xffffffff. You only need to change |
| 149 | this if your device has broken DMA |
| 150 | or supports 64-bit transfers. */ |
| 151 | |
| 152 | pci_power_t current_state; /* Current operating state. In ACPI-speak, |
| 153 | this is D0-D3, D0 being fully functional, |
| 154 | and D3 being off. */ |
| 155 | |
linas | 392a1ce | 2005-11-16 17:10:41 -0600 | [diff] [blame] | 156 | pci_channel_state_t error_state; /* current connectivity state */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 157 | struct device dev; /* Generic device interface */ |
| 158 | |
| 159 | /* device is compatible with these IDs */ |
| 160 | unsigned short vendor_compatible[DEVICE_COUNT_COMPATIBLE]; |
| 161 | unsigned short device_compatible[DEVICE_COUNT_COMPATIBLE]; |
| 162 | |
| 163 | int cfg_size; /* Size of configuration space */ |
| 164 | |
| 165 | /* |
| 166 | * Instead of touching interrupt line and base address registers |
| 167 | * directly, use the values stored here. They might be different! |
| 168 | */ |
| 169 | unsigned int irq; |
| 170 | struct resource resource[DEVICE_COUNT_RESOURCE]; /* I/O and memory regions + expansion ROMs */ |
| 171 | |
| 172 | /* These fields are used by common fixups */ |
| 173 | unsigned int transparent:1; /* Transparent PCI bridge */ |
| 174 | unsigned int multifunction:1;/* Part of multi-function device */ |
| 175 | /* keep track of device state */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 176 | unsigned int is_busmaster:1; /* device is busmaster */ |
Kristen Accardi | 4602b88 | 2005-08-16 15:15:58 -0700 | [diff] [blame] | 177 | unsigned int no_msi:1; /* device may not use msi */ |
Kristen Carlson Accardi | ffadcc2 | 2006-07-12 08:59:00 -0700 | [diff] [blame] | 178 | unsigned int no_d1d2:1; /* only allow d0 or d3 */ |
Brian King | e04b0ea | 2005-09-27 01:21:55 -0700 | [diff] [blame] | 179 | unsigned int block_ucfg_access:1; /* userspace config space access is blocked */ |
Doug Thompson | bd8481e | 2006-05-08 17:06:09 -0700 | [diff] [blame] | 180 | unsigned int broken_parity_status:1; /* Device generates false positive parity */ |
Shaohua Li | 99dc804 | 2006-05-26 10:58:27 +0800 | [diff] [blame] | 181 | unsigned int msi_enabled:1; |
| 182 | unsigned int msix_enabled:1; |
Tejun Heo | 9ac7849 | 2007-01-20 16:00:26 +0900 | [diff] [blame] | 183 | unsigned int is_managed:1; |
Inaky Perez-Gonzalez | bae94d0 | 2006-11-22 12:40:31 -0800 | [diff] [blame] | 184 | atomic_t enable_cnt; /* pci_enable_device has been called */ |
Kristen Accardi | 4602b88 | 2005-08-16 15:15:58 -0700 | [diff] [blame] | 185 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 186 | u32 saved_config_space[16]; /* config space saved at suspend time */ |
Shaohua Li | 41017f0 | 2006-02-08 17:11:38 +0800 | [diff] [blame] | 187 | struct hlist_head saved_cap_space; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 188 | struct bin_attribute *rom_attr; /* attribute descriptor for sysfs ROM entry */ |
| 189 | int rom_attr_enabled; /* has display of the rom attribute been enabled? */ |
| 190 | struct bin_attribute *res_attr[DEVICE_COUNT_RESOURCE]; /* sysfs file for resources */ |
Eric W. Biederman | ded86d8 | 2007-01-28 12:42:52 -0700 | [diff] [blame] | 191 | #ifdef CONFIG_PCI_MSI |
Michael Ellerman | 4aa9bc9 | 2007-04-05 17:19:10 +1000 | [diff] [blame] | 192 | struct list_head msi_list; |
Eric W. Biederman | ded86d8 | 2007-01-28 12:42:52 -0700 | [diff] [blame] | 193 | #endif |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 194 | }; |
| 195 | |
Michael Ellerman | 6589121 | 2007-04-05 17:19:08 +1000 | [diff] [blame] | 196 | extern struct pci_dev *alloc_pci_dev(void); |
| 197 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 198 | #define pci_dev_g(n) list_entry(n, struct pci_dev, global_list) |
| 199 | #define pci_dev_b(n) list_entry(n, struct pci_dev, bus_list) |
| 200 | #define to_pci_dev(n) container_of(n, struct pci_dev, dev) |
| 201 | #define for_each_pci_dev(d) while ((d = pci_get_device(PCI_ANY_ID, PCI_ANY_ID, d)) != NULL) |
| 202 | |
Linas Vepstas | a7369f1 | 2006-12-12 16:55:59 -0600 | [diff] [blame] | 203 | static inline int pci_channel_offline(struct pci_dev *pdev) |
| 204 | { |
| 205 | return (pdev->error_state != pci_channel_io_normal); |
| 206 | } |
| 207 | |
Shaohua Li | 41017f0 | 2006-02-08 17:11:38 +0800 | [diff] [blame] | 208 | static inline struct pci_cap_saved_state *pci_find_saved_cap( |
| 209 | struct pci_dev *pci_dev,char cap) |
| 210 | { |
| 211 | struct pci_cap_saved_state *tmp; |
| 212 | struct hlist_node *pos; |
| 213 | |
| 214 | hlist_for_each_entry(tmp, pos, &pci_dev->saved_cap_space, next) { |
| 215 | if (tmp->cap_nr == cap) |
| 216 | return tmp; |
| 217 | } |
| 218 | return NULL; |
| 219 | } |
| 220 | |
| 221 | static inline void pci_add_saved_cap(struct pci_dev *pci_dev, |
| 222 | struct pci_cap_saved_state *new_cap) |
| 223 | { |
| 224 | hlist_add_head(&new_cap->next, &pci_dev->saved_cap_space); |
| 225 | } |
| 226 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 227 | /* |
| 228 | * For PCI devices, the region numbers are assigned this way: |
| 229 | * |
| 230 | * 0-5 standard PCI regions |
| 231 | * 6 expansion ROM |
| 232 | * 7-10 bridges: address space assigned to buses behind the bridge |
| 233 | */ |
| 234 | |
Greg Kroah-Hartman | 4352dfd | 2005-07-28 11:37:33 -0700 | [diff] [blame] | 235 | #define PCI_ROM_RESOURCE 6 |
| 236 | #define PCI_BRIDGE_RESOURCES 7 |
| 237 | #define PCI_NUM_RESOURCES 11 |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 238 | |
| 239 | #ifndef PCI_BUS_NUM_RESOURCES |
Greg Kroah-Hartman | 4352dfd | 2005-07-28 11:37:33 -0700 | [diff] [blame] | 240 | #define PCI_BUS_NUM_RESOURCES 8 |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 241 | #endif |
Greg Kroah-Hartman | 4352dfd | 2005-07-28 11:37:33 -0700 | [diff] [blame] | 242 | |
| 243 | #define PCI_REGION_FLAG_MASK 0x0fU /* These bits of resource flags tell us the PCI region flags */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 244 | |
| 245 | struct pci_bus { |
| 246 | struct list_head node; /* node in list of buses */ |
| 247 | struct pci_bus *parent; /* parent bus this bridge is on */ |
| 248 | struct list_head children; /* list of child buses */ |
| 249 | struct list_head devices; /* list of devices on this bus */ |
| 250 | struct pci_dev *self; /* bridge device as seen by parent */ |
| 251 | struct resource *resource[PCI_BUS_NUM_RESOURCES]; |
| 252 | /* address space routed to this bus */ |
| 253 | |
| 254 | struct pci_ops *ops; /* configuration access functions */ |
| 255 | void *sysdata; /* hook for sys-specific extension */ |
| 256 | struct proc_dir_entry *procdir; /* directory entry in /proc/bus/pci */ |
| 257 | |
| 258 | unsigned char number; /* bus number */ |
| 259 | unsigned char primary; /* number of primary bridge */ |
| 260 | unsigned char secondary; /* number of secondary bridge */ |
| 261 | unsigned char subordinate; /* max number of subordinate buses */ |
| 262 | |
| 263 | char name[48]; |
| 264 | |
| 265 | unsigned short bridge_ctl; /* manage NO_ISA/FBB/et al behaviors */ |
Michael S. Tsirkin | 6e325a6 | 2006-02-14 18:52:22 +0200 | [diff] [blame] | 266 | pci_bus_flags_t bus_flags; /* Inherited by child busses */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 267 | struct device *bridge; |
| 268 | struct class_device class_dev; |
| 269 | struct bin_attribute *legacy_io; /* legacy I/O for this bus */ |
| 270 | struct bin_attribute *legacy_mem; /* legacy mem */ |
| 271 | }; |
| 272 | |
| 273 | #define pci_bus_b(n) list_entry(n, struct pci_bus, node) |
| 274 | #define to_pci_bus(n) container_of(n, struct pci_bus, class_dev) |
| 275 | |
| 276 | /* |
| 277 | * Error values that may be returned by PCI functions. |
| 278 | */ |
| 279 | #define PCIBIOS_SUCCESSFUL 0x00 |
| 280 | #define PCIBIOS_FUNC_NOT_SUPPORTED 0x81 |
| 281 | #define PCIBIOS_BAD_VENDOR_ID 0x83 |
| 282 | #define PCIBIOS_DEVICE_NOT_FOUND 0x86 |
| 283 | #define PCIBIOS_BAD_REGISTER_NUMBER 0x87 |
| 284 | #define PCIBIOS_SET_FAILED 0x88 |
| 285 | #define PCIBIOS_BUFFER_TOO_SMALL 0x89 |
| 286 | |
| 287 | /* Low-level architecture-dependent routines */ |
| 288 | |
| 289 | struct pci_ops { |
| 290 | int (*read)(struct pci_bus *bus, unsigned int devfn, int where, int size, u32 *val); |
| 291 | int (*write)(struct pci_bus *bus, unsigned int devfn, int where, int size, u32 val); |
| 292 | }; |
| 293 | |
| 294 | struct pci_raw_ops { |
| 295 | int (*read)(unsigned int domain, unsigned int bus, unsigned int devfn, |
| 296 | int reg, int len, u32 *val); |
| 297 | int (*write)(unsigned int domain, unsigned int bus, unsigned int devfn, |
| 298 | int reg, int len, u32 val); |
| 299 | }; |
| 300 | |
| 301 | extern struct pci_raw_ops *raw_pci_ops; |
| 302 | |
| 303 | struct pci_bus_region { |
| 304 | unsigned long start; |
| 305 | unsigned long end; |
| 306 | }; |
| 307 | |
| 308 | struct pci_dynids { |
| 309 | spinlock_t lock; /* protects list, index */ |
| 310 | struct list_head list; /* for IDs added at runtime */ |
| 311 | unsigned int use_driver_data:1; /* pci_driver->driver_data is used */ |
| 312 | }; |
| 313 | |
linas | 392a1ce | 2005-11-16 17:10:41 -0600 | [diff] [blame] | 314 | /* ---------------------------------------------------------------- */ |
| 315 | /** PCI Error Recovery System (PCI-ERS). If a PCI device driver provides |
| 316 | * a set fof callbacks in struct pci_error_handlers, then that device driver |
| 317 | * will be notified of PCI bus errors, and will be driven to recovery |
| 318 | * when an error occurs. |
| 319 | */ |
| 320 | |
| 321 | typedef unsigned int __bitwise pci_ers_result_t; |
| 322 | |
| 323 | enum pci_ers_result { |
| 324 | /* no result/none/not supported in device driver */ |
| 325 | PCI_ERS_RESULT_NONE = (__force pci_ers_result_t) 1, |
| 326 | |
| 327 | /* Device driver can recover without slot reset */ |
| 328 | PCI_ERS_RESULT_CAN_RECOVER = (__force pci_ers_result_t) 2, |
| 329 | |
| 330 | /* Device driver wants slot to be reset. */ |
| 331 | PCI_ERS_RESULT_NEED_RESET = (__force pci_ers_result_t) 3, |
| 332 | |
| 333 | /* Device has completely failed, is unrecoverable */ |
| 334 | PCI_ERS_RESULT_DISCONNECT = (__force pci_ers_result_t) 4, |
| 335 | |
| 336 | /* Device driver is fully recovered and operational */ |
| 337 | PCI_ERS_RESULT_RECOVERED = (__force pci_ers_result_t) 5, |
| 338 | }; |
| 339 | |
| 340 | /* PCI bus error event callbacks */ |
| 341 | struct pci_error_handlers |
| 342 | { |
| 343 | /* PCI bus error detected on this device */ |
| 344 | pci_ers_result_t (*error_detected)(struct pci_dev *dev, |
| 345 | enum pci_channel_state error); |
| 346 | |
| 347 | /* MMIO has been re-enabled, but not DMA */ |
| 348 | pci_ers_result_t (*mmio_enabled)(struct pci_dev *dev); |
| 349 | |
| 350 | /* PCI Express link has been reset */ |
| 351 | pci_ers_result_t (*link_reset)(struct pci_dev *dev); |
| 352 | |
| 353 | /* PCI slot has been reset */ |
| 354 | pci_ers_result_t (*slot_reset)(struct pci_dev *dev); |
| 355 | |
| 356 | /* Device driver may resume normal operations */ |
| 357 | void (*resume)(struct pci_dev *dev); |
| 358 | }; |
| 359 | |
| 360 | /* ---------------------------------------------------------------- */ |
| 361 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 362 | struct module; |
| 363 | struct pci_driver { |
| 364 | struct list_head node; |
| 365 | char *name; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 366 | const struct pci_device_id *id_table; /* must be non-NULL for probe to be called */ |
| 367 | int (*probe) (struct pci_dev *dev, const struct pci_device_id *id); /* New device inserted */ |
| 368 | void (*remove) (struct pci_dev *dev); /* Device removed (NULL if not a hot-plug capable driver) */ |
| 369 | int (*suspend) (struct pci_dev *dev, pm_message_t state); /* Device suspended */ |
Linus Torvalds | cbd69db | 2006-06-24 14:50:29 -0700 | [diff] [blame] | 370 | int (*suspend_late) (struct pci_dev *dev, pm_message_t state); |
| 371 | int (*resume_early) (struct pci_dev *dev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 372 | int (*resume) (struct pci_dev *dev); /* Device woken up */ |
Pavel Machek | 438510f | 2005-04-16 15:25:24 -0700 | [diff] [blame] | 373 | int (*enable_wake) (struct pci_dev *dev, pci_power_t state, int enable); /* Enable wake event */ |
Greg KH | c895817 | 2005-04-08 14:53:31 +0900 | [diff] [blame] | 374 | void (*shutdown) (struct pci_dev *dev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 375 | |
linas | 392a1ce | 2005-11-16 17:10:41 -0600 | [diff] [blame] | 376 | struct pci_error_handlers *err_handler; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 377 | struct device_driver driver; |
| 378 | struct pci_dynids dynids; |
| 379 | }; |
| 380 | |
| 381 | #define to_pci_driver(drv) container_of(drv,struct pci_driver, driver) |
| 382 | |
| 383 | /** |
| 384 | * PCI_DEVICE - macro used to describe a specific pci device |
| 385 | * @vend: the 16 bit PCI Vendor ID |
| 386 | * @dev: the 16 bit PCI Device ID |
| 387 | * |
| 388 | * This macro is used to create a struct pci_device_id that matches a |
| 389 | * specific device. The subvendor and subdevice fields will be set to |
| 390 | * PCI_ANY_ID. |
| 391 | */ |
| 392 | #define PCI_DEVICE(vend,dev) \ |
| 393 | .vendor = (vend), .device = (dev), \ |
| 394 | .subvendor = PCI_ANY_ID, .subdevice = PCI_ANY_ID |
| 395 | |
| 396 | /** |
| 397 | * PCI_DEVICE_CLASS - macro used to describe a specific pci device class |
| 398 | * @dev_class: the class, subclass, prog-if triple for this device |
| 399 | * @dev_class_mask: the class mask for this device |
| 400 | * |
| 401 | * This macro is used to create a struct pci_device_id that matches a |
Greg Kroah-Hartman | 4352dfd | 2005-07-28 11:37:33 -0700 | [diff] [blame] | 402 | * specific PCI class. The vendor, device, subvendor, and subdevice |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 403 | * fields will be set to PCI_ANY_ID. |
| 404 | */ |
| 405 | #define PCI_DEVICE_CLASS(dev_class,dev_class_mask) \ |
| 406 | .class = (dev_class), .class_mask = (dev_class_mask), \ |
| 407 | .vendor = PCI_ANY_ID, .device = PCI_ANY_ID, \ |
| 408 | .subvendor = PCI_ANY_ID, .subdevice = PCI_ANY_ID |
| 409 | |
Alan Cox | 1597cac | 2006-12-04 15:14:45 -0800 | [diff] [blame] | 410 | /** |
| 411 | * PCI_VDEVICE - macro used to describe a specific pci device in short form |
| 412 | * @vend: the vendor name |
| 413 | * @dev: the 16 bit PCI Device ID |
| 414 | * |
| 415 | * This macro is used to create a struct pci_device_id that matches a |
| 416 | * specific PCI device. The subvendor, and subdevice fields will be set |
| 417 | * to PCI_ANY_ID. The macro allows the next field to follow as the device |
| 418 | * private data. |
| 419 | */ |
| 420 | |
| 421 | #define PCI_VDEVICE(vendor, device) \ |
| 422 | PCI_VENDOR_ID_##vendor, (device), \ |
| 423 | PCI_ANY_ID, PCI_ANY_ID, 0, 0 |
| 424 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 425 | /* these external functions are only available when PCI support is enabled */ |
| 426 | #ifdef CONFIG_PCI |
| 427 | |
| 428 | extern struct bus_type pci_bus_type; |
| 429 | |
| 430 | /* Do NOT directly access these two variables, unless you are arch specific pci |
| 431 | * code, or pci core code. */ |
| 432 | extern struct list_head pci_root_buses; /* list of all known PCI buses */ |
| 433 | extern struct list_head pci_devices; /* list of all devices */ |
| 434 | |
| 435 | void pcibios_fixup_bus(struct pci_bus *); |
Andrew Morton | 4a7fb63 | 2006-08-14 22:43:17 -0700 | [diff] [blame] | 436 | int __must_check pcibios_enable_device(struct pci_dev *, int mask); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 437 | char *pcibios_setup (char *str); |
| 438 | |
| 439 | /* Used only when drivers/pci/setup.c is used */ |
Greg Kroah-Hartman | e31dd6e | 2006-06-12 17:06:02 -0700 | [diff] [blame] | 440 | void pcibios_align_resource(void *, struct resource *, resource_size_t, |
| 441 | resource_size_t); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 442 | void pcibios_update_irq(struct pci_dev *, int irq); |
| 443 | |
| 444 | /* Generic PCI functions used internally */ |
| 445 | |
| 446 | extern struct pci_bus *pci_find_bus(int domain, int busnr); |
Rajesh Shah | c431ada | 2005-04-28 00:25:45 -0700 | [diff] [blame] | 447 | void pci_bus_add_devices(struct pci_bus *bus); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 448 | struct pci_bus *pci_scan_bus_parented(struct device *parent, int bus, struct pci_ops *ops, void *sysdata); |
| 449 | static inline struct pci_bus *pci_scan_bus(int bus, struct pci_ops *ops, void *sysdata) |
| 450 | { |
Rajesh Shah | c431ada | 2005-04-28 00:25:45 -0700 | [diff] [blame] | 451 | struct pci_bus *root_bus; |
| 452 | root_bus = pci_scan_bus_parented(NULL, bus, ops, sysdata); |
| 453 | if (root_bus) |
| 454 | pci_bus_add_devices(root_bus); |
| 455 | return root_bus; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 456 | } |
Paul Mackerras | cdb9b9f | 2005-09-06 09:31:03 +1000 | [diff] [blame] | 457 | struct pci_bus *pci_create_bus(struct device *parent, int bus, struct pci_ops *ops, void *sysdata); |
| 458 | struct pci_bus * pci_add_new_bus(struct pci_bus *parent, struct pci_dev *dev, int busnr); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 459 | int pci_scan_slot(struct pci_bus *bus, int devfn); |
| 460 | struct pci_dev * pci_scan_single_device(struct pci_bus *bus, int devfn); |
Paul Mackerras | cdb9b9f | 2005-09-06 09:31:03 +1000 | [diff] [blame] | 461 | void pci_device_add(struct pci_dev *dev, struct pci_bus *bus); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 462 | unsigned int pci_scan_child_bus(struct pci_bus *bus); |
Greg Kroah-Hartman | b19441a | 2006-08-28 11:43:25 -0700 | [diff] [blame] | 463 | int __must_check pci_bus_add_device(struct pci_dev *dev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 464 | void pci_read_bridge_bases(struct pci_bus *child); |
| 465 | struct resource *pci_find_parent_resource(const struct pci_dev *dev, struct resource *res); |
| 466 | int pci_get_interrupt_pin(struct pci_dev *dev, struct pci_dev **bridge); |
| 467 | extern struct pci_dev *pci_dev_get(struct pci_dev *dev); |
| 468 | extern void pci_dev_put(struct pci_dev *dev); |
| 469 | extern void pci_remove_bus(struct pci_bus *b); |
| 470 | extern void pci_remove_bus_device(struct pci_dev *dev); |
Satoru Takeuchi | 24f8aa9 | 2006-09-12 10:16:36 -0700 | [diff] [blame] | 471 | extern void pci_stop_bus_device(struct pci_dev *dev); |
Dominik Brodowski | b3743fa | 2005-09-09 13:03:23 -0700 | [diff] [blame] | 472 | void pci_setup_cardbus(struct pci_bus *bus); |
Matt Domsch | 6b4b78f | 2006-09-29 15:23:23 -0500 | [diff] [blame] | 473 | extern void pci_sort_breadthfirst(void); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 474 | |
| 475 | /* Generic PCI functions exported to card drivers */ |
| 476 | |
Adrian Bunk | 429538a | 2006-11-18 01:06:29 +0100 | [diff] [blame] | 477 | struct pci_dev __deprecated *pci_find_device (unsigned int vendor, unsigned int device, const struct pci_dev *from); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 478 | struct pci_dev *pci_find_slot (unsigned int bus, unsigned int devfn); |
| 479 | int pci_find_capability (struct pci_dev *dev, int cap); |
Roland Dreier | 24a4e37 | 2005-10-28 17:35:34 -0700 | [diff] [blame] | 480 | int pci_find_next_capability (struct pci_dev *dev, u8 pos, int cap); |
Brice Goglin | 3a720d7 | 2006-05-23 06:10:01 -0400 | [diff] [blame] | 481 | int pci_find_ext_capability (struct pci_dev *dev, int cap); |
Michael Ellerman | 687d5fe | 2006-11-22 18:26:18 +1100 | [diff] [blame] | 482 | int pci_find_ht_capability (struct pci_dev *dev, int ht_cap); |
| 483 | int pci_find_next_ht_capability (struct pci_dev *dev, int pos, int ht_cap); |
Alan Cox | 29f3eb6 | 2006-10-16 16:20:21 -0700 | [diff] [blame] | 484 | struct pci_bus *pci_find_next_bus(const struct pci_bus *from); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 485 | |
Andrew Morton | d42552c | 2006-10-21 10:24:12 -0700 | [diff] [blame] | 486 | struct pci_dev *pci_get_device(unsigned int vendor, unsigned int device, |
| 487 | struct pci_dev *from); |
| 488 | struct pci_dev *pci_get_device_reverse(unsigned int vendor, unsigned int device, |
| 489 | struct pci_dev *from); |
| 490 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 491 | struct pci_dev *pci_get_subsys (unsigned int vendor, unsigned int device, |
| 492 | unsigned int ss_vendor, unsigned int ss_device, |
| 493 | struct pci_dev *from); |
| 494 | struct pci_dev *pci_get_slot (struct pci_bus *bus, unsigned int devfn); |
Alan Cox | 29f3eb6 | 2006-10-16 16:20:21 -0700 | [diff] [blame] | 495 | struct pci_dev *pci_get_bus_and_slot (unsigned int bus, unsigned int devfn); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 496 | struct pci_dev *pci_get_class (unsigned int class, struct pci_dev *from); |
| 497 | int pci_dev_present(const struct pci_device_id *ids); |
Alan Cox | d86f90f | 2006-12-04 15:14:44 -0800 | [diff] [blame] | 498 | const struct pci_device_id *pci_find_present(const struct pci_device_id *ids); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 499 | |
| 500 | int pci_bus_read_config_byte (struct pci_bus *bus, unsigned int devfn, int where, u8 *val); |
| 501 | int pci_bus_read_config_word (struct pci_bus *bus, unsigned int devfn, int where, u16 *val); |
| 502 | int pci_bus_read_config_dword (struct pci_bus *bus, unsigned int devfn, int where, u32 *val); |
| 503 | int pci_bus_write_config_byte (struct pci_bus *bus, unsigned int devfn, int where, u8 val); |
| 504 | int pci_bus_write_config_word (struct pci_bus *bus, unsigned int devfn, int where, u16 val); |
| 505 | int pci_bus_write_config_dword (struct pci_bus *bus, unsigned int devfn, int where, u32 val); |
| 506 | |
| 507 | static inline int pci_read_config_byte(struct pci_dev *dev, int where, u8 *val) |
| 508 | { |
| 509 | return pci_bus_read_config_byte (dev->bus, dev->devfn, where, val); |
| 510 | } |
| 511 | static inline int pci_read_config_word(struct pci_dev *dev, int where, u16 *val) |
| 512 | { |
| 513 | return pci_bus_read_config_word (dev->bus, dev->devfn, where, val); |
| 514 | } |
| 515 | static inline int pci_read_config_dword(struct pci_dev *dev, int where, u32 *val) |
| 516 | { |
| 517 | return pci_bus_read_config_dword (dev->bus, dev->devfn, where, val); |
| 518 | } |
| 519 | static inline int pci_write_config_byte(struct pci_dev *dev, int where, u8 val) |
| 520 | { |
| 521 | return pci_bus_write_config_byte (dev->bus, dev->devfn, where, val); |
| 522 | } |
| 523 | static inline int pci_write_config_word(struct pci_dev *dev, int where, u16 val) |
| 524 | { |
| 525 | return pci_bus_write_config_word (dev->bus, dev->devfn, where, val); |
| 526 | } |
| 527 | static inline int pci_write_config_dword(struct pci_dev *dev, int where, u32 val) |
| 528 | { |
| 529 | return pci_bus_write_config_dword (dev->bus, dev->devfn, where, val); |
| 530 | } |
| 531 | |
Andrew Morton | 4a7fb63 | 2006-08-14 22:43:17 -0700 | [diff] [blame] | 532 | int __must_check pci_enable_device(struct pci_dev *dev); |
| 533 | int __must_check pci_enable_device_bars(struct pci_dev *dev, int mask); |
Tejun Heo | 9ac7849 | 2007-01-20 16:00:26 +0900 | [diff] [blame] | 534 | int __must_check pcim_enable_device(struct pci_dev *pdev); |
| 535 | void pcim_pin_device(struct pci_dev *pdev); |
| 536 | |
| 537 | static inline int pci_is_managed(struct pci_dev *pdev) |
| 538 | { |
| 539 | return pdev->is_managed; |
| 540 | } |
| 541 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 542 | void pci_disable_device(struct pci_dev *dev); |
| 543 | void pci_set_master(struct pci_dev *dev); |
Brian King | f7bdd12 | 2007-04-06 16:39:36 -0500 | [diff] [blame] | 544 | int pci_set_pcie_reset_state(struct pci_dev *dev, enum pcie_reset_state state); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 545 | #define HAVE_PCI_SET_MWI |
Andrew Morton | 4a7fb63 | 2006-08-14 22:43:17 -0700 | [diff] [blame] | 546 | int __must_check pci_set_mwi(struct pci_dev *dev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 547 | void pci_clear_mwi(struct pci_dev *dev); |
Brett M Russ | a04ce0f | 2005-08-15 15:23:41 -0400 | [diff] [blame] | 548 | void pci_intx(struct pci_dev *dev, int enable); |
Eric W. Biederman | f5f2b13 | 2007-03-05 00:30:07 -0800 | [diff] [blame] | 549 | void pci_msi_off(struct pci_dev *dev); |
Linus Torvalds | 9c8550e | 2005-09-09 15:43:46 -0700 | [diff] [blame] | 550 | int pci_set_dma_mask(struct pci_dev *dev, u64 mask); |
| 551 | int pci_set_consistent_dma_mask(struct pci_dev *dev, u64 mask); |
John W. Linville | 064b53db | 2005-07-27 10:19:44 -0400 | [diff] [blame] | 552 | void pci_update_resource(struct pci_dev *dev, struct resource *res, int resno); |
Andrew Morton | 4a7fb63 | 2006-08-14 22:43:17 -0700 | [diff] [blame] | 553 | int __must_check pci_assign_resource(struct pci_dev *dev, int i); |
| 554 | int __must_check pci_assign_resource_fixed(struct pci_dev *dev, int i); |
John W. Linville | 064b53db | 2005-07-27 10:19:44 -0400 | [diff] [blame] | 555 | void pci_restore_bars(struct pci_dev *dev); |
Hidetoshi Seto | c87deff | 2006-12-18 10:31:06 +0900 | [diff] [blame] | 556 | int pci_select_bars(struct pci_dev *dev, unsigned long flags); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 557 | |
| 558 | /* ROM control related routines */ |
Dave Jones | 144a50e | 2005-08-09 00:20:10 -0400 | [diff] [blame] | 559 | void __iomem __must_check *pci_map_rom(struct pci_dev *pdev, size_t *size); |
| 560 | void __iomem __must_check *pci_map_rom_copy(struct pci_dev *pdev, size_t *size); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 561 | void pci_unmap_rom(struct pci_dev *pdev, void __iomem *rom); |
| 562 | void pci_remove_rom(struct pci_dev *pdev); |
| 563 | |
| 564 | /* Power management related routines */ |
| 565 | int pci_save_state(struct pci_dev *dev); |
| 566 | int pci_restore_state(struct pci_dev *dev); |
Linus Torvalds | 9c8550e | 2005-09-09 15:43:46 -0700 | [diff] [blame] | 567 | int pci_set_power_state(struct pci_dev *dev, pci_power_t state); |
| 568 | pci_power_t pci_choose_state(struct pci_dev *dev, pm_message_t state); |
| 569 | int pci_enable_wake(struct pci_dev *dev, pci_power_t state, int enable); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 570 | |
| 571 | /* Helper functions for low-level code (drivers/pci/setup-[bus,res].c) */ |
| 572 | void pci_bus_assign_resources(struct pci_bus *bus); |
| 573 | void pci_bus_size_bridges(struct pci_bus *bus); |
| 574 | int pci_claim_resource(struct pci_dev *, int); |
| 575 | void pci_assign_unassigned_resources(void); |
| 576 | void pdev_enable_device(struct pci_dev *); |
| 577 | void pdev_sort_resources(struct pci_dev *, struct resource_list *); |
| 578 | void pci_fixup_irqs(u8 (*)(struct pci_dev *, u8 *), |
| 579 | int (*)(struct pci_dev *, u8, u8)); |
| 580 | #define HAVE_PCI_REQ_REGIONS 2 |
Andrew Morton | 4a7fb63 | 2006-08-14 22:43:17 -0700 | [diff] [blame] | 581 | int __must_check pci_request_regions(struct pci_dev *, const char *); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 582 | void pci_release_regions(struct pci_dev *); |
Andrew Morton | 4a7fb63 | 2006-08-14 22:43:17 -0700 | [diff] [blame] | 583 | int __must_check pci_request_region(struct pci_dev *, int, const char *); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 584 | void pci_release_region(struct pci_dev *, int); |
Hidetoshi Seto | c87deff | 2006-12-18 10:31:06 +0900 | [diff] [blame] | 585 | int pci_request_selected_regions(struct pci_dev *, int, const char *); |
| 586 | void pci_release_selected_regions(struct pci_dev *, int); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 587 | |
| 588 | /* drivers/pci/bus.c */ |
Andrew Morton | 4a7fb63 | 2006-08-14 22:43:17 -0700 | [diff] [blame] | 589 | int __must_check pci_bus_alloc_resource(struct pci_bus *bus, |
| 590 | struct resource *res, resource_size_t size, |
| 591 | resource_size_t align, resource_size_t min, |
| 592 | unsigned int type_mask, |
| 593 | void (*alignf)(void *, struct resource *, |
| 594 | resource_size_t, resource_size_t), |
| 595 | void *alignf_data); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 596 | void pci_enable_bridges(struct pci_bus *bus); |
| 597 | |
Laurent riffard | 863b18f | 2005-10-27 23:12:54 +0200 | [diff] [blame] | 598 | /* Proper probing supporting hot-pluggable devices */ |
Greg Kroah-Hartman | 725522b | 2007-01-15 11:50:02 -0800 | [diff] [blame] | 599 | int __must_check __pci_register_driver(struct pci_driver *, struct module *, |
| 600 | const char *mod_name); |
Andrew Morton | 4a7fb63 | 2006-08-14 22:43:17 -0700 | [diff] [blame] | 601 | static inline int __must_check pci_register_driver(struct pci_driver *driver) |
Laurent riffard | 863b18f | 2005-10-27 23:12:54 +0200 | [diff] [blame] | 602 | { |
Greg Kroah-Hartman | 725522b | 2007-01-15 11:50:02 -0800 | [diff] [blame] | 603 | return __pci_register_driver(driver, THIS_MODULE, KBUILD_MODNAME); |
Laurent riffard | 863b18f | 2005-10-27 23:12:54 +0200 | [diff] [blame] | 604 | } |
| 605 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 606 | void pci_unregister_driver(struct pci_driver *); |
| 607 | void pci_remove_behind_bridge(struct pci_dev *); |
| 608 | struct pci_driver *pci_dev_driver(const struct pci_dev *); |
Greg Kroah-Hartman | 7586585 | 2005-06-30 02:18:12 -0700 | [diff] [blame] | 609 | const struct pci_device_id *pci_match_device(struct pci_driver *drv, struct pci_dev *dev); |
| 610 | const struct pci_device_id *pci_match_id(const struct pci_device_id *ids, struct pci_dev *dev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 611 | int pci_scan_bridge(struct pci_bus *bus, struct pci_dev * dev, int max, int pass); |
| 612 | |
Paul Mackerras | cecf486 | 2005-08-18 14:33:01 +1000 | [diff] [blame] | 613 | void pci_walk_bus(struct pci_bus *top, void (*cb)(struct pci_dev *, void *), |
| 614 | void *userdata); |
Benjamin Herrenschmidt | ac7dc65 | 2005-12-13 18:09:16 +1100 | [diff] [blame] | 615 | int pci_cfg_space_size(struct pci_dev *dev); |
Kristen Accardi | b82db5c | 2006-01-17 16:56:56 -0800 | [diff] [blame] | 616 | unsigned char pci_bus_max_busnr(struct pci_bus* bus); |
Paul Mackerras | cecf486 | 2005-08-18 14:33:01 +1000 | [diff] [blame] | 617 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 618 | /* kmem_cache style wrapper around pci_alloc_consistent() */ |
| 619 | |
| 620 | #include <linux/dmapool.h> |
| 621 | |
| 622 | #define pci_pool dma_pool |
| 623 | #define pci_pool_create(name, pdev, size, align, allocation) \ |
| 624 | dma_pool_create(name, &pdev->dev, size, align, allocation) |
| 625 | #define pci_pool_destroy(pool) dma_pool_destroy(pool) |
| 626 | #define pci_pool_alloc(pool, flags, handle) dma_pool_alloc(pool, flags, handle) |
| 627 | #define pci_pool_free(pool, vaddr, addr) dma_pool_free(pool, vaddr, addr) |
| 628 | |
David S. Miller | e24c2d9 | 2005-06-02 12:55:50 -0700 | [diff] [blame] | 629 | enum pci_dma_burst_strategy { |
| 630 | PCI_DMA_BURST_INFINITY, /* make bursts as large as possible, |
| 631 | strategy_parameter is N/A */ |
| 632 | PCI_DMA_BURST_BOUNDARY, /* disconnect at every strategy_parameter |
| 633 | byte boundaries */ |
| 634 | PCI_DMA_BURST_MULTIPLE, /* disconnect at some multiple of |
| 635 | strategy_parameter byte boundaries */ |
| 636 | }; |
| 637 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 638 | struct msix_entry { |
| 639 | u16 vector; /* kernel uses to write allocated vector */ |
| 640 | u16 entry; /* driver uses to specify entry, OS writes */ |
| 641 | }; |
| 642 | |
Eric W. Biederman | 0366f8f | 2006-10-04 02:16:33 -0700 | [diff] [blame] | 643 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 644 | #ifndef CONFIG_PCI_MSI |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 645 | static inline int pci_enable_msi(struct pci_dev *dev) {return -1;} |
| 646 | static inline void pci_disable_msi(struct pci_dev *dev) {} |
| 647 | static inline int pci_enable_msix(struct pci_dev* dev, |
| 648 | struct msix_entry *entries, int nvec) {return -1;} |
| 649 | static inline void pci_disable_msix(struct pci_dev *dev) {} |
| 650 | static inline void msi_remove_pci_irq_vectors(struct pci_dev *dev) {} |
| 651 | #else |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 652 | extern int pci_enable_msi(struct pci_dev *dev); |
| 653 | extern void pci_disable_msi(struct pci_dev *dev); |
| 654 | extern int pci_enable_msix(struct pci_dev* dev, |
| 655 | struct msix_entry *entries, int nvec); |
| 656 | extern void pci_disable_msix(struct pci_dev *dev); |
| 657 | extern void msi_remove_pci_irq_vectors(struct pci_dev *dev); |
| 658 | #endif |
| 659 | |
Eric W. Biederman | 8b955b0 | 2006-10-04 02:16:55 -0700 | [diff] [blame] | 660 | #ifdef CONFIG_HT_IRQ |
Eric W. Biederman | 8b955b0 | 2006-10-04 02:16:55 -0700 | [diff] [blame] | 661 | /* The functions a driver should call */ |
| 662 | int ht_create_irq(struct pci_dev *dev, int idx); |
| 663 | void ht_destroy_irq(unsigned int irq); |
Eric W. Biederman | 8b955b0 | 2006-10-04 02:16:55 -0700 | [diff] [blame] | 664 | #endif /* CONFIG_HT_IRQ */ |
| 665 | |
Brian King | e04b0ea | 2005-09-27 01:21:55 -0700 | [diff] [blame] | 666 | extern void pci_block_user_cfg_access(struct pci_dev *dev); |
| 667 | extern void pci_unblock_user_cfg_access(struct pci_dev *dev); |
| 668 | |
Greg Kroah-Hartman | 4352dfd | 2005-07-28 11:37:33 -0700 | [diff] [blame] | 669 | /* |
| 670 | * PCI domain support. Sometimes called PCI segment (eg by ACPI), |
| 671 | * a PCI domain is defined to be a set of PCI busses which share |
| 672 | * configuration space. |
| 673 | */ |
| 674 | #ifndef CONFIG_PCI_DOMAINS |
| 675 | static inline int pci_domain_nr(struct pci_bus *bus) { return 0; } |
| 676 | static inline int pci_proc_domain(struct pci_bus *bus) |
| 677 | { |
| 678 | return 0; |
| 679 | } |
| 680 | #endif |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 681 | |
Greg Kroah-Hartman | 4352dfd | 2005-07-28 11:37:33 -0700 | [diff] [blame] | 682 | #else /* CONFIG_PCI is not enabled */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 683 | |
| 684 | /* |
| 685 | * If the system does not have PCI, clearly these return errors. Define |
| 686 | * these as simple inline functions to avoid hair in drivers. |
| 687 | */ |
| 688 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 689 | #define _PCI_NOP(o,s,t) \ |
| 690 | static inline int pci_##o##_config_##s (struct pci_dev *dev, int where, t val) \ |
| 691 | { return PCIBIOS_FUNC_NOT_SUPPORTED; } |
| 692 | #define _PCI_NOP_ALL(o,x) _PCI_NOP(o,byte,u8 x) \ |
| 693 | _PCI_NOP(o,word,u16 x) \ |
| 694 | _PCI_NOP(o,dword,u32 x) |
| 695 | _PCI_NOP_ALL(read, *) |
| 696 | _PCI_NOP_ALL(write,) |
| 697 | |
| 698 | static inline struct pci_dev *pci_find_device(unsigned int vendor, unsigned int device, const struct pci_dev *from) |
| 699 | { return NULL; } |
| 700 | |
| 701 | static inline struct pci_dev *pci_find_slot(unsigned int bus, unsigned int devfn) |
| 702 | { return NULL; } |
| 703 | |
Andrew Morton | d42552c | 2006-10-21 10:24:12 -0700 | [diff] [blame] | 704 | static inline struct pci_dev *pci_get_device(unsigned int vendor, |
| 705 | unsigned int device, struct pci_dev *from) |
| 706 | { return NULL; } |
| 707 | |
| 708 | static inline struct pci_dev *pci_get_device_reverse(unsigned int vendor, |
| 709 | unsigned int device, struct pci_dev *from) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 710 | { return NULL; } |
| 711 | |
| 712 | static inline struct pci_dev *pci_get_subsys (unsigned int vendor, unsigned int device, |
| 713 | unsigned int ss_vendor, unsigned int ss_device, struct pci_dev *from) |
| 714 | { return NULL; } |
| 715 | |
| 716 | static inline struct pci_dev *pci_get_class(unsigned int class, struct pci_dev *from) |
| 717 | { return NULL; } |
| 718 | |
| 719 | #define pci_dev_present(ids) (0) |
Alan Cox | d86f90f | 2006-12-04 15:14:44 -0800 | [diff] [blame] | 720 | #define pci_find_present(ids) (NULL) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 721 | #define pci_dev_put(dev) do { } while (0) |
| 722 | |
| 723 | static inline void pci_set_master(struct pci_dev *dev) { } |
| 724 | static inline int pci_enable_device(struct pci_dev *dev) { return -EIO; } |
| 725 | static inline void pci_disable_device(struct pci_dev *dev) { } |
| 726 | static inline int pci_set_dma_mask(struct pci_dev *dev, u64 mask) { return -EIO; } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 727 | static inline int pci_assign_resource(struct pci_dev *dev, int i) { return -EBUSY;} |
Laurent riffard | 863b18f | 2005-10-27 23:12:54 +0200 | [diff] [blame] | 728 | static inline int __pci_register_driver(struct pci_driver *drv, struct module *owner) { return 0;} |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 729 | static inline int pci_register_driver(struct pci_driver *drv) { return 0;} |
| 730 | static inline void pci_unregister_driver(struct pci_driver *drv) { } |
| 731 | static inline int pci_find_capability (struct pci_dev *dev, int cap) {return 0; } |
Roland Dreier | 24a4e37 | 2005-10-28 17:35:34 -0700 | [diff] [blame] | 732 | static inline int pci_find_next_capability (struct pci_dev *dev, u8 post, int cap) { return 0; } |
Brice Goglin | 3a720d7 | 2006-05-23 06:10:01 -0400 | [diff] [blame] | 733 | static inline int pci_find_ext_capability (struct pci_dev *dev, int cap) {return 0; } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 734 | static inline const struct pci_device_id *pci_match_device(const struct pci_device_id *ids, const struct pci_dev *dev) { return NULL; } |
| 735 | |
| 736 | /* Power management related routines */ |
| 737 | static inline int pci_save_state(struct pci_dev *dev) { return 0; } |
| 738 | static inline int pci_restore_state(struct pci_dev *dev) { return 0; } |
| 739 | static inline int pci_set_power_state(struct pci_dev *dev, pci_power_t state) { return 0; } |
Pavel Machek | 438510f | 2005-04-16 15:25:24 -0700 | [diff] [blame] | 740 | static inline pci_power_t pci_choose_state(struct pci_dev *dev, pm_message_t state) { return PCI_D0; } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 741 | static inline int pci_enable_wake(struct pci_dev *dev, pci_power_t state, int enable) { return 0; } |
| 742 | |
Sergei Shtylyov | 0da0ead | 2007-04-01 21:13:58 +0400 | [diff] [blame] | 743 | static inline int pci_request_regions(struct pci_dev *dev, const char *res_name) { return -EIO; } |
| 744 | static inline void pci_release_regions(struct pci_dev *dev) { } |
| 745 | |
Kumar Gala | a46e812 | 2005-07-29 12:16:27 -0700 | [diff] [blame] | 746 | #define pci_dma_burst_advice(pdev, strat, strategy_parameter) do { } while (0) |
| 747 | |
Brian King | e04b0ea | 2005-09-27 01:21:55 -0700 | [diff] [blame] | 748 | static inline void pci_block_user_cfg_access(struct pci_dev *dev) { } |
| 749 | static inline void pci_unblock_user_cfg_access(struct pci_dev *dev) { } |
| 750 | |
Randy Dunlap | d80d021 | 2007-07-01 12:06:37 -0700 | [diff] [blame] | 751 | static inline struct pci_bus *pci_find_next_bus(const struct pci_bus *from) |
| 752 | { return NULL; } |
| 753 | |
| 754 | static inline struct pci_dev *pci_get_slot(struct pci_bus *bus, |
| 755 | unsigned int devfn) |
| 756 | { return NULL; } |
| 757 | |
| 758 | static inline struct pci_dev *pci_get_bus_and_slot(unsigned int bus, |
| 759 | unsigned int devfn) |
| 760 | { return NULL; } |
| 761 | |
Greg Kroah-Hartman | 4352dfd | 2005-07-28 11:37:33 -0700 | [diff] [blame] | 762 | #endif /* CONFIG_PCI */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 763 | |
Greg Kroah-Hartman | 4352dfd | 2005-07-28 11:37:33 -0700 | [diff] [blame] | 764 | /* Include architecture-dependent settings and functions */ |
| 765 | |
| 766 | #include <asm/pci.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 767 | |
| 768 | /* these helpers provide future and backwards compatibility |
| 769 | * for accessing popular PCI BAR info */ |
| 770 | #define pci_resource_start(dev,bar) ((dev)->resource[(bar)].start) |
| 771 | #define pci_resource_end(dev,bar) ((dev)->resource[(bar)].end) |
| 772 | #define pci_resource_flags(dev,bar) ((dev)->resource[(bar)].flags) |
| 773 | #define pci_resource_len(dev,bar) \ |
| 774 | ((pci_resource_start((dev),(bar)) == 0 && \ |
| 775 | pci_resource_end((dev),(bar)) == \ |
| 776 | pci_resource_start((dev),(bar))) ? 0 : \ |
| 777 | \ |
| 778 | (pci_resource_end((dev),(bar)) - \ |
| 779 | pci_resource_start((dev),(bar)) + 1)) |
| 780 | |
| 781 | /* Similar to the helpers above, these manipulate per-pci_dev |
| 782 | * driver-specific data. They are really just a wrapper around |
| 783 | * the generic device structure functions of these calls. |
| 784 | */ |
| 785 | static inline void *pci_get_drvdata (struct pci_dev *pdev) |
| 786 | { |
| 787 | return dev_get_drvdata(&pdev->dev); |
| 788 | } |
| 789 | |
| 790 | static inline void pci_set_drvdata (struct pci_dev *pdev, void *data) |
| 791 | { |
| 792 | dev_set_drvdata(&pdev->dev, data); |
| 793 | } |
| 794 | |
| 795 | /* If you want to know what to call your pci_dev, ask this function. |
| 796 | * Again, it's a wrapper around the generic device. |
| 797 | */ |
| 798 | static inline char *pci_name(struct pci_dev *pdev) |
| 799 | { |
| 800 | return pdev->dev.bus_id; |
| 801 | } |
| 802 | |
Michael Ellerman | 2311b1f | 2005-05-13 17:44:10 +1000 | [diff] [blame] | 803 | |
| 804 | /* Some archs don't want to expose struct resource to userland as-is |
| 805 | * in sysfs and /proc |
| 806 | */ |
| 807 | #ifndef HAVE_ARCH_PCI_RESOURCE_TO_USER |
| 808 | static inline void pci_resource_to_user(const struct pci_dev *dev, int bar, |
Greg Kroah-Hartman | e31dd6e | 2006-06-12 17:06:02 -0700 | [diff] [blame] | 809 | const struct resource *rsrc, resource_size_t *start, |
| 810 | resource_size_t *end) |
Michael Ellerman | 2311b1f | 2005-05-13 17:44:10 +1000 | [diff] [blame] | 811 | { |
| 812 | *start = rsrc->start; |
| 813 | *end = rsrc->end; |
| 814 | } |
| 815 | #endif /* HAVE_ARCH_PCI_RESOURCE_TO_USER */ |
| 816 | |
| 817 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 818 | /* |
| 819 | * The world is not perfect and supplies us with broken PCI devices. |
| 820 | * For at least a part of these bugs we need a work-around, so both |
| 821 | * generic (drivers/pci/quirks.c) and per-architecture code can define |
| 822 | * fixup hooks to be called for particular buggy devices. |
| 823 | */ |
| 824 | |
| 825 | struct pci_fixup { |
| 826 | u16 vendor, device; /* You can use PCI_ANY_ID here of course */ |
| 827 | void (*hook)(struct pci_dev *dev); |
| 828 | }; |
| 829 | |
| 830 | enum pci_fixup_pass { |
| 831 | pci_fixup_early, /* Before probing BARs */ |
| 832 | pci_fixup_header, /* After reading configuration header */ |
| 833 | pci_fixup_final, /* Final phase of device fixups */ |
| 834 | pci_fixup_enable, /* pci_enable_device() time */ |
Alan Cox | 1597cac | 2006-12-04 15:14:45 -0800 | [diff] [blame] | 835 | pci_fixup_resume, /* pci_enable_device() time */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 836 | }; |
| 837 | |
| 838 | /* Anonymous variables would be nice... */ |
| 839 | #define DECLARE_PCI_FIXUP_SECTION(section, name, vendor, device, hook) \ |
akpm@osdl.org | 74d863e | 2005-07-25 23:28:14 -0700 | [diff] [blame] | 840 | static const struct pci_fixup __pci_fixup_##name __attribute_used__ \ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 841 | __attribute__((__section__(#section))) = { vendor, device, hook }; |
| 842 | #define DECLARE_PCI_FIXUP_EARLY(vendor, device, hook) \ |
| 843 | DECLARE_PCI_FIXUP_SECTION(.pci_fixup_early, \ |
| 844 | vendor##device##hook, vendor, device, hook) |
| 845 | #define DECLARE_PCI_FIXUP_HEADER(vendor, device, hook) \ |
| 846 | DECLARE_PCI_FIXUP_SECTION(.pci_fixup_header, \ |
| 847 | vendor##device##hook, vendor, device, hook) |
| 848 | #define DECLARE_PCI_FIXUP_FINAL(vendor, device, hook) \ |
| 849 | DECLARE_PCI_FIXUP_SECTION(.pci_fixup_final, \ |
| 850 | vendor##device##hook, vendor, device, hook) |
| 851 | #define DECLARE_PCI_FIXUP_ENABLE(vendor, device, hook) \ |
| 852 | DECLARE_PCI_FIXUP_SECTION(.pci_fixup_enable, \ |
| 853 | vendor##device##hook, vendor, device, hook) |
Alan Cox | 1597cac | 2006-12-04 15:14:45 -0800 | [diff] [blame] | 854 | #define DECLARE_PCI_FIXUP_RESUME(vendor, device, hook) \ |
| 855 | DECLARE_PCI_FIXUP_SECTION(.pci_fixup_resume, \ |
| 856 | resume##vendor##device##hook, vendor, device, hook) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 857 | |
| 858 | |
| 859 | void pci_fixup_device(enum pci_fixup_pass pass, struct pci_dev *dev); |
| 860 | |
Al Viro | 5ea8176 | 2007-02-11 15:41:31 +0000 | [diff] [blame] | 861 | void __iomem * pcim_iomap(struct pci_dev *pdev, int bar, unsigned long maxlen); |
| 862 | void pcim_iounmap(struct pci_dev *pdev, void __iomem *addr); |
| 863 | void __iomem * const * pcim_iomap_table(struct pci_dev *pdev); |
| 864 | int pcim_iomap_regions(struct pci_dev *pdev, u16 mask, const char *name); |
Tejun Heo | ec04b07 | 2007-03-09 19:45:58 +0900 | [diff] [blame] | 865 | void pcim_iounmap_regions(struct pci_dev *pdev, u16 mask); |
Al Viro | 5ea8176 | 2007-02-11 15:41:31 +0000 | [diff] [blame] | 866 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 867 | extern int pci_pci_problems; |
Alan Cox | 236561e | 2006-09-30 23:27:03 -0700 | [diff] [blame] | 868 | #define PCIPCI_FAIL 1 /* No PCI PCI DMA */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 869 | #define PCIPCI_TRITON 2 |
| 870 | #define PCIPCI_NATOMA 4 |
| 871 | #define PCIPCI_VIAETBF 8 |
| 872 | #define PCIPCI_VSFX 16 |
Alan Cox | 236561e | 2006-09-30 23:27:03 -0700 | [diff] [blame] | 873 | #define PCIPCI_ALIMAGIK 32 /* Need low latency setting */ |
| 874 | #define PCIAGP_FAIL 64 /* No PCI to AGP DMA */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 875 | |
Atsushi Nemoto | 4516a61 | 2007-02-05 16:36:06 -0800 | [diff] [blame] | 876 | extern unsigned long pci_cardbus_io_size; |
| 877 | extern unsigned long pci_cardbus_mem_size; |
| 878 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 879 | #endif /* __KERNEL__ */ |
| 880 | #endif /* LINUX_PCI_H */ |