Merge git://git.kernel.org/pub/scm/linux/kernel/git/sfrench/cifs-2.6
[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>
13#include <linux/pci.h>
075c1771 14#include <linux/pm.h>
5a0e3ad6 15#include <linux/slab.h>
1da177e4
LT
16#include <linux/module.h>
17#include <linux/spinlock.h>
4e57b681 18#include <linux/string.h>
229f5afd 19#include <linux/log2.h>
7d715a6c 20#include <linux/pci-aspm.h>
c300bd2f 21#include <linux/pm_wakeup.h>
8dd7f803 22#include <linux/interrupt.h>
32a9a682 23#include <linux/device.h>
b67ea761 24#include <linux/pm_runtime.h>
32a9a682 25#include <asm/setup.h>
bc56b9e0 26#include "pci.h"
1da177e4 27
00240c38
AS
28const char *pci_power_names[] = {
29 "error", "D0", "D1", "D2", "D3hot", "D3cold", "unknown",
30};
31EXPORT_SYMBOL_GPL(pci_power_names);
32
93177a74
RW
33int isa_dma_bridge_buggy;
34EXPORT_SYMBOL(isa_dma_bridge_buggy);
35
36int pci_pci_problems;
37EXPORT_SYMBOL(pci_pci_problems);
38
1ae861e6
RW
39unsigned int pci_pm_d3_delay;
40
df17e62e
MG
41static void pci_pme_list_scan(struct work_struct *work);
42
43static LIST_HEAD(pci_pme_list);
44static DEFINE_MUTEX(pci_pme_list_mutex);
45static DECLARE_DELAYED_WORK(pci_pme_work, pci_pme_list_scan);
46
47struct pci_pme_device {
48 struct list_head list;
49 struct pci_dev *dev;
50};
51
52#define PME_TIMEOUT 1000 /* How long between PME checks */
53
1ae861e6
RW
54static void pci_dev_d3_sleep(struct pci_dev *dev)
55{
56 unsigned int delay = dev->d3_delay;
57
58 if (delay < pci_pm_d3_delay)
59 delay = pci_pm_d3_delay;
60
61 msleep(delay);
62}
1da177e4 63
32a2eea7
JG
64#ifdef CONFIG_PCI_DOMAINS
65int pci_domains_supported = 1;
66#endif
67
4516a618
AN
68#define DEFAULT_CARDBUS_IO_SIZE (256)
69#define DEFAULT_CARDBUS_MEM_SIZE (64*1024*1024)
70/* pci=cbmemsize=nnM,cbiosize=nn can override this */
71unsigned long pci_cardbus_io_size = DEFAULT_CARDBUS_IO_SIZE;
72unsigned long pci_cardbus_mem_size = DEFAULT_CARDBUS_MEM_SIZE;
73
28760489
EB
74#define DEFAULT_HOTPLUG_IO_SIZE (256)
75#define DEFAULT_HOTPLUG_MEM_SIZE (2*1024*1024)
76/* pci=hpmemsize=nnM,hpiosize=nn can override this */
77unsigned long pci_hotplug_io_size = DEFAULT_HOTPLUG_IO_SIZE;
78unsigned long pci_hotplug_mem_size = DEFAULT_HOTPLUG_MEM_SIZE;
79
ac1aa47b
JB
80/*
81 * The default CLS is used if arch didn't set CLS explicitly and not
82 * all pci devices agree on the same value. Arch can override either
83 * the dfl or actual value as it sees fit. Don't forget this is
84 * measured in 32-bit words, not bytes.
85 */
98e724c7 86u8 pci_dfl_cache_line_size __devinitdata = L1_CACHE_BYTES >> 2;
ac1aa47b
JB
87u8 pci_cache_line_size;
88
1da177e4
LT
89/**
90 * pci_bus_max_busnr - returns maximum PCI bus number of given bus' children
91 * @bus: pointer to PCI bus structure to search
92 *
93 * Given a PCI bus, returns the highest PCI bus number present in the set
94 * including the given PCI bus and its list of child PCI buses.
95 */
96bde06a 96unsigned char pci_bus_max_busnr(struct pci_bus* bus)
1da177e4
LT
97{
98 struct list_head *tmp;
99 unsigned char max, n;
100
b82db5ce 101 max = bus->subordinate;
1da177e4
LT
102 list_for_each(tmp, &bus->children) {
103 n = pci_bus_max_busnr(pci_bus_b(tmp));
104 if(n > max)
105 max = n;
106 }
107 return max;
108}
b82db5ce 109EXPORT_SYMBOL_GPL(pci_bus_max_busnr);
1da177e4 110
1684f5dd
AM
111#ifdef CONFIG_HAS_IOMEM
112void __iomem *pci_ioremap_bar(struct pci_dev *pdev, int bar)
113{
114 /*
115 * Make sure the BAR is actually a memory resource, not an IO resource
116 */
117 if (!(pci_resource_flags(pdev, bar) & IORESOURCE_MEM)) {
118 WARN_ON(1);
119 return NULL;
120 }
121 return ioremap_nocache(pci_resource_start(pdev, bar),
122 pci_resource_len(pdev, bar));
123}
124EXPORT_SYMBOL_GPL(pci_ioremap_bar);
125#endif
126
b82db5ce 127#if 0
1da177e4
LT
128/**
129 * pci_max_busnr - returns maximum PCI bus number
130 *
131 * Returns the highest PCI bus number present in the system global list of
132 * PCI buses.
133 */
134unsigned char __devinit
135pci_max_busnr(void)
136{
137 struct pci_bus *bus = NULL;
138 unsigned char max, n;
139
140 max = 0;
141 while ((bus = pci_find_next_bus(bus)) != NULL) {
142 n = pci_bus_max_busnr(bus);
143 if(n > max)
144 max = n;
145 }
146 return max;
147}
148
54c762fe
AB
149#endif /* 0 */
150
687d5fe3
ME
151#define PCI_FIND_CAP_TTL 48
152
153static int __pci_find_next_cap_ttl(struct pci_bus *bus, unsigned int devfn,
154 u8 pos, int cap, int *ttl)
24a4e377
RD
155{
156 u8 id;
24a4e377 157
687d5fe3 158 while ((*ttl)--) {
24a4e377
RD
159 pci_bus_read_config_byte(bus, devfn, pos, &pos);
160 if (pos < 0x40)
161 break;
162 pos &= ~3;
163 pci_bus_read_config_byte(bus, devfn, pos + PCI_CAP_LIST_ID,
164 &id);
165 if (id == 0xff)
166 break;
167 if (id == cap)
168 return pos;
169 pos += PCI_CAP_LIST_NEXT;
170 }
171 return 0;
172}
173
687d5fe3
ME
174static int __pci_find_next_cap(struct pci_bus *bus, unsigned int devfn,
175 u8 pos, int cap)
176{
177 int ttl = PCI_FIND_CAP_TTL;
178
179 return __pci_find_next_cap_ttl(bus, devfn, pos, cap, &ttl);
180}
181
24a4e377
RD
182int pci_find_next_capability(struct pci_dev *dev, u8 pos, int cap)
183{
184 return __pci_find_next_cap(dev->bus, dev->devfn,
185 pos + PCI_CAP_LIST_NEXT, cap);
186}
187EXPORT_SYMBOL_GPL(pci_find_next_capability);
188
d3bac118
ME
189static int __pci_bus_find_cap_start(struct pci_bus *bus,
190 unsigned int devfn, u8 hdr_type)
1da177e4
LT
191{
192 u16 status;
1da177e4
LT
193
194 pci_bus_read_config_word(bus, devfn, PCI_STATUS, &status);
195 if (!(status & PCI_STATUS_CAP_LIST))
196 return 0;
197
198 switch (hdr_type) {
199 case PCI_HEADER_TYPE_NORMAL:
200 case PCI_HEADER_TYPE_BRIDGE:
d3bac118 201 return PCI_CAPABILITY_LIST;
1da177e4 202 case PCI_HEADER_TYPE_CARDBUS:
d3bac118 203 return PCI_CB_CAPABILITY_LIST;
1da177e4
LT
204 default:
205 return 0;
206 }
d3bac118
ME
207
208 return 0;
1da177e4
LT
209}
210
211/**
212 * pci_find_capability - query for devices' capabilities
213 * @dev: PCI device to query
214 * @cap: capability code
215 *
216 * Tell if a device supports a given PCI capability.
217 * Returns the address of the requested capability structure within the
218 * device's PCI configuration space or 0 in case the device does not
219 * support it. Possible values for @cap:
220 *
221 * %PCI_CAP_ID_PM Power Management
222 * %PCI_CAP_ID_AGP Accelerated Graphics Port
223 * %PCI_CAP_ID_VPD Vital Product Data
224 * %PCI_CAP_ID_SLOTID Slot Identification
225 * %PCI_CAP_ID_MSI Message Signalled Interrupts
226 * %PCI_CAP_ID_CHSWP CompactPCI HotSwap
227 * %PCI_CAP_ID_PCIX PCI-X
228 * %PCI_CAP_ID_EXP PCI Express
229 */
230int pci_find_capability(struct pci_dev *dev, int cap)
231{
d3bac118
ME
232 int pos;
233
234 pos = __pci_bus_find_cap_start(dev->bus, dev->devfn, dev->hdr_type);
235 if (pos)
236 pos = __pci_find_next_cap(dev->bus, dev->devfn, pos, cap);
237
238 return pos;
1da177e4
LT
239}
240
241/**
242 * pci_bus_find_capability - query for devices' capabilities
243 * @bus: the PCI bus to query
244 * @devfn: PCI device to query
245 * @cap: capability code
246 *
247 * Like pci_find_capability() but works for pci devices that do not have a
248 * pci_dev structure set up yet.
249 *
250 * Returns the address of the requested capability structure within the
251 * device's PCI configuration space or 0 in case the device does not
252 * support it.
253 */
254int pci_bus_find_capability(struct pci_bus *bus, unsigned int devfn, int cap)
255{
d3bac118 256 int pos;
1da177e4
LT
257 u8 hdr_type;
258
259 pci_bus_read_config_byte(bus, devfn, PCI_HEADER_TYPE, &hdr_type);
260
d3bac118
ME
261 pos = __pci_bus_find_cap_start(bus, devfn, hdr_type & 0x7f);
262 if (pos)
263 pos = __pci_find_next_cap(bus, devfn, pos, cap);
264
265 return pos;
1da177e4
LT
266}
267
268/**
269 * pci_find_ext_capability - Find an extended capability
270 * @dev: PCI device to query
271 * @cap: capability code
272 *
273 * Returns the address of the requested extended capability structure
274 * within the device's PCI configuration space or 0 if the device does
275 * not support it. Possible values for @cap:
276 *
277 * %PCI_EXT_CAP_ID_ERR Advanced Error Reporting
278 * %PCI_EXT_CAP_ID_VC Virtual Channel
279 * %PCI_EXT_CAP_ID_DSN Device Serial Number
280 * %PCI_EXT_CAP_ID_PWR Power Budgeting
281 */
282int pci_find_ext_capability(struct pci_dev *dev, int cap)
283{
284 u32 header;
557848c3
ZY
285 int ttl;
286 int pos = PCI_CFG_SPACE_SIZE;
1da177e4 287
557848c3
ZY
288 /* minimum 8 bytes per capability */
289 ttl = (PCI_CFG_SPACE_EXP_SIZE - PCI_CFG_SPACE_SIZE) / 8;
290
291 if (dev->cfg_size <= PCI_CFG_SPACE_SIZE)
1da177e4
LT
292 return 0;
293
294 if (pci_read_config_dword(dev, pos, &header) != PCIBIOS_SUCCESSFUL)
295 return 0;
296
297 /*
298 * If we have no capabilities, this is indicated by cap ID,
299 * cap version and next pointer all being 0.
300 */
301 if (header == 0)
302 return 0;
303
304 while (ttl-- > 0) {
305 if (PCI_EXT_CAP_ID(header) == cap)
306 return pos;
307
308 pos = PCI_EXT_CAP_NEXT(header);
557848c3 309 if (pos < PCI_CFG_SPACE_SIZE)
1da177e4
LT
310 break;
311
312 if (pci_read_config_dword(dev, pos, &header) != PCIBIOS_SUCCESSFUL)
313 break;
314 }
315
316 return 0;
317}
3a720d72 318EXPORT_SYMBOL_GPL(pci_find_ext_capability);
1da177e4 319
cf4c43dd
JB
320/**
321 * pci_bus_find_ext_capability - find an extended capability
322 * @bus: the PCI bus to query
323 * @devfn: PCI device to query
324 * @cap: capability code
325 *
326 * Like pci_find_ext_capability() but works for pci devices that do not have a
327 * pci_dev structure set up yet.
328 *
329 * Returns the address of the requested capability structure within the
330 * device's PCI configuration space or 0 in case the device does not
331 * support it.
332 */
333int pci_bus_find_ext_capability(struct pci_bus *bus, unsigned int devfn,
334 int cap)
335{
336 u32 header;
337 int ttl;
338 int pos = PCI_CFG_SPACE_SIZE;
339
340 /* minimum 8 bytes per capability */
341 ttl = (PCI_CFG_SPACE_EXP_SIZE - PCI_CFG_SPACE_SIZE) / 8;
342
343 if (!pci_bus_read_config_dword(bus, devfn, pos, &header))
344 return 0;
345 if (header == 0xffffffff || header == 0)
346 return 0;
347
348 while (ttl-- > 0) {
349 if (PCI_EXT_CAP_ID(header) == cap)
350 return pos;
351
352 pos = PCI_EXT_CAP_NEXT(header);
353 if (pos < PCI_CFG_SPACE_SIZE)
354 break;
355
356 if (!pci_bus_read_config_dword(bus, devfn, pos, &header))
357 break;
358 }
359
360 return 0;
361}
362
687d5fe3
ME
363static int __pci_find_next_ht_cap(struct pci_dev *dev, int pos, int ht_cap)
364{
365 int rc, ttl = PCI_FIND_CAP_TTL;
366 u8 cap, mask;
367
368 if (ht_cap == HT_CAPTYPE_SLAVE || ht_cap == HT_CAPTYPE_HOST)
369 mask = HT_3BIT_CAP_MASK;
370 else
371 mask = HT_5BIT_CAP_MASK;
372
373 pos = __pci_find_next_cap_ttl(dev->bus, dev->devfn, pos,
374 PCI_CAP_ID_HT, &ttl);
375 while (pos) {
376 rc = pci_read_config_byte(dev, pos + 3, &cap);
377 if (rc != PCIBIOS_SUCCESSFUL)
378 return 0;
379
380 if ((cap & mask) == ht_cap)
381 return pos;
382
47a4d5be
BG
383 pos = __pci_find_next_cap_ttl(dev->bus, dev->devfn,
384 pos + PCI_CAP_LIST_NEXT,
687d5fe3
ME
385 PCI_CAP_ID_HT, &ttl);
386 }
387
388 return 0;
389}
390/**
391 * pci_find_next_ht_capability - query a device's Hypertransport capabilities
392 * @dev: PCI device to query
393 * @pos: Position from which to continue searching
394 * @ht_cap: Hypertransport capability code
395 *
396 * To be used in conjunction with pci_find_ht_capability() to search for
397 * all capabilities matching @ht_cap. @pos should always be a value returned
398 * from pci_find_ht_capability().
399 *
400 * NB. To be 100% safe against broken PCI devices, the caller should take
401 * steps to avoid an infinite loop.
402 */
403int pci_find_next_ht_capability(struct pci_dev *dev, int pos, int ht_cap)
404{
405 return __pci_find_next_ht_cap(dev, pos + PCI_CAP_LIST_NEXT, ht_cap);
406}
407EXPORT_SYMBOL_GPL(pci_find_next_ht_capability);
408
409/**
410 * pci_find_ht_capability - query a device's Hypertransport capabilities
411 * @dev: PCI device to query
412 * @ht_cap: Hypertransport capability code
413 *
414 * Tell if a device supports a given Hypertransport capability.
415 * Returns an address within the device's PCI configuration space
416 * or 0 in case the device does not support the request capability.
417 * The address points to the PCI capability, of type PCI_CAP_ID_HT,
418 * which has a Hypertransport capability matching @ht_cap.
419 */
420int pci_find_ht_capability(struct pci_dev *dev, int ht_cap)
421{
422 int pos;
423
424 pos = __pci_bus_find_cap_start(dev->bus, dev->devfn, dev->hdr_type);
425 if (pos)
426 pos = __pci_find_next_ht_cap(dev, pos, ht_cap);
427
428 return pos;
429}
430EXPORT_SYMBOL_GPL(pci_find_ht_capability);
431
1da177e4
LT
432/**
433 * pci_find_parent_resource - return resource region of parent bus of given region
434 * @dev: PCI device structure contains resources to be searched
435 * @res: child resource record for which parent is sought
436 *
437 * For given resource region of given device, return the resource
438 * region of parent bus the given region is contained in or where
439 * it should be allocated from.
440 */
441struct resource *
442pci_find_parent_resource(const struct pci_dev *dev, struct resource *res)
443{
444 const struct pci_bus *bus = dev->bus;
445 int i;
89a74ecc 446 struct resource *best = NULL, *r;
1da177e4 447
89a74ecc 448 pci_bus_for_each_resource(bus, r, i) {
1da177e4
LT
449 if (!r)
450 continue;
451 if (res->start && !(res->start >= r->start && res->end <= r->end))
452 continue; /* Not contained */
453 if ((res->flags ^ r->flags) & (IORESOURCE_IO | IORESOURCE_MEM))
454 continue; /* Wrong type */
455 if (!((res->flags ^ r->flags) & IORESOURCE_PREFETCH))
456 return r; /* Exact match */
8c8def26
LT
457 /* We can't insert a non-prefetch resource inside a prefetchable parent .. */
458 if (r->flags & IORESOURCE_PREFETCH)
459 continue;
460 /* .. but we can put a prefetchable resource inside a non-prefetchable one */
461 if (!best)
462 best = r;
1da177e4
LT
463 }
464 return best;
465}
466
064b53db
JL
467/**
468 * pci_restore_bars - restore a devices BAR values (e.g. after wake-up)
469 * @dev: PCI device to have its BARs restored
470 *
471 * Restore the BAR values for a given device, so as to make it
472 * accessible by its driver.
473 */
ad668599 474static void
064b53db
JL
475pci_restore_bars(struct pci_dev *dev)
476{
bc5f5a82 477 int i;
064b53db 478
bc5f5a82 479 for (i = 0; i < PCI_BRIDGE_RESOURCES; i++)
14add80b 480 pci_update_resource(dev, i);
064b53db
JL
481}
482
961d9120
RW
483static struct pci_platform_pm_ops *pci_platform_pm;
484
485int pci_set_platform_pm(struct pci_platform_pm_ops *ops)
486{
eb9d0fe4
RW
487 if (!ops->is_manageable || !ops->set_state || !ops->choose_state
488 || !ops->sleep_wake || !ops->can_wakeup)
961d9120
RW
489 return -EINVAL;
490 pci_platform_pm = ops;
491 return 0;
492}
493
494static inline bool platform_pci_power_manageable(struct pci_dev *dev)
495{
496 return pci_platform_pm ? pci_platform_pm->is_manageable(dev) : false;
497}
498
499static inline int platform_pci_set_power_state(struct pci_dev *dev,
500 pci_power_t t)
501{
502 return pci_platform_pm ? pci_platform_pm->set_state(dev, t) : -ENOSYS;
503}
504
505static inline pci_power_t platform_pci_choose_state(struct pci_dev *dev)
506{
507 return pci_platform_pm ?
508 pci_platform_pm->choose_state(dev) : PCI_POWER_ERROR;
509}
8f7020d3 510
eb9d0fe4
RW
511static inline bool platform_pci_can_wakeup(struct pci_dev *dev)
512{
513 return pci_platform_pm ? pci_platform_pm->can_wakeup(dev) : false;
514}
515
516static inline int platform_pci_sleep_wake(struct pci_dev *dev, bool enable)
517{
518 return pci_platform_pm ?
519 pci_platform_pm->sleep_wake(dev, enable) : -ENODEV;
520}
521
b67ea761
RW
522static inline int platform_pci_run_wake(struct pci_dev *dev, bool enable)
523{
524 return pci_platform_pm ?
525 pci_platform_pm->run_wake(dev, enable) : -ENODEV;
526}
527
1da177e4 528/**
44e4e66e
RW
529 * pci_raw_set_power_state - Use PCI PM registers to set the power state of
530 * given PCI device
531 * @dev: PCI device to handle.
44e4e66e 532 * @state: PCI power state (D0, D1, D2, D3hot) to put the device into.
1da177e4 533 *
44e4e66e
RW
534 * RETURN VALUE:
535 * -EINVAL if the requested state is invalid.
536 * -EIO if device does not support PCI PM or its PM capabilities register has a
537 * wrong version, or device doesn't support the requested state.
538 * 0 if device already is in the requested state.
539 * 0 if device's power state has been successfully changed.
1da177e4 540 */
f00a20ef 541static int pci_raw_set_power_state(struct pci_dev *dev, pci_power_t state)
1da177e4 542{
337001b6 543 u16 pmcsr;
44e4e66e 544 bool need_restore = false;
1da177e4 545
4a865905
RW
546 /* Check if we're already there */
547 if (dev->current_state == state)
548 return 0;
549
337001b6 550 if (!dev->pm_cap)
cca03dec
AL
551 return -EIO;
552
44e4e66e
RW
553 if (state < PCI_D0 || state > PCI_D3hot)
554 return -EINVAL;
555
1da177e4
LT
556 /* Validate current state:
557 * Can enter D0 from any state, but if we can only go deeper
558 * to sleep if we're already in a low power state
559 */
4a865905 560 if (state != PCI_D0 && dev->current_state <= PCI_D3cold
44e4e66e 561 && dev->current_state > state) {
80ccba11
BH
562 dev_err(&dev->dev, "invalid power transition "
563 "(from state %d to %d)\n", dev->current_state, state);
1da177e4 564 return -EINVAL;
44e4e66e 565 }
1da177e4 566
1da177e4 567 /* check if this device supports the desired state */
337001b6
RW
568 if ((state == PCI_D1 && !dev->d1_support)
569 || (state == PCI_D2 && !dev->d2_support))
3fe9d19f 570 return -EIO;
1da177e4 571
337001b6 572 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr);
064b53db 573
32a36585 574 /* If we're (effectively) in D3, force entire word to 0.
1da177e4
LT
575 * This doesn't affect PME_Status, disables PME_En, and
576 * sets PowerState to 0.
577 */
32a36585 578 switch (dev->current_state) {
d3535fbb
JL
579 case PCI_D0:
580 case PCI_D1:
581 case PCI_D2:
582 pmcsr &= ~PCI_PM_CTRL_STATE_MASK;
583 pmcsr |= state;
584 break;
f62795f1
RW
585 case PCI_D3hot:
586 case PCI_D3cold:
32a36585
JL
587 case PCI_UNKNOWN: /* Boot-up */
588 if ((pmcsr & PCI_PM_CTRL_STATE_MASK) == PCI_D3hot
f00a20ef 589 && !(pmcsr & PCI_PM_CTRL_NO_SOFT_RESET))
44e4e66e 590 need_restore = true;
32a36585 591 /* Fall-through: force to D0 */
32a36585 592 default:
d3535fbb 593 pmcsr = 0;
32a36585 594 break;
1da177e4
LT
595 }
596
597 /* enter specified state */
337001b6 598 pci_write_config_word(dev, dev->pm_cap + PCI_PM_CTRL, pmcsr);
1da177e4
LT
599
600 /* Mandatory power management transition delays */
601 /* see PCI PM 1.1 5.6.1 table 18 */
602 if (state == PCI_D3hot || dev->current_state == PCI_D3hot)
1ae861e6 603 pci_dev_d3_sleep(dev);
1da177e4 604 else if (state == PCI_D2 || dev->current_state == PCI_D2)
aa8c6c93 605 udelay(PCI_PM_D2_DELAY);
1da177e4 606
e13cdbd7
RW
607 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr);
608 dev->current_state = (pmcsr & PCI_PM_CTRL_STATE_MASK);
609 if (dev->current_state != state && printk_ratelimit())
610 dev_info(&dev->dev, "Refused to change power state, "
611 "currently in D%d\n", dev->current_state);
064b53db
JL
612
613 /* According to section 5.4.1 of the "PCI BUS POWER MANAGEMENT
614 * INTERFACE SPECIFICATION, REV. 1.2", a device transitioning
615 * from D3hot to D0 _may_ perform an internal reset, thereby
616 * going to "D0 Uninitialized" rather than "D0 Initialized".
617 * For example, at least some versions of the 3c905B and the
618 * 3c556B exhibit this behaviour.
619 *
620 * At least some laptop BIOSen (e.g. the Thinkpad T21) leave
621 * devices in a D3hot state at boot. Consequently, we need to
622 * restore at least the BARs so that the device will be
623 * accessible to its driver.
624 */
625 if (need_restore)
626 pci_restore_bars(dev);
627
f00a20ef 628 if (dev->bus->self)
7d715a6c
SL
629 pcie_aspm_pm_state_change(dev->bus->self);
630
1da177e4
LT
631 return 0;
632}
633
44e4e66e
RW
634/**
635 * pci_update_current_state - Read PCI power state of given device from its
636 * PCI PM registers and cache it
637 * @dev: PCI device to handle.
f06fc0b6 638 * @state: State to cache in case the device doesn't have the PM capability
44e4e66e 639 */
73410429 640void pci_update_current_state(struct pci_dev *dev, pci_power_t state)
44e4e66e 641{
337001b6 642 if (dev->pm_cap) {
44e4e66e
RW
643 u16 pmcsr;
644
337001b6 645 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr);
44e4e66e 646 dev->current_state = (pmcsr & PCI_PM_CTRL_STATE_MASK);
f06fc0b6
RW
647 } else {
648 dev->current_state = state;
44e4e66e
RW
649 }
650}
651
0e5dd46b
RW
652/**
653 * pci_platform_power_transition - Use platform to change device power state
654 * @dev: PCI device to handle.
655 * @state: State to put the device into.
656 */
657static int pci_platform_power_transition(struct pci_dev *dev, pci_power_t state)
658{
659 int error;
660
661 if (platform_pci_power_manageable(dev)) {
662 error = platform_pci_set_power_state(dev, state);
663 if (!error)
664 pci_update_current_state(dev, state);
665 } else {
666 error = -ENODEV;
667 /* Fall back to PCI_D0 if native PM is not supported */
b3bad72e
RW
668 if (!dev->pm_cap)
669 dev->current_state = PCI_D0;
0e5dd46b
RW
670 }
671
672 return error;
673}
674
675/**
676 * __pci_start_power_transition - Start power transition of a PCI device
677 * @dev: PCI device to handle.
678 * @state: State to put the device into.
679 */
680static void __pci_start_power_transition(struct pci_dev *dev, pci_power_t state)
681{
682 if (state == PCI_D0)
683 pci_platform_power_transition(dev, PCI_D0);
684}
685
686/**
687 * __pci_complete_power_transition - Complete power transition of a PCI device
688 * @dev: PCI device to handle.
689 * @state: State to put the device into.
690 *
691 * This function should not be called directly by device drivers.
692 */
693int __pci_complete_power_transition(struct pci_dev *dev, pci_power_t state)
694{
cc2893b6 695 return state >= PCI_D0 ?
0e5dd46b
RW
696 pci_platform_power_transition(dev, state) : -EINVAL;
697}
698EXPORT_SYMBOL_GPL(__pci_complete_power_transition);
699
44e4e66e
RW
700/**
701 * pci_set_power_state - Set the power state of a PCI device
702 * @dev: PCI device to handle.
703 * @state: PCI power state (D0, D1, D2, D3hot) to put the device into.
704 *
877d0310 705 * Transition a device to a new power state, using the platform firmware and/or
44e4e66e
RW
706 * the device's PCI PM registers.
707 *
708 * RETURN VALUE:
709 * -EINVAL if the requested state is invalid.
710 * -EIO if device does not support PCI PM or its PM capabilities register has a
711 * wrong version, or device doesn't support the requested state.
712 * 0 if device already is in the requested state.
713 * 0 if device's power state has been successfully changed.
714 */
715int pci_set_power_state(struct pci_dev *dev, pci_power_t state)
716{
337001b6 717 int error;
44e4e66e
RW
718
719 /* bound the state we're entering */
720 if (state > PCI_D3hot)
721 state = PCI_D3hot;
722 else if (state < PCI_D0)
723 state = PCI_D0;
724 else if ((state == PCI_D1 || state == PCI_D2) && pci_no_d1d2(dev))
725 /*
726 * If the device or the parent bridge do not support PCI PM,
727 * ignore the request if we're doing anything other than putting
728 * it into D0 (which would only happen on boot).
729 */
730 return 0;
731
0e5dd46b
RW
732 __pci_start_power_transition(dev, state);
733
979b1791
AC
734 /* This device is quirked not to be put into D3, so
735 don't put it in D3 */
736 if (state == PCI_D3hot && (dev->dev_flags & PCI_DEV_FLAGS_NO_D3))
737 return 0;
44e4e66e 738
f00a20ef 739 error = pci_raw_set_power_state(dev, state);
44e4e66e 740
0e5dd46b
RW
741 if (!__pci_complete_power_transition(dev, state))
742 error = 0;
1a680b7c
NC
743 /*
744 * When aspm_policy is "powersave" this call ensures
745 * that ASPM is configured.
746 */
747 if (!error && dev->bus->self)
748 pcie_aspm_powersave_config_link(dev->bus->self);
44e4e66e
RW
749
750 return error;
751}
752
1da177e4
LT
753/**
754 * pci_choose_state - Choose the power state of a PCI device
755 * @dev: PCI device to be suspended
756 * @state: target sleep state for the whole system. This is the value
757 * that is passed to suspend() function.
758 *
759 * Returns PCI power state suitable for given device and given system
760 * message.
761 */
762
763pci_power_t pci_choose_state(struct pci_dev *dev, pm_message_t state)
764{
ab826ca4 765 pci_power_t ret;
0f64474b 766
1da177e4
LT
767 if (!pci_find_capability(dev, PCI_CAP_ID_PM))
768 return PCI_D0;
769
961d9120
RW
770 ret = platform_pci_choose_state(dev);
771 if (ret != PCI_POWER_ERROR)
772 return ret;
ca078bae
PM
773
774 switch (state.event) {
775 case PM_EVENT_ON:
776 return PCI_D0;
777 case PM_EVENT_FREEZE:
b887d2e6
DB
778 case PM_EVENT_PRETHAW:
779 /* REVISIT both freeze and pre-thaw "should" use D0 */
ca078bae 780 case PM_EVENT_SUSPEND:
3a2d5b70 781 case PM_EVENT_HIBERNATE:
ca078bae 782 return PCI_D3hot;
1da177e4 783 default:
80ccba11
BH
784 dev_info(&dev->dev, "unrecognized suspend event %d\n",
785 state.event);
1da177e4
LT
786 BUG();
787 }
788 return PCI_D0;
789}
790
791EXPORT_SYMBOL(pci_choose_state);
792
89858517
YZ
793#define PCI_EXP_SAVE_REGS 7
794
1b6b8ce2
YZ
795#define pcie_cap_has_devctl(type, flags) 1
796#define pcie_cap_has_lnkctl(type, flags) \
797 ((flags & PCI_EXP_FLAGS_VERS) > 1 || \
798 (type == PCI_EXP_TYPE_ROOT_PORT || \
799 type == PCI_EXP_TYPE_ENDPOINT || \
800 type == PCI_EXP_TYPE_LEG_END))
801#define pcie_cap_has_sltctl(type, flags) \
802 ((flags & PCI_EXP_FLAGS_VERS) > 1 || \
803 ((type == PCI_EXP_TYPE_ROOT_PORT) || \
804 (type == PCI_EXP_TYPE_DOWNSTREAM && \
805 (flags & PCI_EXP_FLAGS_SLOT))))
806#define pcie_cap_has_rtctl(type, flags) \
807 ((flags & PCI_EXP_FLAGS_VERS) > 1 || \
808 (type == PCI_EXP_TYPE_ROOT_PORT || \
809 type == PCI_EXP_TYPE_RC_EC))
810#define pcie_cap_has_devctl2(type, flags) \
811 ((flags & PCI_EXP_FLAGS_VERS) > 1)
812#define pcie_cap_has_lnkctl2(type, flags) \
813 ((flags & PCI_EXP_FLAGS_VERS) > 1)
814#define pcie_cap_has_sltctl2(type, flags) \
815 ((flags & PCI_EXP_FLAGS_VERS) > 1)
816
b56a5a23
MT
817static int pci_save_pcie_state(struct pci_dev *dev)
818{
819 int pos, i = 0;
820 struct pci_cap_saved_state *save_state;
821 u16 *cap;
1b6b8ce2 822 u16 flags;
b56a5a23 823
06a1cbaf
KK
824 pos = pci_pcie_cap(dev);
825 if (!pos)
b56a5a23
MT
826 return 0;
827
9f35575d 828 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_EXP);
b56a5a23 829 if (!save_state) {
e496b617 830 dev_err(&dev->dev, "buffer not found in %s\n", __func__);
b56a5a23
MT
831 return -ENOMEM;
832 }
24a4742f 833 cap = (u16 *)&save_state->cap.data[0];
b56a5a23 834
1b6b8ce2
YZ
835 pci_read_config_word(dev, pos + PCI_EXP_FLAGS, &flags);
836
837 if (pcie_cap_has_devctl(dev->pcie_type, flags))
838 pci_read_config_word(dev, pos + PCI_EXP_DEVCTL, &cap[i++]);
839 if (pcie_cap_has_lnkctl(dev->pcie_type, flags))
840 pci_read_config_word(dev, pos + PCI_EXP_LNKCTL, &cap[i++]);
841 if (pcie_cap_has_sltctl(dev->pcie_type, flags))
842 pci_read_config_word(dev, pos + PCI_EXP_SLTCTL, &cap[i++]);
843 if (pcie_cap_has_rtctl(dev->pcie_type, flags))
844 pci_read_config_word(dev, pos + PCI_EXP_RTCTL, &cap[i++]);
845 if (pcie_cap_has_devctl2(dev->pcie_type, flags))
846 pci_read_config_word(dev, pos + PCI_EXP_DEVCTL2, &cap[i++]);
847 if (pcie_cap_has_lnkctl2(dev->pcie_type, flags))
848 pci_read_config_word(dev, pos + PCI_EXP_LNKCTL2, &cap[i++]);
849 if (pcie_cap_has_sltctl2(dev->pcie_type, flags))
850 pci_read_config_word(dev, pos + PCI_EXP_SLTCTL2, &cap[i++]);
63f4898a 851
b56a5a23
MT
852 return 0;
853}
854
855static void pci_restore_pcie_state(struct pci_dev *dev)
856{
857 int i = 0, pos;
858 struct pci_cap_saved_state *save_state;
859 u16 *cap;
1b6b8ce2 860 u16 flags;
b56a5a23
MT
861
862 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_EXP);
863 pos = pci_find_capability(dev, PCI_CAP_ID_EXP);
864 if (!save_state || pos <= 0)
865 return;
24a4742f 866 cap = (u16 *)&save_state->cap.data[0];
b56a5a23 867
1b6b8ce2
YZ
868 pci_read_config_word(dev, pos + PCI_EXP_FLAGS, &flags);
869
870 if (pcie_cap_has_devctl(dev->pcie_type, flags))
871 pci_write_config_word(dev, pos + PCI_EXP_DEVCTL, cap[i++]);
872 if (pcie_cap_has_lnkctl(dev->pcie_type, flags))
873 pci_write_config_word(dev, pos + PCI_EXP_LNKCTL, cap[i++]);
874 if (pcie_cap_has_sltctl(dev->pcie_type, flags))
875 pci_write_config_word(dev, pos + PCI_EXP_SLTCTL, cap[i++]);
876 if (pcie_cap_has_rtctl(dev->pcie_type, flags))
877 pci_write_config_word(dev, pos + PCI_EXP_RTCTL, cap[i++]);
878 if (pcie_cap_has_devctl2(dev->pcie_type, flags))
879 pci_write_config_word(dev, pos + PCI_EXP_DEVCTL2, cap[i++]);
880 if (pcie_cap_has_lnkctl2(dev->pcie_type, flags))
881 pci_write_config_word(dev, pos + PCI_EXP_LNKCTL2, cap[i++]);
882 if (pcie_cap_has_sltctl2(dev->pcie_type, flags))
883 pci_write_config_word(dev, pos + PCI_EXP_SLTCTL2, cap[i++]);
b56a5a23
MT
884}
885
cc692a5f
SH
886
887static int pci_save_pcix_state(struct pci_dev *dev)
888{
63f4898a 889 int pos;
cc692a5f 890 struct pci_cap_saved_state *save_state;
cc692a5f
SH
891
892 pos = pci_find_capability(dev, PCI_CAP_ID_PCIX);
893 if (pos <= 0)
894 return 0;
895
f34303de 896 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_PCIX);
cc692a5f 897 if (!save_state) {
e496b617 898 dev_err(&dev->dev, "buffer not found in %s\n", __func__);
cc692a5f
SH
899 return -ENOMEM;
900 }
cc692a5f 901
24a4742f
AW
902 pci_read_config_word(dev, pos + PCI_X_CMD,
903 (u16 *)save_state->cap.data);
63f4898a 904
cc692a5f
SH
905 return 0;
906}
907
908static void pci_restore_pcix_state(struct pci_dev *dev)
909{
910 int i = 0, pos;
911 struct pci_cap_saved_state *save_state;
912 u16 *cap;
913
914 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_PCIX);
915 pos = pci_find_capability(dev, PCI_CAP_ID_PCIX);
916 if (!save_state || pos <= 0)
917 return;
24a4742f 918 cap = (u16 *)&save_state->cap.data[0];
cc692a5f
SH
919
920 pci_write_config_word(dev, pos + PCI_X_CMD, cap[i++]);
cc692a5f
SH
921}
922
923
1da177e4
LT
924/**
925 * pci_save_state - save the PCI configuration space of a device before suspending
926 * @dev: - PCI device that we're dealing with
1da177e4
LT
927 */
928int
929pci_save_state(struct pci_dev *dev)
930{
931 int i;
932 /* XXX: 100% dword access ok here? */
933 for (i = 0; i < 16; i++)
9e0b5b2c 934 pci_read_config_dword(dev, i * 4, &dev->saved_config_space[i]);
aa8c6c93 935 dev->state_saved = true;
b56a5a23
MT
936 if ((i = pci_save_pcie_state(dev)) != 0)
937 return i;
cc692a5f
SH
938 if ((i = pci_save_pcix_state(dev)) != 0)
939 return i;
1da177e4
LT
940 return 0;
941}
942
943/**
944 * pci_restore_state - Restore the saved state of a PCI device
945 * @dev: - PCI device that we're dealing with
1da177e4 946 */
1d3c16a8 947void pci_restore_state(struct pci_dev *dev)
1da177e4
LT
948{
949 int i;
b4482a4b 950 u32 val;
1da177e4 951
c82f63e4 952 if (!dev->state_saved)
1d3c16a8 953 return;
4b77b0a2 954
b56a5a23
MT
955 /* PCI Express register must be restored first */
956 pci_restore_pcie_state(dev);
957
8b8c8d28
YL
958 /*
959 * The Base Address register should be programmed before the command
960 * register(s)
961 */
962 for (i = 15; i >= 0; i--) {
04d9c1a1
DJ
963 pci_read_config_dword(dev, i * 4, &val);
964 if (val != dev->saved_config_space[i]) {
80ccba11
BH
965 dev_printk(KERN_DEBUG, &dev->dev, "restoring config "
966 "space at offset %#x (was %#x, writing %#x)\n",
967 i, val, (int)dev->saved_config_space[i]);
04d9c1a1
DJ
968 pci_write_config_dword(dev,i * 4,
969 dev->saved_config_space[i]);
970 }
971 }
cc692a5f 972 pci_restore_pcix_state(dev);
41017f0c 973 pci_restore_msi_state(dev);
8c5cdb6a 974 pci_restore_iov_state(dev);
8fed4b65 975
4b77b0a2 976 dev->state_saved = false;
1da177e4
LT
977}
978
ffbdd3f7
AW
979struct pci_saved_state {
980 u32 config_space[16];
981 struct pci_cap_saved_data cap[0];
982};
983
984/**
985 * pci_store_saved_state - Allocate and return an opaque struct containing
986 * the device saved state.
987 * @dev: PCI device that we're dealing with
988 *
989 * Rerturn NULL if no state or error.
990 */
991struct pci_saved_state *pci_store_saved_state(struct pci_dev *dev)
992{
993 struct pci_saved_state *state;
994 struct pci_cap_saved_state *tmp;
995 struct pci_cap_saved_data *cap;
996 struct hlist_node *pos;
997 size_t size;
998
999 if (!dev->state_saved)
1000 return NULL;
1001
1002 size = sizeof(*state) + sizeof(struct pci_cap_saved_data);
1003
1004 hlist_for_each_entry(tmp, pos, &dev->saved_cap_space, next)
1005 size += sizeof(struct pci_cap_saved_data) + tmp->cap.size;
1006
1007 state = kzalloc(size, GFP_KERNEL);
1008 if (!state)
1009 return NULL;
1010
1011 memcpy(state->config_space, dev->saved_config_space,
1012 sizeof(state->config_space));
1013
1014 cap = state->cap;
1015 hlist_for_each_entry(tmp, pos, &dev->saved_cap_space, next) {
1016 size_t len = sizeof(struct pci_cap_saved_data) + tmp->cap.size;
1017 memcpy(cap, &tmp->cap, len);
1018 cap = (struct pci_cap_saved_data *)((u8 *)cap + len);
1019 }
1020 /* Empty cap_save terminates list */
1021
1022 return state;
1023}
1024EXPORT_SYMBOL_GPL(pci_store_saved_state);
1025
1026/**
1027 * pci_load_saved_state - Reload the provided save state into struct pci_dev.
1028 * @dev: PCI device that we're dealing with
1029 * @state: Saved state returned from pci_store_saved_state()
1030 */
1031int pci_load_saved_state(struct pci_dev *dev, struct pci_saved_state *state)
1032{
1033 struct pci_cap_saved_data *cap;
1034
1035 dev->state_saved = false;
1036
1037 if (!state)
1038 return 0;
1039
1040 memcpy(dev->saved_config_space, state->config_space,
1041 sizeof(state->config_space));
1042
1043 cap = state->cap;
1044 while (cap->size) {
1045 struct pci_cap_saved_state *tmp;
1046
1047 tmp = pci_find_saved_cap(dev, cap->cap_nr);
1048 if (!tmp || tmp->cap.size != cap->size)
1049 return -EINVAL;
1050
1051 memcpy(tmp->cap.data, cap->data, tmp->cap.size);
1052 cap = (struct pci_cap_saved_data *)((u8 *)cap +
1053 sizeof(struct pci_cap_saved_data) + cap->size);
1054 }
1055
1056 dev->state_saved = true;
1057 return 0;
1058}
1059EXPORT_SYMBOL_GPL(pci_load_saved_state);
1060
1061/**
1062 * pci_load_and_free_saved_state - Reload the save state pointed to by state,
1063 * and free the memory allocated for it.
1064 * @dev: PCI device that we're dealing with
1065 * @state: Pointer to saved state returned from pci_store_saved_state()
1066 */
1067int pci_load_and_free_saved_state(struct pci_dev *dev,
1068 struct pci_saved_state **state)
1069{
1070 int ret = pci_load_saved_state(dev, *state);
1071 kfree(*state);
1072 *state = NULL;
1073 return ret;
1074}
1075EXPORT_SYMBOL_GPL(pci_load_and_free_saved_state);
1076
38cc1302
HS
1077static int do_pci_enable_device(struct pci_dev *dev, int bars)
1078{
1079 int err;
1080
1081 err = pci_set_power_state(dev, PCI_D0);
1082 if (err < 0 && err != -EIO)
1083 return err;
1084 err = pcibios_enable_device(dev, bars);
1085 if (err < 0)
1086 return err;
1087 pci_fixup_device(pci_fixup_enable, dev);
1088
1089 return 0;
1090}
1091
1092/**
0b62e13b 1093 * pci_reenable_device - Resume abandoned device
38cc1302
HS
1094 * @dev: PCI device to be resumed
1095 *
1096 * Note this function is a backend of pci_default_resume and is not supposed
1097 * to be called by normal code, write proper resume handler and use it instead.
1098 */
0b62e13b 1099int pci_reenable_device(struct pci_dev *dev)
38cc1302 1100{
296ccb08 1101 if (pci_is_enabled(dev))
38cc1302
HS
1102 return do_pci_enable_device(dev, (1 << PCI_NUM_RESOURCES) - 1);
1103 return 0;
1104}
1105
b718989d
BH
1106static int __pci_enable_device_flags(struct pci_dev *dev,
1107 resource_size_t flags)
1da177e4
LT
1108{
1109 int err;
b718989d 1110 int i, bars = 0;
1da177e4 1111
97c145f7
JB
1112 /*
1113 * Power state could be unknown at this point, either due to a fresh
1114 * boot or a device removal call. So get the current power state
1115 * so that things like MSI message writing will behave as expected
1116 * (e.g. if the device really is in D0 at enable time).
1117 */
1118 if (dev->pm_cap) {
1119 u16 pmcsr;
1120 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr);
1121 dev->current_state = (pmcsr & PCI_PM_CTRL_STATE_MASK);
1122 }
1123
9fb625c3
HS
1124 if (atomic_add_return(1, &dev->enable_cnt) > 1)
1125 return 0; /* already enabled */
1126
b718989d
BH
1127 for (i = 0; i < DEVICE_COUNT_RESOURCE; i++)
1128 if (dev->resource[i].flags & flags)
1129 bars |= (1 << i);
1130
38cc1302 1131 err = do_pci_enable_device(dev, bars);
95a62965 1132 if (err < 0)
38cc1302 1133 atomic_dec(&dev->enable_cnt);
9fb625c3 1134 return err;
1da177e4
LT
1135}
1136
b718989d
BH
1137/**
1138 * pci_enable_device_io - Initialize a device for use with IO space
1139 * @dev: PCI device to be initialized
1140 *
1141 * Initialize device before it's used by a driver. Ask low-level code
1142 * to enable I/O resources. Wake up the device if it was suspended.
1143 * Beware, this function can fail.
1144 */
1145int pci_enable_device_io(struct pci_dev *dev)
1146{
1147 return __pci_enable_device_flags(dev, IORESOURCE_IO);
1148}
1149
1150/**
1151 * pci_enable_device_mem - Initialize a device for use with Memory space
1152 * @dev: PCI device to be initialized
1153 *
1154 * Initialize device before it's used by a driver. Ask low-level code
1155 * to enable Memory resources. Wake up the device if it was suspended.
1156 * Beware, this function can fail.
1157 */
1158int pci_enable_device_mem(struct pci_dev *dev)
1159{
1160 return __pci_enable_device_flags(dev, IORESOURCE_MEM);
1161}
1162
bae94d02
IPG
1163/**
1164 * pci_enable_device - Initialize device before it's used by a driver.
1165 * @dev: PCI device to be initialized
1166 *
1167 * Initialize device before it's used by a driver. Ask low-level code
1168 * to enable I/O and memory. Wake up the device if it was suspended.
1169 * Beware, this function can fail.
1170 *
1171 * Note we don't actually enable the device many times if we call
1172 * this function repeatedly (we just increment the count).
1173 */
1174int pci_enable_device(struct pci_dev *dev)
1175{
b718989d 1176 return __pci_enable_device_flags(dev, IORESOURCE_MEM | IORESOURCE_IO);
bae94d02
IPG
1177}
1178
9ac7849e
TH
1179/*
1180 * Managed PCI resources. This manages device on/off, intx/msi/msix
1181 * on/off and BAR regions. pci_dev itself records msi/msix status, so
1182 * there's no need to track it separately. pci_devres is initialized
1183 * when a device is enabled using managed PCI device enable interface.
1184 */
1185struct pci_devres {
7f375f32
TH
1186 unsigned int enabled:1;
1187 unsigned int pinned:1;
9ac7849e
TH
1188 unsigned int orig_intx:1;
1189 unsigned int restore_intx:1;
1190 u32 region_mask;
1191};
1192
1193static void pcim_release(struct device *gendev, void *res)
1194{
1195 struct pci_dev *dev = container_of(gendev, struct pci_dev, dev);
1196 struct pci_devres *this = res;
1197 int i;
1198
1199 if (dev->msi_enabled)
1200 pci_disable_msi(dev);
1201 if (dev->msix_enabled)
1202 pci_disable_msix(dev);
1203
1204 for (i = 0; i < DEVICE_COUNT_RESOURCE; i++)
1205 if (this->region_mask & (1 << i))
1206 pci_release_region(dev, i);
1207
1208 if (this->restore_intx)
1209 pci_intx(dev, this->orig_intx);
1210
7f375f32 1211 if (this->enabled && !this->pinned)
9ac7849e
TH
1212 pci_disable_device(dev);
1213}
1214
1215static struct pci_devres * get_pci_dr(struct pci_dev *pdev)
1216{
1217 struct pci_devres *dr, *new_dr;
1218
1219 dr = devres_find(&pdev->dev, pcim_release, NULL, NULL);
1220 if (dr)
1221 return dr;
1222
1223 new_dr = devres_alloc(pcim_release, sizeof(*new_dr), GFP_KERNEL);
1224 if (!new_dr)
1225 return NULL;
1226 return devres_get(&pdev->dev, new_dr, NULL, NULL);
1227}
1228
1229static struct pci_devres * find_pci_dr(struct pci_dev *pdev)
1230{
1231 if (pci_is_managed(pdev))
1232 return devres_find(&pdev->dev, pcim_release, NULL, NULL);
1233 return NULL;
1234}
1235
1236/**
1237 * pcim_enable_device - Managed pci_enable_device()
1238 * @pdev: PCI device to be initialized
1239 *
1240 * Managed pci_enable_device().
1241 */
1242int pcim_enable_device(struct pci_dev *pdev)
1243{
1244 struct pci_devres *dr;
1245 int rc;
1246
1247 dr = get_pci_dr(pdev);
1248 if (unlikely(!dr))
1249 return -ENOMEM;
b95d58ea
TH
1250 if (dr->enabled)
1251 return 0;
9ac7849e
TH
1252
1253 rc = pci_enable_device(pdev);
1254 if (!rc) {
1255 pdev->is_managed = 1;
7f375f32 1256 dr->enabled = 1;
9ac7849e
TH
1257 }
1258 return rc;
1259}
1260
1261/**
1262 * pcim_pin_device - Pin managed PCI device
1263 * @pdev: PCI device to pin
1264 *
1265 * Pin managed PCI device @pdev. Pinned device won't be disabled on
1266 * driver detach. @pdev must have been enabled with
1267 * pcim_enable_device().
1268 */
1269void pcim_pin_device(struct pci_dev *pdev)
1270{
1271 struct pci_devres *dr;
1272
1273 dr = find_pci_dr(pdev);
7f375f32 1274 WARN_ON(!dr || !dr->enabled);
9ac7849e 1275 if (dr)
7f375f32 1276 dr->pinned = 1;
9ac7849e
TH
1277}
1278
1da177e4
LT
1279/**
1280 * pcibios_disable_device - disable arch specific PCI resources for device dev
1281 * @dev: the PCI device to disable
1282 *
1283 * Disables architecture specific PCI resources for the device. This
1284 * is the default implementation. Architecture implementations can
1285 * override this.
1286 */
1287void __attribute__ ((weak)) pcibios_disable_device (struct pci_dev *dev) {}
1288
fa58d305
RW
1289static void do_pci_disable_device(struct pci_dev *dev)
1290{
1291 u16 pci_command;
1292
1293 pci_read_config_word(dev, PCI_COMMAND, &pci_command);
1294 if (pci_command & PCI_COMMAND_MASTER) {
1295 pci_command &= ~PCI_COMMAND_MASTER;
1296 pci_write_config_word(dev, PCI_COMMAND, pci_command);
1297 }
1298
1299 pcibios_disable_device(dev);
1300}
1301
1302/**
1303 * pci_disable_enabled_device - Disable device without updating enable_cnt
1304 * @dev: PCI device to disable
1305 *
1306 * NOTE: This function is a backend of PCI power management routines and is
1307 * not supposed to be called drivers.
1308 */
1309void pci_disable_enabled_device(struct pci_dev *dev)
1310{
296ccb08 1311 if (pci_is_enabled(dev))
fa58d305
RW
1312 do_pci_disable_device(dev);
1313}
1314
1da177e4
LT
1315/**
1316 * pci_disable_device - Disable PCI device after use
1317 * @dev: PCI device to be disabled
1318 *
1319 * Signal to the system that the PCI device is not in use by the system
1320 * anymore. This only involves disabling PCI bus-mastering, if active.
bae94d02
IPG
1321 *
1322 * Note we don't actually disable the device until all callers of
ee6583f6 1323 * pci_enable_device() have called pci_disable_device().
1da177e4
LT
1324 */
1325void
1326pci_disable_device(struct pci_dev *dev)
1327{
9ac7849e 1328 struct pci_devres *dr;
99dc804d 1329
9ac7849e
TH
1330 dr = find_pci_dr(dev);
1331 if (dr)
7f375f32 1332 dr->enabled = 0;
9ac7849e 1333
bae94d02
IPG
1334 if (atomic_sub_return(1, &dev->enable_cnt) != 0)
1335 return;
1336
fa58d305 1337 do_pci_disable_device(dev);
1da177e4 1338
fa58d305 1339 dev->is_busmaster = 0;
1da177e4
LT
1340}
1341
f7bdd12d
BK
1342/**
1343 * pcibios_set_pcie_reset_state - set reset state for device dev
45e829ea 1344 * @dev: the PCIe device reset
f7bdd12d
BK
1345 * @state: Reset state to enter into
1346 *
1347 *
45e829ea 1348 * Sets the PCIe reset state for the device. This is the default
f7bdd12d
BK
1349 * implementation. Architecture implementations can override this.
1350 */
1351int __attribute__ ((weak)) pcibios_set_pcie_reset_state(struct pci_dev *dev,
1352 enum pcie_reset_state state)
1353{
1354 return -EINVAL;
1355}
1356
1357/**
1358 * pci_set_pcie_reset_state - set reset state for device dev
45e829ea 1359 * @dev: the PCIe device reset
f7bdd12d
BK
1360 * @state: Reset state to enter into
1361 *
1362 *
1363 * Sets the PCI reset state for the device.
1364 */
1365int pci_set_pcie_reset_state(struct pci_dev *dev, enum pcie_reset_state state)
1366{
1367 return pcibios_set_pcie_reset_state(dev, state);
1368}
1369
58ff4633
RW
1370/**
1371 * pci_check_pme_status - Check if given device has generated PME.
1372 * @dev: Device to check.
1373 *
1374 * Check the PME status of the device and if set, clear it and clear PME enable
1375 * (if set). Return 'true' if PME status and PME enable were both set or
1376 * 'false' otherwise.
1377 */
1378bool pci_check_pme_status(struct pci_dev *dev)
1379{
1380 int pmcsr_pos;
1381 u16 pmcsr;
1382 bool ret = false;
1383
1384 if (!dev->pm_cap)
1385 return false;
1386
1387 pmcsr_pos = dev->pm_cap + PCI_PM_CTRL;
1388 pci_read_config_word(dev, pmcsr_pos, &pmcsr);
1389 if (!(pmcsr & PCI_PM_CTRL_PME_STATUS))
1390 return false;
1391
1392 /* Clear PME status. */
1393 pmcsr |= PCI_PM_CTRL_PME_STATUS;
1394 if (pmcsr & PCI_PM_CTRL_PME_ENABLE) {
1395 /* Disable PME to avoid interrupt flood. */
1396 pmcsr &= ~PCI_PM_CTRL_PME_ENABLE;
1397 ret = true;
1398 }
1399
1400 pci_write_config_word(dev, pmcsr_pos, pmcsr);
1401
1402 return ret;
1403}
1404
b67ea761
RW
1405/**
1406 * pci_pme_wakeup - Wake up a PCI device if its PME Status bit is set.
1407 * @dev: Device to handle.
1408 * @ign: Ignored.
1409 *
1410 * Check if @dev has generated PME and queue a resume request for it in that
1411 * case.
1412 */
1413static int pci_pme_wakeup(struct pci_dev *dev, void *ign)
1414{
c125e96f 1415 if (pci_check_pme_status(dev)) {
c125e96f 1416 pci_wakeup_event(dev);
0f953bf6 1417 pm_request_resume(&dev->dev);
c125e96f 1418 }
b67ea761
RW
1419 return 0;
1420}
1421
1422/**
1423 * pci_pme_wakeup_bus - Walk given bus and wake up devices on it, if necessary.
1424 * @bus: Top bus of the subtree to walk.
1425 */
1426void pci_pme_wakeup_bus(struct pci_bus *bus)
1427{
1428 if (bus)
1429 pci_walk_bus(bus, pci_pme_wakeup, NULL);
1430}
1431
eb9d0fe4
RW
1432/**
1433 * pci_pme_capable - check the capability of PCI device to generate PME#
1434 * @dev: PCI device to handle.
eb9d0fe4
RW
1435 * @state: PCI state from which device will issue PME#.
1436 */
e5899e1b 1437bool pci_pme_capable(struct pci_dev *dev, pci_power_t state)
eb9d0fe4 1438{
337001b6 1439 if (!dev->pm_cap)
eb9d0fe4
RW
1440 return false;
1441
337001b6 1442 return !!(dev->pme_support & (1 << state));
eb9d0fe4
RW
1443}
1444
df17e62e
MG
1445static void pci_pme_list_scan(struct work_struct *work)
1446{
1447 struct pci_pme_device *pme_dev;
1448
1449 mutex_lock(&pci_pme_list_mutex);
1450 if (!list_empty(&pci_pme_list)) {
1451 list_for_each_entry(pme_dev, &pci_pme_list, list)
1452 pci_pme_wakeup(pme_dev->dev, NULL);
1453 schedule_delayed_work(&pci_pme_work, msecs_to_jiffies(PME_TIMEOUT));
1454 }
1455 mutex_unlock(&pci_pme_list_mutex);
1456}
1457
1458/**
1459 * pci_external_pme - is a device an external PCI PME source?
1460 * @dev: PCI device to check
1461 *
1462 */
1463
1464static bool pci_external_pme(struct pci_dev *dev)
1465{
1466 if (pci_is_pcie(dev) || dev->bus->number == 0)
1467 return false;
1468 return true;
1469}
1470
eb9d0fe4
RW
1471/**
1472 * pci_pme_active - enable or disable PCI device's PME# function
1473 * @dev: PCI device to handle.
eb9d0fe4
RW
1474 * @enable: 'true' to enable PME# generation; 'false' to disable it.
1475 *
1476 * The caller must verify that the device is capable of generating PME# before
1477 * calling this function with @enable equal to 'true'.
1478 */
5a6c9b60 1479void pci_pme_active(struct pci_dev *dev, bool enable)
eb9d0fe4
RW
1480{
1481 u16 pmcsr;
1482
337001b6 1483 if (!dev->pm_cap)
eb9d0fe4
RW
1484 return;
1485
337001b6 1486 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr);
eb9d0fe4
RW
1487 /* Clear PME_Status by writing 1 to it and enable PME# */
1488 pmcsr |= PCI_PM_CTRL_PME_STATUS | PCI_PM_CTRL_PME_ENABLE;
1489 if (!enable)
1490 pmcsr &= ~PCI_PM_CTRL_PME_ENABLE;
1491
337001b6 1492 pci_write_config_word(dev, dev->pm_cap + PCI_PM_CTRL, pmcsr);
eb9d0fe4 1493
df17e62e
MG
1494 /* PCI (as opposed to PCIe) PME requires that the device have
1495 its PME# line hooked up correctly. Not all hardware vendors
1496 do this, so the PME never gets delivered and the device
1497 remains asleep. The easiest way around this is to
1498 periodically walk the list of suspended devices and check
1499 whether any have their PME flag set. The assumption is that
1500 we'll wake up often enough anyway that this won't be a huge
1501 hit, and the power savings from the devices will still be a
1502 win. */
1503
1504 if (pci_external_pme(dev)) {
1505 struct pci_pme_device *pme_dev;
1506 if (enable) {
1507 pme_dev = kmalloc(sizeof(struct pci_pme_device),
1508 GFP_KERNEL);
1509 if (!pme_dev)
1510 goto out;
1511 pme_dev->dev = dev;
1512 mutex_lock(&pci_pme_list_mutex);
1513 list_add(&pme_dev->list, &pci_pme_list);
1514 if (list_is_singular(&pci_pme_list))
1515 schedule_delayed_work(&pci_pme_work,
1516 msecs_to_jiffies(PME_TIMEOUT));
1517 mutex_unlock(&pci_pme_list_mutex);
1518 } else {
1519 mutex_lock(&pci_pme_list_mutex);
1520 list_for_each_entry(pme_dev, &pci_pme_list, list) {
1521 if (pme_dev->dev == dev) {
1522 list_del(&pme_dev->list);
1523 kfree(pme_dev);
1524 break;
1525 }
1526 }
1527 mutex_unlock(&pci_pme_list_mutex);
1528 }
1529 }
1530
1531out:
10c3d71d 1532 dev_printk(KERN_DEBUG, &dev->dev, "PME# %s\n",
eb9d0fe4
RW
1533 enable ? "enabled" : "disabled");
1534}
1535
1da177e4 1536/**
6cbf8214 1537 * __pci_enable_wake - enable PCI device as wakeup event source
075c1771
DB
1538 * @dev: PCI device affected
1539 * @state: PCI state from which device will issue wakeup events
6cbf8214 1540 * @runtime: True if the events are to be generated at run time
075c1771
DB
1541 * @enable: True to enable event generation; false to disable
1542 *
1543 * This enables the device as a wakeup event source, or disables it.
1544 * When such events involves platform-specific hooks, those hooks are
1545 * called automatically by this routine.
1546 *
1547 * Devices with legacy power management (no standard PCI PM capabilities)
eb9d0fe4 1548 * always require such platform hooks.
075c1771 1549 *
eb9d0fe4
RW
1550 * RETURN VALUE:
1551 * 0 is returned on success
1552 * -EINVAL is returned if device is not supposed to wake up the system
1553 * Error code depending on the platform is returned if both the platform and
1554 * the native mechanism fail to enable the generation of wake-up events
1da177e4 1555 */
6cbf8214
RW
1556int __pci_enable_wake(struct pci_dev *dev, pci_power_t state,
1557 bool runtime, bool enable)
1da177e4 1558{
5bcc2fb4 1559 int ret = 0;
075c1771 1560
6cbf8214 1561 if (enable && !runtime && !device_may_wakeup(&dev->dev))
eb9d0fe4 1562 return -EINVAL;
1da177e4 1563
e80bb09d
RW
1564 /* Don't do the same thing twice in a row for one device. */
1565 if (!!enable == !!dev->wakeup_prepared)
1566 return 0;
1567
eb9d0fe4
RW
1568 /*
1569 * According to "PCI System Architecture" 4th ed. by Tom Shanley & Don
1570 * Anderson we should be doing PME# wake enable followed by ACPI wake
1571 * enable. To disable wake-up we call the platform first, for symmetry.
075c1771 1572 */
1da177e4 1573
5bcc2fb4
RW
1574 if (enable) {
1575 int error;
1da177e4 1576
5bcc2fb4
RW
1577 if (pci_pme_capable(dev, state))
1578 pci_pme_active(dev, true);
1579 else
1580 ret = 1;
6cbf8214
RW
1581 error = runtime ? platform_pci_run_wake(dev, true) :
1582 platform_pci_sleep_wake(dev, true);
5bcc2fb4
RW
1583 if (ret)
1584 ret = error;
e80bb09d
RW
1585 if (!ret)
1586 dev->wakeup_prepared = true;
5bcc2fb4 1587 } else {
6cbf8214
RW
1588 if (runtime)
1589 platform_pci_run_wake(dev, false);
1590 else
1591 platform_pci_sleep_wake(dev, false);
5bcc2fb4 1592 pci_pme_active(dev, false);
e80bb09d 1593 dev->wakeup_prepared = false;
5bcc2fb4 1594 }
1da177e4 1595
5bcc2fb4 1596 return ret;
eb9d0fe4 1597}
6cbf8214 1598EXPORT_SYMBOL(__pci_enable_wake);
1da177e4 1599
0235c4fc
RW
1600/**
1601 * pci_wake_from_d3 - enable/disable device to wake up from D3_hot or D3_cold
1602 * @dev: PCI device to prepare
1603 * @enable: True to enable wake-up event generation; false to disable
1604 *
1605 * Many drivers want the device to wake up the system from D3_hot or D3_cold
1606 * and this function allows them to set that up cleanly - pci_enable_wake()
1607 * should not be called twice in a row to enable wake-up due to PCI PM vs ACPI
1608 * ordering constraints.
1609 *
1610 * This function only returns error code if the device is not capable of
1611 * generating PME# from both D3_hot and D3_cold, and the platform is unable to
1612 * enable wake-up power for it.
1613 */
1614int pci_wake_from_d3(struct pci_dev *dev, bool enable)
1615{
1616 return pci_pme_capable(dev, PCI_D3cold) ?
1617 pci_enable_wake(dev, PCI_D3cold, enable) :
1618 pci_enable_wake(dev, PCI_D3hot, enable);
1619}
1620
404cc2d8 1621/**
37139074
JB
1622 * pci_target_state - find an appropriate low power state for a given PCI dev
1623 * @dev: PCI device
1624 *
1625 * Use underlying platform code to find a supported low power state for @dev.
1626 * If the platform can't manage @dev, return the deepest state from which it
1627 * can generate wake events, based on any available PME info.
404cc2d8 1628 */
e5899e1b 1629pci_power_t pci_target_state(struct pci_dev *dev)
404cc2d8
RW
1630{
1631 pci_power_t target_state = PCI_D3hot;
404cc2d8
RW
1632
1633 if (platform_pci_power_manageable(dev)) {
1634 /*
1635 * Call the platform to choose the target state of the device
1636 * and enable wake-up from this state if supported.
1637 */
1638 pci_power_t state = platform_pci_choose_state(dev);
1639
1640 switch (state) {
1641 case PCI_POWER_ERROR:
1642 case PCI_UNKNOWN:
1643 break;
1644 case PCI_D1:
1645 case PCI_D2:
1646 if (pci_no_d1d2(dev))
1647 break;
1648 default:
1649 target_state = state;
404cc2d8 1650 }
d2abdf62
RW
1651 } else if (!dev->pm_cap) {
1652 target_state = PCI_D0;
404cc2d8
RW
1653 } else if (device_may_wakeup(&dev->dev)) {
1654 /*
1655 * Find the deepest state from which the device can generate
1656 * wake-up events, make it the target state and enable device
1657 * to generate PME#.
1658 */
337001b6
RW
1659 if (dev->pme_support) {
1660 while (target_state
1661 && !(dev->pme_support & (1 << target_state)))
1662 target_state--;
404cc2d8
RW
1663 }
1664 }
1665
e5899e1b
RW
1666 return target_state;
1667}
1668
1669/**
1670 * pci_prepare_to_sleep - prepare PCI device for system-wide transition into a sleep state
1671 * @dev: Device to handle.
1672 *
1673 * Choose the power state appropriate for the device depending on whether
1674 * it can wake up the system and/or is power manageable by the platform
1675 * (PCI_D3hot is the default) and put the device into that state.
1676 */
1677int pci_prepare_to_sleep(struct pci_dev *dev)
1678{
1679 pci_power_t target_state = pci_target_state(dev);
1680 int error;
1681
1682 if (target_state == PCI_POWER_ERROR)
1683 return -EIO;
1684
8efb8c76 1685 pci_enable_wake(dev, target_state, device_may_wakeup(&dev->dev));
c157dfa3 1686
404cc2d8
RW
1687 error = pci_set_power_state(dev, target_state);
1688
1689 if (error)
1690 pci_enable_wake(dev, target_state, false);
1691
1692 return error;
1693}
1694
1695/**
443bd1c4 1696 * pci_back_from_sleep - turn PCI device on during system-wide transition into working state
404cc2d8
RW
1697 * @dev: Device to handle.
1698 *
88393161 1699 * Disable device's system wake-up capability and put it into D0.
404cc2d8
RW
1700 */
1701int pci_back_from_sleep(struct pci_dev *dev)
1702{
1703 pci_enable_wake(dev, PCI_D0, false);
1704 return pci_set_power_state(dev, PCI_D0);
1705}
1706
6cbf8214
RW
1707/**
1708 * pci_finish_runtime_suspend - Carry out PCI-specific part of runtime suspend.
1709 * @dev: PCI device being suspended.
1710 *
1711 * Prepare @dev to generate wake-up events at run time and put it into a low
1712 * power state.
1713 */
1714int pci_finish_runtime_suspend(struct pci_dev *dev)
1715{
1716 pci_power_t target_state = pci_target_state(dev);
1717 int error;
1718
1719 if (target_state == PCI_POWER_ERROR)
1720 return -EIO;
1721
1722 __pci_enable_wake(dev, target_state, true, pci_dev_run_wake(dev));
1723
1724 error = pci_set_power_state(dev, target_state);
1725
1726 if (error)
1727 __pci_enable_wake(dev, target_state, true, false);
1728
1729 return error;
1730}
1731
b67ea761
RW
1732/**
1733 * pci_dev_run_wake - Check if device can generate run-time wake-up events.
1734 * @dev: Device to check.
1735 *
1736 * Return true if the device itself is cabable of generating wake-up events
1737 * (through the platform or using the native PCIe PME) or if the device supports
1738 * PME and one of its upstream bridges can generate wake-up events.
1739 */
1740bool pci_dev_run_wake(struct pci_dev *dev)
1741{
1742 struct pci_bus *bus = dev->bus;
1743
1744 if (device_run_wake(&dev->dev))
1745 return true;
1746
1747 if (!dev->pme_support)
1748 return false;
1749
1750 while (bus->parent) {
1751 struct pci_dev *bridge = bus->self;
1752
1753 if (device_run_wake(&bridge->dev))
1754 return true;
1755
1756 bus = bus->parent;
1757 }
1758
1759 /* We have reached the root bus. */
1760 if (bus->bridge)
1761 return device_run_wake(bus->bridge);
1762
1763 return false;
1764}
1765EXPORT_SYMBOL_GPL(pci_dev_run_wake);
1766
eb9d0fe4
RW
1767/**
1768 * pci_pm_init - Initialize PM functions of given PCI device
1769 * @dev: PCI device to handle.
1770 */
1771void pci_pm_init(struct pci_dev *dev)
1772{
1773 int pm;
1774 u16 pmc;
1da177e4 1775
bb910a70 1776 pm_runtime_forbid(&dev->dev);
a1e4d72c 1777 device_enable_async_suspend(&dev->dev);
e80bb09d 1778 dev->wakeup_prepared = false;
bb910a70 1779
337001b6
RW
1780 dev->pm_cap = 0;
1781
eb9d0fe4
RW
1782 /* find PCI PM capability in list */
1783 pm = pci_find_capability(dev, PCI_CAP_ID_PM);
1784 if (!pm)
50246dd4 1785 return;
eb9d0fe4
RW
1786 /* Check device's ability to generate PME# */
1787 pci_read_config_word(dev, pm + PCI_PM_PMC, &pmc);
075c1771 1788
eb9d0fe4
RW
1789 if ((pmc & PCI_PM_CAP_VER_MASK) > 3) {
1790 dev_err(&dev->dev, "unsupported PM cap regs version (%u)\n",
1791 pmc & PCI_PM_CAP_VER_MASK);
50246dd4 1792 return;
eb9d0fe4
RW
1793 }
1794
337001b6 1795 dev->pm_cap = pm;
1ae861e6 1796 dev->d3_delay = PCI_PM_D3_WAIT;
337001b6
RW
1797
1798 dev->d1_support = false;
1799 dev->d2_support = false;
1800 if (!pci_no_d1d2(dev)) {
c9ed77ee 1801 if (pmc & PCI_PM_CAP_D1)
337001b6 1802 dev->d1_support = true;
c9ed77ee 1803 if (pmc & PCI_PM_CAP_D2)
337001b6 1804 dev->d2_support = true;
c9ed77ee
BH
1805
1806 if (dev->d1_support || dev->d2_support)
1807 dev_printk(KERN_DEBUG, &dev->dev, "supports%s%s\n",
ec84f126
JB
1808 dev->d1_support ? " D1" : "",
1809 dev->d2_support ? " D2" : "");
337001b6
RW
1810 }
1811
1812 pmc &= PCI_PM_CAP_PME_MASK;
1813 if (pmc) {
10c3d71d
BH
1814 dev_printk(KERN_DEBUG, &dev->dev,
1815 "PME# supported from%s%s%s%s%s\n",
c9ed77ee
BH
1816 (pmc & PCI_PM_CAP_PME_D0) ? " D0" : "",
1817 (pmc & PCI_PM_CAP_PME_D1) ? " D1" : "",
1818 (pmc & PCI_PM_CAP_PME_D2) ? " D2" : "",
1819 (pmc & PCI_PM_CAP_PME_D3) ? " D3hot" : "",
1820 (pmc & PCI_PM_CAP_PME_D3cold) ? " D3cold" : "");
337001b6 1821 dev->pme_support = pmc >> PCI_PM_CAP_PME_SHIFT;
eb9d0fe4
RW
1822 /*
1823 * Make device's PM flags reflect the wake-up capability, but
1824 * let the user space enable it to wake up the system as needed.
1825 */
1826 device_set_wakeup_capable(&dev->dev, true);
eb9d0fe4 1827 /* Disable the PME# generation functionality */
337001b6
RW
1828 pci_pme_active(dev, false);
1829 } else {
1830 dev->pme_support = 0;
eb9d0fe4 1831 }
1da177e4
LT
1832}
1833
eb9c39d0
JB
1834/**
1835 * platform_pci_wakeup_init - init platform wakeup if present
1836 * @dev: PCI device
1837 *
1838 * Some devices don't have PCI PM caps but can still generate wakeup
1839 * events through platform methods (like ACPI events). If @dev supports
1840 * platform wakeup events, set the device flag to indicate as much. This
1841 * may be redundant if the device also supports PCI PM caps, but double
1842 * initialization should be safe in that case.
1843 */
1844void platform_pci_wakeup_init(struct pci_dev *dev)
1845{
1846 if (!platform_pci_can_wakeup(dev))
1847 return;
1848
1849 device_set_wakeup_capable(&dev->dev, true);
eb9c39d0
JB
1850 platform_pci_sleep_wake(dev, false);
1851}
1852
63f4898a
RW
1853/**
1854 * pci_add_save_buffer - allocate buffer for saving given capability registers
1855 * @dev: the PCI device
1856 * @cap: the capability to allocate the buffer for
1857 * @size: requested size of the buffer
1858 */
1859static int pci_add_cap_save_buffer(
1860 struct pci_dev *dev, char cap, unsigned int size)
1861{
1862 int pos;
1863 struct pci_cap_saved_state *save_state;
1864
1865 pos = pci_find_capability(dev, cap);
1866 if (pos <= 0)
1867 return 0;
1868
1869 save_state = kzalloc(sizeof(*save_state) + size, GFP_KERNEL);
1870 if (!save_state)
1871 return -ENOMEM;
1872
24a4742f
AW
1873 save_state->cap.cap_nr = cap;
1874 save_state->cap.size = size;
63f4898a
RW
1875 pci_add_saved_cap(dev, save_state);
1876
1877 return 0;
1878}
1879
1880/**
1881 * pci_allocate_cap_save_buffers - allocate buffers for saving capabilities
1882 * @dev: the PCI device
1883 */
1884void pci_allocate_cap_save_buffers(struct pci_dev *dev)
1885{
1886 int error;
1887
89858517
YZ
1888 error = pci_add_cap_save_buffer(dev, PCI_CAP_ID_EXP,
1889 PCI_EXP_SAVE_REGS * sizeof(u16));
63f4898a
RW
1890 if (error)
1891 dev_err(&dev->dev,
1892 "unable to preallocate PCI Express save buffer\n");
1893
1894 error = pci_add_cap_save_buffer(dev, PCI_CAP_ID_PCIX, sizeof(u16));
1895 if (error)
1896 dev_err(&dev->dev,
1897 "unable to preallocate PCI-X save buffer\n");
1898}
1899
58c3a727
YZ
1900/**
1901 * pci_enable_ari - enable ARI forwarding if hardware support it
1902 * @dev: the PCI device
1903 */
1904void pci_enable_ari(struct pci_dev *dev)
1905{
1906 int pos;
1907 u32 cap;
864d296c 1908 u16 flags, ctrl;
8113587c 1909 struct pci_dev *bridge;
58c3a727 1910
5f4d91a1 1911 if (!pci_is_pcie(dev) || dev->devfn)
58c3a727
YZ
1912 return;
1913
8113587c
ZY
1914 pos = pci_find_ext_capability(dev, PCI_EXT_CAP_ID_ARI);
1915 if (!pos)
58c3a727
YZ
1916 return;
1917
8113587c 1918 bridge = dev->bus->self;
5f4d91a1 1919 if (!bridge || !pci_is_pcie(bridge))
8113587c
ZY
1920 return;
1921
06a1cbaf 1922 pos = pci_pcie_cap(bridge);
58c3a727
YZ
1923 if (!pos)
1924 return;
1925
864d296c
CW
1926 /* ARI is a PCIe v2 feature */
1927 pci_read_config_word(bridge, pos + PCI_EXP_FLAGS, &flags);
1928 if ((flags & PCI_EXP_FLAGS_VERS) < 2)
1929 return;
1930
8113587c 1931 pci_read_config_dword(bridge, pos + PCI_EXP_DEVCAP2, &cap);
58c3a727
YZ
1932 if (!(cap & PCI_EXP_DEVCAP2_ARI))
1933 return;
1934
8113587c 1935 pci_read_config_word(bridge, pos + PCI_EXP_DEVCTL2, &ctrl);
58c3a727 1936 ctrl |= PCI_EXP_DEVCTL2_ARI;
8113587c 1937 pci_write_config_word(bridge, pos + PCI_EXP_DEVCTL2, ctrl);
58c3a727 1938
8113587c 1939 bridge->ari_enabled = 1;
58c3a727
YZ
1940}
1941
b48d4425
JB
1942/**
1943 * pci_enable_ido - enable ID-based ordering on a device
1944 * @dev: the PCI device
1945 * @type: which types of IDO to enable
1946 *
1947 * Enable ID-based ordering on @dev. @type can contain the bits
1948 * %PCI_EXP_IDO_REQUEST and/or %PCI_EXP_IDO_COMPLETION to indicate
1949 * which types of transactions are allowed to be re-ordered.
1950 */
1951void pci_enable_ido(struct pci_dev *dev, unsigned long type)
1952{
1953 int pos;
1954 u16 ctrl;
1955
1956 pos = pci_pcie_cap(dev);
1957 if (!pos)
1958 return;
1959
1960 pci_read_config_word(dev, pos + PCI_EXP_DEVCTL2, &ctrl);
1961 if (type & PCI_EXP_IDO_REQUEST)
1962 ctrl |= PCI_EXP_IDO_REQ_EN;
1963 if (type & PCI_EXP_IDO_COMPLETION)
1964 ctrl |= PCI_EXP_IDO_CMP_EN;
1965 pci_write_config_word(dev, pos + PCI_EXP_DEVCTL2, ctrl);
1966}
1967EXPORT_SYMBOL(pci_enable_ido);
1968
1969/**
1970 * pci_disable_ido - disable ID-based ordering on a device
1971 * @dev: the PCI device
1972 * @type: which types of IDO to disable
1973 */
1974void pci_disable_ido(struct pci_dev *dev, unsigned long type)
1975{
1976 int pos;
1977 u16 ctrl;
1978
1979 if (!pci_is_pcie(dev))
1980 return;
1981
1982 pos = pci_pcie_cap(dev);
1983 if (!pos)
1984 return;
1985
1986 pci_read_config_word(dev, pos + PCI_EXP_DEVCTL2, &ctrl);
1987 if (type & PCI_EXP_IDO_REQUEST)
1988 ctrl &= ~PCI_EXP_IDO_REQ_EN;
1989 if (type & PCI_EXP_IDO_COMPLETION)
1990 ctrl &= ~PCI_EXP_IDO_CMP_EN;
1991 pci_write_config_word(dev, pos + PCI_EXP_DEVCTL2, ctrl);
1992}
1993EXPORT_SYMBOL(pci_disable_ido);
1994
48a92a81
JB
1995/**
1996 * pci_enable_obff - enable optimized buffer flush/fill
1997 * @dev: PCI device
1998 * @type: type of signaling to use
1999 *
2000 * Try to enable @type OBFF signaling on @dev. It will try using WAKE#
2001 * signaling if possible, falling back to message signaling only if
2002 * WAKE# isn't supported. @type should indicate whether the PCIe link
2003 * be brought out of L0s or L1 to send the message. It should be either
2004 * %PCI_EXP_OBFF_SIGNAL_ALWAYS or %PCI_OBFF_SIGNAL_L0.
2005 *
2006 * If your device can benefit from receiving all messages, even at the
2007 * power cost of bringing the link back up from a low power state, use
2008 * %PCI_EXP_OBFF_SIGNAL_ALWAYS. Otherwise, use %PCI_OBFF_SIGNAL_L0 (the
2009 * preferred type).
2010 *
2011 * RETURNS:
2012 * Zero on success, appropriate error number on failure.
2013 */
2014int pci_enable_obff(struct pci_dev *dev, enum pci_obff_signal_type type)
2015{
2016 int pos;
2017 u32 cap;
2018 u16 ctrl;
2019 int ret;
2020
2021 if (!pci_is_pcie(dev))
2022 return -ENOTSUPP;
2023
2024 pos = pci_pcie_cap(dev);
2025 if (!pos)
2026 return -ENOTSUPP;
2027
2028 pci_read_config_dword(dev, pos + PCI_EXP_DEVCAP2, &cap);
2029 if (!(cap & PCI_EXP_OBFF_MASK))
2030 return -ENOTSUPP; /* no OBFF support at all */
2031
2032 /* Make sure the topology supports OBFF as well */
2033 if (dev->bus) {
2034 ret = pci_enable_obff(dev->bus->self, type);
2035 if (ret)
2036 return ret;
2037 }
2038
2039 pci_read_config_word(dev, pos + PCI_EXP_DEVCTL2, &ctrl);
2040 if (cap & PCI_EXP_OBFF_WAKE)
2041 ctrl |= PCI_EXP_OBFF_WAKE_EN;
2042 else {
2043 switch (type) {
2044 case PCI_EXP_OBFF_SIGNAL_L0:
2045 if (!(ctrl & PCI_EXP_OBFF_WAKE_EN))
2046 ctrl |= PCI_EXP_OBFF_MSGA_EN;
2047 break;
2048 case PCI_EXP_OBFF_SIGNAL_ALWAYS:
2049 ctrl &= ~PCI_EXP_OBFF_WAKE_EN;
2050 ctrl |= PCI_EXP_OBFF_MSGB_EN;
2051 break;
2052 default:
2053 WARN(1, "bad OBFF signal type\n");
2054 return -ENOTSUPP;
2055 }
2056 }
2057 pci_write_config_word(dev, pos + PCI_EXP_DEVCTL2, ctrl);
2058
2059 return 0;
2060}
2061EXPORT_SYMBOL(pci_enable_obff);
2062
2063/**
2064 * pci_disable_obff - disable optimized buffer flush/fill
2065 * @dev: PCI device
2066 *
2067 * Disable OBFF on @dev.
2068 */
2069void pci_disable_obff(struct pci_dev *dev)
2070{
2071 int pos;
2072 u16 ctrl;
2073
2074 if (!pci_is_pcie(dev))
2075 return;
2076
2077 pos = pci_pcie_cap(dev);
2078 if (!pos)
2079 return;
2080
2081 pci_read_config_word(dev, pos + PCI_EXP_DEVCTL2, &ctrl);
2082 ctrl &= ~PCI_EXP_OBFF_WAKE_EN;
2083 pci_write_config_word(dev, pos + PCI_EXP_DEVCTL2, ctrl);
2084}
2085EXPORT_SYMBOL(pci_disable_obff);
2086
51c2e0a7
JB
2087/**
2088 * pci_ltr_supported - check whether a device supports LTR
2089 * @dev: PCI device
2090 *
2091 * RETURNS:
2092 * True if @dev supports latency tolerance reporting, false otherwise.
2093 */
2094bool pci_ltr_supported(struct pci_dev *dev)
2095{
2096 int pos;
2097 u32 cap;
2098
2099 if (!pci_is_pcie(dev))
2100 return false;
2101
2102 pos = pci_pcie_cap(dev);
2103 if (!pos)
2104 return false;
2105
2106 pci_read_config_dword(dev, pos + PCI_EXP_DEVCAP2, &cap);
2107
2108 return cap & PCI_EXP_DEVCAP2_LTR;
2109}
2110EXPORT_SYMBOL(pci_ltr_supported);
2111
2112/**
2113 * pci_enable_ltr - enable latency tolerance reporting
2114 * @dev: PCI device
2115 *
2116 * Enable LTR on @dev if possible, which means enabling it first on
2117 * upstream ports.
2118 *
2119 * RETURNS:
2120 * Zero on success, errno on failure.
2121 */
2122int pci_enable_ltr(struct pci_dev *dev)
2123{
2124 int pos;
2125 u16 ctrl;
2126 int ret;
2127
2128 if (!pci_ltr_supported(dev))
2129 return -ENOTSUPP;
2130
2131 pos = pci_pcie_cap(dev);
2132 if (!pos)
2133 return -ENOTSUPP;
2134
2135 /* Only primary function can enable/disable LTR */
2136 if (PCI_FUNC(dev->devfn) != 0)
2137 return -EINVAL;
2138
2139 /* Enable upstream ports first */
2140 if (dev->bus) {
2141 ret = pci_enable_ltr(dev->bus->self);
2142 if (ret)
2143 return ret;
2144 }
2145
2146 pci_read_config_word(dev, pos + PCI_EXP_DEVCTL2, &ctrl);
2147 ctrl |= PCI_EXP_LTR_EN;
2148 pci_write_config_word(dev, pos + PCI_EXP_DEVCTL2, ctrl);
2149
2150 return 0;
2151}
2152EXPORT_SYMBOL(pci_enable_ltr);
2153
2154/**
2155 * pci_disable_ltr - disable latency tolerance reporting
2156 * @dev: PCI device
2157 */
2158void pci_disable_ltr(struct pci_dev *dev)
2159{
2160 int pos;
2161 u16 ctrl;
2162
2163 if (!pci_ltr_supported(dev))
2164 return;
2165
2166 pos = pci_pcie_cap(dev);
2167 if (!pos)
2168 return;
2169
2170 /* Only primary function can enable/disable LTR */
2171 if (PCI_FUNC(dev->devfn) != 0)
2172 return;
2173
2174 pci_read_config_word(dev, pos + PCI_EXP_DEVCTL2, &ctrl);
2175 ctrl &= ~PCI_EXP_LTR_EN;
2176 pci_write_config_word(dev, pos + PCI_EXP_DEVCTL2, ctrl);
2177}
2178EXPORT_SYMBOL(pci_disable_ltr);
2179
2180static int __pci_ltr_scale(int *val)
2181{
2182 int scale = 0;
2183
2184 while (*val > 1023) {
2185 *val = (*val + 31) / 32;
2186 scale++;
2187 }
2188 return scale;
2189}
2190
2191/**
2192 * pci_set_ltr - set LTR latency values
2193 * @dev: PCI device
2194 * @snoop_lat_ns: snoop latency in nanoseconds
2195 * @nosnoop_lat_ns: nosnoop latency in nanoseconds
2196 *
2197 * Figure out the scale and set the LTR values accordingly.
2198 */
2199int pci_set_ltr(struct pci_dev *dev, int snoop_lat_ns, int nosnoop_lat_ns)
2200{
2201 int pos, ret, snoop_scale, nosnoop_scale;
2202 u16 val;
2203
2204 if (!pci_ltr_supported(dev))
2205 return -ENOTSUPP;
2206
2207 snoop_scale = __pci_ltr_scale(&snoop_lat_ns);
2208 nosnoop_scale = __pci_ltr_scale(&nosnoop_lat_ns);
2209
2210 if (snoop_lat_ns > PCI_LTR_VALUE_MASK ||
2211 nosnoop_lat_ns > PCI_LTR_VALUE_MASK)
2212 return -EINVAL;
2213
2214 if ((snoop_scale > (PCI_LTR_SCALE_MASK >> PCI_LTR_SCALE_SHIFT)) ||
2215 (nosnoop_scale > (PCI_LTR_SCALE_MASK >> PCI_LTR_SCALE_SHIFT)))
2216 return -EINVAL;
2217
2218 pos = pci_find_ext_capability(dev, PCI_EXT_CAP_ID_LTR);
2219 if (!pos)
2220 return -ENOTSUPP;
2221
2222 val = (snoop_scale << PCI_LTR_SCALE_SHIFT) | snoop_lat_ns;
2223 ret = pci_write_config_word(dev, pos + PCI_LTR_MAX_SNOOP_LAT, val);
2224 if (ret != 4)
2225 return -EIO;
2226
2227 val = (nosnoop_scale << PCI_LTR_SCALE_SHIFT) | nosnoop_lat_ns;
2228 ret = pci_write_config_word(dev, pos + PCI_LTR_MAX_NOSNOOP_LAT, val);
2229 if (ret != 4)
2230 return -EIO;
2231
2232 return 0;
2233}
2234EXPORT_SYMBOL(pci_set_ltr);
2235
5d990b62
CW
2236static int pci_acs_enable;
2237
2238/**
2239 * pci_request_acs - ask for ACS to be enabled if supported
2240 */
2241void pci_request_acs(void)
2242{
2243 pci_acs_enable = 1;
2244}
2245
ae21ee65
AK
2246/**
2247 * pci_enable_acs - enable ACS if hardware support it
2248 * @dev: the PCI device
2249 */
2250void pci_enable_acs(struct pci_dev *dev)
2251{
2252 int pos;
2253 u16 cap;
2254 u16 ctrl;
2255
5d990b62
CW
2256 if (!pci_acs_enable)
2257 return;
2258
5f4d91a1 2259 if (!pci_is_pcie(dev))
ae21ee65
AK
2260 return;
2261
2262 pos = pci_find_ext_capability(dev, PCI_EXT_CAP_ID_ACS);
2263 if (!pos)
2264 return;
2265
2266 pci_read_config_word(dev, pos + PCI_ACS_CAP, &cap);
2267 pci_read_config_word(dev, pos + PCI_ACS_CTRL, &ctrl);
2268
2269 /* Source Validation */
2270 ctrl |= (cap & PCI_ACS_SV);
2271
2272 /* P2P Request Redirect */
2273 ctrl |= (cap & PCI_ACS_RR);
2274
2275 /* P2P Completion Redirect */
2276 ctrl |= (cap & PCI_ACS_CR);
2277
2278 /* Upstream Forwarding */
2279 ctrl |= (cap & PCI_ACS_UF);
2280
2281 pci_write_config_word(dev, pos + PCI_ACS_CTRL, ctrl);
2282}
2283
57c2cf71
BH
2284/**
2285 * pci_swizzle_interrupt_pin - swizzle INTx for device behind bridge
2286 * @dev: the PCI device
2287 * @pin: the INTx pin (1=INTA, 2=INTB, 3=INTD, 4=INTD)
2288 *
2289 * Perform INTx swizzling for a device behind one level of bridge. This is
2290 * required by section 9.1 of the PCI-to-PCI bridge specification for devices
46b952a3
MW
2291 * behind bridges on add-in cards. For devices with ARI enabled, the slot
2292 * number is always 0 (see the Implementation Note in section 2.2.8.1 of
2293 * the PCI Express Base Specification, Revision 2.1)
57c2cf71
BH
2294 */
2295u8 pci_swizzle_interrupt_pin(struct pci_dev *dev, u8 pin)
2296{
46b952a3
MW
2297 int slot;
2298
2299 if (pci_ari_enabled(dev->bus))
2300 slot = 0;
2301 else
2302 slot = PCI_SLOT(dev->devfn);
2303
2304 return (((pin - 1) + slot) % 4) + 1;
57c2cf71
BH
2305}
2306
1da177e4
LT
2307int
2308pci_get_interrupt_pin(struct pci_dev *dev, struct pci_dev **bridge)
2309{
2310 u8 pin;
2311
514d207d 2312 pin = dev->pin;
1da177e4
LT
2313 if (!pin)
2314 return -1;
878f2e50 2315
8784fd4d 2316 while (!pci_is_root_bus(dev->bus)) {
57c2cf71 2317 pin = pci_swizzle_interrupt_pin(dev, pin);
1da177e4
LT
2318 dev = dev->bus->self;
2319 }
2320 *bridge = dev;
2321 return pin;
2322}
2323
68feac87
BH
2324/**
2325 * pci_common_swizzle - swizzle INTx all the way to root bridge
2326 * @dev: the PCI device
2327 * @pinp: pointer to the INTx pin value (1=INTA, 2=INTB, 3=INTD, 4=INTD)
2328 *
2329 * Perform INTx swizzling for a device. This traverses through all PCI-to-PCI
2330 * bridges all the way up to a PCI root bus.
2331 */
2332u8 pci_common_swizzle(struct pci_dev *dev, u8 *pinp)
2333{
2334 u8 pin = *pinp;
2335
1eb39487 2336 while (!pci_is_root_bus(dev->bus)) {
68feac87
BH
2337 pin = pci_swizzle_interrupt_pin(dev, pin);
2338 dev = dev->bus->self;
2339 }
2340 *pinp = pin;
2341 return PCI_SLOT(dev->devfn);
2342}
2343
1da177e4
LT
2344/**
2345 * pci_release_region - Release a PCI bar
2346 * @pdev: PCI device whose resources were previously reserved by pci_request_region
2347 * @bar: BAR to release
2348 *
2349 * Releases the PCI I/O and memory resources previously reserved by a
2350 * successful call to pci_request_region. Call this function only
2351 * after all use of the PCI regions has ceased.
2352 */
2353void pci_release_region(struct pci_dev *pdev, int bar)
2354{
9ac7849e
TH
2355 struct pci_devres *dr;
2356
1da177e4
LT
2357 if (pci_resource_len(pdev, bar) == 0)
2358 return;
2359 if (pci_resource_flags(pdev, bar) & IORESOURCE_IO)
2360 release_region(pci_resource_start(pdev, bar),
2361 pci_resource_len(pdev, bar));
2362 else if (pci_resource_flags(pdev, bar) & IORESOURCE_MEM)
2363 release_mem_region(pci_resource_start(pdev, bar),
2364 pci_resource_len(pdev, bar));
9ac7849e
TH
2365
2366 dr = find_pci_dr(pdev);
2367 if (dr)
2368 dr->region_mask &= ~(1 << bar);
1da177e4
LT
2369}
2370
2371/**
f5ddcac4 2372 * __pci_request_region - Reserved PCI I/O and memory resource
1da177e4
LT
2373 * @pdev: PCI device whose resources are to be reserved
2374 * @bar: BAR to be reserved
2375 * @res_name: Name to be associated with resource.
f5ddcac4 2376 * @exclusive: whether the region access is exclusive or not
1da177e4
LT
2377 *
2378 * Mark the PCI region associated with PCI device @pdev BR @bar as
2379 * being reserved by owner @res_name. Do not access any
2380 * address inside the PCI regions unless this call returns
2381 * successfully.
2382 *
f5ddcac4
RD
2383 * If @exclusive is set, then the region is marked so that userspace
2384 * is explicitly not allowed to map the resource via /dev/mem or
2385 * sysfs MMIO access.
2386 *
1da177e4
LT
2387 * Returns 0 on success, or %EBUSY on error. A warning
2388 * message is also printed on failure.
2389 */
e8de1481
AV
2390static int __pci_request_region(struct pci_dev *pdev, int bar, const char *res_name,
2391 int exclusive)
1da177e4 2392{
9ac7849e
TH
2393 struct pci_devres *dr;
2394
1da177e4
LT
2395 if (pci_resource_len(pdev, bar) == 0)
2396 return 0;
2397
2398 if (pci_resource_flags(pdev, bar) & IORESOURCE_IO) {
2399 if (!request_region(pci_resource_start(pdev, bar),
2400 pci_resource_len(pdev, bar), res_name))
2401 goto err_out;
2402 }
2403 else if (pci_resource_flags(pdev, bar) & IORESOURCE_MEM) {
e8de1481
AV
2404 if (!__request_mem_region(pci_resource_start(pdev, bar),
2405 pci_resource_len(pdev, bar), res_name,
2406 exclusive))
1da177e4
LT
2407 goto err_out;
2408 }
9ac7849e
TH
2409
2410 dr = find_pci_dr(pdev);
2411 if (dr)
2412 dr->region_mask |= 1 << bar;
2413
1da177e4
LT
2414 return 0;
2415
2416err_out:
c7dabef8 2417 dev_warn(&pdev->dev, "BAR %d: can't reserve %pR\n", bar,
096e6f67 2418 &pdev->resource[bar]);
1da177e4
LT
2419 return -EBUSY;
2420}
2421
e8de1481 2422/**
f5ddcac4 2423 * pci_request_region - Reserve PCI I/O and memory resource
e8de1481
AV
2424 * @pdev: PCI device whose resources are to be reserved
2425 * @bar: BAR to be reserved
f5ddcac4 2426 * @res_name: Name to be associated with resource
e8de1481 2427 *
f5ddcac4 2428 * Mark the PCI region associated with PCI device @pdev BAR @bar as
e8de1481
AV
2429 * being reserved by owner @res_name. Do not access any
2430 * address inside the PCI regions unless this call returns
2431 * successfully.
2432 *
2433 * Returns 0 on success, or %EBUSY on error. A warning
2434 * message is also printed on failure.
2435 */
2436int pci_request_region(struct pci_dev *pdev, int bar, const char *res_name)
2437{
2438 return __pci_request_region(pdev, bar, res_name, 0);
2439}
2440
2441/**
2442 * pci_request_region_exclusive - Reserved PCI I/O and memory resource
2443 * @pdev: PCI device whose resources are to be reserved
2444 * @bar: BAR to be reserved
2445 * @res_name: Name to be associated with resource.
2446 *
2447 * Mark the PCI region associated with PCI device @pdev BR @bar as
2448 * being reserved by owner @res_name. Do not access any
2449 * address inside the PCI regions unless this call returns
2450 * successfully.
2451 *
2452 * Returns 0 on success, or %EBUSY on error. A warning
2453 * message is also printed on failure.
2454 *
2455 * The key difference that _exclusive makes it that userspace is
2456 * explicitly not allowed to map the resource via /dev/mem or
2457 * sysfs.
2458 */
2459int pci_request_region_exclusive(struct pci_dev *pdev, int bar, const char *res_name)
2460{
2461 return __pci_request_region(pdev, bar, res_name, IORESOURCE_EXCLUSIVE);
2462}
c87deff7
HS
2463/**
2464 * pci_release_selected_regions - Release selected PCI I/O and memory resources
2465 * @pdev: PCI device whose resources were previously reserved
2466 * @bars: Bitmask of BARs to be released
2467 *
2468 * Release selected PCI I/O and memory resources previously reserved.
2469 * Call this function only after all use of the PCI regions has ceased.
2470 */
2471void pci_release_selected_regions(struct pci_dev *pdev, int bars)
2472{
2473 int i;
2474
2475 for (i = 0; i < 6; i++)
2476 if (bars & (1 << i))
2477 pci_release_region(pdev, i);
2478}
2479
e8de1481
AV
2480int __pci_request_selected_regions(struct pci_dev *pdev, int bars,
2481 const char *res_name, int excl)
c87deff7
HS
2482{
2483 int i;
2484
2485 for (i = 0; i < 6; i++)
2486 if (bars & (1 << i))
e8de1481 2487 if (__pci_request_region(pdev, i, res_name, excl))
c87deff7
HS
2488 goto err_out;
2489 return 0;
2490
2491err_out:
2492 while(--i >= 0)
2493 if (bars & (1 << i))
2494 pci_release_region(pdev, i);
2495
2496 return -EBUSY;
2497}
1da177e4 2498
e8de1481
AV
2499
2500/**
2501 * pci_request_selected_regions - Reserve selected PCI I/O and memory resources
2502 * @pdev: PCI device whose resources are to be reserved
2503 * @bars: Bitmask of BARs to be requested
2504 * @res_name: Name to be associated with resource
2505 */
2506int pci_request_selected_regions(struct pci_dev *pdev, int bars,
2507 const char *res_name)
2508{
2509 return __pci_request_selected_regions(pdev, bars, res_name, 0);
2510}
2511
2512int pci_request_selected_regions_exclusive(struct pci_dev *pdev,
2513 int bars, const char *res_name)
2514{
2515 return __pci_request_selected_regions(pdev, bars, res_name,
2516 IORESOURCE_EXCLUSIVE);
2517}
2518
1da177e4
LT
2519/**
2520 * pci_release_regions - Release reserved PCI I/O and memory resources
2521 * @pdev: PCI device whose resources were previously reserved by pci_request_regions
2522 *
2523 * Releases all PCI I/O and memory resources previously reserved by a
2524 * successful call to pci_request_regions. Call this function only
2525 * after all use of the PCI regions has ceased.
2526 */
2527
2528void pci_release_regions(struct pci_dev *pdev)
2529{
c87deff7 2530 pci_release_selected_regions(pdev, (1 << 6) - 1);
1da177e4
LT
2531}
2532
2533/**
2534 * pci_request_regions - Reserved PCI I/O and memory resources
2535 * @pdev: PCI device whose resources are to be reserved
2536 * @res_name: Name to be associated with resource.
2537 *
2538 * Mark all PCI regions associated with PCI device @pdev as
2539 * being reserved by owner @res_name. Do not access any
2540 * address inside the PCI regions unless this call returns
2541 * successfully.
2542 *
2543 * Returns 0 on success, or %EBUSY on error. A warning
2544 * message is also printed on failure.
2545 */
3c990e92 2546int pci_request_regions(struct pci_dev *pdev, const char *res_name)
1da177e4 2547{
c87deff7 2548 return pci_request_selected_regions(pdev, ((1 << 6) - 1), res_name);
1da177e4
LT
2549}
2550
e8de1481
AV
2551/**
2552 * pci_request_regions_exclusive - Reserved PCI I/O and memory resources
2553 * @pdev: PCI device whose resources are to be reserved
2554 * @res_name: Name to be associated with resource.
2555 *
2556 * Mark all PCI regions associated with PCI device @pdev as
2557 * being reserved by owner @res_name. Do not access any
2558 * address inside the PCI regions unless this call returns
2559 * successfully.
2560 *
2561 * pci_request_regions_exclusive() will mark the region so that
2562 * /dev/mem and the sysfs MMIO access will not be allowed.
2563 *
2564 * Returns 0 on success, or %EBUSY on error. A warning
2565 * message is also printed on failure.
2566 */
2567int pci_request_regions_exclusive(struct pci_dev *pdev, const char *res_name)
2568{
2569 return pci_request_selected_regions_exclusive(pdev,
2570 ((1 << 6) - 1), res_name);
2571}
2572
6a479079
BH
2573static void __pci_set_master(struct pci_dev *dev, bool enable)
2574{
2575 u16 old_cmd, cmd;
2576
2577 pci_read_config_word(dev, PCI_COMMAND, &old_cmd);
2578 if (enable)
2579 cmd = old_cmd | PCI_COMMAND_MASTER;
2580 else
2581 cmd = old_cmd & ~PCI_COMMAND_MASTER;
2582 if (cmd != old_cmd) {
2583 dev_dbg(&dev->dev, "%s bus mastering\n",
2584 enable ? "enabling" : "disabling");
2585 pci_write_config_word(dev, PCI_COMMAND, cmd);
2586 }
2587 dev->is_busmaster = enable;
2588}
e8de1481 2589
1da177e4
LT
2590/**
2591 * pci_set_master - enables bus-mastering for device dev
2592 * @dev: the PCI device to enable
2593 *
2594 * Enables bus-mastering on the device and calls pcibios_set_master()
2595 * to do the needed arch specific settings.
2596 */
6a479079 2597void pci_set_master(struct pci_dev *dev)
1da177e4 2598{
6a479079 2599 __pci_set_master(dev, true);
1da177e4
LT
2600 pcibios_set_master(dev);
2601}
2602
6a479079
BH
2603/**
2604 * pci_clear_master - disables bus-mastering for device dev
2605 * @dev: the PCI device to disable
2606 */
2607void pci_clear_master(struct pci_dev *dev)
2608{
2609 __pci_set_master(dev, false);
2610}
2611
1da177e4 2612/**
edb2d97e
MW
2613 * pci_set_cacheline_size - ensure the CACHE_LINE_SIZE register is programmed
2614 * @dev: the PCI device for which MWI is to be enabled
1da177e4 2615 *
edb2d97e
MW
2616 * Helper function for pci_set_mwi.
2617 * Originally copied from drivers/net/acenic.c.
1da177e4
LT
2618 * Copyright 1998-2001 by Jes Sorensen, <jes@trained-monkey.org>.
2619 *
2620 * RETURNS: An appropriate -ERRNO error value on error, or zero for success.
2621 */
15ea76d4 2622int pci_set_cacheline_size(struct pci_dev *dev)
1da177e4
LT
2623{
2624 u8 cacheline_size;
2625
2626 if (!pci_cache_line_size)
15ea76d4 2627 return -EINVAL;
1da177e4
LT
2628
2629 /* Validate current setting: the PCI_CACHE_LINE_SIZE must be
2630 equal to or multiple of the right value. */
2631 pci_read_config_byte(dev, PCI_CACHE_LINE_SIZE, &cacheline_size);
2632 if (cacheline_size >= pci_cache_line_size &&
2633 (cacheline_size % pci_cache_line_size) == 0)
2634 return 0;
2635
2636 /* Write the correct value. */
2637 pci_write_config_byte(dev, PCI_CACHE_LINE_SIZE, pci_cache_line_size);
2638 /* Read it back. */
2639 pci_read_config_byte(dev, PCI_CACHE_LINE_SIZE, &cacheline_size);
2640 if (cacheline_size == pci_cache_line_size)
2641 return 0;
2642
80ccba11
BH
2643 dev_printk(KERN_DEBUG, &dev->dev, "cache line size of %d is not "
2644 "supported\n", pci_cache_line_size << 2);
1da177e4
LT
2645
2646 return -EINVAL;
2647}
15ea76d4
TH
2648EXPORT_SYMBOL_GPL(pci_set_cacheline_size);
2649
2650#ifdef PCI_DISABLE_MWI
2651int pci_set_mwi(struct pci_dev *dev)
2652{
2653 return 0;
2654}
2655
2656int pci_try_set_mwi(struct pci_dev *dev)
2657{
2658 return 0;
2659}
2660
2661void pci_clear_mwi(struct pci_dev *dev)
2662{
2663}
2664
2665#else
1da177e4
LT
2666
2667/**
2668 * pci_set_mwi - enables memory-write-invalidate PCI transaction
2669 * @dev: the PCI device for which MWI is enabled
2670 *
694625c0 2671 * Enables the Memory-Write-Invalidate transaction in %PCI_COMMAND.
1da177e4
LT
2672 *
2673 * RETURNS: An appropriate -ERRNO error value on error, or zero for success.
2674 */
2675int
2676pci_set_mwi(struct pci_dev *dev)
2677{
2678 int rc;
2679 u16 cmd;
2680
edb2d97e 2681 rc = pci_set_cacheline_size(dev);
1da177e4
LT
2682 if (rc)
2683 return rc;
2684
2685 pci_read_config_word(dev, PCI_COMMAND, &cmd);
2686 if (! (cmd & PCI_COMMAND_INVALIDATE)) {
80ccba11 2687 dev_dbg(&dev->dev, "enabling Mem-Wr-Inval\n");
1da177e4
LT
2688 cmd |= PCI_COMMAND_INVALIDATE;
2689 pci_write_config_word(dev, PCI_COMMAND, cmd);
2690 }
2691
2692 return 0;
2693}
2694
694625c0
RD
2695/**
2696 * pci_try_set_mwi - enables memory-write-invalidate PCI transaction
2697 * @dev: the PCI device for which MWI is enabled
2698 *
2699 * Enables the Memory-Write-Invalidate transaction in %PCI_COMMAND.
2700 * Callers are not required to check the return value.
2701 *
2702 * RETURNS: An appropriate -ERRNO error value on error, or zero for success.
2703 */
2704int pci_try_set_mwi(struct pci_dev *dev)
2705{
2706 int rc = pci_set_mwi(dev);
2707 return rc;
2708}
2709
1da177e4
LT
2710/**
2711 * pci_clear_mwi - disables Memory-Write-Invalidate for device dev
2712 * @dev: the PCI device to disable
2713 *
2714 * Disables PCI Memory-Write-Invalidate transaction on the device
2715 */
2716void
2717pci_clear_mwi(struct pci_dev *dev)
2718{
2719 u16 cmd;
2720
2721 pci_read_config_word(dev, PCI_COMMAND, &cmd);
2722 if (cmd & PCI_COMMAND_INVALIDATE) {
2723 cmd &= ~PCI_COMMAND_INVALIDATE;
2724 pci_write_config_word(dev, PCI_COMMAND, cmd);
2725 }
2726}
edb2d97e 2727#endif /* ! PCI_DISABLE_MWI */
1da177e4 2728
a04ce0ff
BR
2729/**
2730 * pci_intx - enables/disables PCI INTx for device dev
8f7020d3
RD
2731 * @pdev: the PCI device to operate on
2732 * @enable: boolean: whether to enable or disable PCI INTx
a04ce0ff
BR
2733 *
2734 * Enables/disables PCI INTx for device dev
2735 */
2736void
2737pci_intx(struct pci_dev *pdev, int enable)
2738{
2739 u16 pci_command, new;
2740
2741 pci_read_config_word(pdev, PCI_COMMAND, &pci_command);
2742
2743 if (enable) {
2744 new = pci_command & ~PCI_COMMAND_INTX_DISABLE;
2745 } else {
2746 new = pci_command | PCI_COMMAND_INTX_DISABLE;
2747 }
2748
2749 if (new != pci_command) {
9ac7849e
TH
2750 struct pci_devres *dr;
2751
2fd9d74b 2752 pci_write_config_word(pdev, PCI_COMMAND, new);
9ac7849e
TH
2753
2754 dr = find_pci_dr(pdev);
2755 if (dr && !dr->restore_intx) {
2756 dr->restore_intx = 1;
2757 dr->orig_intx = !enable;
2758 }
a04ce0ff
BR
2759 }
2760}
2761
f5f2b131
EB
2762/**
2763 * pci_msi_off - disables any msi or msix capabilities
8d7d86e9 2764 * @dev: the PCI device to operate on
f5f2b131
EB
2765 *
2766 * If you want to use msi see pci_enable_msi and friends.
2767 * This is a lower level primitive that allows us to disable
2768 * msi operation at the device level.
2769 */
2770void pci_msi_off(struct pci_dev *dev)
2771{
2772 int pos;
2773 u16 control;
2774
2775 pos = pci_find_capability(dev, PCI_CAP_ID_MSI);
2776 if (pos) {
2777 pci_read_config_word(dev, pos + PCI_MSI_FLAGS, &control);
2778 control &= ~PCI_MSI_FLAGS_ENABLE;
2779 pci_write_config_word(dev, pos + PCI_MSI_FLAGS, control);
2780 }
2781 pos = pci_find_capability(dev, PCI_CAP_ID_MSIX);
2782 if (pos) {
2783 pci_read_config_word(dev, pos + PCI_MSIX_FLAGS, &control);
2784 control &= ~PCI_MSIX_FLAGS_ENABLE;
2785 pci_write_config_word(dev, pos + PCI_MSIX_FLAGS, control);
2786 }
2787}
b03214d5 2788EXPORT_SYMBOL_GPL(pci_msi_off);
f5f2b131 2789
4d57cdfa
FT
2790int pci_set_dma_max_seg_size(struct pci_dev *dev, unsigned int size)
2791{
2792 return dma_set_max_seg_size(&dev->dev, size);
2793}
2794EXPORT_SYMBOL(pci_set_dma_max_seg_size);
4d57cdfa 2795
59fc67de
FT
2796int pci_set_dma_seg_boundary(struct pci_dev *dev, unsigned long mask)
2797{
2798 return dma_set_seg_boundary(&dev->dev, mask);
2799}
2800EXPORT_SYMBOL(pci_set_dma_seg_boundary);
59fc67de 2801
8c1c699f 2802static int pcie_flr(struct pci_dev *dev, int probe)
8dd7f803 2803{
8c1c699f
YZ
2804 int i;
2805 int pos;
8dd7f803 2806 u32 cap;
04b55c47 2807 u16 status, control;
8dd7f803 2808
06a1cbaf 2809 pos = pci_pcie_cap(dev);
8c1c699f 2810 if (!pos)
8dd7f803 2811 return -ENOTTY;
8c1c699f
YZ
2812
2813 pci_read_config_dword(dev, pos + PCI_EXP_DEVCAP, &cap);
8dd7f803
SY
2814 if (!(cap & PCI_EXP_DEVCAP_FLR))
2815 return -ENOTTY;
2816
d91cdc74
SY
2817 if (probe)
2818 return 0;
2819
8dd7f803 2820 /* Wait for Transaction Pending bit clean */
8c1c699f
YZ
2821 for (i = 0; i < 4; i++) {
2822 if (i)
2823 msleep((1 << (i - 1)) * 100);
5fe5db05 2824
8c1c699f
YZ
2825 pci_read_config_word(dev, pos + PCI_EXP_DEVSTA, &status);
2826 if (!(status & PCI_EXP_DEVSTA_TRPND))
2827 goto clear;
2828 }
2829
2830 dev_err(&dev->dev, "transaction is not cleared; "
2831 "proceeding with reset anyway\n");
2832
2833clear:
04b55c47
SR
2834 pci_read_config_word(dev, pos + PCI_EXP_DEVCTL, &control);
2835 control |= PCI_EXP_DEVCTL_BCR_FLR;
2836 pci_write_config_word(dev, pos + PCI_EXP_DEVCTL, control);
2837
8c1c699f 2838 msleep(100);
8dd7f803 2839
8dd7f803
SY
2840 return 0;
2841}
d91cdc74 2842
8c1c699f 2843static int pci_af_flr(struct pci_dev *dev, int probe)
1ca88797 2844{
8c1c699f
YZ
2845 int i;
2846 int pos;
1ca88797 2847 u8 cap;
8c1c699f 2848 u8 status;
1ca88797 2849
8c1c699f
YZ
2850 pos = pci_find_capability(dev, PCI_CAP_ID_AF);
2851 if (!pos)
1ca88797 2852 return -ENOTTY;
8c1c699f
YZ
2853
2854 pci_read_config_byte(dev, pos + PCI_AF_CAP, &cap);
1ca88797
SY
2855 if (!(cap & PCI_AF_CAP_TP) || !(cap & PCI_AF_CAP_FLR))
2856 return -ENOTTY;
2857
2858 if (probe)
2859 return 0;
2860
1ca88797 2861 /* Wait for Transaction Pending bit clean */
8c1c699f
YZ
2862 for (i = 0; i < 4; i++) {
2863 if (i)
2864 msleep((1 << (i - 1)) * 100);
2865
2866 pci_read_config_byte(dev, pos + PCI_AF_STATUS, &status);
2867 if (!(status & PCI_AF_STATUS_TP))
2868 goto clear;
2869 }
5fe5db05 2870
8c1c699f
YZ
2871 dev_err(&dev->dev, "transaction is not cleared; "
2872 "proceeding with reset anyway\n");
5fe5db05 2873
8c1c699f
YZ
2874clear:
2875 pci_write_config_byte(dev, pos + PCI_AF_CTRL, PCI_AF_CTRL_FLR);
1ca88797 2876 msleep(100);
8c1c699f 2877
1ca88797
SY
2878 return 0;
2879}
2880
83d74e03
RW
2881/**
2882 * pci_pm_reset - Put device into PCI_D3 and back into PCI_D0.
2883 * @dev: Device to reset.
2884 * @probe: If set, only check if the device can be reset this way.
2885 *
2886 * If @dev supports native PCI PM and its PCI_PM_CTRL_NO_SOFT_RESET flag is
2887 * unset, it will be reinitialized internally when going from PCI_D3hot to
2888 * PCI_D0. If that's the case and the device is not in a low-power state
2889 * already, force it into PCI_D3hot and back to PCI_D0, causing it to be reset.
2890 *
2891 * NOTE: This causes the caller to sleep for twice the device power transition
2892 * cooldown period, which for the D0->D3hot and D3hot->D0 transitions is 10 ms
2893 * by devault (i.e. unless the @dev's d3_delay field has a different value).
2894 * Moreover, only devices in D0 can be reset by this function.
2895 */
f85876ba 2896static int pci_pm_reset(struct pci_dev *dev, int probe)
d91cdc74 2897{
f85876ba
YZ
2898 u16 csr;
2899
2900 if (!dev->pm_cap)
2901 return -ENOTTY;
d91cdc74 2902
f85876ba
YZ
2903 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &csr);
2904 if (csr & PCI_PM_CTRL_NO_SOFT_RESET)
2905 return -ENOTTY;
d91cdc74 2906
f85876ba
YZ
2907 if (probe)
2908 return 0;
1ca88797 2909
f85876ba
YZ
2910 if (dev->current_state != PCI_D0)
2911 return -EINVAL;
2912
2913 csr &= ~PCI_PM_CTRL_STATE_MASK;
2914 csr |= PCI_D3hot;
2915 pci_write_config_word(dev, dev->pm_cap + PCI_PM_CTRL, csr);
1ae861e6 2916 pci_dev_d3_sleep(dev);
f85876ba
YZ
2917
2918 csr &= ~PCI_PM_CTRL_STATE_MASK;
2919 csr |= PCI_D0;
2920 pci_write_config_word(dev, dev->pm_cap + PCI_PM_CTRL, csr);
1ae861e6 2921 pci_dev_d3_sleep(dev);
f85876ba
YZ
2922
2923 return 0;
2924}
2925
c12ff1df
YZ
2926static int pci_parent_bus_reset(struct pci_dev *dev, int probe)
2927{
2928 u16 ctrl;
2929 struct pci_dev *pdev;
2930
654b75e0 2931 if (pci_is_root_bus(dev->bus) || dev->subordinate || !dev->bus->self)
c12ff1df
YZ
2932 return -ENOTTY;
2933
2934 list_for_each_entry(pdev, &dev->bus->devices, bus_list)
2935 if (pdev != dev)
2936 return -ENOTTY;
2937
2938 if (probe)
2939 return 0;
2940
2941 pci_read_config_word(dev->bus->self, PCI_BRIDGE_CONTROL, &ctrl);
2942 ctrl |= PCI_BRIDGE_CTL_BUS_RESET;
2943 pci_write_config_word(dev->bus->self, PCI_BRIDGE_CONTROL, ctrl);
2944 msleep(100);
2945
2946 ctrl &= ~PCI_BRIDGE_CTL_BUS_RESET;
2947 pci_write_config_word(dev->bus->self, PCI_BRIDGE_CONTROL, ctrl);
2948 msleep(100);
2949
2950 return 0;
2951}
2952
8c1c699f 2953static int pci_dev_reset(struct pci_dev *dev, int probe)
d91cdc74 2954{
8c1c699f
YZ
2955 int rc;
2956
2957 might_sleep();
2958
2959 if (!probe) {
2960 pci_block_user_cfg_access(dev);
2961 /* block PM suspend, driver probe, etc. */
8e9394ce 2962 device_lock(&dev->dev);
8c1c699f 2963 }
d91cdc74 2964
b9c3b266
DC
2965 rc = pci_dev_specific_reset(dev, probe);
2966 if (rc != -ENOTTY)
2967 goto done;
2968
8c1c699f
YZ
2969 rc = pcie_flr(dev, probe);
2970 if (rc != -ENOTTY)
2971 goto done;
d91cdc74 2972
8c1c699f 2973 rc = pci_af_flr(dev, probe);
f85876ba
YZ
2974 if (rc != -ENOTTY)
2975 goto done;
2976
2977 rc = pci_pm_reset(dev, probe);
c12ff1df
YZ
2978 if (rc != -ENOTTY)
2979 goto done;
2980
2981 rc = pci_parent_bus_reset(dev, probe);
8c1c699f
YZ
2982done:
2983 if (!probe) {
8e9394ce 2984 device_unlock(&dev->dev);
8c1c699f
YZ
2985 pci_unblock_user_cfg_access(dev);
2986 }
1ca88797 2987
8c1c699f 2988 return rc;
d91cdc74
SY
2989}
2990
2991/**
8c1c699f
YZ
2992 * __pci_reset_function - reset a PCI device function
2993 * @dev: PCI device to reset
d91cdc74
SY
2994 *
2995 * Some devices allow an individual function to be reset without affecting
2996 * other functions in the same device. The PCI device must be responsive
2997 * to PCI config space in order to use this function.
2998 *
2999 * The device function is presumed to be unused when this function is called.
3000 * Resetting the device will make the contents of PCI configuration space
3001 * random, so any caller of this must be prepared to reinitialise the
3002 * device including MSI, bus mastering, BARs, decoding IO and memory spaces,
3003 * etc.
3004 *
8c1c699f 3005 * Returns 0 if the device function was successfully reset or negative if the
d91cdc74
SY
3006 * device doesn't support resetting a single function.
3007 */
8c1c699f 3008int __pci_reset_function(struct pci_dev *dev)
d91cdc74 3009{
8c1c699f 3010 return pci_dev_reset(dev, 0);
d91cdc74 3011}
8c1c699f 3012EXPORT_SYMBOL_GPL(__pci_reset_function);
8dd7f803 3013
711d5779
MT
3014/**
3015 * pci_probe_reset_function - check whether the device can be safely reset
3016 * @dev: PCI device to reset
3017 *
3018 * Some devices allow an individual function to be reset without affecting
3019 * other functions in the same device. The PCI device must be responsive
3020 * to PCI config space in order to use this function.
3021 *
3022 * Returns 0 if the device function can be reset or negative if the
3023 * device doesn't support resetting a single function.
3024 */
3025int pci_probe_reset_function(struct pci_dev *dev)
3026{
3027 return pci_dev_reset(dev, 1);
3028}
3029
8dd7f803 3030/**
8c1c699f
YZ
3031 * pci_reset_function - quiesce and reset a PCI device function
3032 * @dev: PCI device to reset
8dd7f803
SY
3033 *
3034 * Some devices allow an individual function to be reset without affecting
3035 * other functions in the same device. The PCI device must be responsive
3036 * to PCI config space in order to use this function.
3037 *
3038 * This function does not just reset the PCI portion of a device, but
3039 * clears all the state associated with the device. This function differs
8c1c699f 3040 * from __pci_reset_function in that it saves and restores device state
8dd7f803
SY
3041 * over the reset.
3042 *
8c1c699f 3043 * Returns 0 if the device function was successfully reset or negative if the
8dd7f803
SY
3044 * device doesn't support resetting a single function.
3045 */
3046int pci_reset_function(struct pci_dev *dev)
3047{
8c1c699f 3048 int rc;
8dd7f803 3049
8c1c699f
YZ
3050 rc = pci_dev_reset(dev, 1);
3051 if (rc)
3052 return rc;
8dd7f803 3053
8dd7f803
SY
3054 pci_save_state(dev);
3055
8c1c699f
YZ
3056 /*
3057 * both INTx and MSI are disabled after the Interrupt Disable bit
3058 * is set and the Bus Master bit is cleared.
3059 */
8dd7f803
SY
3060 pci_write_config_word(dev, PCI_COMMAND, PCI_COMMAND_INTX_DISABLE);
3061
8c1c699f 3062 rc = pci_dev_reset(dev, 0);
8dd7f803
SY
3063
3064 pci_restore_state(dev);
8dd7f803 3065
8c1c699f 3066 return rc;
8dd7f803
SY
3067}
3068EXPORT_SYMBOL_GPL(pci_reset_function);
3069
d556ad4b
PO
3070/**
3071 * pcix_get_max_mmrbc - get PCI-X maximum designed memory read byte count
3072 * @dev: PCI device to query
3073 *
3074 * Returns mmrbc: maximum designed memory read count in bytes
3075 * or appropriate error value.
3076 */
3077int pcix_get_max_mmrbc(struct pci_dev *dev)
3078{
7c9e2b1c 3079 int cap;
d556ad4b
PO
3080 u32 stat;
3081
3082 cap = pci_find_capability(dev, PCI_CAP_ID_PCIX);
3083 if (!cap)
3084 return -EINVAL;
3085
7c9e2b1c 3086 if (pci_read_config_dword(dev, cap + PCI_X_STATUS, &stat))
d556ad4b
PO
3087 return -EINVAL;
3088
25daeb55 3089 return 512 << ((stat & PCI_X_STATUS_MAX_READ) >> 21);
d556ad4b
PO
3090}
3091EXPORT_SYMBOL(pcix_get_max_mmrbc);
3092
3093/**
3094 * pcix_get_mmrbc - get PCI-X maximum memory read byte count
3095 * @dev: PCI device to query
3096 *
3097 * Returns mmrbc: maximum memory read count in bytes
3098 * or appropriate error value.
3099 */
3100int pcix_get_mmrbc(struct pci_dev *dev)
3101{
7c9e2b1c 3102 int cap;
bdc2bda7 3103 u16 cmd;
d556ad4b
PO
3104
3105 cap = pci_find_capability(dev, PCI_CAP_ID_PCIX);
3106 if (!cap)
3107 return -EINVAL;
3108
7c9e2b1c
DN
3109 if (pci_read_config_word(dev, cap + PCI_X_CMD, &cmd))
3110 return -EINVAL;
d556ad4b 3111
7c9e2b1c 3112 return 512 << ((cmd & PCI_X_CMD_MAX_READ) >> 2);
d556ad4b
PO
3113}
3114EXPORT_SYMBOL(pcix_get_mmrbc);
3115
3116/**
3117 * pcix_set_mmrbc - set PCI-X maximum memory read byte count
3118 * @dev: PCI device to query
3119 * @mmrbc: maximum memory read count in bytes
3120 * valid values are 512, 1024, 2048, 4096
3121 *
3122 * If possible sets maximum memory read byte count, some bridges have erratas
3123 * that prevent this.
3124 */
3125int pcix_set_mmrbc(struct pci_dev *dev, int mmrbc)
3126{
7c9e2b1c 3127 int cap;
bdc2bda7
DN
3128 u32 stat, v, o;
3129 u16 cmd;
d556ad4b 3130
229f5afd 3131 if (mmrbc < 512 || mmrbc > 4096 || !is_power_of_2(mmrbc))
7c9e2b1c 3132 return -EINVAL;
d556ad4b
PO
3133
3134 v = ffs(mmrbc) - 10;
3135
3136 cap = pci_find_capability(dev, PCI_CAP_ID_PCIX);
3137 if (!cap)
7c9e2b1c 3138 return -EINVAL;
d556ad4b 3139
7c9e2b1c
DN
3140 if (pci_read_config_dword(dev, cap + PCI_X_STATUS, &stat))
3141 return -EINVAL;
d556ad4b
PO
3142
3143 if (v > (stat & PCI_X_STATUS_MAX_READ) >> 21)
3144 return -E2BIG;
3145
7c9e2b1c
DN
3146 if (pci_read_config_word(dev, cap + PCI_X_CMD, &cmd))
3147 return -EINVAL;
d556ad4b
PO
3148
3149 o = (cmd & PCI_X_CMD_MAX_READ) >> 2;
3150 if (o != v) {
3151 if (v > o && dev->bus &&
3152 (dev->bus->bus_flags & PCI_BUS_FLAGS_NO_MMRBC))
3153 return -EIO;
3154
3155 cmd &= ~PCI_X_CMD_MAX_READ;
3156 cmd |= v << 2;
7c9e2b1c
DN
3157 if (pci_write_config_word(dev, cap + PCI_X_CMD, cmd))
3158 return -EIO;
d556ad4b 3159 }
7c9e2b1c 3160 return 0;
d556ad4b
PO
3161}
3162EXPORT_SYMBOL(pcix_set_mmrbc);
3163
3164/**
3165 * pcie_get_readrq - get PCI Express read request size
3166 * @dev: PCI device to query
3167 *
3168 * Returns maximum memory read request in bytes
3169 * or appropriate error value.
3170 */
3171int pcie_get_readrq(struct pci_dev *dev)
3172{
3173 int ret, cap;
3174 u16 ctl;
3175
06a1cbaf 3176 cap = pci_pcie_cap(dev);
d556ad4b
PO
3177 if (!cap)
3178 return -EINVAL;
3179
3180 ret = pci_read_config_word(dev, cap + PCI_EXP_DEVCTL, &ctl);
3181 if (!ret)
93e75fab 3182 ret = 128 << ((ctl & PCI_EXP_DEVCTL_READRQ) >> 12);
d556ad4b
PO
3183
3184 return ret;
3185}
3186EXPORT_SYMBOL(pcie_get_readrq);
3187
3188/**
3189 * pcie_set_readrq - set PCI Express maximum memory read request
3190 * @dev: PCI device to query
42e61f4a 3191 * @rq: maximum memory read count in bytes
d556ad4b
PO
3192 * valid values are 128, 256, 512, 1024, 2048, 4096
3193 *
c9b378c7 3194 * If possible sets maximum memory read request in bytes
d556ad4b
PO
3195 */
3196int pcie_set_readrq(struct pci_dev *dev, int rq)
3197{
3198 int cap, err = -EINVAL;
3199 u16 ctl, v;
3200
229f5afd 3201 if (rq < 128 || rq > 4096 || !is_power_of_2(rq))
d556ad4b
PO
3202 goto out;
3203
3204 v = (ffs(rq) - 8) << 12;
3205
06a1cbaf 3206 cap = pci_pcie_cap(dev);
d556ad4b
PO
3207 if (!cap)
3208 goto out;
3209
3210 err = pci_read_config_word(dev, cap + PCI_EXP_DEVCTL, &ctl);
3211 if (err)
3212 goto out;
3213
3214 if ((ctl & PCI_EXP_DEVCTL_READRQ) != v) {
3215 ctl &= ~PCI_EXP_DEVCTL_READRQ;
3216 ctl |= v;
c9b378c7 3217 err = pci_write_config_word(dev, cap + PCI_EXP_DEVCTL, ctl);
d556ad4b
PO
3218 }
3219
3220out:
3221 return err;
3222}
3223EXPORT_SYMBOL(pcie_set_readrq);
3224
c87deff7
HS
3225/**
3226 * pci_select_bars - Make BAR mask from the type of resource
f95d882d 3227 * @dev: the PCI device for which BAR mask is made
c87deff7
HS
3228 * @flags: resource type mask to be selected
3229 *
3230 * This helper routine makes bar mask from the type of resource.
3231 */
3232int pci_select_bars(struct pci_dev *dev, unsigned long flags)
3233{
3234 int i, bars = 0;
3235 for (i = 0; i < PCI_NUM_RESOURCES; i++)
3236 if (pci_resource_flags(dev, i) & flags)
3237 bars |= (1 << i);
3238 return bars;
3239}
3240
613e7ed6
YZ
3241/**
3242 * pci_resource_bar - get position of the BAR associated with a resource
3243 * @dev: the PCI device
3244 * @resno: the resource number
3245 * @type: the BAR type to be filled in
3246 *
3247 * Returns BAR position in config space, or 0 if the BAR is invalid.
3248 */
3249int pci_resource_bar(struct pci_dev *dev, int resno, enum pci_bar_type *type)
3250{
d1b054da
YZ
3251 int reg;
3252
613e7ed6
YZ
3253 if (resno < PCI_ROM_RESOURCE) {
3254 *type = pci_bar_unknown;
3255 return PCI_BASE_ADDRESS_0 + 4 * resno;
3256 } else if (resno == PCI_ROM_RESOURCE) {
3257 *type = pci_bar_mem32;
3258 return dev->rom_base_reg;
d1b054da
YZ
3259 } else if (resno < PCI_BRIDGE_RESOURCES) {
3260 /* device specific resource */
3261 reg = pci_iov_resource_bar(dev, resno, type);
3262 if (reg)
3263 return reg;
613e7ed6
YZ
3264 }
3265
865df576 3266 dev_err(&dev->dev, "BAR %d: invalid resource\n", resno);
613e7ed6
YZ
3267 return 0;
3268}
3269
95a8b6ef
MT
3270/* Some architectures require additional programming to enable VGA */
3271static arch_set_vga_state_t arch_set_vga_state;
3272
3273void __init pci_register_set_vga_state(arch_set_vga_state_t func)
3274{
3275 arch_set_vga_state = func; /* NULL disables */
3276}
3277
3278static int pci_set_vga_state_arch(struct pci_dev *dev, bool decode,
7ad35cf2 3279 unsigned int command_bits, u32 flags)
95a8b6ef
MT
3280{
3281 if (arch_set_vga_state)
3282 return arch_set_vga_state(dev, decode, command_bits,
7ad35cf2 3283 flags);
95a8b6ef
MT
3284 return 0;
3285}
3286
deb2d2ec
BH
3287/**
3288 * pci_set_vga_state - set VGA decode state on device and parents if requested
19eea630
RD
3289 * @dev: the PCI device
3290 * @decode: true = enable decoding, false = disable decoding
3291 * @command_bits: PCI_COMMAND_IO and/or PCI_COMMAND_MEMORY
3f37d622 3292 * @flags: traverse ancestors and change bridges
3448a19d 3293 * CHANGE_BRIDGE_ONLY / CHANGE_BRIDGE
deb2d2ec
BH
3294 */
3295int pci_set_vga_state(struct pci_dev *dev, bool decode,
3448a19d 3296 unsigned int command_bits, u32 flags)
deb2d2ec
BH
3297{
3298 struct pci_bus *bus;
3299 struct pci_dev *bridge;
3300 u16 cmd;
95a8b6ef 3301 int rc;
deb2d2ec 3302
3448a19d 3303 WARN_ON((flags & PCI_VGA_STATE_CHANGE_DECODES) & (command_bits & ~(PCI_COMMAND_IO|PCI_COMMAND_MEMORY)));
deb2d2ec 3304
95a8b6ef 3305 /* ARCH specific VGA enables */
3448a19d 3306 rc = pci_set_vga_state_arch(dev, decode, command_bits, flags);
95a8b6ef
MT
3307 if (rc)
3308 return rc;
3309
3448a19d
DA
3310 if (flags & PCI_VGA_STATE_CHANGE_DECODES) {
3311 pci_read_config_word(dev, PCI_COMMAND, &cmd);
3312 if (decode == true)
3313 cmd |= command_bits;
3314 else
3315 cmd &= ~command_bits;
3316 pci_write_config_word(dev, PCI_COMMAND, cmd);
3317 }
deb2d2ec 3318
3448a19d 3319 if (!(flags & PCI_VGA_STATE_CHANGE_BRIDGE))
deb2d2ec
BH
3320 return 0;
3321
3322 bus = dev->bus;
3323 while (bus) {
3324 bridge = bus->self;
3325 if (bridge) {
3326 pci_read_config_word(bridge, PCI_BRIDGE_CONTROL,
3327 &cmd);
3328 if (decode == true)
3329 cmd |= PCI_BRIDGE_CTL_VGA;
3330 else
3331 cmd &= ~PCI_BRIDGE_CTL_VGA;
3332 pci_write_config_word(bridge, PCI_BRIDGE_CONTROL,
3333 cmd);
3334 }
3335 bus = bus->parent;
3336 }
3337 return 0;
3338}
3339
32a9a682
YS
3340#define RESOURCE_ALIGNMENT_PARAM_SIZE COMMAND_LINE_SIZE
3341static char resource_alignment_param[RESOURCE_ALIGNMENT_PARAM_SIZE] = {0};
e9d1e492 3342static DEFINE_SPINLOCK(resource_alignment_lock);
32a9a682
YS
3343
3344/**
3345 * pci_specified_resource_alignment - get resource alignment specified by user.
3346 * @dev: the PCI device to get
3347 *
3348 * RETURNS: Resource alignment if it is specified.
3349 * Zero if it is not specified.
3350 */
3351resource_size_t pci_specified_resource_alignment(struct pci_dev *dev)
3352{
3353 int seg, bus, slot, func, align_order, count;
3354 resource_size_t align = 0;
3355 char *p;
3356
3357 spin_lock(&resource_alignment_lock);
3358 p = resource_alignment_param;
3359 while (*p) {
3360 count = 0;
3361 if (sscanf(p, "%d%n", &align_order, &count) == 1 &&
3362 p[count] == '@') {
3363 p += count + 1;
3364 } else {
3365 align_order = -1;
3366 }
3367 if (sscanf(p, "%x:%x:%x.%x%n",
3368 &seg, &bus, &slot, &func, &count) != 4) {
3369 seg = 0;
3370 if (sscanf(p, "%x:%x.%x%n",
3371 &bus, &slot, &func, &count) != 3) {
3372 /* Invalid format */
3373 printk(KERN_ERR "PCI: Can't parse resource_alignment parameter: %s\n",
3374 p);
3375 break;
3376 }
3377 }
3378 p += count;
3379 if (seg == pci_domain_nr(dev->bus) &&
3380 bus == dev->bus->number &&
3381 slot == PCI_SLOT(dev->devfn) &&
3382 func == PCI_FUNC(dev->devfn)) {
3383 if (align_order == -1) {
3384 align = PAGE_SIZE;
3385 } else {
3386 align = 1 << align_order;
3387 }
3388 /* Found */
3389 break;
3390 }
3391 if (*p != ';' && *p != ',') {
3392 /* End of param or invalid format */
3393 break;
3394 }
3395 p++;
3396 }
3397 spin_unlock(&resource_alignment_lock);
3398 return align;
3399}
3400
3401/**
3402 * pci_is_reassigndev - check if specified PCI is target device to reassign
3403 * @dev: the PCI device to check
3404 *
3405 * RETURNS: non-zero for PCI device is a target device to reassign,
3406 * or zero is not.
3407 */
3408int pci_is_reassigndev(struct pci_dev *dev)
3409{
3410 return (pci_specified_resource_alignment(dev) != 0);
3411}
3412
3413ssize_t pci_set_resource_alignment_param(const char *buf, size_t count)
3414{
3415 if (count > RESOURCE_ALIGNMENT_PARAM_SIZE - 1)
3416 count = RESOURCE_ALIGNMENT_PARAM_SIZE - 1;
3417 spin_lock(&resource_alignment_lock);
3418 strncpy(resource_alignment_param, buf, count);
3419 resource_alignment_param[count] = '\0';
3420 spin_unlock(&resource_alignment_lock);
3421 return count;
3422}
3423
3424ssize_t pci_get_resource_alignment_param(char *buf, size_t size)
3425{
3426 size_t count;
3427 spin_lock(&resource_alignment_lock);
3428 count = snprintf(buf, size, "%s", resource_alignment_param);
3429 spin_unlock(&resource_alignment_lock);
3430 return count;
3431}
3432
3433static ssize_t pci_resource_alignment_show(struct bus_type *bus, char *buf)
3434{
3435 return pci_get_resource_alignment_param(buf, PAGE_SIZE);
3436}
3437
3438static ssize_t pci_resource_alignment_store(struct bus_type *bus,
3439 const char *buf, size_t count)
3440{
3441 return pci_set_resource_alignment_param(buf, count);
3442}
3443
3444BUS_ATTR(resource_alignment, 0644, pci_resource_alignment_show,
3445 pci_resource_alignment_store);
3446
3447static int __init pci_resource_alignment_sysfs_init(void)
3448{
3449 return bus_create_file(&pci_bus_type,
3450 &bus_attr_resource_alignment);
3451}
3452
3453late_initcall(pci_resource_alignment_sysfs_init);
3454
32a2eea7
JG
3455static void __devinit pci_no_domains(void)
3456{
3457#ifdef CONFIG_PCI_DOMAINS
3458 pci_domains_supported = 0;
3459#endif
3460}
3461
0ef5f8f6
AP
3462/**
3463 * pci_ext_cfg_enabled - can we access extended PCI config space?
3464 * @dev: The PCI device of the root bridge.
3465 *
3466 * Returns 1 if we can access PCI extended config space (offsets
3467 * greater than 0xff). This is the default implementation. Architecture
3468 * implementations can override this.
3469 */
3470int __attribute__ ((weak)) pci_ext_cfg_avail(struct pci_dev *dev)
3471{
3472 return 1;
3473}
3474
2d1c8618
BH
3475void __weak pci_fixup_cardbus(struct pci_bus *bus)
3476{
3477}
3478EXPORT_SYMBOL(pci_fixup_cardbus);
3479
ad04d31e 3480static int __init pci_setup(char *str)
1da177e4
LT
3481{
3482 while (str) {
3483 char *k = strchr(str, ',');
3484 if (k)
3485 *k++ = 0;
3486 if (*str && (str = pcibios_setup(str)) && *str) {
309e57df
MW
3487 if (!strcmp(str, "nomsi")) {
3488 pci_no_msi();
7f785763
RD
3489 } else if (!strcmp(str, "noaer")) {
3490 pci_no_aer();
f483d392
RP
3491 } else if (!strncmp(str, "realloc", 7)) {
3492 pci_realloc();
32a2eea7
JG
3493 } else if (!strcmp(str, "nodomains")) {
3494 pci_no_domains();
4516a618
AN
3495 } else if (!strncmp(str, "cbiosize=", 9)) {
3496 pci_cardbus_io_size = memparse(str + 9, &str);
3497 } else if (!strncmp(str, "cbmemsize=", 10)) {
3498 pci_cardbus_mem_size = memparse(str + 10, &str);
32a9a682
YS
3499 } else if (!strncmp(str, "resource_alignment=", 19)) {
3500 pci_set_resource_alignment_param(str + 19,
3501 strlen(str + 19));
43c16408
AP
3502 } else if (!strncmp(str, "ecrc=", 5)) {
3503 pcie_ecrc_get_policy(str + 5);
28760489
EB
3504 } else if (!strncmp(str, "hpiosize=", 9)) {
3505 pci_hotplug_io_size = memparse(str + 9, &str);
3506 } else if (!strncmp(str, "hpmemsize=", 10)) {
3507 pci_hotplug_mem_size = memparse(str + 10, &str);
309e57df
MW
3508 } else {
3509 printk(KERN_ERR "PCI: Unknown option `%s'\n",
3510 str);
3511 }
1da177e4
LT
3512 }
3513 str = k;
3514 }
0637a70a 3515 return 0;
1da177e4 3516}
0637a70a 3517early_param("pci", pci_setup);
1da177e4 3518
0b62e13b 3519EXPORT_SYMBOL(pci_reenable_device);
b718989d
BH
3520EXPORT_SYMBOL(pci_enable_device_io);
3521EXPORT_SYMBOL(pci_enable_device_mem);
1da177e4 3522EXPORT_SYMBOL(pci_enable_device);
9ac7849e
TH
3523EXPORT_SYMBOL(pcim_enable_device);
3524EXPORT_SYMBOL(pcim_pin_device);
1da177e4 3525EXPORT_SYMBOL(pci_disable_device);
1da177e4
LT
3526EXPORT_SYMBOL(pci_find_capability);
3527EXPORT_SYMBOL(pci_bus_find_capability);
3528EXPORT_SYMBOL(pci_release_regions);
3529EXPORT_SYMBOL(pci_request_regions);
e8de1481 3530EXPORT_SYMBOL(pci_request_regions_exclusive);
1da177e4
LT
3531EXPORT_SYMBOL(pci_release_region);
3532EXPORT_SYMBOL(pci_request_region);
e8de1481 3533EXPORT_SYMBOL(pci_request_region_exclusive);
c87deff7
HS
3534EXPORT_SYMBOL(pci_release_selected_regions);
3535EXPORT_SYMBOL(pci_request_selected_regions);
e8de1481 3536EXPORT_SYMBOL(pci_request_selected_regions_exclusive);
1da177e4 3537EXPORT_SYMBOL(pci_set_master);
6a479079 3538EXPORT_SYMBOL(pci_clear_master);
1da177e4 3539EXPORT_SYMBOL(pci_set_mwi);
694625c0 3540EXPORT_SYMBOL(pci_try_set_mwi);
1da177e4 3541EXPORT_SYMBOL(pci_clear_mwi);
a04ce0ff 3542EXPORT_SYMBOL_GPL(pci_intx);
1da177e4
LT
3543EXPORT_SYMBOL(pci_assign_resource);
3544EXPORT_SYMBOL(pci_find_parent_resource);
c87deff7 3545EXPORT_SYMBOL(pci_select_bars);
1da177e4
LT
3546
3547EXPORT_SYMBOL(pci_set_power_state);
3548EXPORT_SYMBOL(pci_save_state);
3549EXPORT_SYMBOL(pci_restore_state);
e5899e1b 3550EXPORT_SYMBOL(pci_pme_capable);
5a6c9b60 3551EXPORT_SYMBOL(pci_pme_active);
0235c4fc 3552EXPORT_SYMBOL(pci_wake_from_d3);
e5899e1b 3553EXPORT_SYMBOL(pci_target_state);
404cc2d8
RW
3554EXPORT_SYMBOL(pci_prepare_to_sleep);
3555EXPORT_SYMBOL(pci_back_from_sleep);
f7bdd12d 3556EXPORT_SYMBOL_GPL(pci_set_pcie_reset_state);
This page took 0.794819 seconds and 5 git commands to generate.