1 /* 2 * PCI Bus Services, see include/linux/pci.h for further explanation. 3 * 4 * Copyright 1993 -- 1997 Drew Eckhardt, Frederic Potter, 5 * David Mosberger-Tang 6 * 7 * Copyright 1997 -- 2000 Martin Mares <mj@ucw.cz> 8 */ 9 10 #include <linux/kernel.h> 11 #include <linux/delay.h> 12 #include <linux/init.h> 13 #include <linux/pci.h> 14 #include <linux/pm.h> 15 #include <linux/slab.h> 16 #include <linux/module.h> 17 #include <linux/spinlock.h> 18 #include <linux/string.h> 19 #include <linux/log2.h> 20 #include <linux/pci-aspm.h> 21 #include <linux/pm_wakeup.h> 22 #include <linux/interrupt.h> 23 #include <linux/device.h> 24 #include <linux/pm_runtime.h> 25 #include <linux/pci_hotplug.h> 26 #include <asm-generic/pci-bridge.h> 27 #include <asm/setup.h> 28 #include "pci.h" 29 30 const char *pci_power_names[] = { 31 "error", "D0", "D1", "D2", "D3hot", "D3cold", "unknown", 32 }; 33 EXPORT_SYMBOL_GPL(pci_power_names); 34 35 int isa_dma_bridge_buggy; 36 EXPORT_SYMBOL(isa_dma_bridge_buggy); 37 38 int pci_pci_problems; 39 EXPORT_SYMBOL(pci_pci_problems); 40 41 unsigned int pci_pm_d3_delay; 42 43 static void pci_pme_list_scan(struct work_struct *work); 44 45 static LIST_HEAD(pci_pme_list); 46 static DEFINE_MUTEX(pci_pme_list_mutex); 47 static DECLARE_DELAYED_WORK(pci_pme_work, pci_pme_list_scan); 48 49 struct pci_pme_device { 50 struct list_head list; 51 struct pci_dev *dev; 52 }; 53 54 #define PME_TIMEOUT 1000 /* How long between PME checks */ 55 56 static void pci_dev_d3_sleep(struct pci_dev *dev) 57 { 58 unsigned int delay = dev->d3_delay; 59 60 if (delay < pci_pm_d3_delay) 61 delay = pci_pm_d3_delay; 62 63 msleep(delay); 64 } 65 66 #ifdef CONFIG_PCI_DOMAINS 67 int pci_domains_supported = 1; 68 #endif 69 70 #define DEFAULT_CARDBUS_IO_SIZE (256) 71 #define DEFAULT_CARDBUS_MEM_SIZE (64*1024*1024) 72 /* pci=cbmemsize=nnM,cbiosize=nn can override this */ 73 unsigned long pci_cardbus_io_size = DEFAULT_CARDBUS_IO_SIZE; 74 unsigned long pci_cardbus_mem_size = DEFAULT_CARDBUS_MEM_SIZE; 75 76 #define DEFAULT_HOTPLUG_IO_SIZE (256) 77 #define DEFAULT_HOTPLUG_MEM_SIZE (2*1024*1024) 78 /* pci=hpmemsize=nnM,hpiosize=nn can override this */ 79 unsigned long pci_hotplug_io_size = DEFAULT_HOTPLUG_IO_SIZE; 80 unsigned long pci_hotplug_mem_size = DEFAULT_HOTPLUG_MEM_SIZE; 81 82 enum pcie_bus_config_types pcie_bus_config = PCIE_BUS_TUNE_OFF; 83 84 /* 85 * The default CLS is used if arch didn't set CLS explicitly and not 86 * all pci devices agree on the same value. Arch can override either 87 * the dfl or actual value as it sees fit. Don't forget this is 88 * measured in 32-bit words, not bytes. 89 */ 90 u8 pci_dfl_cache_line_size = L1_CACHE_BYTES >> 2; 91 u8 pci_cache_line_size; 92 93 /* 94 * If we set up a device for bus mastering, we need to check the latency 95 * timer as certain BIOSes forget to set it properly. 96 */ 97 unsigned int pcibios_max_latency = 255; 98 99 /* If set, the PCIe ARI capability will not be used. */ 100 static bool pcie_ari_disabled; 101 102 /** 103 * pci_bus_max_busnr - returns maximum PCI bus number of given bus' children 104 * @bus: pointer to PCI bus structure to search 105 * 106 * Given a PCI bus, returns the highest PCI bus number present in the set 107 * including the given PCI bus and its list of child PCI buses. 108 */ 109 unsigned char pci_bus_max_busnr(struct pci_bus *bus) 110 { 111 struct pci_bus *tmp; 112 unsigned char max, n; 113 114 max = bus->busn_res.end; 115 list_for_each_entry(tmp, &bus->children, node) { 116 n = pci_bus_max_busnr(tmp); 117 if (n > max) 118 max = n; 119 } 120 return max; 121 } 122 EXPORT_SYMBOL_GPL(pci_bus_max_busnr); 123 124 #ifdef CONFIG_HAS_IOMEM 125 void __iomem *pci_ioremap_bar(struct pci_dev *pdev, int bar) 126 { 127 /* 128 * Make sure the BAR is actually a memory resource, not an IO resource 129 */ 130 if (!(pci_resource_flags(pdev, bar) & IORESOURCE_MEM)) { 131 WARN_ON(1); 132 return NULL; 133 } 134 return ioremap_nocache(pci_resource_start(pdev, bar), 135 pci_resource_len(pdev, bar)); 136 } 137 EXPORT_SYMBOL_GPL(pci_ioremap_bar); 138 #endif 139 140 #define PCI_FIND_CAP_TTL 48 141 142 static int __pci_find_next_cap_ttl(struct pci_bus *bus, unsigned int devfn, 143 u8 pos, int cap, int *ttl) 144 { 145 u8 id; 146 147 while ((*ttl)--) { 148 pci_bus_read_config_byte(bus, devfn, pos, &pos); 149 if (pos < 0x40) 150 break; 151 pos &= ~3; 152 pci_bus_read_config_byte(bus, devfn, pos + PCI_CAP_LIST_ID, 153 &id); 154 if (id == 0xff) 155 break; 156 if (id == cap) 157 return pos; 158 pos += PCI_CAP_LIST_NEXT; 159 } 160 return 0; 161 } 162 163 static int __pci_find_next_cap(struct pci_bus *bus, unsigned int devfn, 164 u8 pos, int cap) 165 { 166 int ttl = PCI_FIND_CAP_TTL; 167 168 return __pci_find_next_cap_ttl(bus, devfn, pos, cap, &ttl); 169 } 170 171 int pci_find_next_capability(struct pci_dev *dev, u8 pos, int cap) 172 { 173 return __pci_find_next_cap(dev->bus, dev->devfn, 174 pos + PCI_CAP_LIST_NEXT, cap); 175 } 176 EXPORT_SYMBOL_GPL(pci_find_next_capability); 177 178 static int __pci_bus_find_cap_start(struct pci_bus *bus, 179 unsigned int devfn, u8 hdr_type) 180 { 181 u16 status; 182 183 pci_bus_read_config_word(bus, devfn, PCI_STATUS, &status); 184 if (!(status & PCI_STATUS_CAP_LIST)) 185 return 0; 186 187 switch (hdr_type) { 188 case PCI_HEADER_TYPE_NORMAL: 189 case PCI_HEADER_TYPE_BRIDGE: 190 return PCI_CAPABILITY_LIST; 191 case PCI_HEADER_TYPE_CARDBUS: 192 return PCI_CB_CAPABILITY_LIST; 193 default: 194 return 0; 195 } 196 197 return 0; 198 } 199 200 /** 201 * pci_find_capability - query for devices' capabilities 202 * @dev: PCI device to query 203 * @cap: capability code 204 * 205 * Tell if a device supports a given PCI capability. 206 * Returns the address of the requested capability structure within the 207 * device's PCI configuration space or 0 in case the device does not 208 * support it. Possible values for @cap: 209 * 210 * %PCI_CAP_ID_PM Power Management 211 * %PCI_CAP_ID_AGP Accelerated Graphics Port 212 * %PCI_CAP_ID_VPD Vital Product Data 213 * %PCI_CAP_ID_SLOTID Slot Identification 214 * %PCI_CAP_ID_MSI Message Signalled Interrupts 215 * %PCI_CAP_ID_CHSWP CompactPCI HotSwap 216 * %PCI_CAP_ID_PCIX PCI-X 217 * %PCI_CAP_ID_EXP PCI Express 218 */ 219 int pci_find_capability(struct pci_dev *dev, int cap) 220 { 221 int pos; 222 223 pos = __pci_bus_find_cap_start(dev->bus, dev->devfn, dev->hdr_type); 224 if (pos) 225 pos = __pci_find_next_cap(dev->bus, dev->devfn, pos, cap); 226 227 return pos; 228 } 229 EXPORT_SYMBOL(pci_find_capability); 230 231 /** 232 * pci_bus_find_capability - query for devices' capabilities 233 * @bus: the PCI bus to query 234 * @devfn: PCI device to query 235 * @cap: capability code 236 * 237 * Like pci_find_capability() but works for pci devices that do not have a 238 * pci_dev structure set up yet. 239 * 240 * Returns the address of the requested capability structure within the 241 * device's PCI configuration space or 0 in case the device does not 242 * support it. 243 */ 244 int pci_bus_find_capability(struct pci_bus *bus, unsigned int devfn, int cap) 245 { 246 int pos; 247 u8 hdr_type; 248 249 pci_bus_read_config_byte(bus, devfn, PCI_HEADER_TYPE, &hdr_type); 250 251 pos = __pci_bus_find_cap_start(bus, devfn, hdr_type & 0x7f); 252 if (pos) 253 pos = __pci_find_next_cap(bus, devfn, pos, cap); 254 255 return pos; 256 } 257 EXPORT_SYMBOL(pci_bus_find_capability); 258 259 /** 260 * pci_find_next_ext_capability - Find an extended capability 261 * @dev: PCI device to query 262 * @start: address at which to start looking (0 to start at beginning of list) 263 * @cap: capability code 264 * 265 * Returns the address of the next matching extended capability structure 266 * within the device's PCI configuration space or 0 if the device does 267 * not support it. Some capabilities can occur several times, e.g., the 268 * vendor-specific capability, and this provides a way to find them all. 269 */ 270 int pci_find_next_ext_capability(struct pci_dev *dev, int start, int cap) 271 { 272 u32 header; 273 int ttl; 274 int pos = PCI_CFG_SPACE_SIZE; 275 276 /* minimum 8 bytes per capability */ 277 ttl = (PCI_CFG_SPACE_EXP_SIZE - PCI_CFG_SPACE_SIZE) / 8; 278 279 if (dev->cfg_size <= PCI_CFG_SPACE_SIZE) 280 return 0; 281 282 if (start) 283 pos = start; 284 285 if (pci_read_config_dword(dev, pos, &header) != PCIBIOS_SUCCESSFUL) 286 return 0; 287 288 /* 289 * If we have no capabilities, this is indicated by cap ID, 290 * cap version and next pointer all being 0. 291 */ 292 if (header == 0) 293 return 0; 294 295 while (ttl-- > 0) { 296 if (PCI_EXT_CAP_ID(header) == cap && pos != start) 297 return pos; 298 299 pos = PCI_EXT_CAP_NEXT(header); 300 if (pos < PCI_CFG_SPACE_SIZE) 301 break; 302 303 if (pci_read_config_dword(dev, pos, &header) != PCIBIOS_SUCCESSFUL) 304 break; 305 } 306 307 return 0; 308 } 309 EXPORT_SYMBOL_GPL(pci_find_next_ext_capability); 310 311 /** 312 * pci_find_ext_capability - Find an extended capability 313 * @dev: PCI device to query 314 * @cap: capability code 315 * 316 * Returns the address of the requested extended capability structure 317 * within the device's PCI configuration space or 0 if the device does 318 * not support it. Possible values for @cap: 319 * 320 * %PCI_EXT_CAP_ID_ERR Advanced Error Reporting 321 * %PCI_EXT_CAP_ID_VC Virtual Channel 322 * %PCI_EXT_CAP_ID_DSN Device Serial Number 323 * %PCI_EXT_CAP_ID_PWR Power Budgeting 324 */ 325 int pci_find_ext_capability(struct pci_dev *dev, int cap) 326 { 327 return pci_find_next_ext_capability(dev, 0, cap); 328 } 329 EXPORT_SYMBOL_GPL(pci_find_ext_capability); 330 331 static int __pci_find_next_ht_cap(struct pci_dev *dev, int pos, int ht_cap) 332 { 333 int rc, ttl = PCI_FIND_CAP_TTL; 334 u8 cap, mask; 335 336 if (ht_cap == HT_CAPTYPE_SLAVE || ht_cap == HT_CAPTYPE_HOST) 337 mask = HT_3BIT_CAP_MASK; 338 else 339 mask = HT_5BIT_CAP_MASK; 340 341 pos = __pci_find_next_cap_ttl(dev->bus, dev->devfn, pos, 342 PCI_CAP_ID_HT, &ttl); 343 while (pos) { 344 rc = pci_read_config_byte(dev, pos + 3, &cap); 345 if (rc != PCIBIOS_SUCCESSFUL) 346 return 0; 347 348 if ((cap & mask) == ht_cap) 349 return pos; 350 351 pos = __pci_find_next_cap_ttl(dev->bus, dev->devfn, 352 pos + PCI_CAP_LIST_NEXT, 353 PCI_CAP_ID_HT, &ttl); 354 } 355 356 return 0; 357 } 358 /** 359 * pci_find_next_ht_capability - query a device's Hypertransport capabilities 360 * @dev: PCI device to query 361 * @pos: Position from which to continue searching 362 * @ht_cap: Hypertransport capability code 363 * 364 * To be used in conjunction with pci_find_ht_capability() to search for 365 * all capabilities matching @ht_cap. @pos should always be a value returned 366 * from pci_find_ht_capability(). 367 * 368 * NB. To be 100% safe against broken PCI devices, the caller should take 369 * steps to avoid an infinite loop. 370 */ 371 int pci_find_next_ht_capability(struct pci_dev *dev, int pos, int ht_cap) 372 { 373 return __pci_find_next_ht_cap(dev, pos + PCI_CAP_LIST_NEXT, ht_cap); 374 } 375 EXPORT_SYMBOL_GPL(pci_find_next_ht_capability); 376 377 /** 378 * pci_find_ht_capability - query a device's Hypertransport capabilities 379 * @dev: PCI device to query 380 * @ht_cap: Hypertransport capability code 381 * 382 * Tell if a device supports a given Hypertransport capability. 383 * Returns an address within the device's PCI configuration space 384 * or 0 in case the device does not support the request capability. 385 * The address points to the PCI capability, of type PCI_CAP_ID_HT, 386 * which has a Hypertransport capability matching @ht_cap. 387 */ 388 int pci_find_ht_capability(struct pci_dev *dev, int ht_cap) 389 { 390 int pos; 391 392 pos = __pci_bus_find_cap_start(dev->bus, dev->devfn, dev->hdr_type); 393 if (pos) 394 pos = __pci_find_next_ht_cap(dev, pos, ht_cap); 395 396 return pos; 397 } 398 EXPORT_SYMBOL_GPL(pci_find_ht_capability); 399 400 /** 401 * pci_find_parent_resource - return resource region of parent bus of given region 402 * @dev: PCI device structure contains resources to be searched 403 * @res: child resource record for which parent is sought 404 * 405 * For given resource region of given device, return the resource 406 * region of parent bus the given region is contained in. 407 */ 408 struct resource *pci_find_parent_resource(const struct pci_dev *dev, 409 struct resource *res) 410 { 411 const struct pci_bus *bus = dev->bus; 412 struct resource *r; 413 int i; 414 415 pci_bus_for_each_resource(bus, r, i) { 416 if (!r) 417 continue; 418 if (res->start && resource_contains(r, res)) { 419 420 /* 421 * If the window is prefetchable but the BAR is 422 * not, the allocator made a mistake. 423 */ 424 if (r->flags & IORESOURCE_PREFETCH && 425 !(res->flags & IORESOURCE_PREFETCH)) 426 return NULL; 427 428 /* 429 * If we're below a transparent bridge, there may 430 * be both a positively-decoded aperture and a 431 * subtractively-decoded region that contain the BAR. 432 * We want the positively-decoded one, so this depends 433 * on pci_bus_for_each_resource() giving us those 434 * first. 435 */ 436 return r; 437 } 438 } 439 return NULL; 440 } 441 EXPORT_SYMBOL(pci_find_parent_resource); 442 443 /** 444 * pci_wait_for_pending - wait for @mask bit(s) to clear in status word @pos 445 * @dev: the PCI device to operate on 446 * @pos: config space offset of status word 447 * @mask: mask of bit(s) to care about in status word 448 * 449 * Return 1 when mask bit(s) in status word clear, 0 otherwise. 450 */ 451 int pci_wait_for_pending(struct pci_dev *dev, int pos, u16 mask) 452 { 453 int i; 454 455 /* Wait for Transaction Pending bit clean */ 456 for (i = 0; i < 4; i++) { 457 u16 status; 458 if (i) 459 msleep((1 << (i - 1)) * 100); 460 461 pci_read_config_word(dev, pos, &status); 462 if (!(status & mask)) 463 return 1; 464 } 465 466 return 0; 467 } 468 469 /** 470 * pci_restore_bars - restore a devices BAR values (e.g. after wake-up) 471 * @dev: PCI device to have its BARs restored 472 * 473 * Restore the BAR values for a given device, so as to make it 474 * accessible by its driver. 475 */ 476 static void pci_restore_bars(struct pci_dev *dev) 477 { 478 int i; 479 480 for (i = 0; i < PCI_BRIDGE_RESOURCES; i++) 481 pci_update_resource(dev, i); 482 } 483 484 static struct pci_platform_pm_ops *pci_platform_pm; 485 486 int pci_set_platform_pm(struct pci_platform_pm_ops *ops) 487 { 488 if (!ops->is_manageable || !ops->set_state || !ops->choose_state 489 || !ops->sleep_wake) 490 return -EINVAL; 491 pci_platform_pm = ops; 492 return 0; 493 } 494 495 static inline bool platform_pci_power_manageable(struct pci_dev *dev) 496 { 497 return pci_platform_pm ? pci_platform_pm->is_manageable(dev) : false; 498 } 499 500 static inline int platform_pci_set_power_state(struct pci_dev *dev, 501 pci_power_t t) 502 { 503 return pci_platform_pm ? pci_platform_pm->set_state(dev, t) : -ENOSYS; 504 } 505 506 static inline pci_power_t platform_pci_choose_state(struct pci_dev *dev) 507 { 508 return pci_platform_pm ? 509 pci_platform_pm->choose_state(dev) : PCI_POWER_ERROR; 510 } 511 512 static inline int platform_pci_sleep_wake(struct pci_dev *dev, bool enable) 513 { 514 return pci_platform_pm ? 515 pci_platform_pm->sleep_wake(dev, enable) : -ENODEV; 516 } 517 518 static inline int platform_pci_run_wake(struct pci_dev *dev, bool enable) 519 { 520 return pci_platform_pm ? 521 pci_platform_pm->run_wake(dev, enable) : -ENODEV; 522 } 523 524 /** 525 * pci_raw_set_power_state - Use PCI PM registers to set the power state of 526 * given PCI device 527 * @dev: PCI device to handle. 528 * @state: PCI power state (D0, D1, D2, D3hot) to put the device into. 529 * 530 * RETURN VALUE: 531 * -EINVAL if the requested state is invalid. 532 * -EIO if device does not support PCI PM or its PM capabilities register has a 533 * wrong version, or device doesn't support the requested state. 534 * 0 if device already is in the requested state. 535 * 0 if device's power state has been successfully changed. 536 */ 537 static int pci_raw_set_power_state(struct pci_dev *dev, pci_power_t state) 538 { 539 u16 pmcsr; 540 bool need_restore = false; 541 542 /* Check if we're already there */ 543 if (dev->current_state == state) 544 return 0; 545 546 if (!dev->pm_cap) 547 return -EIO; 548 549 if (state < PCI_D0 || state > PCI_D3hot) 550 return -EINVAL; 551 552 /* Validate current state: 553 * Can enter D0 from any state, but if we can only go deeper 554 * to sleep if we're already in a low power state 555 */ 556 if (state != PCI_D0 && dev->current_state <= PCI_D3cold 557 && dev->current_state > state) { 558 dev_err(&dev->dev, "invalid power transition (from state %d to %d)\n", 559 dev->current_state, state); 560 return -EINVAL; 561 } 562 563 /* check if this device supports the desired state */ 564 if ((state == PCI_D1 && !dev->d1_support) 565 || (state == PCI_D2 && !dev->d2_support)) 566 return -EIO; 567 568 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr); 569 570 /* If we're (effectively) in D3, force entire word to 0. 571 * This doesn't affect PME_Status, disables PME_En, and 572 * sets PowerState to 0. 573 */ 574 switch (dev->current_state) { 575 case PCI_D0: 576 case PCI_D1: 577 case PCI_D2: 578 pmcsr &= ~PCI_PM_CTRL_STATE_MASK; 579 pmcsr |= state; 580 break; 581 case PCI_D3hot: 582 case PCI_D3cold: 583 case PCI_UNKNOWN: /* Boot-up */ 584 if ((pmcsr & PCI_PM_CTRL_STATE_MASK) == PCI_D3hot 585 && !(pmcsr & PCI_PM_CTRL_NO_SOFT_RESET)) 586 need_restore = true; 587 /* Fall-through: force to D0 */ 588 default: 589 pmcsr = 0; 590 break; 591 } 592 593 /* enter specified state */ 594 pci_write_config_word(dev, dev->pm_cap + PCI_PM_CTRL, pmcsr); 595 596 /* Mandatory power management transition delays */ 597 /* see PCI PM 1.1 5.6.1 table 18 */ 598 if (state == PCI_D3hot || dev->current_state == PCI_D3hot) 599 pci_dev_d3_sleep(dev); 600 else if (state == PCI_D2 || dev->current_state == PCI_D2) 601 udelay(PCI_PM_D2_DELAY); 602 603 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr); 604 dev->current_state = (pmcsr & PCI_PM_CTRL_STATE_MASK); 605 if (dev->current_state != state && printk_ratelimit()) 606 dev_info(&dev->dev, "Refused to change power state, currently in D%d\n", 607 dev->current_state); 608 609 /* 610 * According to section 5.4.1 of the "PCI BUS POWER MANAGEMENT 611 * INTERFACE SPECIFICATION, REV. 1.2", a device transitioning 612 * from D3hot to D0 _may_ perform an internal reset, thereby 613 * going to "D0 Uninitialized" rather than "D0 Initialized". 614 * For example, at least some versions of the 3c905B and the 615 * 3c556B exhibit this behaviour. 616 * 617 * At least some laptop BIOSen (e.g. the Thinkpad T21) leave 618 * devices in a D3hot state at boot. Consequently, we need to 619 * restore at least the BARs so that the device will be 620 * accessible to its driver. 621 */ 622 if (need_restore) 623 pci_restore_bars(dev); 624 625 if (dev->bus->self) 626 pcie_aspm_pm_state_change(dev->bus->self); 627 628 return 0; 629 } 630 631 /** 632 * pci_update_current_state - Read PCI power state of given device from its 633 * PCI PM registers and cache it 634 * @dev: PCI device to handle. 635 * @state: State to cache in case the device doesn't have the PM capability 636 */ 637 void pci_update_current_state(struct pci_dev *dev, pci_power_t state) 638 { 639 if (dev->pm_cap) { 640 u16 pmcsr; 641 642 /* 643 * Configuration space is not accessible for device in 644 * D3cold, so just keep or set D3cold for safety 645 */ 646 if (dev->current_state == PCI_D3cold) 647 return; 648 if (state == PCI_D3cold) { 649 dev->current_state = PCI_D3cold; 650 return; 651 } 652 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr); 653 dev->current_state = (pmcsr & PCI_PM_CTRL_STATE_MASK); 654 } else { 655 dev->current_state = state; 656 } 657 } 658 659 /** 660 * pci_power_up - Put the given device into D0 forcibly 661 * @dev: PCI device to power up 662 */ 663 void pci_power_up(struct pci_dev *dev) 664 { 665 if (platform_pci_power_manageable(dev)) 666 platform_pci_set_power_state(dev, PCI_D0); 667 668 pci_raw_set_power_state(dev, PCI_D0); 669 pci_update_current_state(dev, PCI_D0); 670 } 671 672 /** 673 * pci_platform_power_transition - Use platform to change device power state 674 * @dev: PCI device to handle. 675 * @state: State to put the device into. 676 */ 677 static int pci_platform_power_transition(struct pci_dev *dev, pci_power_t state) 678 { 679 int error; 680 681 if (platform_pci_power_manageable(dev)) { 682 error = platform_pci_set_power_state(dev, state); 683 if (!error) 684 pci_update_current_state(dev, state); 685 } else 686 error = -ENODEV; 687 688 if (error && !dev->pm_cap) /* Fall back to PCI_D0 */ 689 dev->current_state = PCI_D0; 690 691 return error; 692 } 693 694 /** 695 * pci_wakeup - Wake up a PCI device 696 * @pci_dev: Device to handle. 697 * @ign: ignored parameter 698 */ 699 static int pci_wakeup(struct pci_dev *pci_dev, void *ign) 700 { 701 pci_wakeup_event(pci_dev); 702 pm_request_resume(&pci_dev->dev); 703 return 0; 704 } 705 706 /** 707 * pci_wakeup_bus - Walk given bus and wake up devices on it 708 * @bus: Top bus of the subtree to walk. 709 */ 710 static void pci_wakeup_bus(struct pci_bus *bus) 711 { 712 if (bus) 713 pci_walk_bus(bus, pci_wakeup, NULL); 714 } 715 716 /** 717 * __pci_start_power_transition - Start power transition of a PCI device 718 * @dev: PCI device to handle. 719 * @state: State to put the device into. 720 */ 721 static void __pci_start_power_transition(struct pci_dev *dev, pci_power_t state) 722 { 723 if (state == PCI_D0) { 724 pci_platform_power_transition(dev, PCI_D0); 725 /* 726 * Mandatory power management transition delays, see 727 * PCI Express Base Specification Revision 2.0 Section 728 * 6.6.1: Conventional Reset. Do not delay for 729 * devices powered on/off by corresponding bridge, 730 * because have already delayed for the bridge. 731 */ 732 if (dev->runtime_d3cold) { 733 msleep(dev->d3cold_delay); 734 /* 735 * When powering on a bridge from D3cold, the 736 * whole hierarchy may be powered on into 737 * D0uninitialized state, resume them to give 738 * them a chance to suspend again 739 */ 740 pci_wakeup_bus(dev->subordinate); 741 } 742 } 743 } 744 745 /** 746 * __pci_dev_set_current_state - Set current state of a PCI device 747 * @dev: Device to handle 748 * @data: pointer to state to be set 749 */ 750 static int __pci_dev_set_current_state(struct pci_dev *dev, void *data) 751 { 752 pci_power_t state = *(pci_power_t *)data; 753 754 dev->current_state = state; 755 return 0; 756 } 757 758 /** 759 * __pci_bus_set_current_state - Walk given bus and set current state of devices 760 * @bus: Top bus of the subtree to walk. 761 * @state: state to be set 762 */ 763 static void __pci_bus_set_current_state(struct pci_bus *bus, pci_power_t state) 764 { 765 if (bus) 766 pci_walk_bus(bus, __pci_dev_set_current_state, &state); 767 } 768 769 /** 770 * __pci_complete_power_transition - Complete power transition of a PCI device 771 * @dev: PCI device to handle. 772 * @state: State to put the device into. 773 * 774 * This function should not be called directly by device drivers. 775 */ 776 int __pci_complete_power_transition(struct pci_dev *dev, pci_power_t state) 777 { 778 int ret; 779 780 if (state <= PCI_D0) 781 return -EINVAL; 782 ret = pci_platform_power_transition(dev, state); 783 /* Power off the bridge may power off the whole hierarchy */ 784 if (!ret && state == PCI_D3cold) 785 __pci_bus_set_current_state(dev->subordinate, PCI_D3cold); 786 return ret; 787 } 788 EXPORT_SYMBOL_GPL(__pci_complete_power_transition); 789 790 /** 791 * pci_set_power_state - Set the power state of a PCI device 792 * @dev: PCI device to handle. 793 * @state: PCI power state (D0, D1, D2, D3hot) to put the device into. 794 * 795 * Transition a device to a new power state, using the platform firmware and/or 796 * the device's PCI PM registers. 797 * 798 * RETURN VALUE: 799 * -EINVAL if the requested state is invalid. 800 * -EIO if device does not support PCI PM or its PM capabilities register has a 801 * wrong version, or device doesn't support the requested state. 802 * 0 if device already is in the requested state. 803 * 0 if device's power state has been successfully changed. 804 */ 805 int pci_set_power_state(struct pci_dev *dev, pci_power_t state) 806 { 807 int error; 808 809 /* bound the state we're entering */ 810 if (state > PCI_D3cold) 811 state = PCI_D3cold; 812 else if (state < PCI_D0) 813 state = PCI_D0; 814 else if ((state == PCI_D1 || state == PCI_D2) && pci_no_d1d2(dev)) 815 /* 816 * If the device or the parent bridge do not support PCI PM, 817 * ignore the request if we're doing anything other than putting 818 * it into D0 (which would only happen on boot). 819 */ 820 return 0; 821 822 /* Check if we're already there */ 823 if (dev->current_state == state) 824 return 0; 825 826 __pci_start_power_transition(dev, state); 827 828 /* This device is quirked not to be put into D3, so 829 don't put it in D3 */ 830 if (state >= PCI_D3hot && (dev->dev_flags & PCI_DEV_FLAGS_NO_D3)) 831 return 0; 832 833 /* 834 * To put device in D3cold, we put device into D3hot in native 835 * way, then put device into D3cold with platform ops 836 */ 837 error = pci_raw_set_power_state(dev, state > PCI_D3hot ? 838 PCI_D3hot : state); 839 840 if (!__pci_complete_power_transition(dev, state)) 841 error = 0; 842 843 return error; 844 } 845 EXPORT_SYMBOL(pci_set_power_state); 846 847 /** 848 * pci_choose_state - Choose the power state of a PCI device 849 * @dev: PCI device to be suspended 850 * @state: target sleep state for the whole system. This is the value 851 * that is passed to suspend() function. 852 * 853 * Returns PCI power state suitable for given device and given system 854 * message. 855 */ 856 857 pci_power_t pci_choose_state(struct pci_dev *dev, pm_message_t state) 858 { 859 pci_power_t ret; 860 861 if (!dev->pm_cap) 862 return PCI_D0; 863 864 ret = platform_pci_choose_state(dev); 865 if (ret != PCI_POWER_ERROR) 866 return ret; 867 868 switch (state.event) { 869 case PM_EVENT_ON: 870 return PCI_D0; 871 case PM_EVENT_FREEZE: 872 case PM_EVENT_PRETHAW: 873 /* REVISIT both freeze and pre-thaw "should" use D0 */ 874 case PM_EVENT_SUSPEND: 875 case PM_EVENT_HIBERNATE: 876 return PCI_D3hot; 877 default: 878 dev_info(&dev->dev, "unrecognized suspend event %d\n", 879 state.event); 880 BUG(); 881 } 882 return PCI_D0; 883 } 884 EXPORT_SYMBOL(pci_choose_state); 885 886 #define PCI_EXP_SAVE_REGS 7 887 888 static struct pci_cap_saved_state *_pci_find_saved_cap(struct pci_dev *pci_dev, 889 u16 cap, bool extended) 890 { 891 struct pci_cap_saved_state *tmp; 892 893 hlist_for_each_entry(tmp, &pci_dev->saved_cap_space, next) { 894 if (tmp->cap.cap_extended == extended && tmp->cap.cap_nr == cap) 895 return tmp; 896 } 897 return NULL; 898 } 899 900 struct pci_cap_saved_state *pci_find_saved_cap(struct pci_dev *dev, char cap) 901 { 902 return _pci_find_saved_cap(dev, cap, false); 903 } 904 905 struct pci_cap_saved_state *pci_find_saved_ext_cap(struct pci_dev *dev, u16 cap) 906 { 907 return _pci_find_saved_cap(dev, cap, true); 908 } 909 910 static int pci_save_pcie_state(struct pci_dev *dev) 911 { 912 int i = 0; 913 struct pci_cap_saved_state *save_state; 914 u16 *cap; 915 916 if (!pci_is_pcie(dev)) 917 return 0; 918 919 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_EXP); 920 if (!save_state) { 921 dev_err(&dev->dev, "buffer not found in %s\n", __func__); 922 return -ENOMEM; 923 } 924 925 cap = (u16 *)&save_state->cap.data[0]; 926 pcie_capability_read_word(dev, PCI_EXP_DEVCTL, &cap[i++]); 927 pcie_capability_read_word(dev, PCI_EXP_LNKCTL, &cap[i++]); 928 pcie_capability_read_word(dev, PCI_EXP_SLTCTL, &cap[i++]); 929 pcie_capability_read_word(dev, PCI_EXP_RTCTL, &cap[i++]); 930 pcie_capability_read_word(dev, PCI_EXP_DEVCTL2, &cap[i++]); 931 pcie_capability_read_word(dev, PCI_EXP_LNKCTL2, &cap[i++]); 932 pcie_capability_read_word(dev, PCI_EXP_SLTCTL2, &cap[i++]); 933 934 return 0; 935 } 936 937 static void pci_restore_pcie_state(struct pci_dev *dev) 938 { 939 int i = 0; 940 struct pci_cap_saved_state *save_state; 941 u16 *cap; 942 943 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_EXP); 944 if (!save_state) 945 return; 946 947 cap = (u16 *)&save_state->cap.data[0]; 948 pcie_capability_write_word(dev, PCI_EXP_DEVCTL, cap[i++]); 949 pcie_capability_write_word(dev, PCI_EXP_LNKCTL, cap[i++]); 950 pcie_capability_write_word(dev, PCI_EXP_SLTCTL, cap[i++]); 951 pcie_capability_write_word(dev, PCI_EXP_RTCTL, cap[i++]); 952 pcie_capability_write_word(dev, PCI_EXP_DEVCTL2, cap[i++]); 953 pcie_capability_write_word(dev, PCI_EXP_LNKCTL2, cap[i++]); 954 pcie_capability_write_word(dev, PCI_EXP_SLTCTL2, cap[i++]); 955 } 956 957 958 static int pci_save_pcix_state(struct pci_dev *dev) 959 { 960 int pos; 961 struct pci_cap_saved_state *save_state; 962 963 pos = pci_find_capability(dev, PCI_CAP_ID_PCIX); 964 if (pos <= 0) 965 return 0; 966 967 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_PCIX); 968 if (!save_state) { 969 dev_err(&dev->dev, "buffer not found in %s\n", __func__); 970 return -ENOMEM; 971 } 972 973 pci_read_config_word(dev, pos + PCI_X_CMD, 974 (u16 *)save_state->cap.data); 975 976 return 0; 977 } 978 979 static void pci_restore_pcix_state(struct pci_dev *dev) 980 { 981 int i = 0, pos; 982 struct pci_cap_saved_state *save_state; 983 u16 *cap; 984 985 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_PCIX); 986 pos = pci_find_capability(dev, PCI_CAP_ID_PCIX); 987 if (!save_state || pos <= 0) 988 return; 989 cap = (u16 *)&save_state->cap.data[0]; 990 991 pci_write_config_word(dev, pos + PCI_X_CMD, cap[i++]); 992 } 993 994 995 /** 996 * pci_save_state - save the PCI configuration space of a device before suspending 997 * @dev: - PCI device that we're dealing with 998 */ 999 int pci_save_state(struct pci_dev *dev) 1000 { 1001 int i; 1002 /* XXX: 100% dword access ok here? */ 1003 for (i = 0; i < 16; i++) 1004 pci_read_config_dword(dev, i * 4, &dev->saved_config_space[i]); 1005 dev->state_saved = true; 1006 if ((i = pci_save_pcie_state(dev)) != 0) 1007 return i; 1008 if ((i = pci_save_pcix_state(dev)) != 0) 1009 return i; 1010 if ((i = pci_save_vc_state(dev)) != 0) 1011 return i; 1012 return 0; 1013 } 1014 EXPORT_SYMBOL(pci_save_state); 1015 1016 static void pci_restore_config_dword(struct pci_dev *pdev, int offset, 1017 u32 saved_val, int retry) 1018 { 1019 u32 val; 1020 1021 pci_read_config_dword(pdev, offset, &val); 1022 if (val == saved_val) 1023 return; 1024 1025 for (;;) { 1026 dev_dbg(&pdev->dev, "restoring config space at offset %#x (was %#x, writing %#x)\n", 1027 offset, val, saved_val); 1028 pci_write_config_dword(pdev, offset, saved_val); 1029 if (retry-- <= 0) 1030 return; 1031 1032 pci_read_config_dword(pdev, offset, &val); 1033 if (val == saved_val) 1034 return; 1035 1036 mdelay(1); 1037 } 1038 } 1039 1040 static void pci_restore_config_space_range(struct pci_dev *pdev, 1041 int start, int end, int retry) 1042 { 1043 int index; 1044 1045 for (index = end; index >= start; index--) 1046 pci_restore_config_dword(pdev, 4 * index, 1047 pdev->saved_config_space[index], 1048 retry); 1049 } 1050 1051 static void pci_restore_config_space(struct pci_dev *pdev) 1052 { 1053 if (pdev->hdr_type == PCI_HEADER_TYPE_NORMAL) { 1054 pci_restore_config_space_range(pdev, 10, 15, 0); 1055 /* Restore BARs before the command register. */ 1056 pci_restore_config_space_range(pdev, 4, 9, 10); 1057 pci_restore_config_space_range(pdev, 0, 3, 0); 1058 } else { 1059 pci_restore_config_space_range(pdev, 0, 15, 0); 1060 } 1061 } 1062 1063 /** 1064 * pci_restore_state - Restore the saved state of a PCI device 1065 * @dev: - PCI device that we're dealing with 1066 */ 1067 void pci_restore_state(struct pci_dev *dev) 1068 { 1069 if (!dev->state_saved) 1070 return; 1071 1072 /* PCI Express register must be restored first */ 1073 pci_restore_pcie_state(dev); 1074 pci_restore_ats_state(dev); 1075 pci_restore_vc_state(dev); 1076 1077 pci_restore_config_space(dev); 1078 1079 pci_restore_pcix_state(dev); 1080 pci_restore_msi_state(dev); 1081 pci_restore_iov_state(dev); 1082 1083 dev->state_saved = false; 1084 } 1085 EXPORT_SYMBOL(pci_restore_state); 1086 1087 struct pci_saved_state { 1088 u32 config_space[16]; 1089 struct pci_cap_saved_data cap[0]; 1090 }; 1091 1092 /** 1093 * pci_store_saved_state - Allocate and return an opaque struct containing 1094 * the device saved state. 1095 * @dev: PCI device that we're dealing with 1096 * 1097 * Return NULL if no state or error. 1098 */ 1099 struct pci_saved_state *pci_store_saved_state(struct pci_dev *dev) 1100 { 1101 struct pci_saved_state *state; 1102 struct pci_cap_saved_state *tmp; 1103 struct pci_cap_saved_data *cap; 1104 size_t size; 1105 1106 if (!dev->state_saved) 1107 return NULL; 1108 1109 size = sizeof(*state) + sizeof(struct pci_cap_saved_data); 1110 1111 hlist_for_each_entry(tmp, &dev->saved_cap_space, next) 1112 size += sizeof(struct pci_cap_saved_data) + tmp->cap.size; 1113 1114 state = kzalloc(size, GFP_KERNEL); 1115 if (!state) 1116 return NULL; 1117 1118 memcpy(state->config_space, dev->saved_config_space, 1119 sizeof(state->config_space)); 1120 1121 cap = state->cap; 1122 hlist_for_each_entry(tmp, &dev->saved_cap_space, next) { 1123 size_t len = sizeof(struct pci_cap_saved_data) + tmp->cap.size; 1124 memcpy(cap, &tmp->cap, len); 1125 cap = (struct pci_cap_saved_data *)((u8 *)cap + len); 1126 } 1127 /* Empty cap_save terminates list */ 1128 1129 return state; 1130 } 1131 EXPORT_SYMBOL_GPL(pci_store_saved_state); 1132 1133 /** 1134 * pci_load_saved_state - Reload the provided save state into struct pci_dev. 1135 * @dev: PCI device that we're dealing with 1136 * @state: Saved state returned from pci_store_saved_state() 1137 */ 1138 static int pci_load_saved_state(struct pci_dev *dev, 1139 struct pci_saved_state *state) 1140 { 1141 struct pci_cap_saved_data *cap; 1142 1143 dev->state_saved = false; 1144 1145 if (!state) 1146 return 0; 1147 1148 memcpy(dev->saved_config_space, state->config_space, 1149 sizeof(state->config_space)); 1150 1151 cap = state->cap; 1152 while (cap->size) { 1153 struct pci_cap_saved_state *tmp; 1154 1155 tmp = _pci_find_saved_cap(dev, cap->cap_nr, cap->cap_extended); 1156 if (!tmp || tmp->cap.size != cap->size) 1157 return -EINVAL; 1158 1159 memcpy(tmp->cap.data, cap->data, tmp->cap.size); 1160 cap = (struct pci_cap_saved_data *)((u8 *)cap + 1161 sizeof(struct pci_cap_saved_data) + cap->size); 1162 } 1163 1164 dev->state_saved = true; 1165 return 0; 1166 } 1167 1168 /** 1169 * pci_load_and_free_saved_state - Reload the save state pointed to by state, 1170 * and free the memory allocated for it. 1171 * @dev: PCI device that we're dealing with 1172 * @state: Pointer to saved state returned from pci_store_saved_state() 1173 */ 1174 int pci_load_and_free_saved_state(struct pci_dev *dev, 1175 struct pci_saved_state **state) 1176 { 1177 int ret = pci_load_saved_state(dev, *state); 1178 kfree(*state); 1179 *state = NULL; 1180 return ret; 1181 } 1182 EXPORT_SYMBOL_GPL(pci_load_and_free_saved_state); 1183 1184 int __weak pcibios_enable_device(struct pci_dev *dev, int bars) 1185 { 1186 return pci_enable_resources(dev, bars); 1187 } 1188 1189 static int do_pci_enable_device(struct pci_dev *dev, int bars) 1190 { 1191 int err; 1192 struct pci_dev *bridge; 1193 u16 cmd; 1194 u8 pin; 1195 1196 err = pci_set_power_state(dev, PCI_D0); 1197 if (err < 0 && err != -EIO) 1198 return err; 1199 1200 bridge = pci_upstream_bridge(dev); 1201 if (bridge) 1202 pcie_aspm_powersave_config_link(bridge); 1203 1204 err = pcibios_enable_device(dev, bars); 1205 if (err < 0) 1206 return err; 1207 pci_fixup_device(pci_fixup_enable, dev); 1208 1209 if (dev->msi_enabled || dev->msix_enabled) 1210 return 0; 1211 1212 pci_read_config_byte(dev, PCI_INTERRUPT_PIN, &pin); 1213 if (pin) { 1214 pci_read_config_word(dev, PCI_COMMAND, &cmd); 1215 if (cmd & PCI_COMMAND_INTX_DISABLE) 1216 pci_write_config_word(dev, PCI_COMMAND, 1217 cmd & ~PCI_COMMAND_INTX_DISABLE); 1218 } 1219 1220 return 0; 1221 } 1222 1223 /** 1224 * pci_reenable_device - Resume abandoned device 1225 * @dev: PCI device to be resumed 1226 * 1227 * Note this function is a backend of pci_default_resume and is not supposed 1228 * to be called by normal code, write proper resume handler and use it instead. 1229 */ 1230 int pci_reenable_device(struct pci_dev *dev) 1231 { 1232 if (pci_is_enabled(dev)) 1233 return do_pci_enable_device(dev, (1 << PCI_NUM_RESOURCES) - 1); 1234 return 0; 1235 } 1236 EXPORT_SYMBOL(pci_reenable_device); 1237 1238 static void pci_enable_bridge(struct pci_dev *dev) 1239 { 1240 struct pci_dev *bridge; 1241 int retval; 1242 1243 bridge = pci_upstream_bridge(dev); 1244 if (bridge) 1245 pci_enable_bridge(bridge); 1246 1247 if (pci_is_enabled(dev)) { 1248 if (!dev->is_busmaster) 1249 pci_set_master(dev); 1250 return; 1251 } 1252 1253 retval = pci_enable_device(dev); 1254 if (retval) 1255 dev_err(&dev->dev, "Error enabling bridge (%d), continuing\n", 1256 retval); 1257 pci_set_master(dev); 1258 } 1259 1260 static int pci_enable_device_flags(struct pci_dev *dev, unsigned long flags) 1261 { 1262 struct pci_dev *bridge; 1263 int err; 1264 int i, bars = 0; 1265 1266 /* 1267 * Power state could be unknown at this point, either due to a fresh 1268 * boot or a device removal call. So get the current power state 1269 * so that things like MSI message writing will behave as expected 1270 * (e.g. if the device really is in D0 at enable time). 1271 */ 1272 if (dev->pm_cap) { 1273 u16 pmcsr; 1274 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr); 1275 dev->current_state = (pmcsr & PCI_PM_CTRL_STATE_MASK); 1276 } 1277 1278 if (atomic_inc_return(&dev->enable_cnt) > 1) 1279 return 0; /* already enabled */ 1280 1281 bridge = pci_upstream_bridge(dev); 1282 if (bridge) 1283 pci_enable_bridge(bridge); 1284 1285 /* only skip sriov related */ 1286 for (i = 0; i <= PCI_ROM_RESOURCE; i++) 1287 if (dev->resource[i].flags & flags) 1288 bars |= (1 << i); 1289 for (i = PCI_BRIDGE_RESOURCES; i < DEVICE_COUNT_RESOURCE; i++) 1290 if (dev->resource[i].flags & flags) 1291 bars |= (1 << i); 1292 1293 err = do_pci_enable_device(dev, bars); 1294 if (err < 0) 1295 atomic_dec(&dev->enable_cnt); 1296 return err; 1297 } 1298 1299 /** 1300 * pci_enable_device_io - Initialize a device for use with IO space 1301 * @dev: PCI device to be initialized 1302 * 1303 * Initialize device before it's used by a driver. Ask low-level code 1304 * to enable I/O resources. Wake up the device if it was suspended. 1305 * Beware, this function can fail. 1306 */ 1307 int pci_enable_device_io(struct pci_dev *dev) 1308 { 1309 return pci_enable_device_flags(dev, IORESOURCE_IO); 1310 } 1311 EXPORT_SYMBOL(pci_enable_device_io); 1312 1313 /** 1314 * pci_enable_device_mem - Initialize a device for use with Memory space 1315 * @dev: PCI device to be initialized 1316 * 1317 * Initialize device before it's used by a driver. Ask low-level code 1318 * to enable Memory resources. Wake up the device if it was suspended. 1319 * Beware, this function can fail. 1320 */ 1321 int pci_enable_device_mem(struct pci_dev *dev) 1322 { 1323 return pci_enable_device_flags(dev, IORESOURCE_MEM); 1324 } 1325 EXPORT_SYMBOL(pci_enable_device_mem); 1326 1327 /** 1328 * pci_enable_device - Initialize device before it's used by a driver. 1329 * @dev: PCI device to be initialized 1330 * 1331 * Initialize device before it's used by a driver. Ask low-level code 1332 * to enable I/O and memory. Wake up the device if it was suspended. 1333 * Beware, this function can fail. 1334 * 1335 * Note we don't actually enable the device many times if we call 1336 * this function repeatedly (we just increment the count). 1337 */ 1338 int pci_enable_device(struct pci_dev *dev) 1339 { 1340 return pci_enable_device_flags(dev, IORESOURCE_MEM | IORESOURCE_IO); 1341 } 1342 EXPORT_SYMBOL(pci_enable_device); 1343 1344 /* 1345 * Managed PCI resources. This manages device on/off, intx/msi/msix 1346 * on/off and BAR regions. pci_dev itself records msi/msix status, so 1347 * there's no need to track it separately. pci_devres is initialized 1348 * when a device is enabled using managed PCI device enable interface. 1349 */ 1350 struct pci_devres { 1351 unsigned int enabled:1; 1352 unsigned int pinned:1; 1353 unsigned int orig_intx:1; 1354 unsigned int restore_intx:1; 1355 u32 region_mask; 1356 }; 1357 1358 static void pcim_release(struct device *gendev, void *res) 1359 { 1360 struct pci_dev *dev = container_of(gendev, struct pci_dev, dev); 1361 struct pci_devres *this = res; 1362 int i; 1363 1364 if (dev->msi_enabled) 1365 pci_disable_msi(dev); 1366 if (dev->msix_enabled) 1367 pci_disable_msix(dev); 1368 1369 for (i = 0; i < DEVICE_COUNT_RESOURCE; i++) 1370 if (this->region_mask & (1 << i)) 1371 pci_release_region(dev, i); 1372 1373 if (this->restore_intx) 1374 pci_intx(dev, this->orig_intx); 1375 1376 if (this->enabled && !this->pinned) 1377 pci_disable_device(dev); 1378 } 1379 1380 static struct pci_devres *get_pci_dr(struct pci_dev *pdev) 1381 { 1382 struct pci_devres *dr, *new_dr; 1383 1384 dr = devres_find(&pdev->dev, pcim_release, NULL, NULL); 1385 if (dr) 1386 return dr; 1387 1388 new_dr = devres_alloc(pcim_release, sizeof(*new_dr), GFP_KERNEL); 1389 if (!new_dr) 1390 return NULL; 1391 return devres_get(&pdev->dev, new_dr, NULL, NULL); 1392 } 1393 1394 static struct pci_devres *find_pci_dr(struct pci_dev *pdev) 1395 { 1396 if (pci_is_managed(pdev)) 1397 return devres_find(&pdev->dev, pcim_release, NULL, NULL); 1398 return NULL; 1399 } 1400 1401 /** 1402 * pcim_enable_device - Managed pci_enable_device() 1403 * @pdev: PCI device to be initialized 1404 * 1405 * Managed pci_enable_device(). 1406 */ 1407 int pcim_enable_device(struct pci_dev *pdev) 1408 { 1409 struct pci_devres *dr; 1410 int rc; 1411 1412 dr = get_pci_dr(pdev); 1413 if (unlikely(!dr)) 1414 return -ENOMEM; 1415 if (dr->enabled) 1416 return 0; 1417 1418 rc = pci_enable_device(pdev); 1419 if (!rc) { 1420 pdev->is_managed = 1; 1421 dr->enabled = 1; 1422 } 1423 return rc; 1424 } 1425 EXPORT_SYMBOL(pcim_enable_device); 1426 1427 /** 1428 * pcim_pin_device - Pin managed PCI device 1429 * @pdev: PCI device to pin 1430 * 1431 * Pin managed PCI device @pdev. Pinned device won't be disabled on 1432 * driver detach. @pdev must have been enabled with 1433 * pcim_enable_device(). 1434 */ 1435 void pcim_pin_device(struct pci_dev *pdev) 1436 { 1437 struct pci_devres *dr; 1438 1439 dr = find_pci_dr(pdev); 1440 WARN_ON(!dr || !dr->enabled); 1441 if (dr) 1442 dr->pinned = 1; 1443 } 1444 EXPORT_SYMBOL(pcim_pin_device); 1445 1446 /* 1447 * pcibios_add_device - provide arch specific hooks when adding device dev 1448 * @dev: the PCI device being added 1449 * 1450 * Permits the platform to provide architecture specific functionality when 1451 * devices are added. This is the default implementation. Architecture 1452 * implementations can override this. 1453 */ 1454 int __weak pcibios_add_device(struct pci_dev *dev) 1455 { 1456 return 0; 1457 } 1458 1459 /** 1460 * pcibios_release_device - provide arch specific hooks when releasing device dev 1461 * @dev: the PCI device being released 1462 * 1463 * Permits the platform to provide architecture specific functionality when 1464 * devices are released. This is the default implementation. Architecture 1465 * implementations can override this. 1466 */ 1467 void __weak pcibios_release_device(struct pci_dev *dev) {} 1468 1469 /** 1470 * pcibios_disable_device - disable arch specific PCI resources for device dev 1471 * @dev: the PCI device to disable 1472 * 1473 * Disables architecture specific PCI resources for the device. This 1474 * is the default implementation. Architecture implementations can 1475 * override this. 1476 */ 1477 void __weak pcibios_disable_device (struct pci_dev *dev) {} 1478 1479 /** 1480 * pcibios_penalize_isa_irq - penalize an ISA IRQ 1481 * @irq: ISA IRQ to penalize 1482 * @active: IRQ active or not 1483 * 1484 * Permits the platform to provide architecture-specific functionality when 1485 * penalizing ISA IRQs. This is the default implementation. Architecture 1486 * implementations can override this. 1487 */ 1488 void __weak pcibios_penalize_isa_irq(int irq, int active) {} 1489 1490 static void do_pci_disable_device(struct pci_dev *dev) 1491 { 1492 u16 pci_command; 1493 1494 pci_read_config_word(dev, PCI_COMMAND, &pci_command); 1495 if (pci_command & PCI_COMMAND_MASTER) { 1496 pci_command &= ~PCI_COMMAND_MASTER; 1497 pci_write_config_word(dev, PCI_COMMAND, pci_command); 1498 } 1499 1500 pcibios_disable_device(dev); 1501 } 1502 1503 /** 1504 * pci_disable_enabled_device - Disable device without updating enable_cnt 1505 * @dev: PCI device to disable 1506 * 1507 * NOTE: This function is a backend of PCI power management routines and is 1508 * not supposed to be called drivers. 1509 */ 1510 void pci_disable_enabled_device(struct pci_dev *dev) 1511 { 1512 if (pci_is_enabled(dev)) 1513 do_pci_disable_device(dev); 1514 } 1515 1516 /** 1517 * pci_disable_device - Disable PCI device after use 1518 * @dev: PCI device to be disabled 1519 * 1520 * Signal to the system that the PCI device is not in use by the system 1521 * anymore. This only involves disabling PCI bus-mastering, if active. 1522 * 1523 * Note we don't actually disable the device until all callers of 1524 * pci_enable_device() have called pci_disable_device(). 1525 */ 1526 void pci_disable_device(struct pci_dev *dev) 1527 { 1528 struct pci_devres *dr; 1529 1530 dr = find_pci_dr(dev); 1531 if (dr) 1532 dr->enabled = 0; 1533 1534 dev_WARN_ONCE(&dev->dev, atomic_read(&dev->enable_cnt) <= 0, 1535 "disabling already-disabled device"); 1536 1537 if (atomic_dec_return(&dev->enable_cnt) != 0) 1538 return; 1539 1540 do_pci_disable_device(dev); 1541 1542 dev->is_busmaster = 0; 1543 } 1544 EXPORT_SYMBOL(pci_disable_device); 1545 1546 /** 1547 * pcibios_set_pcie_reset_state - set reset state for device dev 1548 * @dev: the PCIe device reset 1549 * @state: Reset state to enter into 1550 * 1551 * 1552 * Sets the PCIe reset state for the device. This is the default 1553 * implementation. Architecture implementations can override this. 1554 */ 1555 int __weak pcibios_set_pcie_reset_state(struct pci_dev *dev, 1556 enum pcie_reset_state state) 1557 { 1558 return -EINVAL; 1559 } 1560 1561 /** 1562 * pci_set_pcie_reset_state - set reset state for device dev 1563 * @dev: the PCIe device reset 1564 * @state: Reset state to enter into 1565 * 1566 * 1567 * Sets the PCI reset state for the device. 1568 */ 1569 int pci_set_pcie_reset_state(struct pci_dev *dev, enum pcie_reset_state state) 1570 { 1571 return pcibios_set_pcie_reset_state(dev, state); 1572 } 1573 EXPORT_SYMBOL_GPL(pci_set_pcie_reset_state); 1574 1575 /** 1576 * pci_check_pme_status - Check if given device has generated PME. 1577 * @dev: Device to check. 1578 * 1579 * Check the PME status of the device and if set, clear it and clear PME enable 1580 * (if set). Return 'true' if PME status and PME enable were both set or 1581 * 'false' otherwise. 1582 */ 1583 bool pci_check_pme_status(struct pci_dev *dev) 1584 { 1585 int pmcsr_pos; 1586 u16 pmcsr; 1587 bool ret = false; 1588 1589 if (!dev->pm_cap) 1590 return false; 1591 1592 pmcsr_pos = dev->pm_cap + PCI_PM_CTRL; 1593 pci_read_config_word(dev, pmcsr_pos, &pmcsr); 1594 if (!(pmcsr & PCI_PM_CTRL_PME_STATUS)) 1595 return false; 1596 1597 /* Clear PME status. */ 1598 pmcsr |= PCI_PM_CTRL_PME_STATUS; 1599 if (pmcsr & PCI_PM_CTRL_PME_ENABLE) { 1600 /* Disable PME to avoid interrupt flood. */ 1601 pmcsr &= ~PCI_PM_CTRL_PME_ENABLE; 1602 ret = true; 1603 } 1604 1605 pci_write_config_word(dev, pmcsr_pos, pmcsr); 1606 1607 return ret; 1608 } 1609 1610 /** 1611 * pci_pme_wakeup - Wake up a PCI device if its PME Status bit is set. 1612 * @dev: Device to handle. 1613 * @pme_poll_reset: Whether or not to reset the device's pme_poll flag. 1614 * 1615 * Check if @dev has generated PME and queue a resume request for it in that 1616 * case. 1617 */ 1618 static int pci_pme_wakeup(struct pci_dev *dev, void *pme_poll_reset) 1619 { 1620 if (pme_poll_reset && dev->pme_poll) 1621 dev->pme_poll = false; 1622 1623 if (pci_check_pme_status(dev)) { 1624 pci_wakeup_event(dev); 1625 pm_request_resume(&dev->dev); 1626 } 1627 return 0; 1628 } 1629 1630 /** 1631 * pci_pme_wakeup_bus - Walk given bus and wake up devices on it, if necessary. 1632 * @bus: Top bus of the subtree to walk. 1633 */ 1634 void pci_pme_wakeup_bus(struct pci_bus *bus) 1635 { 1636 if (bus) 1637 pci_walk_bus(bus, pci_pme_wakeup, (void *)true); 1638 } 1639 1640 1641 /** 1642 * pci_pme_capable - check the capability of PCI device to generate PME# 1643 * @dev: PCI device to handle. 1644 * @state: PCI state from which device will issue PME#. 1645 */ 1646 bool pci_pme_capable(struct pci_dev *dev, pci_power_t state) 1647 { 1648 if (!dev->pm_cap) 1649 return false; 1650 1651 return !!(dev->pme_support & (1 << state)); 1652 } 1653 EXPORT_SYMBOL(pci_pme_capable); 1654 1655 static void pci_pme_list_scan(struct work_struct *work) 1656 { 1657 struct pci_pme_device *pme_dev, *n; 1658 1659 mutex_lock(&pci_pme_list_mutex); 1660 list_for_each_entry_safe(pme_dev, n, &pci_pme_list, list) { 1661 if (pme_dev->dev->pme_poll) { 1662 struct pci_dev *bridge; 1663 1664 bridge = pme_dev->dev->bus->self; 1665 /* 1666 * If bridge is in low power state, the 1667 * configuration space of subordinate devices 1668 * may be not accessible 1669 */ 1670 if (bridge && bridge->current_state != PCI_D0) 1671 continue; 1672 pci_pme_wakeup(pme_dev->dev, NULL); 1673 } else { 1674 list_del(&pme_dev->list); 1675 kfree(pme_dev); 1676 } 1677 } 1678 if (!list_empty(&pci_pme_list)) 1679 schedule_delayed_work(&pci_pme_work, 1680 msecs_to_jiffies(PME_TIMEOUT)); 1681 mutex_unlock(&pci_pme_list_mutex); 1682 } 1683 1684 /** 1685 * pci_pme_active - enable or disable PCI device's PME# function 1686 * @dev: PCI device to handle. 1687 * @enable: 'true' to enable PME# generation; 'false' to disable it. 1688 * 1689 * The caller must verify that the device is capable of generating PME# before 1690 * calling this function with @enable equal to 'true'. 1691 */ 1692 void pci_pme_active(struct pci_dev *dev, bool enable) 1693 { 1694 u16 pmcsr; 1695 1696 if (!dev->pme_support) 1697 return; 1698 1699 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr); 1700 /* Clear PME_Status by writing 1 to it and enable PME# */ 1701 pmcsr |= PCI_PM_CTRL_PME_STATUS | PCI_PM_CTRL_PME_ENABLE; 1702 if (!enable) 1703 pmcsr &= ~PCI_PM_CTRL_PME_ENABLE; 1704 1705 pci_write_config_word(dev, dev->pm_cap + PCI_PM_CTRL, pmcsr); 1706 1707 /* 1708 * PCI (as opposed to PCIe) PME requires that the device have 1709 * its PME# line hooked up correctly. Not all hardware vendors 1710 * do this, so the PME never gets delivered and the device 1711 * remains asleep. The easiest way around this is to 1712 * periodically walk the list of suspended devices and check 1713 * whether any have their PME flag set. The assumption is that 1714 * we'll wake up often enough anyway that this won't be a huge 1715 * hit, and the power savings from the devices will still be a 1716 * win. 1717 * 1718 * Although PCIe uses in-band PME message instead of PME# line 1719 * to report PME, PME does not work for some PCIe devices in 1720 * reality. For example, there are devices that set their PME 1721 * status bits, but don't really bother to send a PME message; 1722 * there are PCI Express Root Ports that don't bother to 1723 * trigger interrupts when they receive PME messages from the 1724 * devices below. So PME poll is used for PCIe devices too. 1725 */ 1726 1727 if (dev->pme_poll) { 1728 struct pci_pme_device *pme_dev; 1729 if (enable) { 1730 pme_dev = kmalloc(sizeof(struct pci_pme_device), 1731 GFP_KERNEL); 1732 if (!pme_dev) { 1733 dev_warn(&dev->dev, "can't enable PME#\n"); 1734 return; 1735 } 1736 pme_dev->dev = dev; 1737 mutex_lock(&pci_pme_list_mutex); 1738 list_add(&pme_dev->list, &pci_pme_list); 1739 if (list_is_singular(&pci_pme_list)) 1740 schedule_delayed_work(&pci_pme_work, 1741 msecs_to_jiffies(PME_TIMEOUT)); 1742 mutex_unlock(&pci_pme_list_mutex); 1743 } else { 1744 mutex_lock(&pci_pme_list_mutex); 1745 list_for_each_entry(pme_dev, &pci_pme_list, list) { 1746 if (pme_dev->dev == dev) { 1747 list_del(&pme_dev->list); 1748 kfree(pme_dev); 1749 break; 1750 } 1751 } 1752 mutex_unlock(&pci_pme_list_mutex); 1753 } 1754 } 1755 1756 dev_dbg(&dev->dev, "PME# %s\n", enable ? "enabled" : "disabled"); 1757 } 1758 EXPORT_SYMBOL(pci_pme_active); 1759 1760 /** 1761 * __pci_enable_wake - enable PCI device as wakeup event source 1762 * @dev: PCI device affected 1763 * @state: PCI state from which device will issue wakeup events 1764 * @runtime: True if the events are to be generated at run time 1765 * @enable: True to enable event generation; false to disable 1766 * 1767 * This enables the device as a wakeup event source, or disables it. 1768 * When such events involves platform-specific hooks, those hooks are 1769 * called automatically by this routine. 1770 * 1771 * Devices with legacy power management (no standard PCI PM capabilities) 1772 * always require such platform hooks. 1773 * 1774 * RETURN VALUE: 1775 * 0 is returned on success 1776 * -EINVAL is returned if device is not supposed to wake up the system 1777 * Error code depending on the platform is returned if both the platform and 1778 * the native mechanism fail to enable the generation of wake-up events 1779 */ 1780 int __pci_enable_wake(struct pci_dev *dev, pci_power_t state, 1781 bool runtime, bool enable) 1782 { 1783 int ret = 0; 1784 1785 if (enable && !runtime && !device_may_wakeup(&dev->dev)) 1786 return -EINVAL; 1787 1788 /* Don't do the same thing twice in a row for one device. */ 1789 if (!!enable == !!dev->wakeup_prepared) 1790 return 0; 1791 1792 /* 1793 * According to "PCI System Architecture" 4th ed. by Tom Shanley & Don 1794 * Anderson we should be doing PME# wake enable followed by ACPI wake 1795 * enable. To disable wake-up we call the platform first, for symmetry. 1796 */ 1797 1798 if (enable) { 1799 int error; 1800 1801 if (pci_pme_capable(dev, state)) 1802 pci_pme_active(dev, true); 1803 else 1804 ret = 1; 1805 error = runtime ? platform_pci_run_wake(dev, true) : 1806 platform_pci_sleep_wake(dev, true); 1807 if (ret) 1808 ret = error; 1809 if (!ret) 1810 dev->wakeup_prepared = true; 1811 } else { 1812 if (runtime) 1813 platform_pci_run_wake(dev, false); 1814 else 1815 platform_pci_sleep_wake(dev, false); 1816 pci_pme_active(dev, false); 1817 dev->wakeup_prepared = false; 1818 } 1819 1820 return ret; 1821 } 1822 EXPORT_SYMBOL(__pci_enable_wake); 1823 1824 /** 1825 * pci_wake_from_d3 - enable/disable device to wake up from D3_hot or D3_cold 1826 * @dev: PCI device to prepare 1827 * @enable: True to enable wake-up event generation; false to disable 1828 * 1829 * Many drivers want the device to wake up the system from D3_hot or D3_cold 1830 * and this function allows them to set that up cleanly - pci_enable_wake() 1831 * should not be called twice in a row to enable wake-up due to PCI PM vs ACPI 1832 * ordering constraints. 1833 * 1834 * This function only returns error code if the device is not capable of 1835 * generating PME# from both D3_hot and D3_cold, and the platform is unable to 1836 * enable wake-up power for it. 1837 */ 1838 int pci_wake_from_d3(struct pci_dev *dev, bool enable) 1839 { 1840 return pci_pme_capable(dev, PCI_D3cold) ? 1841 pci_enable_wake(dev, PCI_D3cold, enable) : 1842 pci_enable_wake(dev, PCI_D3hot, enable); 1843 } 1844 EXPORT_SYMBOL(pci_wake_from_d3); 1845 1846 /** 1847 * pci_target_state - find an appropriate low power state for a given PCI dev 1848 * @dev: PCI device 1849 * 1850 * Use underlying platform code to find a supported low power state for @dev. 1851 * If the platform can't manage @dev, return the deepest state from which it 1852 * can generate wake events, based on any available PME info. 1853 */ 1854 static pci_power_t pci_target_state(struct pci_dev *dev) 1855 { 1856 pci_power_t target_state = PCI_D3hot; 1857 1858 if (platform_pci_power_manageable(dev)) { 1859 /* 1860 * Call the platform to choose the target state of the device 1861 * and enable wake-up from this state if supported. 1862 */ 1863 pci_power_t state = platform_pci_choose_state(dev); 1864 1865 switch (state) { 1866 case PCI_POWER_ERROR: 1867 case PCI_UNKNOWN: 1868 break; 1869 case PCI_D1: 1870 case PCI_D2: 1871 if (pci_no_d1d2(dev)) 1872 break; 1873 default: 1874 target_state = state; 1875 } 1876 } else if (!dev->pm_cap) { 1877 target_state = PCI_D0; 1878 } else if (device_may_wakeup(&dev->dev)) { 1879 /* 1880 * Find the deepest state from which the device can generate 1881 * wake-up events, make it the target state and enable device 1882 * to generate PME#. 1883 */ 1884 if (dev->pme_support) { 1885 while (target_state 1886 && !(dev->pme_support & (1 << target_state))) 1887 target_state--; 1888 } 1889 } 1890 1891 return target_state; 1892 } 1893 1894 /** 1895 * pci_prepare_to_sleep - prepare PCI device for system-wide transition into a sleep state 1896 * @dev: Device to handle. 1897 * 1898 * Choose the power state appropriate for the device depending on whether 1899 * it can wake up the system and/or is power manageable by the platform 1900 * (PCI_D3hot is the default) and put the device into that state. 1901 */ 1902 int pci_prepare_to_sleep(struct pci_dev *dev) 1903 { 1904 pci_power_t target_state = pci_target_state(dev); 1905 int error; 1906 1907 if (target_state == PCI_POWER_ERROR) 1908 return -EIO; 1909 1910 /* D3cold during system suspend/hibernate is not supported */ 1911 if (target_state > PCI_D3hot) 1912 target_state = PCI_D3hot; 1913 1914 pci_enable_wake(dev, target_state, device_may_wakeup(&dev->dev)); 1915 1916 error = pci_set_power_state(dev, target_state); 1917 1918 if (error) 1919 pci_enable_wake(dev, target_state, false); 1920 1921 return error; 1922 } 1923 EXPORT_SYMBOL(pci_prepare_to_sleep); 1924 1925 /** 1926 * pci_back_from_sleep - turn PCI device on during system-wide transition into working state 1927 * @dev: Device to handle. 1928 * 1929 * Disable device's system wake-up capability and put it into D0. 1930 */ 1931 int pci_back_from_sleep(struct pci_dev *dev) 1932 { 1933 pci_enable_wake(dev, PCI_D0, false); 1934 return pci_set_power_state(dev, PCI_D0); 1935 } 1936 EXPORT_SYMBOL(pci_back_from_sleep); 1937 1938 /** 1939 * pci_finish_runtime_suspend - Carry out PCI-specific part of runtime suspend. 1940 * @dev: PCI device being suspended. 1941 * 1942 * Prepare @dev to generate wake-up events at run time and put it into a low 1943 * power state. 1944 */ 1945 int pci_finish_runtime_suspend(struct pci_dev *dev) 1946 { 1947 pci_power_t target_state = pci_target_state(dev); 1948 int error; 1949 1950 if (target_state == PCI_POWER_ERROR) 1951 return -EIO; 1952 1953 dev->runtime_d3cold = target_state == PCI_D3cold; 1954 1955 __pci_enable_wake(dev, target_state, true, pci_dev_run_wake(dev)); 1956 1957 error = pci_set_power_state(dev, target_state); 1958 1959 if (error) { 1960 __pci_enable_wake(dev, target_state, true, false); 1961 dev->runtime_d3cold = false; 1962 } 1963 1964 return error; 1965 } 1966 1967 /** 1968 * pci_dev_run_wake - Check if device can generate run-time wake-up events. 1969 * @dev: Device to check. 1970 * 1971 * Return true if the device itself is capable of generating wake-up events 1972 * (through the platform or using the native PCIe PME) or if the device supports 1973 * PME and one of its upstream bridges can generate wake-up events. 1974 */ 1975 bool pci_dev_run_wake(struct pci_dev *dev) 1976 { 1977 struct pci_bus *bus = dev->bus; 1978 1979 if (device_run_wake(&dev->dev)) 1980 return true; 1981 1982 if (!dev->pme_support) 1983 return false; 1984 1985 while (bus->parent) { 1986 struct pci_dev *bridge = bus->self; 1987 1988 if (device_run_wake(&bridge->dev)) 1989 return true; 1990 1991 bus = bus->parent; 1992 } 1993 1994 /* We have reached the root bus. */ 1995 if (bus->bridge) 1996 return device_run_wake(bus->bridge); 1997 1998 return false; 1999 } 2000 EXPORT_SYMBOL_GPL(pci_dev_run_wake); 2001 2002 void pci_config_pm_runtime_get(struct pci_dev *pdev) 2003 { 2004 struct device *dev = &pdev->dev; 2005 struct device *parent = dev->parent; 2006 2007 if (parent) 2008 pm_runtime_get_sync(parent); 2009 pm_runtime_get_noresume(dev); 2010 /* 2011 * pdev->current_state is set to PCI_D3cold during suspending, 2012 * so wait until suspending completes 2013 */ 2014 pm_runtime_barrier(dev); 2015 /* 2016 * Only need to resume devices in D3cold, because config 2017 * registers are still accessible for devices suspended but 2018 * not in D3cold. 2019 */ 2020 if (pdev->current_state == PCI_D3cold) 2021 pm_runtime_resume(dev); 2022 } 2023 2024 void pci_config_pm_runtime_put(struct pci_dev *pdev) 2025 { 2026 struct device *dev = &pdev->dev; 2027 struct device *parent = dev->parent; 2028 2029 pm_runtime_put(dev); 2030 if (parent) 2031 pm_runtime_put_sync(parent); 2032 } 2033 2034 /** 2035 * pci_pm_init - Initialize PM functions of given PCI device 2036 * @dev: PCI device to handle. 2037 */ 2038 void pci_pm_init(struct pci_dev *dev) 2039 { 2040 int pm; 2041 u16 pmc; 2042 2043 pm_runtime_forbid(&dev->dev); 2044 pm_runtime_set_active(&dev->dev); 2045 pm_runtime_enable(&dev->dev); 2046 device_enable_async_suspend(&dev->dev); 2047 dev->wakeup_prepared = false; 2048 2049 dev->pm_cap = 0; 2050 dev->pme_support = 0; 2051 2052 /* find PCI PM capability in list */ 2053 pm = pci_find_capability(dev, PCI_CAP_ID_PM); 2054 if (!pm) 2055 return; 2056 /* Check device's ability to generate PME# */ 2057 pci_read_config_word(dev, pm + PCI_PM_PMC, &pmc); 2058 2059 if ((pmc & PCI_PM_CAP_VER_MASK) > 3) { 2060 dev_err(&dev->dev, "unsupported PM cap regs version (%u)\n", 2061 pmc & PCI_PM_CAP_VER_MASK); 2062 return; 2063 } 2064 2065 dev->pm_cap = pm; 2066 dev->d3_delay = PCI_PM_D3_WAIT; 2067 dev->d3cold_delay = PCI_PM_D3COLD_WAIT; 2068 dev->d3cold_allowed = true; 2069 2070 dev->d1_support = false; 2071 dev->d2_support = false; 2072 if (!pci_no_d1d2(dev)) { 2073 if (pmc & PCI_PM_CAP_D1) 2074 dev->d1_support = true; 2075 if (pmc & PCI_PM_CAP_D2) 2076 dev->d2_support = true; 2077 2078 if (dev->d1_support || dev->d2_support) 2079 dev_printk(KERN_DEBUG, &dev->dev, "supports%s%s\n", 2080 dev->d1_support ? " D1" : "", 2081 dev->d2_support ? " D2" : ""); 2082 } 2083 2084 pmc &= PCI_PM_CAP_PME_MASK; 2085 if (pmc) { 2086 dev_printk(KERN_DEBUG, &dev->dev, 2087 "PME# supported from%s%s%s%s%s\n", 2088 (pmc & PCI_PM_CAP_PME_D0) ? " D0" : "", 2089 (pmc & PCI_PM_CAP_PME_D1) ? " D1" : "", 2090 (pmc & PCI_PM_CAP_PME_D2) ? " D2" : "", 2091 (pmc & PCI_PM_CAP_PME_D3) ? " D3hot" : "", 2092 (pmc & PCI_PM_CAP_PME_D3cold) ? " D3cold" : ""); 2093 dev->pme_support = pmc >> PCI_PM_CAP_PME_SHIFT; 2094 dev->pme_poll = true; 2095 /* 2096 * Make device's PM flags reflect the wake-up capability, but 2097 * let the user space enable it to wake up the system as needed. 2098 */ 2099 device_set_wakeup_capable(&dev->dev, true); 2100 /* Disable the PME# generation functionality */ 2101 pci_pme_active(dev, false); 2102 } 2103 } 2104 2105 static void pci_add_saved_cap(struct pci_dev *pci_dev, 2106 struct pci_cap_saved_state *new_cap) 2107 { 2108 hlist_add_head(&new_cap->next, &pci_dev->saved_cap_space); 2109 } 2110 2111 /** 2112 * _pci_add_cap_save_buffer - allocate buffer for saving given 2113 * capability registers 2114 * @dev: the PCI device 2115 * @cap: the capability to allocate the buffer for 2116 * @extended: Standard or Extended capability ID 2117 * @size: requested size of the buffer 2118 */ 2119 static int _pci_add_cap_save_buffer(struct pci_dev *dev, u16 cap, 2120 bool extended, unsigned int size) 2121 { 2122 int pos; 2123 struct pci_cap_saved_state *save_state; 2124 2125 if (extended) 2126 pos = pci_find_ext_capability(dev, cap); 2127 else 2128 pos = pci_find_capability(dev, cap); 2129 2130 if (pos <= 0) 2131 return 0; 2132 2133 save_state = kzalloc(sizeof(*save_state) + size, GFP_KERNEL); 2134 if (!save_state) 2135 return -ENOMEM; 2136 2137 save_state->cap.cap_nr = cap; 2138 save_state->cap.cap_extended = extended; 2139 save_state->cap.size = size; 2140 pci_add_saved_cap(dev, save_state); 2141 2142 return 0; 2143 } 2144 2145 int pci_add_cap_save_buffer(struct pci_dev *dev, char cap, unsigned int size) 2146 { 2147 return _pci_add_cap_save_buffer(dev, cap, false, size); 2148 } 2149 2150 int pci_add_ext_cap_save_buffer(struct pci_dev *dev, u16 cap, unsigned int size) 2151 { 2152 return _pci_add_cap_save_buffer(dev, cap, true, size); 2153 } 2154 2155 /** 2156 * pci_allocate_cap_save_buffers - allocate buffers for saving capabilities 2157 * @dev: the PCI device 2158 */ 2159 void pci_allocate_cap_save_buffers(struct pci_dev *dev) 2160 { 2161 int error; 2162 2163 error = pci_add_cap_save_buffer(dev, PCI_CAP_ID_EXP, 2164 PCI_EXP_SAVE_REGS * sizeof(u16)); 2165 if (error) 2166 dev_err(&dev->dev, 2167 "unable to preallocate PCI Express save buffer\n"); 2168 2169 error = pci_add_cap_save_buffer(dev, PCI_CAP_ID_PCIX, sizeof(u16)); 2170 if (error) 2171 dev_err(&dev->dev, 2172 "unable to preallocate PCI-X save buffer\n"); 2173 2174 pci_allocate_vc_save_buffers(dev); 2175 } 2176 2177 void pci_free_cap_save_buffers(struct pci_dev *dev) 2178 { 2179 struct pci_cap_saved_state *tmp; 2180 struct hlist_node *n; 2181 2182 hlist_for_each_entry_safe(tmp, n, &dev->saved_cap_space, next) 2183 kfree(tmp); 2184 } 2185 2186 /** 2187 * pci_configure_ari - enable or disable ARI forwarding 2188 * @dev: the PCI device 2189 * 2190 * If @dev and its upstream bridge both support ARI, enable ARI in the 2191 * bridge. Otherwise, disable ARI in the bridge. 2192 */ 2193 void pci_configure_ari(struct pci_dev *dev) 2194 { 2195 u32 cap; 2196 struct pci_dev *bridge; 2197 2198 if (pcie_ari_disabled || !pci_is_pcie(dev) || dev->devfn) 2199 return; 2200 2201 bridge = dev->bus->self; 2202 if (!bridge) 2203 return; 2204 2205 pcie_capability_read_dword(bridge, PCI_EXP_DEVCAP2, &cap); 2206 if (!(cap & PCI_EXP_DEVCAP2_ARI)) 2207 return; 2208 2209 if (pci_find_ext_capability(dev, PCI_EXT_CAP_ID_ARI)) { 2210 pcie_capability_set_word(bridge, PCI_EXP_DEVCTL2, 2211 PCI_EXP_DEVCTL2_ARI); 2212 bridge->ari_enabled = 1; 2213 } else { 2214 pcie_capability_clear_word(bridge, PCI_EXP_DEVCTL2, 2215 PCI_EXP_DEVCTL2_ARI); 2216 bridge->ari_enabled = 0; 2217 } 2218 } 2219 2220 static int pci_acs_enable; 2221 2222 /** 2223 * pci_request_acs - ask for ACS to be enabled if supported 2224 */ 2225 void pci_request_acs(void) 2226 { 2227 pci_acs_enable = 1; 2228 } 2229 2230 /** 2231 * pci_std_enable_acs - enable ACS on devices using standard ACS capabilites 2232 * @dev: the PCI device 2233 */ 2234 static int pci_std_enable_acs(struct pci_dev *dev) 2235 { 2236 int pos; 2237 u16 cap; 2238 u16 ctrl; 2239 2240 pos = pci_find_ext_capability(dev, PCI_EXT_CAP_ID_ACS); 2241 if (!pos) 2242 return -ENODEV; 2243 2244 pci_read_config_word(dev, pos + PCI_ACS_CAP, &cap); 2245 pci_read_config_word(dev, pos + PCI_ACS_CTRL, &ctrl); 2246 2247 /* Source Validation */ 2248 ctrl |= (cap & PCI_ACS_SV); 2249 2250 /* P2P Request Redirect */ 2251 ctrl |= (cap & PCI_ACS_RR); 2252 2253 /* P2P Completion Redirect */ 2254 ctrl |= (cap & PCI_ACS_CR); 2255 2256 /* Upstream Forwarding */ 2257 ctrl |= (cap & PCI_ACS_UF); 2258 2259 pci_write_config_word(dev, pos + PCI_ACS_CTRL, ctrl); 2260 2261 return 0; 2262 } 2263 2264 /** 2265 * pci_enable_acs - enable ACS if hardware support it 2266 * @dev: the PCI device 2267 */ 2268 void pci_enable_acs(struct pci_dev *dev) 2269 { 2270 if (!pci_acs_enable) 2271 return; 2272 2273 if (!pci_std_enable_acs(dev)) 2274 return; 2275 2276 pci_dev_specific_enable_acs(dev); 2277 } 2278 2279 static bool pci_acs_flags_enabled(struct pci_dev *pdev, u16 acs_flags) 2280 { 2281 int pos; 2282 u16 cap, ctrl; 2283 2284 pos = pci_find_ext_capability(pdev, PCI_EXT_CAP_ID_ACS); 2285 if (!pos) 2286 return false; 2287 2288 /* 2289 * Except for egress control, capabilities are either required 2290 * or only required if controllable. Features missing from the 2291 * capability field can therefore be assumed as hard-wired enabled. 2292 */ 2293 pci_read_config_word(pdev, pos + PCI_ACS_CAP, &cap); 2294 acs_flags &= (cap | PCI_ACS_EC); 2295 2296 pci_read_config_word(pdev, pos + PCI_ACS_CTRL, &ctrl); 2297 return (ctrl & acs_flags) == acs_flags; 2298 } 2299 2300 /** 2301 * pci_acs_enabled - test ACS against required flags for a given device 2302 * @pdev: device to test 2303 * @acs_flags: required PCI ACS flags 2304 * 2305 * Return true if the device supports the provided flags. Automatically 2306 * filters out flags that are not implemented on multifunction devices. 2307 * 2308 * Note that this interface checks the effective ACS capabilities of the 2309 * device rather than the actual capabilities. For instance, most single 2310 * function endpoints are not required to support ACS because they have no 2311 * opportunity for peer-to-peer access. We therefore return 'true' 2312 * regardless of whether the device exposes an ACS capability. This makes 2313 * it much easier for callers of this function to ignore the actual type 2314 * or topology of the device when testing ACS support. 2315 */ 2316 bool pci_acs_enabled(struct pci_dev *pdev, u16 acs_flags) 2317 { 2318 int ret; 2319 2320 ret = pci_dev_specific_acs_enabled(pdev, acs_flags); 2321 if (ret >= 0) 2322 return ret > 0; 2323 2324 /* 2325 * Conventional PCI and PCI-X devices never support ACS, either 2326 * effectively or actually. The shared bus topology implies that 2327 * any device on the bus can receive or snoop DMA. 2328 */ 2329 if (!pci_is_pcie(pdev)) 2330 return false; 2331 2332 switch (pci_pcie_type(pdev)) { 2333 /* 2334 * PCI/X-to-PCIe bridges are not specifically mentioned by the spec, 2335 * but since their primary interface is PCI/X, we conservatively 2336 * handle them as we would a non-PCIe device. 2337 */ 2338 case PCI_EXP_TYPE_PCIE_BRIDGE: 2339 /* 2340 * PCIe 3.0, 6.12.1 excludes ACS on these devices. "ACS is never 2341 * applicable... must never implement an ACS Extended Capability...". 2342 * This seems arbitrary, but we take a conservative interpretation 2343 * of this statement. 2344 */ 2345 case PCI_EXP_TYPE_PCI_BRIDGE: 2346 case PCI_EXP_TYPE_RC_EC: 2347 return false; 2348 /* 2349 * PCIe 3.0, 6.12.1.1 specifies that downstream and root ports should 2350 * implement ACS in order to indicate their peer-to-peer capabilities, 2351 * regardless of whether they are single- or multi-function devices. 2352 */ 2353 case PCI_EXP_TYPE_DOWNSTREAM: 2354 case PCI_EXP_TYPE_ROOT_PORT: 2355 return pci_acs_flags_enabled(pdev, acs_flags); 2356 /* 2357 * PCIe 3.0, 6.12.1.2 specifies ACS capabilities that should be 2358 * implemented by the remaining PCIe types to indicate peer-to-peer 2359 * capabilities, but only when they are part of a multifunction 2360 * device. The footnote for section 6.12 indicates the specific 2361 * PCIe types included here. 2362 */ 2363 case PCI_EXP_TYPE_ENDPOINT: 2364 case PCI_EXP_TYPE_UPSTREAM: 2365 case PCI_EXP_TYPE_LEG_END: 2366 case PCI_EXP_TYPE_RC_END: 2367 if (!pdev->multifunction) 2368 break; 2369 2370 return pci_acs_flags_enabled(pdev, acs_flags); 2371 } 2372 2373 /* 2374 * PCIe 3.0, 6.12.1.3 specifies no ACS capabilities are applicable 2375 * to single function devices with the exception of downstream ports. 2376 */ 2377 return true; 2378 } 2379 2380 /** 2381 * pci_acs_path_enable - test ACS flags from start to end in a hierarchy 2382 * @start: starting downstream device 2383 * @end: ending upstream device or NULL to search to the root bus 2384 * @acs_flags: required flags 2385 * 2386 * Walk up a device tree from start to end testing PCI ACS support. If 2387 * any step along the way does not support the required flags, return false. 2388 */ 2389 bool pci_acs_path_enabled(struct pci_dev *start, 2390 struct pci_dev *end, u16 acs_flags) 2391 { 2392 struct pci_dev *pdev, *parent = start; 2393 2394 do { 2395 pdev = parent; 2396 2397 if (!pci_acs_enabled(pdev, acs_flags)) 2398 return false; 2399 2400 if (pci_is_root_bus(pdev->bus)) 2401 return (end == NULL); 2402 2403 parent = pdev->bus->self; 2404 } while (pdev != end); 2405 2406 return true; 2407 } 2408 2409 /** 2410 * pci_swizzle_interrupt_pin - swizzle INTx for device behind bridge 2411 * @dev: the PCI device 2412 * @pin: the INTx pin (1=INTA, 2=INTB, 3=INTC, 4=INTD) 2413 * 2414 * Perform INTx swizzling for a device behind one level of bridge. This is 2415 * required by section 9.1 of the PCI-to-PCI bridge specification for devices 2416 * behind bridges on add-in cards. For devices with ARI enabled, the slot 2417 * number is always 0 (see the Implementation Note in section 2.2.8.1 of 2418 * the PCI Express Base Specification, Revision 2.1) 2419 */ 2420 u8 pci_swizzle_interrupt_pin(const struct pci_dev *dev, u8 pin) 2421 { 2422 int slot; 2423 2424 if (pci_ari_enabled(dev->bus)) 2425 slot = 0; 2426 else 2427 slot = PCI_SLOT(dev->devfn); 2428 2429 return (((pin - 1) + slot) % 4) + 1; 2430 } 2431 2432 int pci_get_interrupt_pin(struct pci_dev *dev, struct pci_dev **bridge) 2433 { 2434 u8 pin; 2435 2436 pin = dev->pin; 2437 if (!pin) 2438 return -1; 2439 2440 while (!pci_is_root_bus(dev->bus)) { 2441 pin = pci_swizzle_interrupt_pin(dev, pin); 2442 dev = dev->bus->self; 2443 } 2444 *bridge = dev; 2445 return pin; 2446 } 2447 2448 /** 2449 * pci_common_swizzle - swizzle INTx all the way to root bridge 2450 * @dev: the PCI device 2451 * @pinp: pointer to the INTx pin value (1=INTA, 2=INTB, 3=INTD, 4=INTD) 2452 * 2453 * Perform INTx swizzling for a device. This traverses through all PCI-to-PCI 2454 * bridges all the way up to a PCI root bus. 2455 */ 2456 u8 pci_common_swizzle(struct pci_dev *dev, u8 *pinp) 2457 { 2458 u8 pin = *pinp; 2459 2460 while (!pci_is_root_bus(dev->bus)) { 2461 pin = pci_swizzle_interrupt_pin(dev, pin); 2462 dev = dev->bus->self; 2463 } 2464 *pinp = pin; 2465 return PCI_SLOT(dev->devfn); 2466 } 2467 2468 /** 2469 * pci_release_region - Release a PCI bar 2470 * @pdev: PCI device whose resources were previously reserved by pci_request_region 2471 * @bar: BAR to release 2472 * 2473 * Releases the PCI I/O and memory resources previously reserved by a 2474 * successful call to pci_request_region. Call this function only 2475 * after all use of the PCI regions has ceased. 2476 */ 2477 void pci_release_region(struct pci_dev *pdev, int bar) 2478 { 2479 struct pci_devres *dr; 2480 2481 if (pci_resource_len(pdev, bar) == 0) 2482 return; 2483 if (pci_resource_flags(pdev, bar) & IORESOURCE_IO) 2484 release_region(pci_resource_start(pdev, bar), 2485 pci_resource_len(pdev, bar)); 2486 else if (pci_resource_flags(pdev, bar) & IORESOURCE_MEM) 2487 release_mem_region(pci_resource_start(pdev, bar), 2488 pci_resource_len(pdev, bar)); 2489 2490 dr = find_pci_dr(pdev); 2491 if (dr) 2492 dr->region_mask &= ~(1 << bar); 2493 } 2494 EXPORT_SYMBOL(pci_release_region); 2495 2496 /** 2497 * __pci_request_region - Reserved PCI I/O and memory resource 2498 * @pdev: PCI device whose resources are to be reserved 2499 * @bar: BAR to be reserved 2500 * @res_name: Name to be associated with resource. 2501 * @exclusive: whether the region access is exclusive or not 2502 * 2503 * Mark the PCI region associated with PCI device @pdev BR @bar as 2504 * being reserved by owner @res_name. Do not access any 2505 * address inside the PCI regions unless this call returns 2506 * successfully. 2507 * 2508 * If @exclusive is set, then the region is marked so that userspace 2509 * is explicitly not allowed to map the resource via /dev/mem or 2510 * sysfs MMIO access. 2511 * 2512 * Returns 0 on success, or %EBUSY on error. A warning 2513 * message is also printed on failure. 2514 */ 2515 static int __pci_request_region(struct pci_dev *pdev, int bar, 2516 const char *res_name, int exclusive) 2517 { 2518 struct pci_devres *dr; 2519 2520 if (pci_resource_len(pdev, bar) == 0) 2521 return 0; 2522 2523 if (pci_resource_flags(pdev, bar) & IORESOURCE_IO) { 2524 if (!request_region(pci_resource_start(pdev, bar), 2525 pci_resource_len(pdev, bar), res_name)) 2526 goto err_out; 2527 } else if (pci_resource_flags(pdev, bar) & IORESOURCE_MEM) { 2528 if (!__request_mem_region(pci_resource_start(pdev, bar), 2529 pci_resource_len(pdev, bar), res_name, 2530 exclusive)) 2531 goto err_out; 2532 } 2533 2534 dr = find_pci_dr(pdev); 2535 if (dr) 2536 dr->region_mask |= 1 << bar; 2537 2538 return 0; 2539 2540 err_out: 2541 dev_warn(&pdev->dev, "BAR %d: can't reserve %pR\n", bar, 2542 &pdev->resource[bar]); 2543 return -EBUSY; 2544 } 2545 2546 /** 2547 * pci_request_region - Reserve PCI I/O and memory resource 2548 * @pdev: PCI device whose resources are to be reserved 2549 * @bar: BAR to be reserved 2550 * @res_name: Name to be associated with resource 2551 * 2552 * Mark the PCI region associated with PCI device @pdev BAR @bar as 2553 * being reserved by owner @res_name. Do not access any 2554 * address inside the PCI regions unless this call returns 2555 * successfully. 2556 * 2557 * Returns 0 on success, or %EBUSY on error. A warning 2558 * message is also printed on failure. 2559 */ 2560 int pci_request_region(struct pci_dev *pdev, int bar, const char *res_name) 2561 { 2562 return __pci_request_region(pdev, bar, res_name, 0); 2563 } 2564 EXPORT_SYMBOL(pci_request_region); 2565 2566 /** 2567 * pci_request_region_exclusive - Reserved PCI I/O and memory resource 2568 * @pdev: PCI device whose resources are to be reserved 2569 * @bar: BAR to be reserved 2570 * @res_name: Name to be associated with resource. 2571 * 2572 * Mark the PCI region associated with PCI device @pdev BR @bar as 2573 * being reserved by owner @res_name. Do not access any 2574 * address inside the PCI regions unless this call returns 2575 * successfully. 2576 * 2577 * Returns 0 on success, or %EBUSY on error. A warning 2578 * message is also printed on failure. 2579 * 2580 * The key difference that _exclusive makes it that userspace is 2581 * explicitly not allowed to map the resource via /dev/mem or 2582 * sysfs. 2583 */ 2584 int pci_request_region_exclusive(struct pci_dev *pdev, int bar, 2585 const char *res_name) 2586 { 2587 return __pci_request_region(pdev, bar, res_name, IORESOURCE_EXCLUSIVE); 2588 } 2589 EXPORT_SYMBOL(pci_request_region_exclusive); 2590 2591 /** 2592 * pci_release_selected_regions - Release selected PCI I/O and memory resources 2593 * @pdev: PCI device whose resources were previously reserved 2594 * @bars: Bitmask of BARs to be released 2595 * 2596 * Release selected PCI I/O and memory resources previously reserved. 2597 * Call this function only after all use of the PCI regions has ceased. 2598 */ 2599 void pci_release_selected_regions(struct pci_dev *pdev, int bars) 2600 { 2601 int i; 2602 2603 for (i = 0; i < 6; i++) 2604 if (bars & (1 << i)) 2605 pci_release_region(pdev, i); 2606 } 2607 EXPORT_SYMBOL(pci_release_selected_regions); 2608 2609 static int __pci_request_selected_regions(struct pci_dev *pdev, int bars, 2610 const char *res_name, int excl) 2611 { 2612 int i; 2613 2614 for (i = 0; i < 6; i++) 2615 if (bars & (1 << i)) 2616 if (__pci_request_region(pdev, i, res_name, excl)) 2617 goto err_out; 2618 return 0; 2619 2620 err_out: 2621 while (--i >= 0) 2622 if (bars & (1 << i)) 2623 pci_release_region(pdev, i); 2624 2625 return -EBUSY; 2626 } 2627 2628 2629 /** 2630 * pci_request_selected_regions - Reserve selected PCI I/O and memory resources 2631 * @pdev: PCI device whose resources are to be reserved 2632 * @bars: Bitmask of BARs to be requested 2633 * @res_name: Name to be associated with resource 2634 */ 2635 int pci_request_selected_regions(struct pci_dev *pdev, int bars, 2636 const char *res_name) 2637 { 2638 return __pci_request_selected_regions(pdev, bars, res_name, 0); 2639 } 2640 EXPORT_SYMBOL(pci_request_selected_regions); 2641 2642 int pci_request_selected_regions_exclusive(struct pci_dev *pdev, int bars, 2643 const char *res_name) 2644 { 2645 return __pci_request_selected_regions(pdev, bars, res_name, 2646 IORESOURCE_EXCLUSIVE); 2647 } 2648 EXPORT_SYMBOL(pci_request_selected_regions_exclusive); 2649 2650 /** 2651 * pci_release_regions - Release reserved PCI I/O and memory resources 2652 * @pdev: PCI device whose resources were previously reserved by pci_request_regions 2653 * 2654 * Releases all PCI I/O and memory resources previously reserved by a 2655 * successful call to pci_request_regions. Call this function only 2656 * after all use of the PCI regions has ceased. 2657 */ 2658 2659 void pci_release_regions(struct pci_dev *pdev) 2660 { 2661 pci_release_selected_regions(pdev, (1 << 6) - 1); 2662 } 2663 EXPORT_SYMBOL(pci_release_regions); 2664 2665 /** 2666 * pci_request_regions - Reserved PCI I/O and memory resources 2667 * @pdev: PCI device whose resources are to be reserved 2668 * @res_name: Name to be associated with resource. 2669 * 2670 * Mark all PCI regions associated with PCI device @pdev as 2671 * being reserved by owner @res_name. Do not access any 2672 * address inside the PCI regions unless this call returns 2673 * successfully. 2674 * 2675 * Returns 0 on success, or %EBUSY on error. A warning 2676 * message is also printed on failure. 2677 */ 2678 int pci_request_regions(struct pci_dev *pdev, const char *res_name) 2679 { 2680 return pci_request_selected_regions(pdev, ((1 << 6) - 1), res_name); 2681 } 2682 EXPORT_SYMBOL(pci_request_regions); 2683 2684 /** 2685 * pci_request_regions_exclusive - Reserved PCI I/O and memory resources 2686 * @pdev: PCI device whose resources are to be reserved 2687 * @res_name: Name to be associated with resource. 2688 * 2689 * Mark all PCI regions associated with PCI device @pdev as 2690 * being reserved by owner @res_name. Do not access any 2691 * address inside the PCI regions unless this call returns 2692 * successfully. 2693 * 2694 * pci_request_regions_exclusive() will mark the region so that 2695 * /dev/mem and the sysfs MMIO access will not be allowed. 2696 * 2697 * Returns 0 on success, or %EBUSY on error. A warning 2698 * message is also printed on failure. 2699 */ 2700 int pci_request_regions_exclusive(struct pci_dev *pdev, const char *res_name) 2701 { 2702 return pci_request_selected_regions_exclusive(pdev, 2703 ((1 << 6) - 1), res_name); 2704 } 2705 EXPORT_SYMBOL(pci_request_regions_exclusive); 2706 2707 static void __pci_set_master(struct pci_dev *dev, bool enable) 2708 { 2709 u16 old_cmd, cmd; 2710 2711 pci_read_config_word(dev, PCI_COMMAND, &old_cmd); 2712 if (enable) 2713 cmd = old_cmd | PCI_COMMAND_MASTER; 2714 else 2715 cmd = old_cmd & ~PCI_COMMAND_MASTER; 2716 if (cmd != old_cmd) { 2717 dev_dbg(&dev->dev, "%s bus mastering\n", 2718 enable ? "enabling" : "disabling"); 2719 pci_write_config_word(dev, PCI_COMMAND, cmd); 2720 } 2721 dev->is_busmaster = enable; 2722 } 2723 2724 /** 2725 * pcibios_setup - process "pci=" kernel boot arguments 2726 * @str: string used to pass in "pci=" kernel boot arguments 2727 * 2728 * Process kernel boot arguments. This is the default implementation. 2729 * Architecture specific implementations can override this as necessary. 2730 */ 2731 char * __weak __init pcibios_setup(char *str) 2732 { 2733 return str; 2734 } 2735 2736 /** 2737 * pcibios_set_master - enable PCI bus-mastering for device dev 2738 * @dev: the PCI device to enable 2739 * 2740 * Enables PCI bus-mastering for the device. This is the default 2741 * implementation. Architecture specific implementations can override 2742 * this if necessary. 2743 */ 2744 void __weak pcibios_set_master(struct pci_dev *dev) 2745 { 2746 u8 lat; 2747 2748 /* The latency timer doesn't apply to PCIe (either Type 0 or Type 1) */ 2749 if (pci_is_pcie(dev)) 2750 return; 2751 2752 pci_read_config_byte(dev, PCI_LATENCY_TIMER, &lat); 2753 if (lat < 16) 2754 lat = (64 <= pcibios_max_latency) ? 64 : pcibios_max_latency; 2755 else if (lat > pcibios_max_latency) 2756 lat = pcibios_max_latency; 2757 else 2758 return; 2759 2760 pci_write_config_byte(dev, PCI_LATENCY_TIMER, lat); 2761 } 2762 2763 /** 2764 * pci_set_master - enables bus-mastering for device dev 2765 * @dev: the PCI device to enable 2766 * 2767 * Enables bus-mastering on the device and calls pcibios_set_master() 2768 * to do the needed arch specific settings. 2769 */ 2770 void pci_set_master(struct pci_dev *dev) 2771 { 2772 __pci_set_master(dev, true); 2773 pcibios_set_master(dev); 2774 } 2775 EXPORT_SYMBOL(pci_set_master); 2776 2777 /** 2778 * pci_clear_master - disables bus-mastering for device dev 2779 * @dev: the PCI device to disable 2780 */ 2781 void pci_clear_master(struct pci_dev *dev) 2782 { 2783 __pci_set_master(dev, false); 2784 } 2785 EXPORT_SYMBOL(pci_clear_master); 2786 2787 /** 2788 * pci_set_cacheline_size - ensure the CACHE_LINE_SIZE register is programmed 2789 * @dev: the PCI device for which MWI is to be enabled 2790 * 2791 * Helper function for pci_set_mwi. 2792 * Originally copied from drivers/net/acenic.c. 2793 * Copyright 1998-2001 by Jes Sorensen, <jes@trained-monkey.org>. 2794 * 2795 * RETURNS: An appropriate -ERRNO error value on error, or zero for success. 2796 */ 2797 int pci_set_cacheline_size(struct pci_dev *dev) 2798 { 2799 u8 cacheline_size; 2800 2801 if (!pci_cache_line_size) 2802 return -EINVAL; 2803 2804 /* Validate current setting: the PCI_CACHE_LINE_SIZE must be 2805 equal to or multiple of the right value. */ 2806 pci_read_config_byte(dev, PCI_CACHE_LINE_SIZE, &cacheline_size); 2807 if (cacheline_size >= pci_cache_line_size && 2808 (cacheline_size % pci_cache_line_size) == 0) 2809 return 0; 2810 2811 /* Write the correct value. */ 2812 pci_write_config_byte(dev, PCI_CACHE_LINE_SIZE, pci_cache_line_size); 2813 /* Read it back. */ 2814 pci_read_config_byte(dev, PCI_CACHE_LINE_SIZE, &cacheline_size); 2815 if (cacheline_size == pci_cache_line_size) 2816 return 0; 2817 2818 dev_printk(KERN_DEBUG, &dev->dev, "cache line size of %d is not supported\n", 2819 pci_cache_line_size << 2); 2820 2821 return -EINVAL; 2822 } 2823 EXPORT_SYMBOL_GPL(pci_set_cacheline_size); 2824 2825 /** 2826 * pci_set_mwi - enables memory-write-invalidate PCI transaction 2827 * @dev: the PCI device for which MWI is enabled 2828 * 2829 * Enables the Memory-Write-Invalidate transaction in %PCI_COMMAND. 2830 * 2831 * RETURNS: An appropriate -ERRNO error value on error, or zero for success. 2832 */ 2833 int pci_set_mwi(struct pci_dev *dev) 2834 { 2835 #ifdef PCI_DISABLE_MWI 2836 return 0; 2837 #else 2838 int rc; 2839 u16 cmd; 2840 2841 rc = pci_set_cacheline_size(dev); 2842 if (rc) 2843 return rc; 2844 2845 pci_read_config_word(dev, PCI_COMMAND, &cmd); 2846 if (!(cmd & PCI_COMMAND_INVALIDATE)) { 2847 dev_dbg(&dev->dev, "enabling Mem-Wr-Inval\n"); 2848 cmd |= PCI_COMMAND_INVALIDATE; 2849 pci_write_config_word(dev, PCI_COMMAND, cmd); 2850 } 2851 return 0; 2852 #endif 2853 } 2854 EXPORT_SYMBOL(pci_set_mwi); 2855 2856 /** 2857 * pci_try_set_mwi - enables memory-write-invalidate PCI transaction 2858 * @dev: the PCI device for which MWI is enabled 2859 * 2860 * Enables the Memory-Write-Invalidate transaction in %PCI_COMMAND. 2861 * Callers are not required to check the return value. 2862 * 2863 * RETURNS: An appropriate -ERRNO error value on error, or zero for success. 2864 */ 2865 int pci_try_set_mwi(struct pci_dev *dev) 2866 { 2867 #ifdef PCI_DISABLE_MWI 2868 return 0; 2869 #else 2870 return pci_set_mwi(dev); 2871 #endif 2872 } 2873 EXPORT_SYMBOL(pci_try_set_mwi); 2874 2875 /** 2876 * pci_clear_mwi - disables Memory-Write-Invalidate for device dev 2877 * @dev: the PCI device to disable 2878 * 2879 * Disables PCI Memory-Write-Invalidate transaction on the device 2880 */ 2881 void pci_clear_mwi(struct pci_dev *dev) 2882 { 2883 #ifndef PCI_DISABLE_MWI 2884 u16 cmd; 2885 2886 pci_read_config_word(dev, PCI_COMMAND, &cmd); 2887 if (cmd & PCI_COMMAND_INVALIDATE) { 2888 cmd &= ~PCI_COMMAND_INVALIDATE; 2889 pci_write_config_word(dev, PCI_COMMAND, cmd); 2890 } 2891 #endif 2892 } 2893 EXPORT_SYMBOL(pci_clear_mwi); 2894 2895 /** 2896 * pci_intx - enables/disables PCI INTx for device dev 2897 * @pdev: the PCI device to operate on 2898 * @enable: boolean: whether to enable or disable PCI INTx 2899 * 2900 * Enables/disables PCI INTx for device dev 2901 */ 2902 void pci_intx(struct pci_dev *pdev, int enable) 2903 { 2904 u16 pci_command, new; 2905 2906 pci_read_config_word(pdev, PCI_COMMAND, &pci_command); 2907 2908 if (enable) 2909 new = pci_command & ~PCI_COMMAND_INTX_DISABLE; 2910 else 2911 new = pci_command | PCI_COMMAND_INTX_DISABLE; 2912 2913 if (new != pci_command) { 2914 struct pci_devres *dr; 2915 2916 pci_write_config_word(pdev, PCI_COMMAND, new); 2917 2918 dr = find_pci_dr(pdev); 2919 if (dr && !dr->restore_intx) { 2920 dr->restore_intx = 1; 2921 dr->orig_intx = !enable; 2922 } 2923 } 2924 } 2925 EXPORT_SYMBOL_GPL(pci_intx); 2926 2927 /** 2928 * pci_intx_mask_supported - probe for INTx masking support 2929 * @dev: the PCI device to operate on 2930 * 2931 * Check if the device dev support INTx masking via the config space 2932 * command word. 2933 */ 2934 bool pci_intx_mask_supported(struct pci_dev *dev) 2935 { 2936 bool mask_supported = false; 2937 u16 orig, new; 2938 2939 if (dev->broken_intx_masking) 2940 return false; 2941 2942 pci_cfg_access_lock(dev); 2943 2944 pci_read_config_word(dev, PCI_COMMAND, &orig); 2945 pci_write_config_word(dev, PCI_COMMAND, 2946 orig ^ PCI_COMMAND_INTX_DISABLE); 2947 pci_read_config_word(dev, PCI_COMMAND, &new); 2948 2949 /* 2950 * There's no way to protect against hardware bugs or detect them 2951 * reliably, but as long as we know what the value should be, let's 2952 * go ahead and check it. 2953 */ 2954 if ((new ^ orig) & ~PCI_COMMAND_INTX_DISABLE) { 2955 dev_err(&dev->dev, "Command register changed from 0x%x to 0x%x: driver or hardware bug?\n", 2956 orig, new); 2957 } else if ((new ^ orig) & PCI_COMMAND_INTX_DISABLE) { 2958 mask_supported = true; 2959 pci_write_config_word(dev, PCI_COMMAND, orig); 2960 } 2961 2962 pci_cfg_access_unlock(dev); 2963 return mask_supported; 2964 } 2965 EXPORT_SYMBOL_GPL(pci_intx_mask_supported); 2966 2967 static bool pci_check_and_set_intx_mask(struct pci_dev *dev, bool mask) 2968 { 2969 struct pci_bus *bus = dev->bus; 2970 bool mask_updated = true; 2971 u32 cmd_status_dword; 2972 u16 origcmd, newcmd; 2973 unsigned long flags; 2974 bool irq_pending; 2975 2976 /* 2977 * We do a single dword read to retrieve both command and status. 2978 * Document assumptions that make this possible. 2979 */ 2980 BUILD_BUG_ON(PCI_COMMAND % 4); 2981 BUILD_BUG_ON(PCI_COMMAND + 2 != PCI_STATUS); 2982 2983 raw_spin_lock_irqsave(&pci_lock, flags); 2984 2985 bus->ops->read(bus, dev->devfn, PCI_COMMAND, 4, &cmd_status_dword); 2986 2987 irq_pending = (cmd_status_dword >> 16) & PCI_STATUS_INTERRUPT; 2988 2989 /* 2990 * Check interrupt status register to see whether our device 2991 * triggered the interrupt (when masking) or the next IRQ is 2992 * already pending (when unmasking). 2993 */ 2994 if (mask != irq_pending) { 2995 mask_updated = false; 2996 goto done; 2997 } 2998 2999 origcmd = cmd_status_dword; 3000 newcmd = origcmd & ~PCI_COMMAND_INTX_DISABLE; 3001 if (mask) 3002 newcmd |= PCI_COMMAND_INTX_DISABLE; 3003 if (newcmd != origcmd) 3004 bus->ops->write(bus, dev->devfn, PCI_COMMAND, 2, newcmd); 3005 3006 done: 3007 raw_spin_unlock_irqrestore(&pci_lock, flags); 3008 3009 return mask_updated; 3010 } 3011 3012 /** 3013 * pci_check_and_mask_intx - mask INTx on pending interrupt 3014 * @dev: the PCI device to operate on 3015 * 3016 * Check if the device dev has its INTx line asserted, mask it and 3017 * return true in that case. False is returned if not interrupt was 3018 * pending. 3019 */ 3020 bool pci_check_and_mask_intx(struct pci_dev *dev) 3021 { 3022 return pci_check_and_set_intx_mask(dev, true); 3023 } 3024 EXPORT_SYMBOL_GPL(pci_check_and_mask_intx); 3025 3026 /** 3027 * pci_check_and_unmask_intx - unmask INTx if no interrupt is pending 3028 * @dev: the PCI device to operate on 3029 * 3030 * Check if the device dev has its INTx line asserted, unmask it if not 3031 * and return true. False is returned and the mask remains active if 3032 * there was still an interrupt pending. 3033 */ 3034 bool pci_check_and_unmask_intx(struct pci_dev *dev) 3035 { 3036 return pci_check_and_set_intx_mask(dev, false); 3037 } 3038 EXPORT_SYMBOL_GPL(pci_check_and_unmask_intx); 3039 3040 /** 3041 * pci_msi_off - disables any MSI or MSI-X capabilities 3042 * @dev: the PCI device to operate on 3043 * 3044 * If you want to use MSI, see pci_enable_msi() and friends. 3045 * This is a lower-level primitive that allows us to disable 3046 * MSI operation at the device level. 3047 */ 3048 void pci_msi_off(struct pci_dev *dev) 3049 { 3050 int pos; 3051 u16 control; 3052 3053 /* 3054 * This looks like it could go in msi.c, but we need it even when 3055 * CONFIG_PCI_MSI=n. For the same reason, we can't use 3056 * dev->msi_cap or dev->msix_cap here. 3057 */ 3058 pos = pci_find_capability(dev, PCI_CAP_ID_MSI); 3059 if (pos) { 3060 pci_read_config_word(dev, pos + PCI_MSI_FLAGS, &control); 3061 control &= ~PCI_MSI_FLAGS_ENABLE; 3062 pci_write_config_word(dev, pos + PCI_MSI_FLAGS, control); 3063 } 3064 pos = pci_find_capability(dev, PCI_CAP_ID_MSIX); 3065 if (pos) { 3066 pci_read_config_word(dev, pos + PCI_MSIX_FLAGS, &control); 3067 control &= ~PCI_MSIX_FLAGS_ENABLE; 3068 pci_write_config_word(dev, pos + PCI_MSIX_FLAGS, control); 3069 } 3070 } 3071 EXPORT_SYMBOL_GPL(pci_msi_off); 3072 3073 int pci_set_dma_max_seg_size(struct pci_dev *dev, unsigned int size) 3074 { 3075 return dma_set_max_seg_size(&dev->dev, size); 3076 } 3077 EXPORT_SYMBOL(pci_set_dma_max_seg_size); 3078 3079 int pci_set_dma_seg_boundary(struct pci_dev *dev, unsigned long mask) 3080 { 3081 return dma_set_seg_boundary(&dev->dev, mask); 3082 } 3083 EXPORT_SYMBOL(pci_set_dma_seg_boundary); 3084 3085 /** 3086 * pci_wait_for_pending_transaction - waits for pending transaction 3087 * @dev: the PCI device to operate on 3088 * 3089 * Return 0 if transaction is pending 1 otherwise. 3090 */ 3091 int pci_wait_for_pending_transaction(struct pci_dev *dev) 3092 { 3093 if (!pci_is_pcie(dev)) 3094 return 1; 3095 3096 return pci_wait_for_pending(dev, pci_pcie_cap(dev) + PCI_EXP_DEVSTA, 3097 PCI_EXP_DEVSTA_TRPND); 3098 } 3099 EXPORT_SYMBOL(pci_wait_for_pending_transaction); 3100 3101 static int pcie_flr(struct pci_dev *dev, int probe) 3102 { 3103 u32 cap; 3104 3105 pcie_capability_read_dword(dev, PCI_EXP_DEVCAP, &cap); 3106 if (!(cap & PCI_EXP_DEVCAP_FLR)) 3107 return -ENOTTY; 3108 3109 if (probe) 3110 return 0; 3111 3112 if (!pci_wait_for_pending_transaction(dev)) 3113 dev_err(&dev->dev, "transaction is not cleared; proceeding with reset anyway\n"); 3114 3115 pcie_capability_set_word(dev, PCI_EXP_DEVCTL, PCI_EXP_DEVCTL_BCR_FLR); 3116 3117 msleep(100); 3118 3119 return 0; 3120 } 3121 3122 static int pci_af_flr(struct pci_dev *dev, int probe) 3123 { 3124 int pos; 3125 u8 cap; 3126 3127 pos = pci_find_capability(dev, PCI_CAP_ID_AF); 3128 if (!pos) 3129 return -ENOTTY; 3130 3131 pci_read_config_byte(dev, pos + PCI_AF_CAP, &cap); 3132 if (!(cap & PCI_AF_CAP_TP) || !(cap & PCI_AF_CAP_FLR)) 3133 return -ENOTTY; 3134 3135 if (probe) 3136 return 0; 3137 3138 /* 3139 * Wait for Transaction Pending bit to clear. A word-aligned test 3140 * is used, so we use the conrol offset rather than status and shift 3141 * the test bit to match. 3142 */ 3143 if (pci_wait_for_pending(dev, pos + PCI_AF_CTRL, 3144 PCI_AF_STATUS_TP << 8)) 3145 goto clear; 3146 3147 dev_err(&dev->dev, "transaction is not cleared; proceeding with reset anyway\n"); 3148 3149 clear: 3150 pci_write_config_byte(dev, pos + PCI_AF_CTRL, PCI_AF_CTRL_FLR); 3151 msleep(100); 3152 3153 return 0; 3154 } 3155 3156 /** 3157 * pci_pm_reset - Put device into PCI_D3 and back into PCI_D0. 3158 * @dev: Device to reset. 3159 * @probe: If set, only check if the device can be reset this way. 3160 * 3161 * If @dev supports native PCI PM and its PCI_PM_CTRL_NO_SOFT_RESET flag is 3162 * unset, it will be reinitialized internally when going from PCI_D3hot to 3163 * PCI_D0. If that's the case and the device is not in a low-power state 3164 * already, force it into PCI_D3hot and back to PCI_D0, causing it to be reset. 3165 * 3166 * NOTE: This causes the caller to sleep for twice the device power transition 3167 * cooldown period, which for the D0->D3hot and D3hot->D0 transitions is 10 ms 3168 * by default (i.e. unless the @dev's d3_delay field has a different value). 3169 * Moreover, only devices in D0 can be reset by this function. 3170 */ 3171 static int pci_pm_reset(struct pci_dev *dev, int probe) 3172 { 3173 u16 csr; 3174 3175 if (!dev->pm_cap) 3176 return -ENOTTY; 3177 3178 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &csr); 3179 if (csr & PCI_PM_CTRL_NO_SOFT_RESET) 3180 return -ENOTTY; 3181 3182 if (probe) 3183 return 0; 3184 3185 if (dev->current_state != PCI_D0) 3186 return -EINVAL; 3187 3188 csr &= ~PCI_PM_CTRL_STATE_MASK; 3189 csr |= PCI_D3hot; 3190 pci_write_config_word(dev, dev->pm_cap + PCI_PM_CTRL, csr); 3191 pci_dev_d3_sleep(dev); 3192 3193 csr &= ~PCI_PM_CTRL_STATE_MASK; 3194 csr |= PCI_D0; 3195 pci_write_config_word(dev, dev->pm_cap + PCI_PM_CTRL, csr); 3196 pci_dev_d3_sleep(dev); 3197 3198 return 0; 3199 } 3200 3201 void pci_reset_secondary_bus(struct pci_dev *dev) 3202 { 3203 u16 ctrl; 3204 3205 pci_read_config_word(dev, PCI_BRIDGE_CONTROL, &ctrl); 3206 ctrl |= PCI_BRIDGE_CTL_BUS_RESET; 3207 pci_write_config_word(dev, PCI_BRIDGE_CONTROL, ctrl); 3208 /* 3209 * PCI spec v3.0 7.6.4.2 requires minimum Trst of 1ms. Double 3210 * this to 2ms to ensure that we meet the minimum requirement. 3211 */ 3212 msleep(2); 3213 3214 ctrl &= ~PCI_BRIDGE_CTL_BUS_RESET; 3215 pci_write_config_word(dev, PCI_BRIDGE_CONTROL, ctrl); 3216 3217 /* 3218 * Trhfa for conventional PCI is 2^25 clock cycles. 3219 * Assuming a minimum 33MHz clock this results in a 1s 3220 * delay before we can consider subordinate devices to 3221 * be re-initialized. PCIe has some ways to shorten this, 3222 * but we don't make use of them yet. 3223 */ 3224 ssleep(1); 3225 } 3226 3227 void __weak pcibios_reset_secondary_bus(struct pci_dev *dev) 3228 { 3229 pci_reset_secondary_bus(dev); 3230 } 3231 3232 /** 3233 * pci_reset_bridge_secondary_bus - Reset the secondary bus on a PCI bridge. 3234 * @dev: Bridge device 3235 * 3236 * Use the bridge control register to assert reset on the secondary bus. 3237 * Devices on the secondary bus are left in power-on state. 3238 */ 3239 void pci_reset_bridge_secondary_bus(struct pci_dev *dev) 3240 { 3241 pcibios_reset_secondary_bus(dev); 3242 } 3243 EXPORT_SYMBOL_GPL(pci_reset_bridge_secondary_bus); 3244 3245 static int pci_parent_bus_reset(struct pci_dev *dev, int probe) 3246 { 3247 struct pci_dev *pdev; 3248 3249 if (pci_is_root_bus(dev->bus) || dev->subordinate || !dev->bus->self) 3250 return -ENOTTY; 3251 3252 list_for_each_entry(pdev, &dev->bus->devices, bus_list) 3253 if (pdev != dev) 3254 return -ENOTTY; 3255 3256 if (probe) 3257 return 0; 3258 3259 pci_reset_bridge_secondary_bus(dev->bus->self); 3260 3261 return 0; 3262 } 3263 3264 static int pci_reset_hotplug_slot(struct hotplug_slot *hotplug, int probe) 3265 { 3266 int rc = -ENOTTY; 3267 3268 if (!hotplug || !try_module_get(hotplug->ops->owner)) 3269 return rc; 3270 3271 if (hotplug->ops->reset_slot) 3272 rc = hotplug->ops->reset_slot(hotplug, probe); 3273 3274 module_put(hotplug->ops->owner); 3275 3276 return rc; 3277 } 3278 3279 static int pci_dev_reset_slot_function(struct pci_dev *dev, int probe) 3280 { 3281 struct pci_dev *pdev; 3282 3283 if (dev->subordinate || !dev->slot) 3284 return -ENOTTY; 3285 3286 list_for_each_entry(pdev, &dev->bus->devices, bus_list) 3287 if (pdev != dev && pdev->slot == dev->slot) 3288 return -ENOTTY; 3289 3290 return pci_reset_hotplug_slot(dev->slot->hotplug, probe); 3291 } 3292 3293 static int __pci_dev_reset(struct pci_dev *dev, int probe) 3294 { 3295 int rc; 3296 3297 might_sleep(); 3298 3299 rc = pci_dev_specific_reset(dev, probe); 3300 if (rc != -ENOTTY) 3301 goto done; 3302 3303 rc = pcie_flr(dev, probe); 3304 if (rc != -ENOTTY) 3305 goto done; 3306 3307 rc = pci_af_flr(dev, probe); 3308 if (rc != -ENOTTY) 3309 goto done; 3310 3311 rc = pci_pm_reset(dev, probe); 3312 if (rc != -ENOTTY) 3313 goto done; 3314 3315 rc = pci_dev_reset_slot_function(dev, probe); 3316 if (rc != -ENOTTY) 3317 goto done; 3318 3319 rc = pci_parent_bus_reset(dev, probe); 3320 done: 3321 return rc; 3322 } 3323 3324 static void pci_dev_lock(struct pci_dev *dev) 3325 { 3326 pci_cfg_access_lock(dev); 3327 /* block PM suspend, driver probe, etc. */ 3328 device_lock(&dev->dev); 3329 } 3330 3331 /* Return 1 on successful lock, 0 on contention */ 3332 static int pci_dev_trylock(struct pci_dev *dev) 3333 { 3334 if (pci_cfg_access_trylock(dev)) { 3335 if (device_trylock(&dev->dev)) 3336 return 1; 3337 pci_cfg_access_unlock(dev); 3338 } 3339 3340 return 0; 3341 } 3342 3343 static void pci_dev_unlock(struct pci_dev *dev) 3344 { 3345 device_unlock(&dev->dev); 3346 pci_cfg_access_unlock(dev); 3347 } 3348 3349 /** 3350 * pci_reset_notify - notify device driver of reset 3351 * @dev: device to be notified of reset 3352 * @prepare: 'true' if device is about to be reset; 'false' if reset attempt 3353 * completed 3354 * 3355 * Must be called prior to device access being disabled and after device 3356 * access is restored. 3357 */ 3358 static void pci_reset_notify(struct pci_dev *dev, bool prepare) 3359 { 3360 const struct pci_error_handlers *err_handler = 3361 dev->driver ? dev->driver->err_handler : NULL; 3362 if (err_handler && err_handler->reset_notify) 3363 err_handler->reset_notify(dev, prepare); 3364 } 3365 3366 static void pci_dev_save_and_disable(struct pci_dev *dev) 3367 { 3368 pci_reset_notify(dev, true); 3369 3370 /* 3371 * Wake-up device prior to save. PM registers default to D0 after 3372 * reset and a simple register restore doesn't reliably return 3373 * to a non-D0 state anyway. 3374 */ 3375 pci_set_power_state(dev, PCI_D0); 3376 3377 pci_save_state(dev); 3378 /* 3379 * Disable the device by clearing the Command register, except for 3380 * INTx-disable which is set. This not only disables MMIO and I/O port 3381 * BARs, but also prevents the device from being Bus Master, preventing 3382 * DMA from the device including MSI/MSI-X interrupts. For PCI 2.3 3383 * compliant devices, INTx-disable prevents legacy interrupts. 3384 */ 3385 pci_write_config_word(dev, PCI_COMMAND, PCI_COMMAND_INTX_DISABLE); 3386 } 3387 3388 static void pci_dev_restore(struct pci_dev *dev) 3389 { 3390 pci_restore_state(dev); 3391 pci_reset_notify(dev, false); 3392 } 3393 3394 static int pci_dev_reset(struct pci_dev *dev, int probe) 3395 { 3396 int rc; 3397 3398 if (!probe) 3399 pci_dev_lock(dev); 3400 3401 rc = __pci_dev_reset(dev, probe); 3402 3403 if (!probe) 3404 pci_dev_unlock(dev); 3405 3406 return rc; 3407 } 3408 3409 /** 3410 * __pci_reset_function - reset a PCI device function 3411 * @dev: PCI device to reset 3412 * 3413 * Some devices allow an individual function to be reset without affecting 3414 * other functions in the same device. The PCI device must be responsive 3415 * to PCI config space in order to use this function. 3416 * 3417 * The device function is presumed to be unused when this function is called. 3418 * Resetting the device will make the contents of PCI configuration space 3419 * random, so any caller of this must be prepared to reinitialise the 3420 * device including MSI, bus mastering, BARs, decoding IO and memory spaces, 3421 * etc. 3422 * 3423 * Returns 0 if the device function was successfully reset or negative if the 3424 * device doesn't support resetting a single function. 3425 */ 3426 int __pci_reset_function(struct pci_dev *dev) 3427 { 3428 return pci_dev_reset(dev, 0); 3429 } 3430 EXPORT_SYMBOL_GPL(__pci_reset_function); 3431 3432 /** 3433 * __pci_reset_function_locked - reset a PCI device function while holding 3434 * the @dev mutex lock. 3435 * @dev: PCI device to reset 3436 * 3437 * Some devices allow an individual function to be reset without affecting 3438 * other functions in the same device. The PCI device must be responsive 3439 * to PCI config space in order to use this function. 3440 * 3441 * The device function is presumed to be unused and the caller is holding 3442 * the device mutex lock when this function is called. 3443 * Resetting the device will make the contents of PCI configuration space 3444 * random, so any caller of this must be prepared to reinitialise the 3445 * device including MSI, bus mastering, BARs, decoding IO and memory spaces, 3446 * etc. 3447 * 3448 * Returns 0 if the device function was successfully reset or negative if the 3449 * device doesn't support resetting a single function. 3450 */ 3451 int __pci_reset_function_locked(struct pci_dev *dev) 3452 { 3453 return __pci_dev_reset(dev, 0); 3454 } 3455 EXPORT_SYMBOL_GPL(__pci_reset_function_locked); 3456 3457 /** 3458 * pci_probe_reset_function - check whether the device can be safely reset 3459 * @dev: PCI device to reset 3460 * 3461 * Some devices allow an individual function to be reset without affecting 3462 * other functions in the same device. The PCI device must be responsive 3463 * to PCI config space in order to use this function. 3464 * 3465 * Returns 0 if the device function can be reset or negative if the 3466 * device doesn't support resetting a single function. 3467 */ 3468 int pci_probe_reset_function(struct pci_dev *dev) 3469 { 3470 return pci_dev_reset(dev, 1); 3471 } 3472 3473 /** 3474 * pci_reset_function - quiesce and reset a PCI device function 3475 * @dev: PCI device to reset 3476 * 3477 * Some devices allow an individual function to be reset without affecting 3478 * other functions in the same device. The PCI device must be responsive 3479 * to PCI config space in order to use this function. 3480 * 3481 * This function does not just reset the PCI portion of a device, but 3482 * clears all the state associated with the device. This function differs 3483 * from __pci_reset_function in that it saves and restores device state 3484 * over the reset. 3485 * 3486 * Returns 0 if the device function was successfully reset or negative if the 3487 * device doesn't support resetting a single function. 3488 */ 3489 int pci_reset_function(struct pci_dev *dev) 3490 { 3491 int rc; 3492 3493 rc = pci_dev_reset(dev, 1); 3494 if (rc) 3495 return rc; 3496 3497 pci_dev_save_and_disable(dev); 3498 3499 rc = pci_dev_reset(dev, 0); 3500 3501 pci_dev_restore(dev); 3502 3503 return rc; 3504 } 3505 EXPORT_SYMBOL_GPL(pci_reset_function); 3506 3507 /** 3508 * pci_try_reset_function - quiesce and reset a PCI device function 3509 * @dev: PCI device to reset 3510 * 3511 * Same as above, except return -EAGAIN if unable to lock device. 3512 */ 3513 int pci_try_reset_function(struct pci_dev *dev) 3514 { 3515 int rc; 3516 3517 rc = pci_dev_reset(dev, 1); 3518 if (rc) 3519 return rc; 3520 3521 pci_dev_save_and_disable(dev); 3522 3523 if (pci_dev_trylock(dev)) { 3524 rc = __pci_dev_reset(dev, 0); 3525 pci_dev_unlock(dev); 3526 } else 3527 rc = -EAGAIN; 3528 3529 pci_dev_restore(dev); 3530 3531 return rc; 3532 } 3533 EXPORT_SYMBOL_GPL(pci_try_reset_function); 3534 3535 /* Lock devices from the top of the tree down */ 3536 static void pci_bus_lock(struct pci_bus *bus) 3537 { 3538 struct pci_dev *dev; 3539 3540 list_for_each_entry(dev, &bus->devices, bus_list) { 3541 pci_dev_lock(dev); 3542 if (dev->subordinate) 3543 pci_bus_lock(dev->subordinate); 3544 } 3545 } 3546 3547 /* Unlock devices from the bottom of the tree up */ 3548 static void pci_bus_unlock(struct pci_bus *bus) 3549 { 3550 struct pci_dev *dev; 3551 3552 list_for_each_entry(dev, &bus->devices, bus_list) { 3553 if (dev->subordinate) 3554 pci_bus_unlock(dev->subordinate); 3555 pci_dev_unlock(dev); 3556 } 3557 } 3558 3559 /* Return 1 on successful lock, 0 on contention */ 3560 static int pci_bus_trylock(struct pci_bus *bus) 3561 { 3562 struct pci_dev *dev; 3563 3564 list_for_each_entry(dev, &bus->devices, bus_list) { 3565 if (!pci_dev_trylock(dev)) 3566 goto unlock; 3567 if (dev->subordinate) { 3568 if (!pci_bus_trylock(dev->subordinate)) { 3569 pci_dev_unlock(dev); 3570 goto unlock; 3571 } 3572 } 3573 } 3574 return 1; 3575 3576 unlock: 3577 list_for_each_entry_continue_reverse(dev, &bus->devices, bus_list) { 3578 if (dev->subordinate) 3579 pci_bus_unlock(dev->subordinate); 3580 pci_dev_unlock(dev); 3581 } 3582 return 0; 3583 } 3584 3585 /* Lock devices from the top of the tree down */ 3586 static void pci_slot_lock(struct pci_slot *slot) 3587 { 3588 struct pci_dev *dev; 3589 3590 list_for_each_entry(dev, &slot->bus->devices, bus_list) { 3591 if (!dev->slot || dev->slot != slot) 3592 continue; 3593 pci_dev_lock(dev); 3594 if (dev->subordinate) 3595 pci_bus_lock(dev->subordinate); 3596 } 3597 } 3598 3599 /* Unlock devices from the bottom of the tree up */ 3600 static void pci_slot_unlock(struct pci_slot *slot) 3601 { 3602 struct pci_dev *dev; 3603 3604 list_for_each_entry(dev, &slot->bus->devices, bus_list) { 3605 if (!dev->slot || dev->slot != slot) 3606 continue; 3607 if (dev->subordinate) 3608 pci_bus_unlock(dev->subordinate); 3609 pci_dev_unlock(dev); 3610 } 3611 } 3612 3613 /* Return 1 on successful lock, 0 on contention */ 3614 static int pci_slot_trylock(struct pci_slot *slot) 3615 { 3616 struct pci_dev *dev; 3617 3618 list_for_each_entry(dev, &slot->bus->devices, bus_list) { 3619 if (!dev->slot || dev->slot != slot) 3620 continue; 3621 if (!pci_dev_trylock(dev)) 3622 goto unlock; 3623 if (dev->subordinate) { 3624 if (!pci_bus_trylock(dev->subordinate)) { 3625 pci_dev_unlock(dev); 3626 goto unlock; 3627 } 3628 } 3629 } 3630 return 1; 3631 3632 unlock: 3633 list_for_each_entry_continue_reverse(dev, 3634 &slot->bus->devices, bus_list) { 3635 if (!dev->slot || dev->slot != slot) 3636 continue; 3637 if (dev->subordinate) 3638 pci_bus_unlock(dev->subordinate); 3639 pci_dev_unlock(dev); 3640 } 3641 return 0; 3642 } 3643 3644 /* Save and disable devices from the top of the tree down */ 3645 static void pci_bus_save_and_disable(struct pci_bus *bus) 3646 { 3647 struct pci_dev *dev; 3648 3649 list_for_each_entry(dev, &bus->devices, bus_list) { 3650 pci_dev_save_and_disable(dev); 3651 if (dev->subordinate) 3652 pci_bus_save_and_disable(dev->subordinate); 3653 } 3654 } 3655 3656 /* 3657 * Restore devices from top of the tree down - parent bridges need to be 3658 * restored before we can get to subordinate devices. 3659 */ 3660 static void pci_bus_restore(struct pci_bus *bus) 3661 { 3662 struct pci_dev *dev; 3663 3664 list_for_each_entry(dev, &bus->devices, bus_list) { 3665 pci_dev_restore(dev); 3666 if (dev->subordinate) 3667 pci_bus_restore(dev->subordinate); 3668 } 3669 } 3670 3671 /* Save and disable devices from the top of the tree down */ 3672 static void pci_slot_save_and_disable(struct pci_slot *slot) 3673 { 3674 struct pci_dev *dev; 3675 3676 list_for_each_entry(dev, &slot->bus->devices, bus_list) { 3677 if (!dev->slot || dev->slot != slot) 3678 continue; 3679 pci_dev_save_and_disable(dev); 3680 if (dev->subordinate) 3681 pci_bus_save_and_disable(dev->subordinate); 3682 } 3683 } 3684 3685 /* 3686 * Restore devices from top of the tree down - parent bridges need to be 3687 * restored before we can get to subordinate devices. 3688 */ 3689 static void pci_slot_restore(struct pci_slot *slot) 3690 { 3691 struct pci_dev *dev; 3692 3693 list_for_each_entry(dev, &slot->bus->devices, bus_list) { 3694 if (!dev->slot || dev->slot != slot) 3695 continue; 3696 pci_dev_restore(dev); 3697 if (dev->subordinate) 3698 pci_bus_restore(dev->subordinate); 3699 } 3700 } 3701 3702 static int pci_slot_reset(struct pci_slot *slot, int probe) 3703 { 3704 int rc; 3705 3706 if (!slot) 3707 return -ENOTTY; 3708 3709 if (!probe) 3710 pci_slot_lock(slot); 3711 3712 might_sleep(); 3713 3714 rc = pci_reset_hotplug_slot(slot->hotplug, probe); 3715 3716 if (!probe) 3717 pci_slot_unlock(slot); 3718 3719 return rc; 3720 } 3721 3722 /** 3723 * pci_probe_reset_slot - probe whether a PCI slot can be reset 3724 * @slot: PCI slot to probe 3725 * 3726 * Return 0 if slot can be reset, negative if a slot reset is not supported. 3727 */ 3728 int pci_probe_reset_slot(struct pci_slot *slot) 3729 { 3730 return pci_slot_reset(slot, 1); 3731 } 3732 EXPORT_SYMBOL_GPL(pci_probe_reset_slot); 3733 3734 /** 3735 * pci_reset_slot - reset a PCI slot 3736 * @slot: PCI slot to reset 3737 * 3738 * A PCI bus may host multiple slots, each slot may support a reset mechanism 3739 * independent of other slots. For instance, some slots may support slot power 3740 * control. In the case of a 1:1 bus to slot architecture, this function may 3741 * wrap the bus reset to avoid spurious slot related events such as hotplug. 3742 * Generally a slot reset should be attempted before a bus reset. All of the 3743 * function of the slot and any subordinate buses behind the slot are reset 3744 * through this function. PCI config space of all devices in the slot and 3745 * behind the slot is saved before and restored after reset. 3746 * 3747 * Return 0 on success, non-zero on error. 3748 */ 3749 int pci_reset_slot(struct pci_slot *slot) 3750 { 3751 int rc; 3752 3753 rc = pci_slot_reset(slot, 1); 3754 if (rc) 3755 return rc; 3756 3757 pci_slot_save_and_disable(slot); 3758 3759 rc = pci_slot_reset(slot, 0); 3760 3761 pci_slot_restore(slot); 3762 3763 return rc; 3764 } 3765 EXPORT_SYMBOL_GPL(pci_reset_slot); 3766 3767 /** 3768 * pci_try_reset_slot - Try to reset a PCI slot 3769 * @slot: PCI slot to reset 3770 * 3771 * Same as above except return -EAGAIN if the slot cannot be locked 3772 */ 3773 int pci_try_reset_slot(struct pci_slot *slot) 3774 { 3775 int rc; 3776 3777 rc = pci_slot_reset(slot, 1); 3778 if (rc) 3779 return rc; 3780 3781 pci_slot_save_and_disable(slot); 3782 3783 if (pci_slot_trylock(slot)) { 3784 might_sleep(); 3785 rc = pci_reset_hotplug_slot(slot->hotplug, 0); 3786 pci_slot_unlock(slot); 3787 } else 3788 rc = -EAGAIN; 3789 3790 pci_slot_restore(slot); 3791 3792 return rc; 3793 } 3794 EXPORT_SYMBOL_GPL(pci_try_reset_slot); 3795 3796 static int pci_bus_reset(struct pci_bus *bus, int probe) 3797 { 3798 if (!bus->self) 3799 return -ENOTTY; 3800 3801 if (probe) 3802 return 0; 3803 3804 pci_bus_lock(bus); 3805 3806 might_sleep(); 3807 3808 pci_reset_bridge_secondary_bus(bus->self); 3809 3810 pci_bus_unlock(bus); 3811 3812 return 0; 3813 } 3814 3815 /** 3816 * pci_probe_reset_bus - probe whether a PCI bus can be reset 3817 * @bus: PCI bus to probe 3818 * 3819 * Return 0 if bus can be reset, negative if a bus reset is not supported. 3820 */ 3821 int pci_probe_reset_bus(struct pci_bus *bus) 3822 { 3823 return pci_bus_reset(bus, 1); 3824 } 3825 EXPORT_SYMBOL_GPL(pci_probe_reset_bus); 3826 3827 /** 3828 * pci_reset_bus - reset a PCI bus 3829 * @bus: top level PCI bus to reset 3830 * 3831 * Do a bus reset on the given bus and any subordinate buses, saving 3832 * and restoring state of all devices. 3833 * 3834 * Return 0 on success, non-zero on error. 3835 */ 3836 int pci_reset_bus(struct pci_bus *bus) 3837 { 3838 int rc; 3839 3840 rc = pci_bus_reset(bus, 1); 3841 if (rc) 3842 return rc; 3843 3844 pci_bus_save_and_disable(bus); 3845 3846 rc = pci_bus_reset(bus, 0); 3847 3848 pci_bus_restore(bus); 3849 3850 return rc; 3851 } 3852 EXPORT_SYMBOL_GPL(pci_reset_bus); 3853 3854 /** 3855 * pci_try_reset_bus - Try to reset a PCI bus 3856 * @bus: top level PCI bus to reset 3857 * 3858 * Same as above except return -EAGAIN if the bus cannot be locked 3859 */ 3860 int pci_try_reset_bus(struct pci_bus *bus) 3861 { 3862 int rc; 3863 3864 rc = pci_bus_reset(bus, 1); 3865 if (rc) 3866 return rc; 3867 3868 pci_bus_save_and_disable(bus); 3869 3870 if (pci_bus_trylock(bus)) { 3871 might_sleep(); 3872 pci_reset_bridge_secondary_bus(bus->self); 3873 pci_bus_unlock(bus); 3874 } else 3875 rc = -EAGAIN; 3876 3877 pci_bus_restore(bus); 3878 3879 return rc; 3880 } 3881 EXPORT_SYMBOL_GPL(pci_try_reset_bus); 3882 3883 /** 3884 * pcix_get_max_mmrbc - get PCI-X maximum designed memory read byte count 3885 * @dev: PCI device to query 3886 * 3887 * Returns mmrbc: maximum designed memory read count in bytes 3888 * or appropriate error value. 3889 */ 3890 int pcix_get_max_mmrbc(struct pci_dev *dev) 3891 { 3892 int cap; 3893 u32 stat; 3894 3895 cap = pci_find_capability(dev, PCI_CAP_ID_PCIX); 3896 if (!cap) 3897 return -EINVAL; 3898 3899 if (pci_read_config_dword(dev, cap + PCI_X_STATUS, &stat)) 3900 return -EINVAL; 3901 3902 return 512 << ((stat & PCI_X_STATUS_MAX_READ) >> 21); 3903 } 3904 EXPORT_SYMBOL(pcix_get_max_mmrbc); 3905 3906 /** 3907 * pcix_get_mmrbc - get PCI-X maximum memory read byte count 3908 * @dev: PCI device to query 3909 * 3910 * Returns mmrbc: maximum memory read count in bytes 3911 * or appropriate error value. 3912 */ 3913 int pcix_get_mmrbc(struct pci_dev *dev) 3914 { 3915 int cap; 3916 u16 cmd; 3917 3918 cap = pci_find_capability(dev, PCI_CAP_ID_PCIX); 3919 if (!cap) 3920 return -EINVAL; 3921 3922 if (pci_read_config_word(dev, cap + PCI_X_CMD, &cmd)) 3923 return -EINVAL; 3924 3925 return 512 << ((cmd & PCI_X_CMD_MAX_READ) >> 2); 3926 } 3927 EXPORT_SYMBOL(pcix_get_mmrbc); 3928 3929 /** 3930 * pcix_set_mmrbc - set PCI-X maximum memory read byte count 3931 * @dev: PCI device to query 3932 * @mmrbc: maximum memory read count in bytes 3933 * valid values are 512, 1024, 2048, 4096 3934 * 3935 * If possible sets maximum memory read byte count, some bridges have erratas 3936 * that prevent this. 3937 */ 3938 int pcix_set_mmrbc(struct pci_dev *dev, int mmrbc) 3939 { 3940 int cap; 3941 u32 stat, v, o; 3942 u16 cmd; 3943 3944 if (mmrbc < 512 || mmrbc > 4096 || !is_power_of_2(mmrbc)) 3945 return -EINVAL; 3946 3947 v = ffs(mmrbc) - 10; 3948 3949 cap = pci_find_capability(dev, PCI_CAP_ID_PCIX); 3950 if (!cap) 3951 return -EINVAL; 3952 3953 if (pci_read_config_dword(dev, cap + PCI_X_STATUS, &stat)) 3954 return -EINVAL; 3955 3956 if (v > (stat & PCI_X_STATUS_MAX_READ) >> 21) 3957 return -E2BIG; 3958 3959 if (pci_read_config_word(dev, cap + PCI_X_CMD, &cmd)) 3960 return -EINVAL; 3961 3962 o = (cmd & PCI_X_CMD_MAX_READ) >> 2; 3963 if (o != v) { 3964 if (v > o && (dev->bus->bus_flags & PCI_BUS_FLAGS_NO_MMRBC)) 3965 return -EIO; 3966 3967 cmd &= ~PCI_X_CMD_MAX_READ; 3968 cmd |= v << 2; 3969 if (pci_write_config_word(dev, cap + PCI_X_CMD, cmd)) 3970 return -EIO; 3971 } 3972 return 0; 3973 } 3974 EXPORT_SYMBOL(pcix_set_mmrbc); 3975 3976 /** 3977 * pcie_get_readrq - get PCI Express read request size 3978 * @dev: PCI device to query 3979 * 3980 * Returns maximum memory read request in bytes 3981 * or appropriate error value. 3982 */ 3983 int pcie_get_readrq(struct pci_dev *dev) 3984 { 3985 u16 ctl; 3986 3987 pcie_capability_read_word(dev, PCI_EXP_DEVCTL, &ctl); 3988 3989 return 128 << ((ctl & PCI_EXP_DEVCTL_READRQ) >> 12); 3990 } 3991 EXPORT_SYMBOL(pcie_get_readrq); 3992 3993 /** 3994 * pcie_set_readrq - set PCI Express maximum memory read request 3995 * @dev: PCI device to query 3996 * @rq: maximum memory read count in bytes 3997 * valid values are 128, 256, 512, 1024, 2048, 4096 3998 * 3999 * If possible sets maximum memory read request in bytes 4000 */ 4001 int pcie_set_readrq(struct pci_dev *dev, int rq) 4002 { 4003 u16 v; 4004 4005 if (rq < 128 || rq > 4096 || !is_power_of_2(rq)) 4006 return -EINVAL; 4007 4008 /* 4009 * If using the "performance" PCIe config, we clamp the 4010 * read rq size to the max packet size to prevent the 4011 * host bridge generating requests larger than we can 4012 * cope with 4013 */ 4014 if (pcie_bus_config == PCIE_BUS_PERFORMANCE) { 4015 int mps = pcie_get_mps(dev); 4016 4017 if (mps < rq) 4018 rq = mps; 4019 } 4020 4021 v = (ffs(rq) - 8) << 12; 4022 4023 return pcie_capability_clear_and_set_word(dev, PCI_EXP_DEVCTL, 4024 PCI_EXP_DEVCTL_READRQ, v); 4025 } 4026 EXPORT_SYMBOL(pcie_set_readrq); 4027 4028 /** 4029 * pcie_get_mps - get PCI Express maximum payload size 4030 * @dev: PCI device to query 4031 * 4032 * Returns maximum payload size in bytes 4033 */ 4034 int pcie_get_mps(struct pci_dev *dev) 4035 { 4036 u16 ctl; 4037 4038 pcie_capability_read_word(dev, PCI_EXP_DEVCTL, &ctl); 4039 4040 return 128 << ((ctl & PCI_EXP_DEVCTL_PAYLOAD) >> 5); 4041 } 4042 EXPORT_SYMBOL(pcie_get_mps); 4043 4044 /** 4045 * pcie_set_mps - set PCI Express maximum payload size 4046 * @dev: PCI device to query 4047 * @mps: maximum payload size in bytes 4048 * valid values are 128, 256, 512, 1024, 2048, 4096 4049 * 4050 * If possible sets maximum payload size 4051 */ 4052 int pcie_set_mps(struct pci_dev *dev, int mps) 4053 { 4054 u16 v; 4055 4056 if (mps < 128 || mps > 4096 || !is_power_of_2(mps)) 4057 return -EINVAL; 4058 4059 v = ffs(mps) - 8; 4060 if (v > dev->pcie_mpss) 4061 return -EINVAL; 4062 v <<= 5; 4063 4064 return pcie_capability_clear_and_set_word(dev, PCI_EXP_DEVCTL, 4065 PCI_EXP_DEVCTL_PAYLOAD, v); 4066 } 4067 EXPORT_SYMBOL(pcie_set_mps); 4068 4069 /** 4070 * pcie_get_minimum_link - determine minimum link settings of a PCI device 4071 * @dev: PCI device to query 4072 * @speed: storage for minimum speed 4073 * @width: storage for minimum width 4074 * 4075 * This function will walk up the PCI device chain and determine the minimum 4076 * link width and speed of the device. 4077 */ 4078 int pcie_get_minimum_link(struct pci_dev *dev, enum pci_bus_speed *speed, 4079 enum pcie_link_width *width) 4080 { 4081 int ret; 4082 4083 *speed = PCI_SPEED_UNKNOWN; 4084 *width = PCIE_LNK_WIDTH_UNKNOWN; 4085 4086 while (dev) { 4087 u16 lnksta; 4088 enum pci_bus_speed next_speed; 4089 enum pcie_link_width next_width; 4090 4091 ret = pcie_capability_read_word(dev, PCI_EXP_LNKSTA, &lnksta); 4092 if (ret) 4093 return ret; 4094 4095 next_speed = pcie_link_speed[lnksta & PCI_EXP_LNKSTA_CLS]; 4096 next_width = (lnksta & PCI_EXP_LNKSTA_NLW) >> 4097 PCI_EXP_LNKSTA_NLW_SHIFT; 4098 4099 if (next_speed < *speed) 4100 *speed = next_speed; 4101 4102 if (next_width < *width) 4103 *width = next_width; 4104 4105 dev = dev->bus->self; 4106 } 4107 4108 return 0; 4109 } 4110 EXPORT_SYMBOL(pcie_get_minimum_link); 4111 4112 /** 4113 * pci_select_bars - Make BAR mask from the type of resource 4114 * @dev: the PCI device for which BAR mask is made 4115 * @flags: resource type mask to be selected 4116 * 4117 * This helper routine makes bar mask from the type of resource. 4118 */ 4119 int pci_select_bars(struct pci_dev *dev, unsigned long flags) 4120 { 4121 int i, bars = 0; 4122 for (i = 0; i < PCI_NUM_RESOURCES; i++) 4123 if (pci_resource_flags(dev, i) & flags) 4124 bars |= (1 << i); 4125 return bars; 4126 } 4127 EXPORT_SYMBOL(pci_select_bars); 4128 4129 /** 4130 * pci_resource_bar - get position of the BAR associated with a resource 4131 * @dev: the PCI device 4132 * @resno: the resource number 4133 * @type: the BAR type to be filled in 4134 * 4135 * Returns BAR position in config space, or 0 if the BAR is invalid. 4136 */ 4137 int pci_resource_bar(struct pci_dev *dev, int resno, enum pci_bar_type *type) 4138 { 4139 int reg; 4140 4141 if (resno < PCI_ROM_RESOURCE) { 4142 *type = pci_bar_unknown; 4143 return PCI_BASE_ADDRESS_0 + 4 * resno; 4144 } else if (resno == PCI_ROM_RESOURCE) { 4145 *type = pci_bar_mem32; 4146 return dev->rom_base_reg; 4147 } else if (resno < PCI_BRIDGE_RESOURCES) { 4148 /* device specific resource */ 4149 reg = pci_iov_resource_bar(dev, resno, type); 4150 if (reg) 4151 return reg; 4152 } 4153 4154 dev_err(&dev->dev, "BAR %d: invalid resource\n", resno); 4155 return 0; 4156 } 4157 4158 /* Some architectures require additional programming to enable VGA */ 4159 static arch_set_vga_state_t arch_set_vga_state; 4160 4161 void __init pci_register_set_vga_state(arch_set_vga_state_t func) 4162 { 4163 arch_set_vga_state = func; /* NULL disables */ 4164 } 4165 4166 static int pci_set_vga_state_arch(struct pci_dev *dev, bool decode, 4167 unsigned int command_bits, u32 flags) 4168 { 4169 if (arch_set_vga_state) 4170 return arch_set_vga_state(dev, decode, command_bits, 4171 flags); 4172 return 0; 4173 } 4174 4175 /** 4176 * pci_set_vga_state - set VGA decode state on device and parents if requested 4177 * @dev: the PCI device 4178 * @decode: true = enable decoding, false = disable decoding 4179 * @command_bits: PCI_COMMAND_IO and/or PCI_COMMAND_MEMORY 4180 * @flags: traverse ancestors and change bridges 4181 * CHANGE_BRIDGE_ONLY / CHANGE_BRIDGE 4182 */ 4183 int pci_set_vga_state(struct pci_dev *dev, bool decode, 4184 unsigned int command_bits, u32 flags) 4185 { 4186 struct pci_bus *bus; 4187 struct pci_dev *bridge; 4188 u16 cmd; 4189 int rc; 4190 4191 WARN_ON((flags & PCI_VGA_STATE_CHANGE_DECODES) && (command_bits & ~(PCI_COMMAND_IO|PCI_COMMAND_MEMORY))); 4192 4193 /* ARCH specific VGA enables */ 4194 rc = pci_set_vga_state_arch(dev, decode, command_bits, flags); 4195 if (rc) 4196 return rc; 4197 4198 if (flags & PCI_VGA_STATE_CHANGE_DECODES) { 4199 pci_read_config_word(dev, PCI_COMMAND, &cmd); 4200 if (decode == true) 4201 cmd |= command_bits; 4202 else 4203 cmd &= ~command_bits; 4204 pci_write_config_word(dev, PCI_COMMAND, cmd); 4205 } 4206 4207 if (!(flags & PCI_VGA_STATE_CHANGE_BRIDGE)) 4208 return 0; 4209 4210 bus = dev->bus; 4211 while (bus) { 4212 bridge = bus->self; 4213 if (bridge) { 4214 pci_read_config_word(bridge, PCI_BRIDGE_CONTROL, 4215 &cmd); 4216 if (decode == true) 4217 cmd |= PCI_BRIDGE_CTL_VGA; 4218 else 4219 cmd &= ~PCI_BRIDGE_CTL_VGA; 4220 pci_write_config_word(bridge, PCI_BRIDGE_CONTROL, 4221 cmd); 4222 } 4223 bus = bus->parent; 4224 } 4225 return 0; 4226 } 4227 4228 bool pci_device_is_present(struct pci_dev *pdev) 4229 { 4230 u32 v; 4231 4232 return pci_bus_read_dev_vendor_id(pdev->bus, pdev->devfn, &v, 0); 4233 } 4234 EXPORT_SYMBOL_GPL(pci_device_is_present); 4235 4236 #define RESOURCE_ALIGNMENT_PARAM_SIZE COMMAND_LINE_SIZE 4237 static char resource_alignment_param[RESOURCE_ALIGNMENT_PARAM_SIZE] = {0}; 4238 static DEFINE_SPINLOCK(resource_alignment_lock); 4239 4240 /** 4241 * pci_specified_resource_alignment - get resource alignment specified by user. 4242 * @dev: the PCI device to get 4243 * 4244 * RETURNS: Resource alignment if it is specified. 4245 * Zero if it is not specified. 4246 */ 4247 static resource_size_t pci_specified_resource_alignment(struct pci_dev *dev) 4248 { 4249 int seg, bus, slot, func, align_order, count; 4250 resource_size_t align = 0; 4251 char *p; 4252 4253 spin_lock(&resource_alignment_lock); 4254 p = resource_alignment_param; 4255 while (*p) { 4256 count = 0; 4257 if (sscanf(p, "%d%n", &align_order, &count) == 1 && 4258 p[count] == '@') { 4259 p += count + 1; 4260 } else { 4261 align_order = -1; 4262 } 4263 if (sscanf(p, "%x:%x:%x.%x%n", 4264 &seg, &bus, &slot, &func, &count) != 4) { 4265 seg = 0; 4266 if (sscanf(p, "%x:%x.%x%n", 4267 &bus, &slot, &func, &count) != 3) { 4268 /* Invalid format */ 4269 printk(KERN_ERR "PCI: Can't parse resource_alignment parameter: %s\n", 4270 p); 4271 break; 4272 } 4273 } 4274 p += count; 4275 if (seg == pci_domain_nr(dev->bus) && 4276 bus == dev->bus->number && 4277 slot == PCI_SLOT(dev->devfn) && 4278 func == PCI_FUNC(dev->devfn)) { 4279 if (align_order == -1) 4280 align = PAGE_SIZE; 4281 else 4282 align = 1 << align_order; 4283 /* Found */ 4284 break; 4285 } 4286 if (*p != ';' && *p != ',') { 4287 /* End of param or invalid format */ 4288 break; 4289 } 4290 p++; 4291 } 4292 spin_unlock(&resource_alignment_lock); 4293 return align; 4294 } 4295 4296 /* 4297 * This function disables memory decoding and releases memory resources 4298 * of the device specified by kernel's boot parameter 'pci=resource_alignment='. 4299 * It also rounds up size to specified alignment. 4300 * Later on, the kernel will assign page-aligned memory resource back 4301 * to the device. 4302 */ 4303 void pci_reassigndev_resource_alignment(struct pci_dev *dev) 4304 { 4305 int i; 4306 struct resource *r; 4307 resource_size_t align, size; 4308 u16 command; 4309 4310 /* check if specified PCI is target device to reassign */ 4311 align = pci_specified_resource_alignment(dev); 4312 if (!align) 4313 return; 4314 4315 if (dev->hdr_type == PCI_HEADER_TYPE_NORMAL && 4316 (dev->class >> 8) == PCI_CLASS_BRIDGE_HOST) { 4317 dev_warn(&dev->dev, 4318 "Can't reassign resources to host bridge.\n"); 4319 return; 4320 } 4321 4322 dev_info(&dev->dev, 4323 "Disabling memory decoding and releasing memory resources.\n"); 4324 pci_read_config_word(dev, PCI_COMMAND, &command); 4325 command &= ~PCI_COMMAND_MEMORY; 4326 pci_write_config_word(dev, PCI_COMMAND, command); 4327 4328 for (i = 0; i < PCI_BRIDGE_RESOURCES; i++) { 4329 r = &dev->resource[i]; 4330 if (!(r->flags & IORESOURCE_MEM)) 4331 continue; 4332 size = resource_size(r); 4333 if (size < align) { 4334 size = align; 4335 dev_info(&dev->dev, 4336 "Rounding up size of resource #%d to %#llx.\n", 4337 i, (unsigned long long)size); 4338 } 4339 r->flags |= IORESOURCE_UNSET; 4340 r->end = size - 1; 4341 r->start = 0; 4342 } 4343 /* Need to disable bridge's resource window, 4344 * to enable the kernel to reassign new resource 4345 * window later on. 4346 */ 4347 if (dev->hdr_type == PCI_HEADER_TYPE_BRIDGE && 4348 (dev->class >> 8) == PCI_CLASS_BRIDGE_PCI) { 4349 for (i = PCI_BRIDGE_RESOURCES; i < PCI_NUM_RESOURCES; i++) { 4350 r = &dev->resource[i]; 4351 if (!(r->flags & IORESOURCE_MEM)) 4352 continue; 4353 r->flags |= IORESOURCE_UNSET; 4354 r->end = resource_size(r) - 1; 4355 r->start = 0; 4356 } 4357 pci_disable_bridge_window(dev); 4358 } 4359 } 4360 4361 static ssize_t pci_set_resource_alignment_param(const char *buf, size_t count) 4362 { 4363 if (count > RESOURCE_ALIGNMENT_PARAM_SIZE - 1) 4364 count = RESOURCE_ALIGNMENT_PARAM_SIZE - 1; 4365 spin_lock(&resource_alignment_lock); 4366 strncpy(resource_alignment_param, buf, count); 4367 resource_alignment_param[count] = '\0'; 4368 spin_unlock(&resource_alignment_lock); 4369 return count; 4370 } 4371 4372 static ssize_t pci_get_resource_alignment_param(char *buf, size_t size) 4373 { 4374 size_t count; 4375 spin_lock(&resource_alignment_lock); 4376 count = snprintf(buf, size, "%s", resource_alignment_param); 4377 spin_unlock(&resource_alignment_lock); 4378 return count; 4379 } 4380 4381 static ssize_t pci_resource_alignment_show(struct bus_type *bus, char *buf) 4382 { 4383 return pci_get_resource_alignment_param(buf, PAGE_SIZE); 4384 } 4385 4386 static ssize_t pci_resource_alignment_store(struct bus_type *bus, 4387 const char *buf, size_t count) 4388 { 4389 return pci_set_resource_alignment_param(buf, count); 4390 } 4391 4392 BUS_ATTR(resource_alignment, 0644, pci_resource_alignment_show, 4393 pci_resource_alignment_store); 4394 4395 static int __init pci_resource_alignment_sysfs_init(void) 4396 { 4397 return bus_create_file(&pci_bus_type, 4398 &bus_attr_resource_alignment); 4399 } 4400 late_initcall(pci_resource_alignment_sysfs_init); 4401 4402 static void pci_no_domains(void) 4403 { 4404 #ifdef CONFIG_PCI_DOMAINS 4405 pci_domains_supported = 0; 4406 #endif 4407 } 4408 4409 /** 4410 * pci_ext_cfg_avail - can we access extended PCI config space? 4411 * 4412 * Returns 1 if we can access PCI extended config space (offsets 4413 * greater than 0xff). This is the default implementation. Architecture 4414 * implementations can override this. 4415 */ 4416 int __weak pci_ext_cfg_avail(void) 4417 { 4418 return 1; 4419 } 4420 4421 void __weak pci_fixup_cardbus(struct pci_bus *bus) 4422 { 4423 } 4424 EXPORT_SYMBOL(pci_fixup_cardbus); 4425 4426 static int __init pci_setup(char *str) 4427 { 4428 while (str) { 4429 char *k = strchr(str, ','); 4430 if (k) 4431 *k++ = 0; 4432 if (*str && (str = pcibios_setup(str)) && *str) { 4433 if (!strcmp(str, "nomsi")) { 4434 pci_no_msi(); 4435 } else if (!strcmp(str, "noaer")) { 4436 pci_no_aer(); 4437 } else if (!strncmp(str, "realloc=", 8)) { 4438 pci_realloc_get_opt(str + 8); 4439 } else if (!strncmp(str, "realloc", 7)) { 4440 pci_realloc_get_opt("on"); 4441 } else if (!strcmp(str, "nodomains")) { 4442 pci_no_domains(); 4443 } else if (!strncmp(str, "noari", 5)) { 4444 pcie_ari_disabled = true; 4445 } else if (!strncmp(str, "cbiosize=", 9)) { 4446 pci_cardbus_io_size = memparse(str + 9, &str); 4447 } else if (!strncmp(str, "cbmemsize=", 10)) { 4448 pci_cardbus_mem_size = memparse(str + 10, &str); 4449 } else if (!strncmp(str, "resource_alignment=", 19)) { 4450 pci_set_resource_alignment_param(str + 19, 4451 strlen(str + 19)); 4452 } else if (!strncmp(str, "ecrc=", 5)) { 4453 pcie_ecrc_get_policy(str + 5); 4454 } else if (!strncmp(str, "hpiosize=", 9)) { 4455 pci_hotplug_io_size = memparse(str + 9, &str); 4456 } else if (!strncmp(str, "hpmemsize=", 10)) { 4457 pci_hotplug_mem_size = memparse(str + 10, &str); 4458 } else if (!strncmp(str, "pcie_bus_tune_off", 17)) { 4459 pcie_bus_config = PCIE_BUS_TUNE_OFF; 4460 } else if (!strncmp(str, "pcie_bus_safe", 13)) { 4461 pcie_bus_config = PCIE_BUS_SAFE; 4462 } else if (!strncmp(str, "pcie_bus_perf", 13)) { 4463 pcie_bus_config = PCIE_BUS_PERFORMANCE; 4464 } else if (!strncmp(str, "pcie_bus_peer2peer", 18)) { 4465 pcie_bus_config = PCIE_BUS_PEER2PEER; 4466 } else if (!strncmp(str, "pcie_scan_all", 13)) { 4467 pci_add_flags(PCI_SCAN_ALL_PCIE_DEVS); 4468 } else { 4469 printk(KERN_ERR "PCI: Unknown option `%s'\n", 4470 str); 4471 } 4472 } 4473 str = k; 4474 } 4475 return 0; 4476 } 4477 early_param("pci", pci_setup); 4478