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