blob: 9d2aa6366fd047622df85c4dcc56c6d0160a791e [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
Linus Torvalds1da177e2005-04-16 15:20:36 -07002 * 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>
David Brownell075c1772007-04-26 00:12:06 -070014#include <linux/pm.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070015#include <linux/module.h>
16#include <linux/spinlock.h>
Tim Schmielau4e57b682005-10-30 15:03:48 -080017#include <linux/string.h>
vignesh babu229f5af2007-08-13 18:23:14 +053018#include <linux/log2.h>
Shaohua Li7d715a62008-02-25 09:46:41 +080019#include <linux/pci-aspm.h>
Stephen Rothwellc300bd2fb2008-07-10 02:16:44 +020020#include <linux/pm_wakeup.h>
Sheng Yang8dd7f802008-10-21 17:38:25 +080021#include <linux/interrupt.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070022#include <asm/dma.h> /* isa_dma_bridge_buggy */
Greg KHbc56b9e2005-04-08 14:53:31 +090023#include "pci.h"
Linus Torvalds1da177e2005-04-16 15:20:36 -070024
Kristen Carlson Accardiffadcc22006-07-12 08:59:00 -070025unsigned int pci_pm_d3_delay = 10;
Linus Torvalds1da177e2005-04-16 15:20:36 -070026
Jeff Garzik32a2eea2007-10-11 16:57:27 -040027#ifdef CONFIG_PCI_DOMAINS
28int pci_domains_supported = 1;
29#endif
30
Atsushi Nemoto4516a612007-02-05 16:36:06 -080031#define DEFAULT_CARDBUS_IO_SIZE (256)
32#define DEFAULT_CARDBUS_MEM_SIZE (64*1024*1024)
33/* pci=cbmemsize=nnM,cbiosize=nn can override this */
34unsigned long pci_cardbus_io_size = DEFAULT_CARDBUS_IO_SIZE;
35unsigned long pci_cardbus_mem_size = DEFAULT_CARDBUS_MEM_SIZE;
36
Linus Torvalds1da177e2005-04-16 15:20:36 -070037/**
38 * pci_bus_max_busnr - returns maximum PCI bus number of given bus' children
39 * @bus: pointer to PCI bus structure to search
40 *
41 * Given a PCI bus, returns the highest PCI bus number present in the set
42 * including the given PCI bus and its list of child PCI buses.
43 */
Sam Ravnborg96bde062007-03-26 21:53:30 -080044unsigned char pci_bus_max_busnr(struct pci_bus* bus)
Linus Torvalds1da177e2005-04-16 15:20:36 -070045{
46 struct list_head *tmp;
47 unsigned char max, n;
48
Kristen Accardib82db5c2006-01-17 16:56:56 -080049 max = bus->subordinate;
Linus Torvalds1da177e2005-04-16 15:20:36 -070050 list_for_each(tmp, &bus->children) {
51 n = pci_bus_max_busnr(pci_bus_b(tmp));
52 if(n > max)
53 max = n;
54 }
55 return max;
56}
Kristen Accardib82db5c2006-01-17 16:56:56 -080057EXPORT_SYMBOL_GPL(pci_bus_max_busnr);
Linus Torvalds1da177e2005-04-16 15:20:36 -070058
Andrew Morton1684f5d2008-12-01 14:30:30 -080059#ifdef CONFIG_HAS_IOMEM
60void __iomem *pci_ioremap_bar(struct pci_dev *pdev, int bar)
61{
62 /*
63 * Make sure the BAR is actually a memory resource, not an IO resource
64 */
65 if (!(pci_resource_flags(pdev, bar) & IORESOURCE_MEM)) {
66 WARN_ON(1);
67 return NULL;
68 }
69 return ioremap_nocache(pci_resource_start(pdev, bar),
70 pci_resource_len(pdev, bar));
71}
72EXPORT_SYMBOL_GPL(pci_ioremap_bar);
73#endif
74
Kristen Accardib82db5c2006-01-17 16:56:56 -080075#if 0
Linus Torvalds1da177e2005-04-16 15:20:36 -070076/**
77 * pci_max_busnr - returns maximum PCI bus number
78 *
79 * Returns the highest PCI bus number present in the system global list of
80 * PCI buses.
81 */
82unsigned char __devinit
83pci_max_busnr(void)
84{
85 struct pci_bus *bus = NULL;
86 unsigned char max, n;
87
88 max = 0;
89 while ((bus = pci_find_next_bus(bus)) != NULL) {
90 n = pci_bus_max_busnr(bus);
91 if(n > max)
92 max = n;
93 }
94 return max;
95}
96
Adrian Bunk54c762f2005-12-22 01:08:52 +010097#endif /* 0 */
98
Michael Ellerman687d5fe2006-11-22 18:26:18 +110099#define PCI_FIND_CAP_TTL 48
100
101static int __pci_find_next_cap_ttl(struct pci_bus *bus, unsigned int devfn,
102 u8 pos, int cap, int *ttl)
Roland Dreier24a4e372005-10-28 17:35:34 -0700103{
104 u8 id;
Roland Dreier24a4e372005-10-28 17:35:34 -0700105
Michael Ellerman687d5fe2006-11-22 18:26:18 +1100106 while ((*ttl)--) {
Roland Dreier24a4e372005-10-28 17:35:34 -0700107 pci_bus_read_config_byte(bus, devfn, pos, &pos);
108 if (pos < 0x40)
109 break;
110 pos &= ~3;
111 pci_bus_read_config_byte(bus, devfn, pos + PCI_CAP_LIST_ID,
112 &id);
113 if (id == 0xff)
114 break;
115 if (id == cap)
116 return pos;
117 pos += PCI_CAP_LIST_NEXT;
118 }
119 return 0;
120}
121
Michael Ellerman687d5fe2006-11-22 18:26:18 +1100122static int __pci_find_next_cap(struct pci_bus *bus, unsigned int devfn,
123 u8 pos, int cap)
124{
125 int ttl = PCI_FIND_CAP_TTL;
126
127 return __pci_find_next_cap_ttl(bus, devfn, pos, cap, &ttl);
128}
129
Roland Dreier24a4e372005-10-28 17:35:34 -0700130int pci_find_next_capability(struct pci_dev *dev, u8 pos, int cap)
131{
132 return __pci_find_next_cap(dev->bus, dev->devfn,
133 pos + PCI_CAP_LIST_NEXT, cap);
134}
135EXPORT_SYMBOL_GPL(pci_find_next_capability);
136
Michael Ellermand3bac112006-11-22 18:26:16 +1100137static int __pci_bus_find_cap_start(struct pci_bus *bus,
138 unsigned int devfn, u8 hdr_type)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700139{
140 u16 status;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700141
142 pci_bus_read_config_word(bus, devfn, PCI_STATUS, &status);
143 if (!(status & PCI_STATUS_CAP_LIST))
144 return 0;
145
146 switch (hdr_type) {
147 case PCI_HEADER_TYPE_NORMAL:
148 case PCI_HEADER_TYPE_BRIDGE:
Michael Ellermand3bac112006-11-22 18:26:16 +1100149 return PCI_CAPABILITY_LIST;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700150 case PCI_HEADER_TYPE_CARDBUS:
Michael Ellermand3bac112006-11-22 18:26:16 +1100151 return PCI_CB_CAPABILITY_LIST;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700152 default:
153 return 0;
154 }
Michael Ellermand3bac112006-11-22 18:26:16 +1100155
156 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700157}
158
159/**
160 * pci_find_capability - query for devices' capabilities
161 * @dev: PCI device to query
162 * @cap: capability code
163 *
164 * Tell if a device supports a given PCI capability.
165 * Returns the address of the requested capability structure within the
166 * device's PCI configuration space or 0 in case the device does not
167 * support it. Possible values for @cap:
168 *
169 * %PCI_CAP_ID_PM Power Management
170 * %PCI_CAP_ID_AGP Accelerated Graphics Port
171 * %PCI_CAP_ID_VPD Vital Product Data
172 * %PCI_CAP_ID_SLOTID Slot Identification
173 * %PCI_CAP_ID_MSI Message Signalled Interrupts
174 * %PCI_CAP_ID_CHSWP CompactPCI HotSwap
175 * %PCI_CAP_ID_PCIX PCI-X
176 * %PCI_CAP_ID_EXP PCI Express
177 */
178int pci_find_capability(struct pci_dev *dev, int cap)
179{
Michael Ellermand3bac112006-11-22 18:26:16 +1100180 int pos;
181
182 pos = __pci_bus_find_cap_start(dev->bus, dev->devfn, dev->hdr_type);
183 if (pos)
184 pos = __pci_find_next_cap(dev->bus, dev->devfn, pos, cap);
185
186 return pos;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700187}
188
189/**
190 * pci_bus_find_capability - query for devices' capabilities
191 * @bus: the PCI bus to query
192 * @devfn: PCI device to query
193 * @cap: capability code
194 *
195 * Like pci_find_capability() but works for pci devices that do not have a
196 * pci_dev structure set up yet.
197 *
198 * Returns the address of the requested capability structure within the
199 * device's PCI configuration space or 0 in case the device does not
200 * support it.
201 */
202int pci_bus_find_capability(struct pci_bus *bus, unsigned int devfn, int cap)
203{
Michael Ellermand3bac112006-11-22 18:26:16 +1100204 int pos;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700205 u8 hdr_type;
206
207 pci_bus_read_config_byte(bus, devfn, PCI_HEADER_TYPE, &hdr_type);
208
Michael Ellermand3bac112006-11-22 18:26:16 +1100209 pos = __pci_bus_find_cap_start(bus, devfn, hdr_type & 0x7f);
210 if (pos)
211 pos = __pci_find_next_cap(bus, devfn, pos, cap);
212
213 return pos;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700214}
215
216/**
217 * pci_find_ext_capability - Find an extended capability
218 * @dev: PCI device to query
219 * @cap: capability code
220 *
221 * Returns the address of the requested extended capability structure
222 * within the device's PCI configuration space or 0 if the device does
223 * not support it. Possible values for @cap:
224 *
225 * %PCI_EXT_CAP_ID_ERR Advanced Error Reporting
226 * %PCI_EXT_CAP_ID_VC Virtual Channel
227 * %PCI_EXT_CAP_ID_DSN Device Serial Number
228 * %PCI_EXT_CAP_ID_PWR Power Budgeting
229 */
230int pci_find_ext_capability(struct pci_dev *dev, int cap)
231{
232 u32 header;
Zhao, Yu557848c2008-10-13 19:18:07 +0800233 int ttl;
234 int pos = PCI_CFG_SPACE_SIZE;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700235
Zhao, Yu557848c2008-10-13 19:18:07 +0800236 /* minimum 8 bytes per capability */
237 ttl = (PCI_CFG_SPACE_EXP_SIZE - PCI_CFG_SPACE_SIZE) / 8;
238
239 if (dev->cfg_size <= PCI_CFG_SPACE_SIZE)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700240 return 0;
241
242 if (pci_read_config_dword(dev, pos, &header) != PCIBIOS_SUCCESSFUL)
243 return 0;
244
245 /*
246 * If we have no capabilities, this is indicated by cap ID,
247 * cap version and next pointer all being 0.
248 */
249 if (header == 0)
250 return 0;
251
252 while (ttl-- > 0) {
253 if (PCI_EXT_CAP_ID(header) == cap)
254 return pos;
255
256 pos = PCI_EXT_CAP_NEXT(header);
Zhao, Yu557848c2008-10-13 19:18:07 +0800257 if (pos < PCI_CFG_SPACE_SIZE)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700258 break;
259
260 if (pci_read_config_dword(dev, pos, &header) != PCIBIOS_SUCCESSFUL)
261 break;
262 }
263
264 return 0;
265}
Brice Goglin3a720d72006-05-23 06:10:01 -0400266EXPORT_SYMBOL_GPL(pci_find_ext_capability);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700267
Michael Ellerman687d5fe2006-11-22 18:26:18 +1100268static int __pci_find_next_ht_cap(struct pci_dev *dev, int pos, int ht_cap)
269{
270 int rc, ttl = PCI_FIND_CAP_TTL;
271 u8 cap, mask;
272
273 if (ht_cap == HT_CAPTYPE_SLAVE || ht_cap == HT_CAPTYPE_HOST)
274 mask = HT_3BIT_CAP_MASK;
275 else
276 mask = HT_5BIT_CAP_MASK;
277
278 pos = __pci_find_next_cap_ttl(dev->bus, dev->devfn, pos,
279 PCI_CAP_ID_HT, &ttl);
280 while (pos) {
281 rc = pci_read_config_byte(dev, pos + 3, &cap);
282 if (rc != PCIBIOS_SUCCESSFUL)
283 return 0;
284
285 if ((cap & mask) == ht_cap)
286 return pos;
287
Brice Goglin47a4d5b2007-01-10 23:15:29 -0800288 pos = __pci_find_next_cap_ttl(dev->bus, dev->devfn,
289 pos + PCI_CAP_LIST_NEXT,
Michael Ellerman687d5fe2006-11-22 18:26:18 +1100290 PCI_CAP_ID_HT, &ttl);
291 }
292
293 return 0;
294}
295/**
296 * pci_find_next_ht_capability - query a device's Hypertransport capabilities
297 * @dev: PCI device to query
298 * @pos: Position from which to continue searching
299 * @ht_cap: Hypertransport capability code
300 *
301 * To be used in conjunction with pci_find_ht_capability() to search for
302 * all capabilities matching @ht_cap. @pos should always be a value returned
303 * from pci_find_ht_capability().
304 *
305 * NB. To be 100% safe against broken PCI devices, the caller should take
306 * steps to avoid an infinite loop.
307 */
308int pci_find_next_ht_capability(struct pci_dev *dev, int pos, int ht_cap)
309{
310 return __pci_find_next_ht_cap(dev, pos + PCI_CAP_LIST_NEXT, ht_cap);
311}
312EXPORT_SYMBOL_GPL(pci_find_next_ht_capability);
313
314/**
315 * pci_find_ht_capability - query a device's Hypertransport capabilities
316 * @dev: PCI device to query
317 * @ht_cap: Hypertransport capability code
318 *
319 * Tell if a device supports a given Hypertransport capability.
320 * Returns an address within the device's PCI configuration space
321 * or 0 in case the device does not support the request capability.
322 * The address points to the PCI capability, of type PCI_CAP_ID_HT,
323 * which has a Hypertransport capability matching @ht_cap.
324 */
325int pci_find_ht_capability(struct pci_dev *dev, int ht_cap)
326{
327 int pos;
328
329 pos = __pci_bus_find_cap_start(dev->bus, dev->devfn, dev->hdr_type);
330 if (pos)
331 pos = __pci_find_next_ht_cap(dev, pos, ht_cap);
332
333 return pos;
334}
335EXPORT_SYMBOL_GPL(pci_find_ht_capability);
336
Linus Torvalds1da177e2005-04-16 15:20:36 -0700337/**
338 * pci_find_parent_resource - return resource region of parent bus of given region
339 * @dev: PCI device structure contains resources to be searched
340 * @res: child resource record for which parent is sought
341 *
342 * For given resource region of given device, return the resource
343 * region of parent bus the given region is contained in or where
344 * it should be allocated from.
345 */
346struct resource *
347pci_find_parent_resource(const struct pci_dev *dev, struct resource *res)
348{
349 const struct pci_bus *bus = dev->bus;
350 int i;
351 struct resource *best = NULL;
352
353 for(i = 0; i < PCI_BUS_NUM_RESOURCES; i++) {
354 struct resource *r = bus->resource[i];
355 if (!r)
356 continue;
357 if (res->start && !(res->start >= r->start && res->end <= r->end))
358 continue; /* Not contained */
359 if ((res->flags ^ r->flags) & (IORESOURCE_IO | IORESOURCE_MEM))
360 continue; /* Wrong type */
361 if (!((res->flags ^ r->flags) & IORESOURCE_PREFETCH))
362 return r; /* Exact match */
363 if ((res->flags & IORESOURCE_PREFETCH) && !(r->flags & IORESOURCE_PREFETCH))
364 best = r; /* Approximating prefetchable by non-prefetchable */
365 }
366 return best;
367}
368
369/**
John W. Linville064b53d2005-07-27 10:19:44 -0400370 * pci_restore_bars - restore a devices BAR values (e.g. after wake-up)
371 * @dev: PCI device to have its BARs restored
372 *
373 * Restore the BAR values for a given device, so as to make it
374 * accessible by its driver.
375 */
Adrian Bunkad668592007-10-27 03:06:22 +0200376static void
John W. Linville064b53d2005-07-27 10:19:44 -0400377pci_restore_bars(struct pci_dev *dev)
378{
Yu Zhaobc5f5a82008-11-22 02:40:00 +0800379 int i;
John W. Linville064b53d2005-07-27 10:19:44 -0400380
Yu Zhaobc5f5a82008-11-22 02:40:00 +0800381 for (i = 0; i < PCI_BRIDGE_RESOURCES; i++)
Yu Zhao14add802008-11-22 02:38:52 +0800382 pci_update_resource(dev, i);
John W. Linville064b53d2005-07-27 10:19:44 -0400383}
384
Rafael J. Wysocki961d9122008-07-07 03:32:02 +0200385static struct pci_platform_pm_ops *pci_platform_pm;
386
387int pci_set_platform_pm(struct pci_platform_pm_ops *ops)
388{
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +0200389 if (!ops->is_manageable || !ops->set_state || !ops->choose_state
390 || !ops->sleep_wake || !ops->can_wakeup)
Rafael J. Wysocki961d9122008-07-07 03:32:02 +0200391 return -EINVAL;
392 pci_platform_pm = ops;
393 return 0;
394}
395
396static inline bool platform_pci_power_manageable(struct pci_dev *dev)
397{
398 return pci_platform_pm ? pci_platform_pm->is_manageable(dev) : false;
399}
400
401static inline int platform_pci_set_power_state(struct pci_dev *dev,
402 pci_power_t t)
403{
404 return pci_platform_pm ? pci_platform_pm->set_state(dev, t) : -ENOSYS;
405}
406
407static inline pci_power_t platform_pci_choose_state(struct pci_dev *dev)
408{
409 return pci_platform_pm ?
410 pci_platform_pm->choose_state(dev) : PCI_POWER_ERROR;
411}
Randy Dunlap8f7020d2005-10-23 11:57:38 -0700412
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +0200413static inline bool platform_pci_can_wakeup(struct pci_dev *dev)
414{
415 return pci_platform_pm ? pci_platform_pm->can_wakeup(dev) : false;
416}
417
418static inline int platform_pci_sleep_wake(struct pci_dev *dev, bool enable)
419{
420 return pci_platform_pm ?
421 pci_platform_pm->sleep_wake(dev, enable) : -ENODEV;
422}
423
John W. Linville064b53d2005-07-27 10:19:44 -0400424/**
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200425 * pci_raw_set_power_state - Use PCI PM registers to set the power state of
426 * given PCI device
427 * @dev: PCI device to handle.
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200428 * @state: PCI power state (D0, D1, D2, D3hot) to put the device into.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700429 *
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200430 * RETURN VALUE:
431 * -EINVAL if the requested state is invalid.
432 * -EIO if device does not support PCI PM or its PM capabilities register has a
433 * wrong version, or device doesn't support the requested state.
434 * 0 if device already is in the requested state.
435 * 0 if device's power state has been successfully changed.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700436 */
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200437static int
Rafael J. Wysocki337001b2008-07-07 03:36:24 +0200438pci_raw_set_power_state(struct pci_dev *dev, pci_power_t state)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700439{
Rafael J. Wysocki337001b2008-07-07 03:36:24 +0200440 u16 pmcsr;
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200441 bool need_restore = false;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700442
Rafael J. Wysocki337001b2008-07-07 03:36:24 +0200443 if (!dev->pm_cap)
Andrew Lunncca03de2007-07-09 11:55:58 -0700444 return -EIO;
445
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200446 if (state < PCI_D0 || state > PCI_D3hot)
447 return -EINVAL;
448
Linus Torvalds1da177e2005-04-16 15:20:36 -0700449 /* Validate current state:
450 * Can enter D0 from any state, but if we can only go deeper
451 * to sleep if we're already in a low power state
452 */
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200453 if (dev->current_state == state) {
454 /* we're already there */
455 return 0;
456 } else if (state != PCI_D0 && dev->current_state <= PCI_D3cold
457 && dev->current_state > state) {
Bjorn Helgaas80ccba12008-06-13 10:52:11 -0600458 dev_err(&dev->dev, "invalid power transition "
459 "(from state %d to %d)\n", dev->current_state, state);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700460 return -EINVAL;
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200461 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700462
Linus Torvalds1da177e2005-04-16 15:20:36 -0700463 /* check if this device supports the desired state */
Rafael J. Wysocki337001b2008-07-07 03:36:24 +0200464 if ((state == PCI_D1 && !dev->d1_support)
465 || (state == PCI_D2 && !dev->d2_support))
Daniel Ritz3fe9d192005-08-17 15:32:19 -0700466 return -EIO;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700467
Rafael J. Wysocki337001b2008-07-07 03:36:24 +0200468 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr);
John W. Linville064b53d2005-07-27 10:19:44 -0400469
John W. Linville32a36582005-09-14 09:52:42 -0400470 /* If we're (effectively) in D3, force entire word to 0.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700471 * This doesn't affect PME_Status, disables PME_En, and
472 * sets PowerState to 0.
473 */
John W. Linville32a36582005-09-14 09:52:42 -0400474 switch (dev->current_state) {
John W. Linvilled3535fb2005-09-28 17:50:51 -0400475 case PCI_D0:
476 case PCI_D1:
477 case PCI_D2:
478 pmcsr &= ~PCI_PM_CTRL_STATE_MASK;
479 pmcsr |= state;
480 break;
John W. Linville32a36582005-09-14 09:52:42 -0400481 case PCI_UNKNOWN: /* Boot-up */
482 if ((pmcsr & PCI_PM_CTRL_STATE_MASK) == PCI_D3hot
483 && !(pmcsr & PCI_PM_CTRL_NO_SOFT_RESET))
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200484 need_restore = true;
John W. Linville32a36582005-09-14 09:52:42 -0400485 /* Fall-through: force to D0 */
John W. Linville32a36582005-09-14 09:52:42 -0400486 default:
John W. Linvilled3535fb2005-09-28 17:50:51 -0400487 pmcsr = 0;
John W. Linville32a36582005-09-14 09:52:42 -0400488 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700489 }
490
491 /* enter specified state */
Rafael J. Wysocki337001b2008-07-07 03:36:24 +0200492 pci_write_config_word(dev, dev->pm_cap + PCI_PM_CTRL, pmcsr);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700493
494 /* Mandatory power management transition delays */
495 /* see PCI PM 1.1 5.6.1 table 18 */
496 if (state == PCI_D3hot || dev->current_state == PCI_D3hot)
Kristen Carlson Accardiffadcc22006-07-12 08:59:00 -0700497 msleep(pci_pm_d3_delay);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700498 else if (state == PCI_D2 || dev->current_state == PCI_D2)
499 udelay(200);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700500
David Shaohua Lib9131002005-03-19 00:16:18 -0500501 dev->current_state = state;
John W. Linville064b53d2005-07-27 10:19:44 -0400502
503 /* According to section 5.4.1 of the "PCI BUS POWER MANAGEMENT
504 * INTERFACE SPECIFICATION, REV. 1.2", a device transitioning
505 * from D3hot to D0 _may_ perform an internal reset, thereby
506 * going to "D0 Uninitialized" rather than "D0 Initialized".
507 * For example, at least some versions of the 3c905B and the
508 * 3c556B exhibit this behaviour.
509 *
510 * At least some laptop BIOSen (e.g. the Thinkpad T21) leave
511 * devices in a D3hot state at boot. Consequently, we need to
512 * restore at least the BARs so that the device will be
513 * accessible to its driver.
514 */
515 if (need_restore)
516 pci_restore_bars(dev);
517
Shaohua Li7d715a62008-02-25 09:46:41 +0800518 if (dev->bus->self)
519 pcie_aspm_pm_state_change(dev->bus->self);
520
Linus Torvalds1da177e2005-04-16 15:20:36 -0700521 return 0;
522}
523
524/**
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200525 * pci_update_current_state - Read PCI power state of given device from its
526 * PCI PM registers and cache it
527 * @dev: PCI device to handle.
Rafael J. Wysockif06fc0b2008-12-27 16:30:52 +0100528 * @state: State to cache in case the device doesn't have the PM capability
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200529 */
Rafael J. Wysockif06fc0b2008-12-27 16:30:52 +0100530static void pci_update_current_state(struct pci_dev *dev, pci_power_t state)
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200531{
Rafael J. Wysocki337001b2008-07-07 03:36:24 +0200532 if (dev->pm_cap) {
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200533 u16 pmcsr;
534
Rafael J. Wysocki337001b2008-07-07 03:36:24 +0200535 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr);
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200536 dev->current_state = (pmcsr & PCI_PM_CTRL_STATE_MASK);
Rafael J. Wysockif06fc0b2008-12-27 16:30:52 +0100537 } else {
538 dev->current_state = state;
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200539 }
540}
541
542/**
543 * pci_set_power_state - Set the power state of a PCI device
544 * @dev: PCI device to handle.
545 * @state: PCI power state (D0, D1, D2, D3hot) to put the device into.
546 *
547 * Transition a device to a new power state, using the platform formware and/or
548 * the device's PCI PM registers.
549 *
550 * RETURN VALUE:
551 * -EINVAL if the requested state is invalid.
552 * -EIO if device does not support PCI PM or its PM capabilities register has a
553 * wrong version, or device doesn't support the requested state.
554 * 0 if device already is in the requested state.
555 * 0 if device's power state has been successfully changed.
556 */
557int pci_set_power_state(struct pci_dev *dev, pci_power_t state)
558{
Rafael J. Wysocki337001b2008-07-07 03:36:24 +0200559 int error;
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200560
561 /* bound the state we're entering */
562 if (state > PCI_D3hot)
563 state = PCI_D3hot;
564 else if (state < PCI_D0)
565 state = PCI_D0;
566 else if ((state == PCI_D1 || state == PCI_D2) && pci_no_d1d2(dev))
567 /*
568 * If the device or the parent bridge do not support PCI PM,
569 * ignore the request if we're doing anything other than putting
570 * it into D0 (which would only happen on boot).
571 */
572 return 0;
573
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200574 if (state == PCI_D0 && platform_pci_power_manageable(dev)) {
575 /*
576 * Allow the platform to change the state, for example via ACPI
577 * _PR0, _PS0 and some such, but do not trust it.
578 */
579 int ret = platform_pci_set_power_state(dev, PCI_D0);
580 if (!ret)
Rafael J. Wysockif06fc0b2008-12-27 16:30:52 +0100581 pci_update_current_state(dev, PCI_D0);
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200582 }
Alan Cox979b1792008-07-24 17:18:38 +0100583 /* This device is quirked not to be put into D3, so
584 don't put it in D3 */
585 if (state == PCI_D3hot && (dev->dev_flags & PCI_DEV_FLAGS_NO_D3))
586 return 0;
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200587
Rafael J. Wysocki337001b2008-07-07 03:36:24 +0200588 error = pci_raw_set_power_state(dev, state);
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200589
590 if (state > PCI_D0 && platform_pci_power_manageable(dev)) {
591 /* Allow the platform to finalize the transition */
592 int ret = platform_pci_set_power_state(dev, state);
593 if (!ret) {
Rafael J. Wysockif06fc0b2008-12-27 16:30:52 +0100594 pci_update_current_state(dev, state);
Rafael J. Wysocki44e4e662008-07-07 03:32:52 +0200595 error = 0;
596 }
597 }
598
599 return error;
600}
601
602/**
Linus Torvalds1da177e2005-04-16 15:20:36 -0700603 * pci_choose_state - Choose the power state of a PCI device
604 * @dev: PCI device to be suspended
605 * @state: target sleep state for the whole system. This is the value
606 * that is passed to suspend() function.
607 *
608 * Returns PCI power state suitable for given device and given system
609 * message.
610 */
611
612pci_power_t pci_choose_state(struct pci_dev *dev, pm_message_t state)
613{
Shaohua Liab826ca2007-07-20 10:03:22 +0800614 pci_power_t ret;
David Shaohua Li0f644742005-03-19 00:15:48 -0500615
Linus Torvalds1da177e2005-04-16 15:20:36 -0700616 if (!pci_find_capability(dev, PCI_CAP_ID_PM))
617 return PCI_D0;
618
Rafael J. Wysocki961d9122008-07-07 03:32:02 +0200619 ret = platform_pci_choose_state(dev);
620 if (ret != PCI_POWER_ERROR)
621 return ret;
Pavel Machekca078ba2005-09-03 15:56:57 -0700622
623 switch (state.event) {
624 case PM_EVENT_ON:
625 return PCI_D0;
626 case PM_EVENT_FREEZE:
David Brownellb887d2e2006-08-14 23:11:05 -0700627 case PM_EVENT_PRETHAW:
628 /* REVISIT both freeze and pre-thaw "should" use D0 */
Pavel Machekca078ba2005-09-03 15:56:57 -0700629 case PM_EVENT_SUSPEND:
Rafael J. Wysocki3a2d5b72008-02-23 19:13:25 +0100630 case PM_EVENT_HIBERNATE:
Pavel Machekca078ba2005-09-03 15:56:57 -0700631 return PCI_D3hot;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700632 default:
Bjorn Helgaas80ccba12008-06-13 10:52:11 -0600633 dev_info(&dev->dev, "unrecognized suspend event %d\n",
634 state.event);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700635 BUG();
636 }
637 return PCI_D0;
638}
639
640EXPORT_SYMBOL(pci_choose_state);
641
Michael S. Tsirkinb56a5a22006-08-21 16:22:22 +0300642static int pci_save_pcie_state(struct pci_dev *dev)
643{
644 int pos, i = 0;
645 struct pci_cap_saved_state *save_state;
646 u16 *cap;
647
648 pos = pci_find_capability(dev, PCI_CAP_ID_EXP);
649 if (pos <= 0)
650 return 0;
651
Eric W. Biederman9f355752007-03-08 13:06:13 -0700652 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_EXP);
Michael S. Tsirkinb56a5a22006-08-21 16:22:22 +0300653 if (!save_state) {
Rafael J. Wysocki63f48982008-12-07 22:02:58 +0100654 dev_err(&dev->dev, "buffer not found in %s\n", __FUNCTION__);
Michael S. Tsirkinb56a5a22006-08-21 16:22:22 +0300655 return -ENOMEM;
656 }
657 cap = (u16 *)&save_state->data[0];
658
659 pci_read_config_word(dev, pos + PCI_EXP_DEVCTL, &cap[i++]);
660 pci_read_config_word(dev, pos + PCI_EXP_LNKCTL, &cap[i++]);
661 pci_read_config_word(dev, pos + PCI_EXP_SLTCTL, &cap[i++]);
662 pci_read_config_word(dev, pos + PCI_EXP_RTCTL, &cap[i++]);
Rafael J. Wysocki63f48982008-12-07 22:02:58 +0100663
Michael S. Tsirkinb56a5a22006-08-21 16:22:22 +0300664 return 0;
665}
666
667static void pci_restore_pcie_state(struct pci_dev *dev)
668{
669 int i = 0, pos;
670 struct pci_cap_saved_state *save_state;
671 u16 *cap;
672
673 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_EXP);
674 pos = pci_find_capability(dev, PCI_CAP_ID_EXP);
675 if (!save_state || pos <= 0)
676 return;
677 cap = (u16 *)&save_state->data[0];
678
679 pci_write_config_word(dev, pos + PCI_EXP_DEVCTL, cap[i++]);
680 pci_write_config_word(dev, pos + PCI_EXP_LNKCTL, cap[i++]);
681 pci_write_config_word(dev, pos + PCI_EXP_SLTCTL, cap[i++]);
682 pci_write_config_word(dev, pos + PCI_EXP_RTCTL, cap[i++]);
Michael S. Tsirkinb56a5a22006-08-21 16:22:22 +0300683}
684
Stephen Hemmingercc692a52006-11-08 16:17:15 -0800685
686static int pci_save_pcix_state(struct pci_dev *dev)
687{
Rafael J. Wysocki63f48982008-12-07 22:02:58 +0100688 int pos;
Stephen Hemmingercc692a52006-11-08 16:17:15 -0800689 struct pci_cap_saved_state *save_state;
Stephen Hemmingercc692a52006-11-08 16:17:15 -0800690
691 pos = pci_find_capability(dev, PCI_CAP_ID_PCIX);
692 if (pos <= 0)
693 return 0;
694
Shaohua Lif34303d2007-12-18 09:56:47 +0800695 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_PCIX);
Stephen Hemmingercc692a52006-11-08 16:17:15 -0800696 if (!save_state) {
Rafael J. Wysocki63f48982008-12-07 22:02:58 +0100697 dev_err(&dev->dev, "buffer not found in %s\n", __FUNCTION__);
Stephen Hemmingercc692a52006-11-08 16:17:15 -0800698 return -ENOMEM;
699 }
Stephen Hemmingercc692a52006-11-08 16:17:15 -0800700
Rafael J. Wysocki63f48982008-12-07 22:02:58 +0100701 pci_read_config_word(dev, pos + PCI_X_CMD, (u16 *)save_state->data);
702
Stephen Hemmingercc692a52006-11-08 16:17:15 -0800703 return 0;
704}
705
706static void pci_restore_pcix_state(struct pci_dev *dev)
707{
708 int i = 0, pos;
709 struct pci_cap_saved_state *save_state;
710 u16 *cap;
711
712 save_state = pci_find_saved_cap(dev, PCI_CAP_ID_PCIX);
713 pos = pci_find_capability(dev, PCI_CAP_ID_PCIX);
714 if (!save_state || pos <= 0)
715 return;
716 cap = (u16 *)&save_state->data[0];
717
718 pci_write_config_word(dev, pos + PCI_X_CMD, cap[i++]);
Stephen Hemmingercc692a52006-11-08 16:17:15 -0800719}
720
721
Linus Torvalds1da177e2005-04-16 15:20:36 -0700722/**
723 * pci_save_state - save the PCI configuration space of a device before suspending
724 * @dev: - PCI device that we're dealing with
Linus Torvalds1da177e2005-04-16 15:20:36 -0700725 */
726int
727pci_save_state(struct pci_dev *dev)
728{
729 int i;
730 /* XXX: 100% dword access ok here? */
731 for (i = 0; i < 16; i++)
732 pci_read_config_dword(dev, i * 4,&dev->saved_config_space[i]);
Michael S. Tsirkinb56a5a22006-08-21 16:22:22 +0300733 if ((i = pci_save_pcie_state(dev)) != 0)
734 return i;
Stephen Hemmingercc692a52006-11-08 16:17:15 -0800735 if ((i = pci_save_pcix_state(dev)) != 0)
736 return i;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700737 return 0;
738}
739
740/**
741 * pci_restore_state - Restore the saved state of a PCI device
742 * @dev: - PCI device that we're dealing with
Linus Torvalds1da177e2005-04-16 15:20:36 -0700743 */
744int
745pci_restore_state(struct pci_dev *dev)
746{
747 int i;
Al Virob4482a42007-10-14 19:35:40 +0100748 u32 val;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700749
Michael S. Tsirkinb56a5a22006-08-21 16:22:22 +0300750 /* PCI Express register must be restored first */
751 pci_restore_pcie_state(dev);
752
Yu, Luming8b8c8d22006-04-25 00:00:34 -0700753 /*
754 * The Base Address register should be programmed before the command
755 * register(s)
756 */
757 for (i = 15; i >= 0; i--) {
Dave Jones04d9c1a2006-04-18 21:06:51 -0700758 pci_read_config_dword(dev, i * 4, &val);
759 if (val != dev->saved_config_space[i]) {
Bjorn Helgaas80ccba12008-06-13 10:52:11 -0600760 dev_printk(KERN_DEBUG, &dev->dev, "restoring config "
761 "space at offset %#x (was %#x, writing %#x)\n",
762 i, val, (int)dev->saved_config_space[i]);
Dave Jones04d9c1a2006-04-18 21:06:51 -0700763 pci_write_config_dword(dev,i * 4,
764 dev->saved_config_space[i]);
765 }
766 }
Stephen Hemmingercc692a52006-11-08 16:17:15 -0800767 pci_restore_pcix_state(dev);
Shaohua Li41017f02006-02-08 17:11:38 +0800768 pci_restore_msi_state(dev);
Michael Ellerman8fed4b62007-01-25 19:34:08 +1100769
Linus Torvalds1da177e2005-04-16 15:20:36 -0700770 return 0;
771}
772
Hidetoshi Seto38cc1302006-12-18 10:30:00 +0900773static int do_pci_enable_device(struct pci_dev *dev, int bars)
774{
775 int err;
776
777 err = pci_set_power_state(dev, PCI_D0);
778 if (err < 0 && err != -EIO)
779 return err;
780 err = pcibios_enable_device(dev, bars);
781 if (err < 0)
782 return err;
783 pci_fixup_device(pci_fixup_enable, dev);
784
785 return 0;
786}
787
788/**
Tejun Heo0b62e132007-07-27 14:43:35 +0900789 * pci_reenable_device - Resume abandoned device
Hidetoshi Seto38cc1302006-12-18 10:30:00 +0900790 * @dev: PCI device to be resumed
791 *
792 * Note this function is a backend of pci_default_resume and is not supposed
793 * to be called by normal code, write proper resume handler and use it instead.
794 */
Tejun Heo0b62e132007-07-27 14:43:35 +0900795int pci_reenable_device(struct pci_dev *dev)
Hidetoshi Seto38cc1302006-12-18 10:30:00 +0900796{
797 if (atomic_read(&dev->enable_cnt))
798 return do_pci_enable_device(dev, (1 << PCI_NUM_RESOURCES) - 1);
799 return 0;
800}
801
Benjamin Herrenschmidtb7189892007-12-20 15:28:08 +1100802static int __pci_enable_device_flags(struct pci_dev *dev,
803 resource_size_t flags)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700804{
805 int err;
Benjamin Herrenschmidtb7189892007-12-20 15:28:08 +1100806 int i, bars = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700807
Hidetoshi Seto9fb625c2006-12-18 10:28:43 +0900808 if (atomic_add_return(1, &dev->enable_cnt) > 1)
809 return 0; /* already enabled */
810
Benjamin Herrenschmidtb7189892007-12-20 15:28:08 +1100811 for (i = 0; i < DEVICE_COUNT_RESOURCE; i++)
812 if (dev->resource[i].flags & flags)
813 bars |= (1 << i);
814
Hidetoshi Seto38cc1302006-12-18 10:30:00 +0900815 err = do_pci_enable_device(dev, bars);
Greg Kroah-Hartman95a62962005-07-28 11:37:33 -0700816 if (err < 0)
Hidetoshi Seto38cc1302006-12-18 10:30:00 +0900817 atomic_dec(&dev->enable_cnt);
Hidetoshi Seto9fb625c2006-12-18 10:28:43 +0900818 return err;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700819}
820
821/**
Benjamin Herrenschmidtb7189892007-12-20 15:28:08 +1100822 * pci_enable_device_io - Initialize a device for use with IO space
823 * @dev: PCI device to be initialized
824 *
825 * Initialize device before it's used by a driver. Ask low-level code
826 * to enable I/O resources. Wake up the device if it was suspended.
827 * Beware, this function can fail.
828 */
829int pci_enable_device_io(struct pci_dev *dev)
830{
831 return __pci_enable_device_flags(dev, IORESOURCE_IO);
832}
833
834/**
835 * pci_enable_device_mem - Initialize a device for use with Memory space
836 * @dev: PCI device to be initialized
837 *
838 * Initialize device before it's used by a driver. Ask low-level code
839 * to enable Memory resources. Wake up the device if it was suspended.
840 * Beware, this function can fail.
841 */
842int pci_enable_device_mem(struct pci_dev *dev)
843{
844 return __pci_enable_device_flags(dev, IORESOURCE_MEM);
845}
846
Linus Torvalds1da177e2005-04-16 15:20:36 -0700847/**
848 * pci_enable_device - Initialize device before it's used by a driver.
849 * @dev: PCI device to be initialized
850 *
851 * Initialize device before it's used by a driver. Ask low-level code
852 * to enable I/O and memory. Wake up the device if it was suspended.
853 * Beware, this function can fail.
Inaky Perez-Gonzalezbae94d02006-11-22 12:40:31 -0800854 *
855 * Note we don't actually enable the device many times if we call
856 * this function repeatedly (we just increment the count).
Linus Torvalds1da177e2005-04-16 15:20:36 -0700857 */
Inaky Perez-Gonzalezbae94d02006-11-22 12:40:31 -0800858int pci_enable_device(struct pci_dev *dev)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700859{
Benjamin Herrenschmidtb7189892007-12-20 15:28:08 +1100860 return __pci_enable_device_flags(dev, IORESOURCE_MEM | IORESOURCE_IO);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700861}
862
Tejun Heo9ac78492007-01-20 16:00:26 +0900863/*
864 * Managed PCI resources. This manages device on/off, intx/msi/msix
865 * on/off and BAR regions. pci_dev itself records msi/msix status, so
866 * there's no need to track it separately. pci_devres is initialized
867 * when a device is enabled using managed PCI device enable interface.
868 */
869struct pci_devres {
Tejun Heo7f375f32007-02-25 04:36:01 -0800870 unsigned int enabled:1;
871 unsigned int pinned:1;
Tejun Heo9ac78492007-01-20 16:00:26 +0900872 unsigned int orig_intx:1;
873 unsigned int restore_intx:1;
874 u32 region_mask;
875};
876
877static void pcim_release(struct device *gendev, void *res)
878{
879 struct pci_dev *dev = container_of(gendev, struct pci_dev, dev);
880 struct pci_devres *this = res;
881 int i;
882
883 if (dev->msi_enabled)
884 pci_disable_msi(dev);
885 if (dev->msix_enabled)
886 pci_disable_msix(dev);
887
888 for (i = 0; i < DEVICE_COUNT_RESOURCE; i++)
889 if (this->region_mask & (1 << i))
890 pci_release_region(dev, i);
891
892 if (this->restore_intx)
893 pci_intx(dev, this->orig_intx);
894
Tejun Heo7f375f32007-02-25 04:36:01 -0800895 if (this->enabled && !this->pinned)
Tejun Heo9ac78492007-01-20 16:00:26 +0900896 pci_disable_device(dev);
897}
898
899static struct pci_devres * get_pci_dr(struct pci_dev *pdev)
900{
901 struct pci_devres *dr, *new_dr;
902
903 dr = devres_find(&pdev->dev, pcim_release, NULL, NULL);
904 if (dr)
905 return dr;
906
907 new_dr = devres_alloc(pcim_release, sizeof(*new_dr), GFP_KERNEL);
908 if (!new_dr)
909 return NULL;
910 return devres_get(&pdev->dev, new_dr, NULL, NULL);
911}
912
913static struct pci_devres * find_pci_dr(struct pci_dev *pdev)
914{
915 if (pci_is_managed(pdev))
916 return devres_find(&pdev->dev, pcim_release, NULL, NULL);
917 return NULL;
918}
919
920/**
921 * pcim_enable_device - Managed pci_enable_device()
922 * @pdev: PCI device to be initialized
923 *
924 * Managed pci_enable_device().
925 */
926int pcim_enable_device(struct pci_dev *pdev)
927{
928 struct pci_devres *dr;
929 int rc;
930
931 dr = get_pci_dr(pdev);
932 if (unlikely(!dr))
933 return -ENOMEM;
Tejun Heob95d58e2008-01-30 18:20:04 +0900934 if (dr->enabled)
935 return 0;
Tejun Heo9ac78492007-01-20 16:00:26 +0900936
937 rc = pci_enable_device(pdev);
938 if (!rc) {
939 pdev->is_managed = 1;
Tejun Heo7f375f32007-02-25 04:36:01 -0800940 dr->enabled = 1;
Tejun Heo9ac78492007-01-20 16:00:26 +0900941 }
942 return rc;
943}
944
945/**
946 * pcim_pin_device - Pin managed PCI device
947 * @pdev: PCI device to pin
948 *
949 * Pin managed PCI device @pdev. Pinned device won't be disabled on
950 * driver detach. @pdev must have been enabled with
951 * pcim_enable_device().
952 */
953void pcim_pin_device(struct pci_dev *pdev)
954{
955 struct pci_devres *dr;
956
957 dr = find_pci_dr(pdev);
Tejun Heo7f375f32007-02-25 04:36:01 -0800958 WARN_ON(!dr || !dr->enabled);
Tejun Heo9ac78492007-01-20 16:00:26 +0900959 if (dr)
Tejun Heo7f375f32007-02-25 04:36:01 -0800960 dr->pinned = 1;
Tejun Heo9ac78492007-01-20 16:00:26 +0900961}
962
Linus Torvalds1da177e2005-04-16 15:20:36 -0700963/**
964 * pcibios_disable_device - disable arch specific PCI resources for device dev
965 * @dev: the PCI device to disable
966 *
967 * Disables architecture specific PCI resources for the device. This
968 * is the default implementation. Architecture implementations can
969 * override this.
970 */
971void __attribute__ ((weak)) pcibios_disable_device (struct pci_dev *dev) {}
972
973/**
974 * pci_disable_device - Disable PCI device after use
975 * @dev: PCI device to be disabled
976 *
977 * Signal to the system that the PCI device is not in use by the system
978 * anymore. This only involves disabling PCI bus-mastering, if active.
Inaky Perez-Gonzalezbae94d02006-11-22 12:40:31 -0800979 *
980 * Note we don't actually disable the device until all callers of
981 * pci_device_enable() have called pci_device_disable().
Linus Torvalds1da177e2005-04-16 15:20:36 -0700982 */
983void
984pci_disable_device(struct pci_dev *dev)
985{
Tejun Heo9ac78492007-01-20 16:00:26 +0900986 struct pci_devres *dr;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700987 u16 pci_command;
Shaohua Li99dc8042006-05-26 10:58:27 +0800988
Tejun Heo9ac78492007-01-20 16:00:26 +0900989 dr = find_pci_dr(dev);
990 if (dr)
Tejun Heo7f375f32007-02-25 04:36:01 -0800991 dr->enabled = 0;
Tejun Heo9ac78492007-01-20 16:00:26 +0900992
Inaky Perez-Gonzalezbae94d02006-11-22 12:40:31 -0800993 if (atomic_sub_return(1, &dev->enable_cnt) != 0)
994 return;
995
Linus Torvalds1da177e2005-04-16 15:20:36 -0700996 pci_read_config_word(dev, PCI_COMMAND, &pci_command);
997 if (pci_command & PCI_COMMAND_MASTER) {
998 pci_command &= ~PCI_COMMAND_MASTER;
999 pci_write_config_word(dev, PCI_COMMAND, pci_command);
1000 }
Kenji Kaneshigeceb43742005-04-08 14:53:31 +09001001 dev->is_busmaster = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001002
1003 pcibios_disable_device(dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001004}
1005
1006/**
Brian Kingf7bdd122007-04-06 16:39:36 -05001007 * pcibios_set_pcie_reset_state - set reset state for device dev
1008 * @dev: the PCI-E device reset
1009 * @state: Reset state to enter into
1010 *
1011 *
1012 * Sets the PCI-E reset state for the device. This is the default
1013 * implementation. Architecture implementations can override this.
1014 */
1015int __attribute__ ((weak)) pcibios_set_pcie_reset_state(struct pci_dev *dev,
1016 enum pcie_reset_state state)
1017{
1018 return -EINVAL;
1019}
1020
1021/**
1022 * pci_set_pcie_reset_state - set reset state for device dev
1023 * @dev: the PCI-E device reset
1024 * @state: Reset state to enter into
1025 *
1026 *
1027 * Sets the PCI reset state for the device.
1028 */
1029int pci_set_pcie_reset_state(struct pci_dev *dev, enum pcie_reset_state state)
1030{
1031 return pcibios_set_pcie_reset_state(dev, state);
1032}
1033
1034/**
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001035 * pci_pme_capable - check the capability of PCI device to generate PME#
1036 * @dev: PCI device to handle.
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001037 * @state: PCI state from which device will issue PME#.
1038 */
Rafael J. Wysockie5899e12008-07-19 14:39:24 +02001039bool pci_pme_capable(struct pci_dev *dev, pci_power_t state)
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001040{
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001041 if (!dev->pm_cap)
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001042 return false;
1043
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001044 return !!(dev->pme_support & (1 << state));
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001045}
1046
1047/**
1048 * pci_pme_active - enable or disable PCI device's PME# function
1049 * @dev: PCI device to handle.
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001050 * @enable: 'true' to enable PME# generation; 'false' to disable it.
1051 *
1052 * The caller must verify that the device is capable of generating PME# before
1053 * calling this function with @enable equal to 'true'.
1054 */
Rafael J. Wysocki5a6c9b62008-08-08 00:14:24 +02001055void pci_pme_active(struct pci_dev *dev, bool enable)
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001056{
1057 u16 pmcsr;
1058
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001059 if (!dev->pm_cap)
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001060 return;
1061
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001062 pci_read_config_word(dev, dev->pm_cap + PCI_PM_CTRL, &pmcsr);
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001063 /* Clear PME_Status by writing 1 to it and enable PME# */
1064 pmcsr |= PCI_PM_CTRL_PME_STATUS | PCI_PM_CTRL_PME_ENABLE;
1065 if (!enable)
1066 pmcsr &= ~PCI_PM_CTRL_PME_ENABLE;
1067
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001068 pci_write_config_word(dev, dev->pm_cap + PCI_PM_CTRL, pmcsr);
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001069
1070 dev_printk(KERN_INFO, &dev->dev, "PME# %s\n",
1071 enable ? "enabled" : "disabled");
1072}
1073
1074/**
David Brownell075c1772007-04-26 00:12:06 -07001075 * pci_enable_wake - enable PCI device as wakeup event source
1076 * @dev: PCI device affected
1077 * @state: PCI state from which device will issue wakeup events
1078 * @enable: True to enable event generation; false to disable
Linus Torvalds1da177e2005-04-16 15:20:36 -07001079 *
David Brownell075c1772007-04-26 00:12:06 -07001080 * This enables the device as a wakeup event source, or disables it.
1081 * When such events involves platform-specific hooks, those hooks are
1082 * called automatically by this routine.
1083 *
1084 * Devices with legacy power management (no standard PCI PM capabilities)
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001085 * always require such platform hooks.
David Brownell075c1772007-04-26 00:12:06 -07001086 *
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001087 * RETURN VALUE:
1088 * 0 is returned on success
1089 * -EINVAL is returned if device is not supposed to wake up the system
1090 * Error code depending on the platform is returned if both the platform and
1091 * the native mechanism fail to enable the generation of wake-up events
Linus Torvalds1da177e2005-04-16 15:20:36 -07001092 */
1093int pci_enable_wake(struct pci_dev *dev, pci_power_t state, int enable)
1094{
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001095 int error = 0;
1096 bool pme_done = false;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001097
Alan Sternbebd5902008-12-16 14:06:58 -05001098 if (enable && !device_may_wakeup(&dev->dev))
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001099 return -EINVAL;
1100
1101 /*
1102 * According to "PCI System Architecture" 4th ed. by Tom Shanley & Don
1103 * Anderson we should be doing PME# wake enable followed by ACPI wake
1104 * enable. To disable wake-up we call the platform first, for symmetry.
David Brownell075c1772007-04-26 00:12:06 -07001105 */
1106
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001107 if (!enable && platform_pci_can_wakeup(dev))
1108 error = platform_pci_sleep_wake(dev, false);
1109
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001110 if (!enable || pci_pme_capable(dev, state)) {
1111 pci_pme_active(dev, enable);
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001112 pme_done = true;
1113 }
1114
1115 if (enable && platform_pci_can_wakeup(dev))
1116 error = platform_pci_sleep_wake(dev, true);
1117
1118 return pme_done ? 0 : error;
1119}
1120
1121/**
Rafael J. Wysocki0235c4f2008-08-18 21:38:00 +02001122 * pci_wake_from_d3 - enable/disable device to wake up from D3_hot or D3_cold
1123 * @dev: PCI device to prepare
1124 * @enable: True to enable wake-up event generation; false to disable
1125 *
1126 * Many drivers want the device to wake up the system from D3_hot or D3_cold
1127 * and this function allows them to set that up cleanly - pci_enable_wake()
1128 * should not be called twice in a row to enable wake-up due to PCI PM vs ACPI
1129 * ordering constraints.
1130 *
1131 * This function only returns error code if the device is not capable of
1132 * generating PME# from both D3_hot and D3_cold, and the platform is unable to
1133 * enable wake-up power for it.
1134 */
1135int pci_wake_from_d3(struct pci_dev *dev, bool enable)
1136{
1137 return pci_pme_capable(dev, PCI_D3cold) ?
1138 pci_enable_wake(dev, PCI_D3cold, enable) :
1139 pci_enable_wake(dev, PCI_D3hot, enable);
1140}
1141
1142/**
Jesse Barnes37139072008-07-28 11:49:26 -07001143 * pci_target_state - find an appropriate low power state for a given PCI dev
1144 * @dev: PCI device
1145 *
1146 * Use underlying platform code to find a supported low power state for @dev.
1147 * If the platform can't manage @dev, return the deepest state from which it
1148 * can generate wake events, based on any available PME info.
Rafael J. Wysocki404cc2d2008-07-07 03:35:26 +02001149 */
Rafael J. Wysockie5899e12008-07-19 14:39:24 +02001150pci_power_t pci_target_state(struct pci_dev *dev)
Rafael J. Wysocki404cc2d2008-07-07 03:35:26 +02001151{
1152 pci_power_t target_state = PCI_D3hot;
Rafael J. Wysocki404cc2d2008-07-07 03:35:26 +02001153
1154 if (platform_pci_power_manageable(dev)) {
1155 /*
1156 * Call the platform to choose the target state of the device
1157 * and enable wake-up from this state if supported.
1158 */
1159 pci_power_t state = platform_pci_choose_state(dev);
1160
1161 switch (state) {
1162 case PCI_POWER_ERROR:
1163 case PCI_UNKNOWN:
1164 break;
1165 case PCI_D1:
1166 case PCI_D2:
1167 if (pci_no_d1d2(dev))
1168 break;
1169 default:
1170 target_state = state;
Rafael J. Wysocki404cc2d2008-07-07 03:35:26 +02001171 }
1172 } else if (device_may_wakeup(&dev->dev)) {
1173 /*
1174 * Find the deepest state from which the device can generate
1175 * wake-up events, make it the target state and enable device
1176 * to generate PME#.
1177 */
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001178 if (!dev->pm_cap)
Rafael J. Wysockie5899e12008-07-19 14:39:24 +02001179 return PCI_POWER_ERROR;
Rafael J. Wysocki404cc2d2008-07-07 03:35:26 +02001180
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001181 if (dev->pme_support) {
1182 while (target_state
1183 && !(dev->pme_support & (1 << target_state)))
1184 target_state--;
Rafael J. Wysocki404cc2d2008-07-07 03:35:26 +02001185 }
1186 }
1187
Rafael J. Wysockie5899e12008-07-19 14:39:24 +02001188 return target_state;
1189}
1190
1191/**
1192 * pci_prepare_to_sleep - prepare PCI device for system-wide transition into a sleep state
1193 * @dev: Device to handle.
1194 *
1195 * Choose the power state appropriate for the device depending on whether
1196 * it can wake up the system and/or is power manageable by the platform
1197 * (PCI_D3hot is the default) and put the device into that state.
1198 */
1199int pci_prepare_to_sleep(struct pci_dev *dev)
1200{
1201 pci_power_t target_state = pci_target_state(dev);
1202 int error;
1203
1204 if (target_state == PCI_POWER_ERROR)
1205 return -EIO;
1206
Rafael J. Wysockic157dfa2008-07-13 22:45:06 +02001207 pci_enable_wake(dev, target_state, true);
1208
Rafael J. Wysocki404cc2d2008-07-07 03:35:26 +02001209 error = pci_set_power_state(dev, target_state);
1210
1211 if (error)
1212 pci_enable_wake(dev, target_state, false);
1213
1214 return error;
1215}
1216
1217/**
Randy Dunlap443bd1c2008-07-21 09:27:18 -07001218 * pci_back_from_sleep - turn PCI device on during system-wide transition into working state
Rafael J. Wysocki404cc2d2008-07-07 03:35:26 +02001219 * @dev: Device to handle.
1220 *
1221 * Disable device's sytem wake-up capability and put it into D0.
1222 */
1223int pci_back_from_sleep(struct pci_dev *dev)
1224{
1225 pci_enable_wake(dev, PCI_D0, false);
1226 return pci_set_power_state(dev, PCI_D0);
1227}
1228
1229/**
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001230 * pci_pm_init - Initialize PM functions of given PCI device
1231 * @dev: PCI device to handle.
1232 */
1233void pci_pm_init(struct pci_dev *dev)
1234{
1235 int pm;
1236 u16 pmc;
David Brownell075c1772007-04-26 00:12:06 -07001237
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001238 dev->pm_cap = 0;
1239
Linus Torvalds1da177e2005-04-16 15:20:36 -07001240 /* find PCI PM capability in list */
1241 pm = pci_find_capability(dev, PCI_CAP_ID_PM);
David Brownell075c1772007-04-26 00:12:06 -07001242 if (!pm)
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001243 return;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001244 /* Check device's ability to generate PME# */
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001245 pci_read_config_word(dev, pm + PCI_PM_PMC, &pmc);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001246
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001247 if ((pmc & PCI_PM_CAP_VER_MASK) > 3) {
1248 dev_err(&dev->dev, "unsupported PM cap regs version (%u)\n",
1249 pmc & PCI_PM_CAP_VER_MASK);
1250 return;
David Brownell075c1772007-04-26 00:12:06 -07001251 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001252
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001253 dev->pm_cap = pm;
1254
1255 dev->d1_support = false;
1256 dev->d2_support = false;
1257 if (!pci_no_d1d2(dev)) {
Bjorn Helgaasc9ed77e2008-08-22 09:37:02 -06001258 if (pmc & PCI_PM_CAP_D1)
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001259 dev->d1_support = true;
Bjorn Helgaasc9ed77e2008-08-22 09:37:02 -06001260 if (pmc & PCI_PM_CAP_D2)
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001261 dev->d2_support = true;
Bjorn Helgaasc9ed77e2008-08-22 09:37:02 -06001262
1263 if (dev->d1_support || dev->d2_support)
1264 dev_printk(KERN_DEBUG, &dev->dev, "supports%s%s\n",
Jesse Barnesec84f122008-09-23 11:43:34 -07001265 dev->d1_support ? " D1" : "",
1266 dev->d2_support ? " D2" : "");
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001267 }
1268
1269 pmc &= PCI_PM_CAP_PME_MASK;
1270 if (pmc) {
Bjorn Helgaasc9ed77e2008-08-22 09:37:02 -06001271 dev_info(&dev->dev, "PME# supported from%s%s%s%s%s\n",
1272 (pmc & PCI_PM_CAP_PME_D0) ? " D0" : "",
1273 (pmc & PCI_PM_CAP_PME_D1) ? " D1" : "",
1274 (pmc & PCI_PM_CAP_PME_D2) ? " D2" : "",
1275 (pmc & PCI_PM_CAP_PME_D3) ? " D3hot" : "",
1276 (pmc & PCI_PM_CAP_PME_D3cold) ? " D3cold" : "");
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001277 dev->pme_support = pmc >> PCI_PM_CAP_PME_SHIFT;
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001278 /*
1279 * Make device's PM flags reflect the wake-up capability, but
1280 * let the user space enable it to wake up the system as needed.
1281 */
1282 device_set_wakeup_capable(&dev->dev, true);
1283 device_set_wakeup_enable(&dev->dev, false);
1284 /* Disable the PME# generation functionality */
Rafael J. Wysocki337001b2008-07-07 03:36:24 +02001285 pci_pme_active(dev, false);
1286 } else {
1287 dev->pme_support = 0;
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +02001288 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001289}
1290
Yu Zhao58c3a722008-10-14 14:02:53 +08001291/**
Jesse Barneseb9c39d2008-12-17 12:10:05 -08001292 * platform_pci_wakeup_init - init platform wakeup if present
1293 * @dev: PCI device
1294 *
1295 * Some devices don't have PCI PM caps but can still generate wakeup
1296 * events through platform methods (like ACPI events). If @dev supports
1297 * platform wakeup events, set the device flag to indicate as much. This
1298 * may be redundant if the device also supports PCI PM caps, but double
1299 * initialization should be safe in that case.
1300 */
1301void platform_pci_wakeup_init(struct pci_dev *dev)
1302{
1303 if (!platform_pci_can_wakeup(dev))
1304 return;
1305
1306 device_set_wakeup_capable(&dev->dev, true);
1307 device_set_wakeup_enable(&dev->dev, false);
1308 platform_pci_sleep_wake(dev, false);
1309}
1310
1311/**
Rafael J. Wysocki63f48982008-12-07 22:02:58 +01001312 * pci_add_save_buffer - allocate buffer for saving given capability registers
1313 * @dev: the PCI device
1314 * @cap: the capability to allocate the buffer for
1315 * @size: requested size of the buffer
1316 */
1317static int pci_add_cap_save_buffer(
1318 struct pci_dev *dev, char cap, unsigned int size)
1319{
1320 int pos;
1321 struct pci_cap_saved_state *save_state;
1322
1323 pos = pci_find_capability(dev, cap);
1324 if (pos <= 0)
1325 return 0;
1326
1327 save_state = kzalloc(sizeof(*save_state) + size, GFP_KERNEL);
1328 if (!save_state)
1329 return -ENOMEM;
1330
1331 save_state->cap_nr = cap;
1332 pci_add_saved_cap(dev, save_state);
1333
1334 return 0;
1335}
1336
1337/**
1338 * pci_allocate_cap_save_buffers - allocate buffers for saving capabilities
1339 * @dev: the PCI device
1340 */
1341void pci_allocate_cap_save_buffers(struct pci_dev *dev)
1342{
1343 int error;
1344
1345 error = pci_add_cap_save_buffer(dev, PCI_CAP_ID_EXP, 4 * sizeof(u16));
1346 if (error)
1347 dev_err(&dev->dev,
1348 "unable to preallocate PCI Express save buffer\n");
1349
1350 error = pci_add_cap_save_buffer(dev, PCI_CAP_ID_PCIX, sizeof(u16));
1351 if (error)
1352 dev_err(&dev->dev,
1353 "unable to preallocate PCI-X save buffer\n");
1354}
1355
1356/**
Yu Zhao58c3a722008-10-14 14:02:53 +08001357 * pci_enable_ari - enable ARI forwarding if hardware support it
1358 * @dev: the PCI device
1359 */
1360void pci_enable_ari(struct pci_dev *dev)
1361{
1362 int pos;
1363 u32 cap;
1364 u16 ctrl;
Zhao, Yu81135872008-10-23 13:15:39 +08001365 struct pci_dev *bridge;
Yu Zhao58c3a722008-10-14 14:02:53 +08001366
Zhao, Yu81135872008-10-23 13:15:39 +08001367 if (!dev->is_pcie || dev->devfn)
Yu Zhao58c3a722008-10-14 14:02:53 +08001368 return;
1369
Zhao, Yu81135872008-10-23 13:15:39 +08001370 pos = pci_find_ext_capability(dev, PCI_EXT_CAP_ID_ARI);
Yu Zhao58c3a722008-10-14 14:02:53 +08001371 if (!pos)
1372 return;
1373
Zhao, Yu81135872008-10-23 13:15:39 +08001374 bridge = dev->bus->self;
1375 if (!bridge || !bridge->is_pcie)
1376 return;
1377
1378 pos = pci_find_capability(bridge, PCI_CAP_ID_EXP);
1379 if (!pos)
1380 return;
1381
1382 pci_read_config_dword(bridge, pos + PCI_EXP_DEVCAP2, &cap);
Yu Zhao58c3a722008-10-14 14:02:53 +08001383 if (!(cap & PCI_EXP_DEVCAP2_ARI))
1384 return;
1385
Zhao, Yu81135872008-10-23 13:15:39 +08001386 pci_read_config_word(bridge, pos + PCI_EXP_DEVCTL2, &ctrl);
Yu Zhao58c3a722008-10-14 14:02:53 +08001387 ctrl |= PCI_EXP_DEVCTL2_ARI;
Zhao, Yu81135872008-10-23 13:15:39 +08001388 pci_write_config_word(bridge, pos + PCI_EXP_DEVCTL2, ctrl);
Yu Zhao58c3a722008-10-14 14:02:53 +08001389
Zhao, Yu81135872008-10-23 13:15:39 +08001390 bridge->ari_enabled = 1;
Yu Zhao58c3a722008-10-14 14:02:53 +08001391}
1392
Bjorn Helgaas57c2cf72008-12-11 11:24:23 -07001393/**
1394 * pci_swizzle_interrupt_pin - swizzle INTx for device behind bridge
1395 * @dev: the PCI device
1396 * @pin: the INTx pin (1=INTA, 2=INTB, 3=INTD, 4=INTD)
1397 *
1398 * Perform INTx swizzling for a device behind one level of bridge. This is
1399 * required by section 9.1 of the PCI-to-PCI bridge specification for devices
1400 * behind bridges on add-in cards.
1401 */
1402u8 pci_swizzle_interrupt_pin(struct pci_dev *dev, u8 pin)
1403{
1404 return (((pin - 1) + PCI_SLOT(dev->devfn)) % 4) + 1;
1405}
1406
Linus Torvalds1da177e2005-04-16 15:20:36 -07001407int
1408pci_get_interrupt_pin(struct pci_dev *dev, struct pci_dev **bridge)
1409{
1410 u8 pin;
1411
Kristen Accardi514d2072005-11-02 16:24:39 -08001412 pin = dev->pin;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001413 if (!pin)
1414 return -1;
Bjorn Helgaas878f2e52008-12-09 16:11:46 -07001415
Linus Torvalds1da177e2005-04-16 15:20:36 -07001416 while (dev->bus->self) {
Bjorn Helgaas57c2cf72008-12-11 11:24:23 -07001417 pin = pci_swizzle_interrupt_pin(dev, pin);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001418 dev = dev->bus->self;
1419 }
1420 *bridge = dev;
1421 return pin;
1422}
1423
1424/**
1425 * pci_release_region - Release a PCI bar
1426 * @pdev: PCI device whose resources were previously reserved by pci_request_region
1427 * @bar: BAR to release
1428 *
1429 * Releases the PCI I/O and memory resources previously reserved by a
1430 * successful call to pci_request_region. Call this function only
1431 * after all use of the PCI regions has ceased.
1432 */
1433void pci_release_region(struct pci_dev *pdev, int bar)
1434{
Tejun Heo9ac78492007-01-20 16:00:26 +09001435 struct pci_devres *dr;
1436
Linus Torvalds1da177e2005-04-16 15:20:36 -07001437 if (pci_resource_len(pdev, bar) == 0)
1438 return;
1439 if (pci_resource_flags(pdev, bar) & IORESOURCE_IO)
1440 release_region(pci_resource_start(pdev, bar),
1441 pci_resource_len(pdev, bar));
1442 else if (pci_resource_flags(pdev, bar) & IORESOURCE_MEM)
1443 release_mem_region(pci_resource_start(pdev, bar),
1444 pci_resource_len(pdev, bar));
Tejun Heo9ac78492007-01-20 16:00:26 +09001445
1446 dr = find_pci_dr(pdev);
1447 if (dr)
1448 dr->region_mask &= ~(1 << bar);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001449}
1450
1451/**
1452 * pci_request_region - Reserved PCI I/O and memory resource
1453 * @pdev: PCI device whose resources are to be reserved
1454 * @bar: BAR to be reserved
1455 * @res_name: Name to be associated with resource.
1456 *
1457 * Mark the PCI region associated with PCI device @pdev BR @bar as
1458 * being reserved by owner @res_name. Do not access any
1459 * address inside the PCI regions unless this call returns
1460 * successfully.
1461 *
1462 * Returns 0 on success, or %EBUSY on error. A warning
1463 * message is also printed on failure.
1464 */
Arjan van de Vene8de1482008-10-22 19:55:31 -07001465static int __pci_request_region(struct pci_dev *pdev, int bar, const char *res_name,
1466 int exclusive)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001467{
Tejun Heo9ac78492007-01-20 16:00:26 +09001468 struct pci_devres *dr;
1469
Linus Torvalds1da177e2005-04-16 15:20:36 -07001470 if (pci_resource_len(pdev, bar) == 0)
1471 return 0;
1472
1473 if (pci_resource_flags(pdev, bar) & IORESOURCE_IO) {
1474 if (!request_region(pci_resource_start(pdev, bar),
1475 pci_resource_len(pdev, bar), res_name))
1476 goto err_out;
1477 }
1478 else if (pci_resource_flags(pdev, bar) & IORESOURCE_MEM) {
Arjan van de Vene8de1482008-10-22 19:55:31 -07001479 if (!__request_mem_region(pci_resource_start(pdev, bar),
1480 pci_resource_len(pdev, bar), res_name,
1481 exclusive))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001482 goto err_out;
1483 }
Tejun Heo9ac78492007-01-20 16:00:26 +09001484
1485 dr = find_pci_dr(pdev);
1486 if (dr)
1487 dr->region_mask |= 1 << bar;
1488
Linus Torvalds1da177e2005-04-16 15:20:36 -07001489 return 0;
1490
1491err_out:
Benjamin Herrenschmidt096e6f62008-10-20 15:07:37 +11001492 dev_warn(&pdev->dev, "BAR %d: can't reserve %s region %pR\n",
Jesse Barnese4ec7a02008-06-25 16:12:25 -07001493 bar,
1494 pci_resource_flags(pdev, bar) & IORESOURCE_IO ? "I/O" : "mem",
Benjamin Herrenschmidt096e6f62008-10-20 15:07:37 +11001495 &pdev->resource[bar]);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001496 return -EBUSY;
1497}
1498
Hidetoshi Setoc87deff2006-12-18 10:31:06 +09001499/**
Arjan van de Vene8de1482008-10-22 19:55:31 -07001500 * pci_request_region - Reserved PCI I/O and memory resource
1501 * @pdev: PCI device whose resources are to be reserved
1502 * @bar: BAR to be reserved
1503 * @res_name: Name to be associated with resource.
1504 *
1505 * Mark the PCI region associated with PCI device @pdev BR @bar as
1506 * being reserved by owner @res_name. Do not access any
1507 * address inside the PCI regions unless this call returns
1508 * successfully.
1509 *
1510 * Returns 0 on success, or %EBUSY on error. A warning
1511 * message is also printed on failure.
1512 */
1513int pci_request_region(struct pci_dev *pdev, int bar, const char *res_name)
1514{
1515 return __pci_request_region(pdev, bar, res_name, 0);
1516}
1517
1518/**
1519 * pci_request_region_exclusive - Reserved PCI I/O and memory resource
1520 * @pdev: PCI device whose resources are to be reserved
1521 * @bar: BAR to be reserved
1522 * @res_name: Name to be associated with resource.
1523 *
1524 * Mark the PCI region associated with PCI device @pdev BR @bar as
1525 * being reserved by owner @res_name. Do not access any
1526 * address inside the PCI regions unless this call returns
1527 * successfully.
1528 *
1529 * Returns 0 on success, or %EBUSY on error. A warning
1530 * message is also printed on failure.
1531 *
1532 * The key difference that _exclusive makes it that userspace is
1533 * explicitly not allowed to map the resource via /dev/mem or
1534 * sysfs.
1535 */
1536int pci_request_region_exclusive(struct pci_dev *pdev, int bar, const char *res_name)
1537{
1538 return __pci_request_region(pdev, bar, res_name, IORESOURCE_EXCLUSIVE);
1539}
1540/**
Hidetoshi Setoc87deff2006-12-18 10:31:06 +09001541 * pci_release_selected_regions - Release selected PCI I/O and memory resources
1542 * @pdev: PCI device whose resources were previously reserved
1543 * @bars: Bitmask of BARs to be released
1544 *
1545 * Release selected PCI I/O and memory resources previously reserved.
1546 * Call this function only after all use of the PCI regions has ceased.
1547 */
1548void pci_release_selected_regions(struct pci_dev *pdev, int bars)
1549{
1550 int i;
1551
1552 for (i = 0; i < 6; i++)
1553 if (bars & (1 << i))
1554 pci_release_region(pdev, i);
1555}
1556
Arjan van de Vene8de1482008-10-22 19:55:31 -07001557int __pci_request_selected_regions(struct pci_dev *pdev, int bars,
1558 const char *res_name, int excl)
Hidetoshi Setoc87deff2006-12-18 10:31:06 +09001559{
1560 int i;
1561
1562 for (i = 0; i < 6; i++)
1563 if (bars & (1 << i))
Arjan van de Vene8de1482008-10-22 19:55:31 -07001564 if (__pci_request_region(pdev, i, res_name, excl))
Hidetoshi Setoc87deff2006-12-18 10:31:06 +09001565 goto err_out;
1566 return 0;
1567
1568err_out:
1569 while(--i >= 0)
1570 if (bars & (1 << i))
1571 pci_release_region(pdev, i);
1572
1573 return -EBUSY;
1574}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001575
Arjan van de Vene8de1482008-10-22 19:55:31 -07001576
1577/**
1578 * pci_request_selected_regions - Reserve selected PCI I/O and memory resources
1579 * @pdev: PCI device whose resources are to be reserved
1580 * @bars: Bitmask of BARs to be requested
1581 * @res_name: Name to be associated with resource
1582 */
1583int pci_request_selected_regions(struct pci_dev *pdev, int bars,
1584 const char *res_name)
1585{
1586 return __pci_request_selected_regions(pdev, bars, res_name, 0);
1587}
1588
1589int pci_request_selected_regions_exclusive(struct pci_dev *pdev,
1590 int bars, const char *res_name)
1591{
1592 return __pci_request_selected_regions(pdev, bars, res_name,
1593 IORESOURCE_EXCLUSIVE);
1594}
1595
Linus Torvalds1da177e2005-04-16 15:20:36 -07001596/**
1597 * pci_release_regions - Release reserved PCI I/O and memory resources
1598 * @pdev: PCI device whose resources were previously reserved by pci_request_regions
1599 *
1600 * Releases all PCI I/O and memory resources previously reserved by a
1601 * successful call to pci_request_regions. Call this function only
1602 * after all use of the PCI regions has ceased.
1603 */
1604
1605void pci_release_regions(struct pci_dev *pdev)
1606{
Hidetoshi Setoc87deff2006-12-18 10:31:06 +09001607 pci_release_selected_regions(pdev, (1 << 6) - 1);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001608}
1609
1610/**
1611 * pci_request_regions - Reserved PCI I/O and memory resources
1612 * @pdev: PCI device whose resources are to be reserved
1613 * @res_name: Name to be associated with resource.
1614 *
1615 * Mark all PCI regions associated with PCI device @pdev as
1616 * being reserved by owner @res_name. Do not access any
1617 * address inside the PCI regions unless this call returns
1618 * successfully.
1619 *
1620 * Returns 0 on success, or %EBUSY on error. A warning
1621 * message is also printed on failure.
1622 */
Jeff Garzik3c990e92006-03-04 21:52:42 -05001623int pci_request_regions(struct pci_dev *pdev, const char *res_name)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001624{
Hidetoshi Setoc87deff2006-12-18 10:31:06 +09001625 return pci_request_selected_regions(pdev, ((1 << 6) - 1), res_name);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001626}
1627
1628/**
Arjan van de Vene8de1482008-10-22 19:55:31 -07001629 * pci_request_regions_exclusive - Reserved PCI I/O and memory resources
1630 * @pdev: PCI device whose resources are to be reserved
1631 * @res_name: Name to be associated with resource.
1632 *
1633 * Mark all PCI regions associated with PCI device @pdev as
1634 * being reserved by owner @res_name. Do not access any
1635 * address inside the PCI regions unless this call returns
1636 * successfully.
1637 *
1638 * pci_request_regions_exclusive() will mark the region so that
1639 * /dev/mem and the sysfs MMIO access will not be allowed.
1640 *
1641 * Returns 0 on success, or %EBUSY on error. A warning
1642 * message is also printed on failure.
1643 */
1644int pci_request_regions_exclusive(struct pci_dev *pdev, const char *res_name)
1645{
1646 return pci_request_selected_regions_exclusive(pdev,
1647 ((1 << 6) - 1), res_name);
1648}
1649
1650
1651/**
Linus Torvalds1da177e2005-04-16 15:20:36 -07001652 * pci_set_master - enables bus-mastering for device dev
1653 * @dev: the PCI device to enable
1654 *
1655 * Enables bus-mastering on the device and calls pcibios_set_master()
1656 * to do the needed arch specific settings.
1657 */
1658void
1659pci_set_master(struct pci_dev *dev)
1660{
1661 u16 cmd;
1662
1663 pci_read_config_word(dev, PCI_COMMAND, &cmd);
1664 if (! (cmd & PCI_COMMAND_MASTER)) {
Bjorn Helgaas80ccba12008-06-13 10:52:11 -06001665 dev_dbg(&dev->dev, "enabling bus mastering\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -07001666 cmd |= PCI_COMMAND_MASTER;
1667 pci_write_config_word(dev, PCI_COMMAND, cmd);
1668 }
1669 dev->is_busmaster = 1;
1670 pcibios_set_master(dev);
1671}
1672
Matthew Wilcoxedb2d972006-10-10 08:01:21 -06001673#ifdef PCI_DISABLE_MWI
1674int pci_set_mwi(struct pci_dev *dev)
1675{
1676 return 0;
1677}
1678
Randy Dunlap694625c2007-07-09 11:55:54 -07001679int pci_try_set_mwi(struct pci_dev *dev)
1680{
1681 return 0;
1682}
1683
Matthew Wilcoxedb2d972006-10-10 08:01:21 -06001684void pci_clear_mwi(struct pci_dev *dev)
1685{
1686}
1687
1688#else
Matthew Wilcoxebf5a242006-10-10 08:01:20 -06001689
1690#ifndef PCI_CACHE_LINE_BYTES
1691#define PCI_CACHE_LINE_BYTES L1_CACHE_BYTES
1692#endif
1693
Linus Torvalds1da177e2005-04-16 15:20:36 -07001694/* This can be overridden by arch code. */
Matthew Wilcoxebf5a242006-10-10 08:01:20 -06001695/* Don't forget this is measured in 32-bit words, not bytes */
1696u8 pci_cache_line_size = PCI_CACHE_LINE_BYTES / 4;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001697
1698/**
Matthew Wilcoxedb2d972006-10-10 08:01:21 -06001699 * pci_set_cacheline_size - ensure the CACHE_LINE_SIZE register is programmed
1700 * @dev: the PCI device for which MWI is to be enabled
Linus Torvalds1da177e2005-04-16 15:20:36 -07001701 *
Matthew Wilcoxedb2d972006-10-10 08:01:21 -06001702 * Helper function for pci_set_mwi.
1703 * Originally copied from drivers/net/acenic.c.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001704 * Copyright 1998-2001 by Jes Sorensen, <jes@trained-monkey.org>.
1705 *
1706 * RETURNS: An appropriate -ERRNO error value on error, or zero for success.
1707 */
1708static int
Matthew Wilcoxedb2d972006-10-10 08:01:21 -06001709pci_set_cacheline_size(struct pci_dev *dev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001710{
1711 u8 cacheline_size;
1712
1713 if (!pci_cache_line_size)
1714 return -EINVAL; /* The system doesn't support MWI. */
1715
1716 /* Validate current setting: the PCI_CACHE_LINE_SIZE must be
1717 equal to or multiple of the right value. */
1718 pci_read_config_byte(dev, PCI_CACHE_LINE_SIZE, &cacheline_size);
1719 if (cacheline_size >= pci_cache_line_size &&
1720 (cacheline_size % pci_cache_line_size) == 0)
1721 return 0;
1722
1723 /* Write the correct value. */
1724 pci_write_config_byte(dev, PCI_CACHE_LINE_SIZE, pci_cache_line_size);
1725 /* Read it back. */
1726 pci_read_config_byte(dev, PCI_CACHE_LINE_SIZE, &cacheline_size);
1727 if (cacheline_size == pci_cache_line_size)
1728 return 0;
1729
Bjorn Helgaas80ccba12008-06-13 10:52:11 -06001730 dev_printk(KERN_DEBUG, &dev->dev, "cache line size of %d is not "
1731 "supported\n", pci_cache_line_size << 2);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001732
1733 return -EINVAL;
1734}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001735
1736/**
1737 * pci_set_mwi - enables memory-write-invalidate PCI transaction
1738 * @dev: the PCI device for which MWI is enabled
1739 *
Randy Dunlap694625c2007-07-09 11:55:54 -07001740 * Enables the Memory-Write-Invalidate transaction in %PCI_COMMAND.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001741 *
1742 * RETURNS: An appropriate -ERRNO error value on error, or zero for success.
1743 */
1744int
1745pci_set_mwi(struct pci_dev *dev)
1746{
1747 int rc;
1748 u16 cmd;
1749
Matthew Wilcoxedb2d972006-10-10 08:01:21 -06001750 rc = pci_set_cacheline_size(dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001751 if (rc)
1752 return rc;
1753
1754 pci_read_config_word(dev, PCI_COMMAND, &cmd);
1755 if (! (cmd & PCI_COMMAND_INVALIDATE)) {
Bjorn Helgaas80ccba12008-06-13 10:52:11 -06001756 dev_dbg(&dev->dev, "enabling Mem-Wr-Inval\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -07001757 cmd |= PCI_COMMAND_INVALIDATE;
1758 pci_write_config_word(dev, PCI_COMMAND, cmd);
1759 }
1760
1761 return 0;
1762}
1763
1764/**
Randy Dunlap694625c2007-07-09 11:55:54 -07001765 * pci_try_set_mwi - enables memory-write-invalidate PCI transaction
1766 * @dev: the PCI device for which MWI is enabled
1767 *
1768 * Enables the Memory-Write-Invalidate transaction in %PCI_COMMAND.
1769 * Callers are not required to check the return value.
1770 *
1771 * RETURNS: An appropriate -ERRNO error value on error, or zero for success.
1772 */
1773int pci_try_set_mwi(struct pci_dev *dev)
1774{
1775 int rc = pci_set_mwi(dev);
1776 return rc;
1777}
1778
1779/**
Linus Torvalds1da177e2005-04-16 15:20:36 -07001780 * pci_clear_mwi - disables Memory-Write-Invalidate for device dev
1781 * @dev: the PCI device to disable
1782 *
1783 * Disables PCI Memory-Write-Invalidate transaction on the device
1784 */
1785void
1786pci_clear_mwi(struct pci_dev *dev)
1787{
1788 u16 cmd;
1789
1790 pci_read_config_word(dev, PCI_COMMAND, &cmd);
1791 if (cmd & PCI_COMMAND_INVALIDATE) {
1792 cmd &= ~PCI_COMMAND_INVALIDATE;
1793 pci_write_config_word(dev, PCI_COMMAND, cmd);
1794 }
1795}
Matthew Wilcoxedb2d972006-10-10 08:01:21 -06001796#endif /* ! PCI_DISABLE_MWI */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001797
Brett M Russa04ce0f2005-08-15 15:23:41 -04001798/**
1799 * pci_intx - enables/disables PCI INTx for device dev
Randy Dunlap8f7020d2005-10-23 11:57:38 -07001800 * @pdev: the PCI device to operate on
1801 * @enable: boolean: whether to enable or disable PCI INTx
Brett M Russa04ce0f2005-08-15 15:23:41 -04001802 *
1803 * Enables/disables PCI INTx for device dev
1804 */
1805void
1806pci_intx(struct pci_dev *pdev, int enable)
1807{
1808 u16 pci_command, new;
1809
1810 pci_read_config_word(pdev, PCI_COMMAND, &pci_command);
1811
1812 if (enable) {
1813 new = pci_command & ~PCI_COMMAND_INTX_DISABLE;
1814 } else {
1815 new = pci_command | PCI_COMMAND_INTX_DISABLE;
1816 }
1817
1818 if (new != pci_command) {
Tejun Heo9ac78492007-01-20 16:00:26 +09001819 struct pci_devres *dr;
1820
Brett M Russ2fd9d742005-09-09 10:02:22 -07001821 pci_write_config_word(pdev, PCI_COMMAND, new);
Tejun Heo9ac78492007-01-20 16:00:26 +09001822
1823 dr = find_pci_dr(pdev);
1824 if (dr && !dr->restore_intx) {
1825 dr->restore_intx = 1;
1826 dr->orig_intx = !enable;
1827 }
Brett M Russa04ce0f2005-08-15 15:23:41 -04001828 }
1829}
1830
Eric W. Biedermanf5f2b132007-03-05 00:30:07 -08001831/**
1832 * pci_msi_off - disables any msi or msix capabilities
Randy Dunlap8d7d86e2007-03-16 19:55:52 -07001833 * @dev: the PCI device to operate on
Eric W. Biedermanf5f2b132007-03-05 00:30:07 -08001834 *
1835 * If you want to use msi see pci_enable_msi and friends.
1836 * This is a lower level primitive that allows us to disable
1837 * msi operation at the device level.
1838 */
1839void pci_msi_off(struct pci_dev *dev)
1840{
1841 int pos;
1842 u16 control;
1843
1844 pos = pci_find_capability(dev, PCI_CAP_ID_MSI);
1845 if (pos) {
1846 pci_read_config_word(dev, pos + PCI_MSI_FLAGS, &control);
1847 control &= ~PCI_MSI_FLAGS_ENABLE;
1848 pci_write_config_word(dev, pos + PCI_MSI_FLAGS, control);
1849 }
1850 pos = pci_find_capability(dev, PCI_CAP_ID_MSIX);
1851 if (pos) {
1852 pci_read_config_word(dev, pos + PCI_MSIX_FLAGS, &control);
1853 control &= ~PCI_MSIX_FLAGS_ENABLE;
1854 pci_write_config_word(dev, pos + PCI_MSIX_FLAGS, control);
1855 }
1856}
1857
Linus Torvalds1da177e2005-04-16 15:20:36 -07001858#ifndef HAVE_ARCH_PCI_SET_DMA_MASK
1859/*
1860 * These can be overridden by arch-specific implementations
1861 */
1862int
1863pci_set_dma_mask(struct pci_dev *dev, u64 mask)
1864{
1865 if (!pci_dma_supported(dev, mask))
1866 return -EIO;
1867
1868 dev->dma_mask = mask;
1869
1870 return 0;
1871}
1872
1873int
Linus Torvalds1da177e2005-04-16 15:20:36 -07001874pci_set_consistent_dma_mask(struct pci_dev *dev, u64 mask)
1875{
1876 if (!pci_dma_supported(dev, mask))
1877 return -EIO;
1878
1879 dev->dev.coherent_dma_mask = mask;
1880
1881 return 0;
1882}
1883#endif
Hidetoshi Setoc87deff2006-12-18 10:31:06 +09001884
FUJITA Tomonori4d57cdf2008-02-04 22:27:55 -08001885#ifndef HAVE_ARCH_PCI_SET_DMA_MAX_SEGMENT_SIZE
1886int pci_set_dma_max_seg_size(struct pci_dev *dev, unsigned int size)
1887{
1888 return dma_set_max_seg_size(&dev->dev, size);
1889}
1890EXPORT_SYMBOL(pci_set_dma_max_seg_size);
1891#endif
1892
FUJITA Tomonori59fc67d2008-02-04 22:28:14 -08001893#ifndef HAVE_ARCH_PCI_SET_DMA_SEGMENT_BOUNDARY
1894int pci_set_dma_seg_boundary(struct pci_dev *dev, unsigned long mask)
1895{
1896 return dma_set_seg_boundary(&dev->dev, mask);
1897}
1898EXPORT_SYMBOL(pci_set_dma_seg_boundary);
1899#endif
1900
Sheng Yangd91cdc72008-11-11 17:17:47 +08001901static int __pcie_flr(struct pci_dev *dev, int probe)
Sheng Yang8dd7f802008-10-21 17:38:25 +08001902{
1903 u16 status;
1904 u32 cap;
1905 int exppos = pci_find_capability(dev, PCI_CAP_ID_EXP);
1906
1907 if (!exppos)
1908 return -ENOTTY;
1909 pci_read_config_dword(dev, exppos + PCI_EXP_DEVCAP, &cap);
1910 if (!(cap & PCI_EXP_DEVCAP_FLR))
1911 return -ENOTTY;
1912
Sheng Yangd91cdc72008-11-11 17:17:47 +08001913 if (probe)
1914 return 0;
1915
Sheng Yang8dd7f802008-10-21 17:38:25 +08001916 pci_block_user_cfg_access(dev);
1917
1918 /* Wait for Transaction Pending bit clean */
1919 msleep(100);
1920 pci_read_config_word(dev, exppos + PCI_EXP_DEVSTA, &status);
1921 if (status & PCI_EXP_DEVSTA_TRPND) {
1922 dev_info(&dev->dev, "Busy after 100ms while trying to reset; "
1923 "sleeping for 1 second\n");
1924 ssleep(1);
1925 pci_read_config_word(dev, exppos + PCI_EXP_DEVSTA, &status);
1926 if (status & PCI_EXP_DEVSTA_TRPND)
1927 dev_info(&dev->dev, "Still busy after 1s; "
1928 "proceeding with reset anyway\n");
1929 }
1930
1931 pci_write_config_word(dev, exppos + PCI_EXP_DEVCTL,
1932 PCI_EXP_DEVCTL_BCR_FLR);
1933 mdelay(100);
1934
1935 pci_unblock_user_cfg_access(dev);
1936 return 0;
1937}
Sheng Yangd91cdc72008-11-11 17:17:47 +08001938
Sheng Yang1ca88792008-11-11 17:17:48 +08001939static int __pci_af_flr(struct pci_dev *dev, int probe)
1940{
1941 int cappos = pci_find_capability(dev, PCI_CAP_ID_AF);
1942 u8 status;
1943 u8 cap;
1944
1945 if (!cappos)
1946 return -ENOTTY;
1947 pci_read_config_byte(dev, cappos + PCI_AF_CAP, &cap);
1948 if (!(cap & PCI_AF_CAP_TP) || !(cap & PCI_AF_CAP_FLR))
1949 return -ENOTTY;
1950
1951 if (probe)
1952 return 0;
1953
1954 pci_block_user_cfg_access(dev);
1955
1956 /* Wait for Transaction Pending bit clean */
1957 msleep(100);
1958 pci_read_config_byte(dev, cappos + PCI_AF_STATUS, &status);
1959 if (status & PCI_AF_STATUS_TP) {
1960 dev_info(&dev->dev, "Busy after 100ms while trying to"
1961 " reset; sleeping for 1 second\n");
1962 ssleep(1);
1963 pci_read_config_byte(dev,
1964 cappos + PCI_AF_STATUS, &status);
1965 if (status & PCI_AF_STATUS_TP)
1966 dev_info(&dev->dev, "Still busy after 1s; "
1967 "proceeding with reset anyway\n");
1968 }
1969 pci_write_config_byte(dev, cappos + PCI_AF_CTRL, PCI_AF_CTRL_FLR);
1970 mdelay(100);
1971
1972 pci_unblock_user_cfg_access(dev);
1973 return 0;
1974}
1975
Sheng Yangd91cdc72008-11-11 17:17:47 +08001976static int __pci_reset_function(struct pci_dev *pdev, int probe)
1977{
1978 int res;
1979
1980 res = __pcie_flr(pdev, probe);
1981 if (res != -ENOTTY)
1982 return res;
1983
Sheng Yang1ca88792008-11-11 17:17:48 +08001984 res = __pci_af_flr(pdev, probe);
1985 if (res != -ENOTTY)
1986 return res;
1987
Sheng Yangd91cdc72008-11-11 17:17:47 +08001988 return res;
1989}
1990
1991/**
1992 * pci_execute_reset_function() - Reset a PCI device function
1993 * @dev: Device function to reset
1994 *
1995 * Some devices allow an individual function to be reset without affecting
1996 * other functions in the same device. The PCI device must be responsive
1997 * to PCI config space in order to use this function.
1998 *
1999 * The device function is presumed to be unused when this function is called.
2000 * Resetting the device will make the contents of PCI configuration space
2001 * random, so any caller of this must be prepared to reinitialise the
2002 * device including MSI, bus mastering, BARs, decoding IO and memory spaces,
2003 * etc.
2004 *
2005 * Returns 0 if the device function was successfully reset or -ENOTTY if the
2006 * device doesn't support resetting a single function.
2007 */
2008int pci_execute_reset_function(struct pci_dev *dev)
2009{
2010 return __pci_reset_function(dev, 0);
2011}
Sheng Yang8dd7f802008-10-21 17:38:25 +08002012EXPORT_SYMBOL_GPL(pci_execute_reset_function);
2013
2014/**
2015 * pci_reset_function() - quiesce and reset a PCI device function
2016 * @dev: Device function to reset
2017 *
2018 * Some devices allow an individual function to be reset without affecting
2019 * other functions in the same device. The PCI device must be responsive
2020 * to PCI config space in order to use this function.
2021 *
2022 * This function does not just reset the PCI portion of a device, but
2023 * clears all the state associated with the device. This function differs
2024 * from pci_execute_reset_function in that it saves and restores device state
2025 * over the reset.
2026 *
2027 * Returns 0 if the device function was successfully reset or -ENOTTY if the
2028 * device doesn't support resetting a single function.
2029 */
2030int pci_reset_function(struct pci_dev *dev)
2031{
Sheng Yangd91cdc72008-11-11 17:17:47 +08002032 int r = __pci_reset_function(dev, 1);
Sheng Yang8dd7f802008-10-21 17:38:25 +08002033
Sheng Yangd91cdc72008-11-11 17:17:47 +08002034 if (r < 0)
2035 return r;
Sheng Yang8dd7f802008-10-21 17:38:25 +08002036
Sheng Yang1df8fb32008-11-11 17:17:45 +08002037 if (!dev->msi_enabled && !dev->msix_enabled && dev->irq != 0)
Sheng Yang8dd7f802008-10-21 17:38:25 +08002038 disable_irq(dev->irq);
2039 pci_save_state(dev);
2040
2041 pci_write_config_word(dev, PCI_COMMAND, PCI_COMMAND_INTX_DISABLE);
2042
2043 r = pci_execute_reset_function(dev);
2044
2045 pci_restore_state(dev);
Sheng Yang1df8fb32008-11-11 17:17:45 +08002046 if (!dev->msi_enabled && !dev->msix_enabled && dev->irq != 0)
Sheng Yang8dd7f802008-10-21 17:38:25 +08002047 enable_irq(dev->irq);
2048
2049 return r;
2050}
2051EXPORT_SYMBOL_GPL(pci_reset_function);
2052
2053/**
Peter Orubad556ad42007-05-15 13:59:13 +02002054 * pcix_get_max_mmrbc - get PCI-X maximum designed memory read byte count
2055 * @dev: PCI device to query
2056 *
2057 * Returns mmrbc: maximum designed memory read count in bytes
2058 * or appropriate error value.
2059 */
2060int pcix_get_max_mmrbc(struct pci_dev *dev)
2061{
Andrew Mortonb7b095c2007-07-09 11:55:50 -07002062 int err, cap;
Peter Orubad556ad42007-05-15 13:59:13 +02002063 u32 stat;
2064
2065 cap = pci_find_capability(dev, PCI_CAP_ID_PCIX);
2066 if (!cap)
2067 return -EINVAL;
2068
2069 err = pci_read_config_dword(dev, cap + PCI_X_STATUS, &stat);
2070 if (err)
2071 return -EINVAL;
2072
Andrew Mortonb7b095c2007-07-09 11:55:50 -07002073 return (stat & PCI_X_STATUS_MAX_READ) >> 12;
Peter Orubad556ad42007-05-15 13:59:13 +02002074}
2075EXPORT_SYMBOL(pcix_get_max_mmrbc);
2076
2077/**
2078 * pcix_get_mmrbc - get PCI-X maximum memory read byte count
2079 * @dev: PCI device to query
2080 *
2081 * Returns mmrbc: maximum memory read count in bytes
2082 * or appropriate error value.
2083 */
2084int pcix_get_mmrbc(struct pci_dev *dev)
2085{
2086 int ret, cap;
2087 u32 cmd;
2088
2089 cap = pci_find_capability(dev, PCI_CAP_ID_PCIX);
2090 if (!cap)
2091 return -EINVAL;
2092
2093 ret = pci_read_config_dword(dev, cap + PCI_X_CMD, &cmd);
2094 if (!ret)
2095 ret = 512 << ((cmd & PCI_X_CMD_MAX_READ) >> 2);
2096
2097 return ret;
2098}
2099EXPORT_SYMBOL(pcix_get_mmrbc);
2100
2101/**
2102 * pcix_set_mmrbc - set PCI-X maximum memory read byte count
2103 * @dev: PCI device to query
2104 * @mmrbc: maximum memory read count in bytes
2105 * valid values are 512, 1024, 2048, 4096
2106 *
2107 * If possible sets maximum memory read byte count, some bridges have erratas
2108 * that prevent this.
2109 */
2110int pcix_set_mmrbc(struct pci_dev *dev, int mmrbc)
2111{
2112 int cap, err = -EINVAL;
2113 u32 stat, cmd, v, o;
2114
vignesh babu229f5af2007-08-13 18:23:14 +05302115 if (mmrbc < 512 || mmrbc > 4096 || !is_power_of_2(mmrbc))
Peter Orubad556ad42007-05-15 13:59:13 +02002116 goto out;
2117
2118 v = ffs(mmrbc) - 10;
2119
2120 cap = pci_find_capability(dev, PCI_CAP_ID_PCIX);
2121 if (!cap)
2122 goto out;
2123
2124 err = pci_read_config_dword(dev, cap + PCI_X_STATUS, &stat);
2125 if (err)
2126 goto out;
2127
2128 if (v > (stat & PCI_X_STATUS_MAX_READ) >> 21)
2129 return -E2BIG;
2130
2131 err = pci_read_config_dword(dev, cap + PCI_X_CMD, &cmd);
2132 if (err)
2133 goto out;
2134
2135 o = (cmd & PCI_X_CMD_MAX_READ) >> 2;
2136 if (o != v) {
2137 if (v > o && dev->bus &&
2138 (dev->bus->bus_flags & PCI_BUS_FLAGS_NO_MMRBC))
2139 return -EIO;
2140
2141 cmd &= ~PCI_X_CMD_MAX_READ;
2142 cmd |= v << 2;
2143 err = pci_write_config_dword(dev, cap + PCI_X_CMD, cmd);
2144 }
2145out:
2146 return err;
2147}
2148EXPORT_SYMBOL(pcix_set_mmrbc);
2149
2150/**
2151 * pcie_get_readrq - get PCI Express read request size
2152 * @dev: PCI device to query
2153 *
2154 * Returns maximum memory read request in bytes
2155 * or appropriate error value.
2156 */
2157int pcie_get_readrq(struct pci_dev *dev)
2158{
2159 int ret, cap;
2160 u16 ctl;
2161
2162 cap = pci_find_capability(dev, PCI_CAP_ID_EXP);
2163 if (!cap)
2164 return -EINVAL;
2165
2166 ret = pci_read_config_word(dev, cap + PCI_EXP_DEVCTL, &ctl);
2167 if (!ret)
2168 ret = 128 << ((ctl & PCI_EXP_DEVCTL_READRQ) >> 12);
2169
2170 return ret;
2171}
2172EXPORT_SYMBOL(pcie_get_readrq);
2173
2174/**
2175 * pcie_set_readrq - set PCI Express maximum memory read request
2176 * @dev: PCI device to query
Randy Dunlap42e61f42007-07-23 21:42:11 -07002177 * @rq: maximum memory read count in bytes
Peter Orubad556ad42007-05-15 13:59:13 +02002178 * valid values are 128, 256, 512, 1024, 2048, 4096
2179 *
2180 * If possible sets maximum read byte count
2181 */
2182int pcie_set_readrq(struct pci_dev *dev, int rq)
2183{
2184 int cap, err = -EINVAL;
2185 u16 ctl, v;
2186
vignesh babu229f5af2007-08-13 18:23:14 +05302187 if (rq < 128 || rq > 4096 || !is_power_of_2(rq))
Peter Orubad556ad42007-05-15 13:59:13 +02002188 goto out;
2189
2190 v = (ffs(rq) - 8) << 12;
2191
2192 cap = pci_find_capability(dev, PCI_CAP_ID_EXP);
2193 if (!cap)
2194 goto out;
2195
2196 err = pci_read_config_word(dev, cap + PCI_EXP_DEVCTL, &ctl);
2197 if (err)
2198 goto out;
2199
2200 if ((ctl & PCI_EXP_DEVCTL_READRQ) != v) {
2201 ctl &= ~PCI_EXP_DEVCTL_READRQ;
2202 ctl |= v;
2203 err = pci_write_config_dword(dev, cap + PCI_EXP_DEVCTL, ctl);
2204 }
2205
2206out:
2207 return err;
2208}
2209EXPORT_SYMBOL(pcie_set_readrq);
2210
2211/**
Hidetoshi Setoc87deff2006-12-18 10:31:06 +09002212 * pci_select_bars - Make BAR mask from the type of resource
Randy Dunlapf95d8822007-02-10 14:41:56 -08002213 * @dev: the PCI device for which BAR mask is made
Hidetoshi Setoc87deff2006-12-18 10:31:06 +09002214 * @flags: resource type mask to be selected
2215 *
2216 * This helper routine makes bar mask from the type of resource.
2217 */
2218int pci_select_bars(struct pci_dev *dev, unsigned long flags)
2219{
2220 int i, bars = 0;
2221 for (i = 0; i < PCI_NUM_RESOURCES; i++)
2222 if (pci_resource_flags(dev, i) & flags)
2223 bars |= (1 << i);
2224 return bars;
2225}
2226
Yu Zhao613e7ed2008-11-22 02:41:27 +08002227/**
2228 * pci_resource_bar - get position of the BAR associated with a resource
2229 * @dev: the PCI device
2230 * @resno: the resource number
2231 * @type: the BAR type to be filled in
2232 *
2233 * Returns BAR position in config space, or 0 if the BAR is invalid.
2234 */
2235int pci_resource_bar(struct pci_dev *dev, int resno, enum pci_bar_type *type)
2236{
2237 if (resno < PCI_ROM_RESOURCE) {
2238 *type = pci_bar_unknown;
2239 return PCI_BASE_ADDRESS_0 + 4 * resno;
2240 } else if (resno == PCI_ROM_RESOURCE) {
2241 *type = pci_bar_mem32;
2242 return dev->rom_base_reg;
2243 }
2244
2245 dev_err(&dev->dev, "BAR: invalid resource #%d\n", resno);
2246 return 0;
2247}
2248
Jeff Garzik32a2eea2007-10-11 16:57:27 -04002249static void __devinit pci_no_domains(void)
2250{
2251#ifdef CONFIG_PCI_DOMAINS
2252 pci_domains_supported = 0;
2253#endif
2254}
2255
Andrew Patterson0ef5f8f2008-11-10 15:30:50 -07002256/**
2257 * pci_ext_cfg_enabled - can we access extended PCI config space?
2258 * @dev: The PCI device of the root bridge.
2259 *
2260 * Returns 1 if we can access PCI extended config space (offsets
2261 * greater than 0xff). This is the default implementation. Architecture
2262 * implementations can override this.
2263 */
2264int __attribute__ ((weak)) pci_ext_cfg_avail(struct pci_dev *dev)
2265{
2266 return 1;
2267}
2268
Linus Torvalds1da177e2005-04-16 15:20:36 -07002269static int __devinit pci_init(void)
2270{
2271 struct pci_dev *dev = NULL;
2272
2273 while ((dev = pci_get_device(PCI_ANY_ID, PCI_ANY_ID, dev)) != NULL) {
2274 pci_fixup_device(pci_fixup_final, dev);
2275 }
Taku Izumid389fec2008-10-17 13:52:51 +09002276
Linus Torvalds1da177e2005-04-16 15:20:36 -07002277 return 0;
2278}
2279
Al Viroad04d312008-11-22 17:37:14 +00002280static int __init pci_setup(char *str)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002281{
2282 while (str) {
2283 char *k = strchr(str, ',');
2284 if (k)
2285 *k++ = 0;
2286 if (*str && (str = pcibios_setup(str)) && *str) {
Matthew Wilcox309e57d2006-03-05 22:33:34 -07002287 if (!strcmp(str, "nomsi")) {
2288 pci_no_msi();
Randy Dunlap7f785762007-10-05 13:17:58 -07002289 } else if (!strcmp(str, "noaer")) {
2290 pci_no_aer();
Jeff Garzik32a2eea2007-10-11 16:57:27 -04002291 } else if (!strcmp(str, "nodomains")) {
2292 pci_no_domains();
Atsushi Nemoto4516a612007-02-05 16:36:06 -08002293 } else if (!strncmp(str, "cbiosize=", 9)) {
2294 pci_cardbus_io_size = memparse(str + 9, &str);
2295 } else if (!strncmp(str, "cbmemsize=", 10)) {
2296 pci_cardbus_mem_size = memparse(str + 10, &str);
Matthew Wilcox309e57d2006-03-05 22:33:34 -07002297 } else {
2298 printk(KERN_ERR "PCI: Unknown option `%s'\n",
2299 str);
2300 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07002301 }
2302 str = k;
2303 }
Andi Kleen0637a702006-09-26 10:52:41 +02002304 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002305}
Andi Kleen0637a702006-09-26 10:52:41 +02002306early_param("pci", pci_setup);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002307
2308device_initcall(pci_init);
2309
Tejun Heo0b62e132007-07-27 14:43:35 +09002310EXPORT_SYMBOL(pci_reenable_device);
Benjamin Herrenschmidtb7189892007-12-20 15:28:08 +11002311EXPORT_SYMBOL(pci_enable_device_io);
2312EXPORT_SYMBOL(pci_enable_device_mem);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002313EXPORT_SYMBOL(pci_enable_device);
Tejun Heo9ac78492007-01-20 16:00:26 +09002314EXPORT_SYMBOL(pcim_enable_device);
2315EXPORT_SYMBOL(pcim_pin_device);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002316EXPORT_SYMBOL(pci_disable_device);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002317EXPORT_SYMBOL(pci_find_capability);
2318EXPORT_SYMBOL(pci_bus_find_capability);
2319EXPORT_SYMBOL(pci_release_regions);
2320EXPORT_SYMBOL(pci_request_regions);
Arjan van de Vene8de1482008-10-22 19:55:31 -07002321EXPORT_SYMBOL(pci_request_regions_exclusive);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002322EXPORT_SYMBOL(pci_release_region);
2323EXPORT_SYMBOL(pci_request_region);
Arjan van de Vene8de1482008-10-22 19:55:31 -07002324EXPORT_SYMBOL(pci_request_region_exclusive);
Hidetoshi Setoc87deff2006-12-18 10:31:06 +09002325EXPORT_SYMBOL(pci_release_selected_regions);
2326EXPORT_SYMBOL(pci_request_selected_regions);
Arjan van de Vene8de1482008-10-22 19:55:31 -07002327EXPORT_SYMBOL(pci_request_selected_regions_exclusive);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002328EXPORT_SYMBOL(pci_set_master);
2329EXPORT_SYMBOL(pci_set_mwi);
Randy Dunlap694625c2007-07-09 11:55:54 -07002330EXPORT_SYMBOL(pci_try_set_mwi);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002331EXPORT_SYMBOL(pci_clear_mwi);
Brett M Russa04ce0f2005-08-15 15:23:41 -04002332EXPORT_SYMBOL_GPL(pci_intx);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002333EXPORT_SYMBOL(pci_set_dma_mask);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002334EXPORT_SYMBOL(pci_set_consistent_dma_mask);
2335EXPORT_SYMBOL(pci_assign_resource);
2336EXPORT_SYMBOL(pci_find_parent_resource);
Hidetoshi Setoc87deff2006-12-18 10:31:06 +09002337EXPORT_SYMBOL(pci_select_bars);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002338
2339EXPORT_SYMBOL(pci_set_power_state);
2340EXPORT_SYMBOL(pci_save_state);
2341EXPORT_SYMBOL(pci_restore_state);
Rafael J. Wysockie5899e12008-07-19 14:39:24 +02002342EXPORT_SYMBOL(pci_pme_capable);
Rafael J. Wysocki5a6c9b62008-08-08 00:14:24 +02002343EXPORT_SYMBOL(pci_pme_active);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002344EXPORT_SYMBOL(pci_enable_wake);
Rafael J. Wysocki0235c4f2008-08-18 21:38:00 +02002345EXPORT_SYMBOL(pci_wake_from_d3);
Rafael J. Wysockie5899e12008-07-19 14:39:24 +02002346EXPORT_SYMBOL(pci_target_state);
Rafael J. Wysocki404cc2d2008-07-07 03:35:26 +02002347EXPORT_SYMBOL(pci_prepare_to_sleep);
2348EXPORT_SYMBOL(pci_back_from_sleep);
Brian Kingf7bdd122007-04-06 16:39:36 -05002349EXPORT_SYMBOL_GPL(pci_set_pcie_reset_state);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002350