]> err.no Git - linux-2.6/blob - drivers/pci/pci.c
PCI: Add pci_enable_device_{io,mem} intefaces
[linux-2.6] / drivers / pci / pci.c
1 /*
2  *      $Id: pci.c,v 1.91 1999/01/21 13:34:01 davem Exp $
3  *
4  *      PCI Bus Services, see include/linux/pci.h for further explanation.
5  *
6  *      Copyright 1993 -- 1997 Drew Eckhardt, Frederic Potter,
7  *      David Mosberger-Tang
8  *
9  *      Copyright 1997 -- 2000 Martin Mares <mj@ucw.cz>
10  */
11
12 #include <linux/kernel.h>
13 #include <linux/delay.h>
14 #include <linux/init.h>
15 #include <linux/pci.h>
16 #include <linux/pm.h>
17 #include <linux/module.h>
18 #include <linux/spinlock.h>
19 #include <linux/string.h>
20 #include <linux/log2.h>
21 #include <asm/dma.h>    /* isa_dma_bridge_buggy */
22 #include "pci.h"
23
24 unsigned int pci_pm_d3_delay = 10;
25
26 #ifdef CONFIG_PCI_DOMAINS
27 int pci_domains_supported = 1;
28 #endif
29
30 #define DEFAULT_CARDBUS_IO_SIZE         (256)
31 #define DEFAULT_CARDBUS_MEM_SIZE        (64*1024*1024)
32 /* pci=cbmemsize=nnM,cbiosize=nn can override this */
33 unsigned long pci_cardbus_io_size = DEFAULT_CARDBUS_IO_SIZE;
34 unsigned long pci_cardbus_mem_size = DEFAULT_CARDBUS_MEM_SIZE;
35
36 /**
37  * pci_bus_max_busnr - returns maximum PCI bus number of given bus' children
38  * @bus: pointer to PCI bus structure to search
39  *
40  * Given a PCI bus, returns the highest PCI bus number present in the set
41  * including the given PCI bus and its list of child PCI buses.
42  */
43 unsigned char pci_bus_max_busnr(struct pci_bus* bus)
44 {
45         struct list_head *tmp;
46         unsigned char max, n;
47
48         max = bus->subordinate;
49         list_for_each(tmp, &bus->children) {
50                 n = pci_bus_max_busnr(pci_bus_b(tmp));
51                 if(n > max)
52                         max = n;
53         }
54         return max;
55 }
56 EXPORT_SYMBOL_GPL(pci_bus_max_busnr);
57
58 #if 0
59 /**
60  * pci_max_busnr - returns maximum PCI bus number
61  *
62  * Returns the highest PCI bus number present in the system global list of
63  * PCI buses.
64  */
65 unsigned char __devinit
66 pci_max_busnr(void)
67 {
68         struct pci_bus *bus = NULL;
69         unsigned char max, n;
70
71         max = 0;
72         while ((bus = pci_find_next_bus(bus)) != NULL) {
73                 n = pci_bus_max_busnr(bus);
74                 if(n > max)
75                         max = n;
76         }
77         return max;
78 }
79
80 #endif  /*  0  */
81
82 #define PCI_FIND_CAP_TTL        48
83
84 static int __pci_find_next_cap_ttl(struct pci_bus *bus, unsigned int devfn,
85                                    u8 pos, int cap, int *ttl)
86 {
87         u8 id;
88
89         while ((*ttl)--) {
90                 pci_bus_read_config_byte(bus, devfn, pos, &pos);
91                 if (pos < 0x40)
92                         break;
93                 pos &= ~3;
94                 pci_bus_read_config_byte(bus, devfn, pos + PCI_CAP_LIST_ID,
95                                          &id);
96                 if (id == 0xff)
97                         break;
98                 if (id == cap)
99                         return pos;
100                 pos += PCI_CAP_LIST_NEXT;
101         }
102         return 0;
103 }
104
105 static int __pci_find_next_cap(struct pci_bus *bus, unsigned int devfn,
106                                u8 pos, int cap)
107 {
108         int ttl = PCI_FIND_CAP_TTL;
109
110         return __pci_find_next_cap_ttl(bus, devfn, pos, cap, &ttl);
111 }
112
113 int pci_find_next_capability(struct pci_dev *dev, u8 pos, int cap)
114 {
115         return __pci_find_next_cap(dev->bus, dev->devfn,
116                                    pos + PCI_CAP_LIST_NEXT, cap);
117 }
118 EXPORT_SYMBOL_GPL(pci_find_next_capability);
119
120 static int __pci_bus_find_cap_start(struct pci_bus *bus,
121                                     unsigned int devfn, u8 hdr_type)
122 {
123         u16 status;
124
125         pci_bus_read_config_word(bus, devfn, PCI_STATUS, &status);
126         if (!(status & PCI_STATUS_CAP_LIST))
127                 return 0;
128
129         switch (hdr_type) {
130         case PCI_HEADER_TYPE_NORMAL:
131         case PCI_HEADER_TYPE_BRIDGE:
132                 return PCI_CAPABILITY_LIST;
133         case PCI_HEADER_TYPE_CARDBUS:
134                 return PCI_CB_CAPABILITY_LIST;
135         default:
136                 return 0;
137         }
138
139         return 0;
140 }
141
142 /**
143  * pci_find_capability - query for devices' capabilities 
144  * @dev: PCI device to query
145  * @cap: capability code
146  *
147  * Tell if a device supports a given PCI capability.
148  * Returns the address of the requested capability structure within the
149  * device's PCI configuration space or 0 in case the device does not
150  * support it.  Possible values for @cap:
151  *
152  *  %PCI_CAP_ID_PM           Power Management 
153  *  %PCI_CAP_ID_AGP          Accelerated Graphics Port 
154  *  %PCI_CAP_ID_VPD          Vital Product Data 
155  *  %PCI_CAP_ID_SLOTID       Slot Identification 
156  *  %PCI_CAP_ID_MSI          Message Signalled Interrupts
157  *  %PCI_CAP_ID_CHSWP        CompactPCI HotSwap 
158  *  %PCI_CAP_ID_PCIX         PCI-X
159  *  %PCI_CAP_ID_EXP          PCI Express
160  */
161 int pci_find_capability(struct pci_dev *dev, int cap)
162 {
163         int pos;
164
165         pos = __pci_bus_find_cap_start(dev->bus, dev->devfn, dev->hdr_type);
166         if (pos)
167                 pos = __pci_find_next_cap(dev->bus, dev->devfn, pos, cap);
168
169         return pos;
170 }
171
172 /**
173  * pci_bus_find_capability - query for devices' capabilities 
174  * @bus:   the PCI bus to query
175  * @devfn: PCI device to query
176  * @cap:   capability code
177  *
178  * Like pci_find_capability() but works for pci devices that do not have a
179  * pci_dev structure set up yet. 
180  *
181  * Returns the address of the requested capability structure within the
182  * device's PCI configuration space or 0 in case the device does not
183  * support it.
184  */
185 int pci_bus_find_capability(struct pci_bus *bus, unsigned int devfn, int cap)
186 {
187         int pos;
188         u8 hdr_type;
189
190         pci_bus_read_config_byte(bus, devfn, PCI_HEADER_TYPE, &hdr_type);
191
192         pos = __pci_bus_find_cap_start(bus, devfn, hdr_type & 0x7f);
193         if (pos)
194                 pos = __pci_find_next_cap(bus, devfn, pos, cap);
195
196         return pos;
197 }
198
199 /**
200  * pci_find_ext_capability - Find an extended capability
201  * @dev: PCI device to query
202  * @cap: capability code
203  *
204  * Returns the address of the requested extended capability structure
205  * within the device's PCI configuration space or 0 if the device does
206  * not support it.  Possible values for @cap:
207  *
208  *  %PCI_EXT_CAP_ID_ERR         Advanced Error Reporting
209  *  %PCI_EXT_CAP_ID_VC          Virtual Channel
210  *  %PCI_EXT_CAP_ID_DSN         Device Serial Number
211  *  %PCI_EXT_CAP_ID_PWR         Power Budgeting
212  */
213 int pci_find_ext_capability(struct pci_dev *dev, int cap)
214 {
215         u32 header;
216         int ttl = 480; /* 3840 bytes, minimum 8 bytes per capability */
217         int pos = 0x100;
218
219         if (dev->cfg_size <= 256)
220                 return 0;
221
222         if (pci_read_config_dword(dev, pos, &header) != PCIBIOS_SUCCESSFUL)
223                 return 0;
224
225         /*
226          * If we have no capabilities, this is indicated by cap ID,
227          * cap version and next pointer all being 0.
228          */
229         if (header == 0)
230                 return 0;
231
232         while (ttl-- > 0) {
233                 if (PCI_EXT_CAP_ID(header) == cap)
234                         return pos;
235
236                 pos = PCI_EXT_CAP_NEXT(header);
237                 if (pos < 0x100)
238                         break;
239
240                 if (pci_read_config_dword(dev, pos, &header) != PCIBIOS_SUCCESSFUL)
241                         break;
242         }
243
244         return 0;
245 }
246 EXPORT_SYMBOL_GPL(pci_find_ext_capability);
247
248 static int __pci_find_next_ht_cap(struct pci_dev *dev, int pos, int ht_cap)
249 {
250         int rc, ttl = PCI_FIND_CAP_TTL;
251         u8 cap, mask;
252
253         if (ht_cap == HT_CAPTYPE_SLAVE || ht_cap == HT_CAPTYPE_HOST)
254                 mask = HT_3BIT_CAP_MASK;
255         else
256                 mask = HT_5BIT_CAP_MASK;
257
258         pos = __pci_find_next_cap_ttl(dev->bus, dev->devfn, pos,
259                                       PCI_CAP_ID_HT, &ttl);
260         while (pos) {
261                 rc = pci_read_config_byte(dev, pos + 3, &cap);
262                 if (rc != PCIBIOS_SUCCESSFUL)
263                         return 0;
264
265                 if ((cap & mask) == ht_cap)
266                         return pos;
267
268                 pos = __pci_find_next_cap_ttl(dev->bus, dev->devfn,
269                                               pos + PCI_CAP_LIST_NEXT,
270                                               PCI_CAP_ID_HT, &ttl);
271         }
272
273         return 0;
274 }
275 /**
276  * pci_find_next_ht_capability - query a device's Hypertransport capabilities
277  * @dev: PCI device to query
278  * @pos: Position from which to continue searching
279  * @ht_cap: Hypertransport capability code
280  *
281  * To be used in conjunction with pci_find_ht_capability() to search for
282  * all capabilities matching @ht_cap. @pos should always be a value returned
283  * from pci_find_ht_capability().
284  *
285  * NB. To be 100% safe against broken PCI devices, the caller should take
286  * steps to avoid an infinite loop.
287  */
288 int pci_find_next_ht_capability(struct pci_dev *dev, int pos, int ht_cap)
289 {
290         return __pci_find_next_ht_cap(dev, pos + PCI_CAP_LIST_NEXT, ht_cap);
291 }
292 EXPORT_SYMBOL_GPL(pci_find_next_ht_capability);
293
294 /**
295  * pci_find_ht_capability - query a device's Hypertransport capabilities
296  * @dev: PCI device to query
297  * @ht_cap: Hypertransport capability code
298  *
299  * Tell if a device supports a given Hypertransport capability.
300  * Returns an address within the device's PCI configuration space
301  * or 0 in case the device does not support the request capability.
302  * The address points to the PCI capability, of type PCI_CAP_ID_HT,
303  * which has a Hypertransport capability matching @ht_cap.
304  */
305 int pci_find_ht_capability(struct pci_dev *dev, int ht_cap)
306 {
307         int pos;
308
309         pos = __pci_bus_find_cap_start(dev->bus, dev->devfn, dev->hdr_type);
310         if (pos)
311                 pos = __pci_find_next_ht_cap(dev, pos, ht_cap);
312
313         return pos;
314 }
315 EXPORT_SYMBOL_GPL(pci_find_ht_capability);
316
317 void pcie_wait_pending_transaction(struct pci_dev *dev)
318 {
319         int pos;
320         u16 reg16;
321
322         pos = pci_find_capability(dev, PCI_CAP_ID_EXP);
323         if (!pos)
324                 return;
325         while (1) {
326                 pci_read_config_word(dev, pos + PCI_EXP_DEVSTA, &reg16);
327                 if (!(reg16 & PCI_EXP_DEVSTA_TRPND))
328                         break;
329                 cpu_relax();
330         }
331
332 }
333 EXPORT_SYMBOL_GPL(pcie_wait_pending_transaction);
334
335 /**
336  * pci_find_parent_resource - return resource region of parent bus of given region
337  * @dev: PCI device structure contains resources to be searched
338  * @res: child resource record for which parent is sought
339  *
340  *  For given resource region of given device, return the resource
341  *  region of parent bus the given region is contained in or where
342  *  it should be allocated from.
343  */
344 struct resource *
345 pci_find_parent_resource(const struct pci_dev *dev, struct resource *res)
346 {
347         const struct pci_bus *bus = dev->bus;
348         int i;
349         struct resource *best = NULL;
350
351         for(i = 0; i < PCI_BUS_NUM_RESOURCES; i++) {
352                 struct resource *r = bus->resource[i];
353                 if (!r)
354                         continue;
355                 if (res->start && !(res->start >= r->start && res->end <= r->end))
356                         continue;       /* Not contained */
357                 if ((res->flags ^ r->flags) & (IORESOURCE_IO | IORESOURCE_MEM))
358                         continue;       /* Wrong type */
359                 if (!((res->flags ^ r->flags) & IORESOURCE_PREFETCH))
360                         return r;       /* Exact match */
361                 if ((res->flags & IORESOURCE_PREFETCH) && !(r->flags & IORESOURCE_PREFETCH))
362                         best = r;       /* Approximating prefetchable by non-prefetchable */
363         }
364         return best;
365 }
366
367 /**
368  * pci_restore_bars - restore a devices BAR values (e.g. after wake-up)
369  * @dev: PCI device to have its BARs restored
370  *
371  * Restore the BAR values for a given device, so as to make it
372  * accessible by its driver.
373  */
374 static void
375 pci_restore_bars(struct pci_dev *dev)
376 {
377         int i, numres;
378
379         switch (dev->hdr_type) {
380         case PCI_HEADER_TYPE_NORMAL:
381                 numres = 6;
382                 break;
383         case PCI_HEADER_TYPE_BRIDGE:
384                 numres = 2;
385                 break;
386         case PCI_HEADER_TYPE_CARDBUS:
387                 numres = 1;
388                 break;
389         default:
390                 /* Should never get here, but just in case... */
391                 return;
392         }
393
394         for (i = 0; i < numres; i ++)
395                 pci_update_resource(dev, &dev->resource[i], i);
396 }
397
398 int (*platform_pci_set_power_state)(struct pci_dev *dev, pci_power_t t);
399
400 /**
401  * pci_set_power_state - Set the power state of a PCI device
402  * @dev: PCI device to be suspended
403  * @state: PCI power state (D0, D1, D2, D3hot, D3cold) we're entering
404  *
405  * Transition a device to a new power state, using the Power Management 
406  * Capabilities in the device's config space.
407  *
408  * RETURN VALUE: 
409  * -EINVAL if trying to enter a lower state than we're already in.
410  * 0 if we're already in the requested state.
411  * -EIO if device does not support PCI PM.
412  * 0 if we can successfully change the power state.
413  */
414 int
415 pci_set_power_state(struct pci_dev *dev, pci_power_t state)
416 {
417         int pm, need_restore = 0;
418         u16 pmcsr, pmc;
419
420         /* bound the state we're entering */
421         if (state > PCI_D3hot)
422                 state = PCI_D3hot;
423
424         /*
425          * If the device or the parent bridge can't support PCI PM, ignore
426          * the request if we're doing anything besides putting it into D0
427          * (which would only happen on boot).
428          */
429         if ((state == PCI_D1 || state == PCI_D2) && pci_no_d1d2(dev))
430                 return 0;
431
432         /* find PCI PM capability in list */
433         pm = pci_find_capability(dev, PCI_CAP_ID_PM);
434
435         /* abort if the device doesn't support PM capabilities */
436         if (!pm)
437                 return -EIO;
438
439         /* Validate current state:
440          * Can enter D0 from any state, but if we can only go deeper 
441          * to sleep if we're already in a low power state
442          */
443         if (state != PCI_D0 && dev->current_state > state) {
444                 printk(KERN_ERR "%s(): %s: state=%d, current state=%d\n",
445                         __FUNCTION__, pci_name(dev), state, dev->current_state);
446                 return -EINVAL;
447         } else if (dev->current_state == state)
448                 return 0;        /* we're already there */
449
450
451         pci_read_config_word(dev,pm + PCI_PM_PMC,&pmc);
452         if ((pmc & PCI_PM_CAP_VER_MASK) > 3) {
453                 printk(KERN_DEBUG
454                        "PCI: %s has unsupported PM cap regs version (%u)\n",
455                        pci_name(dev), pmc & PCI_PM_CAP_VER_MASK);
456                 return -EIO;
457         }
458
459         /* check if this device supports the desired state */
460         if (state == PCI_D1 && !(pmc & PCI_PM_CAP_D1))
461                 return -EIO;
462         else if (state == PCI_D2 && !(pmc & PCI_PM_CAP_D2))
463                 return -EIO;
464
465         pci_read_config_word(dev, pm + PCI_PM_CTRL, &pmcsr);
466
467         /* If we're (effectively) in D3, force entire word to 0.
468          * This doesn't affect PME_Status, disables PME_En, and
469          * sets PowerState to 0.
470          */
471         switch (dev->current_state) {
472         case PCI_D0:
473         case PCI_D1:
474         case PCI_D2:
475                 pmcsr &= ~PCI_PM_CTRL_STATE_MASK;
476                 pmcsr |= state;
477                 break;
478         case PCI_UNKNOWN: /* Boot-up */
479                 if ((pmcsr & PCI_PM_CTRL_STATE_MASK) == PCI_D3hot
480                  && !(pmcsr & PCI_PM_CTRL_NO_SOFT_RESET))
481                         need_restore = 1;
482                 /* Fall-through: force to D0 */
483         default:
484                 pmcsr = 0;
485                 break;
486         }
487
488         /* enter specified state */
489         pci_write_config_word(dev, pm + PCI_PM_CTRL, pmcsr);
490
491         /* Mandatory power management transition delays */
492         /* see PCI PM 1.1 5.6.1 table 18 */
493         if (state == PCI_D3hot || dev->current_state == PCI_D3hot)
494                 msleep(pci_pm_d3_delay);
495         else if (state == PCI_D2 || dev->current_state == PCI_D2)
496                 udelay(200);
497
498         /*
499          * Give firmware a chance to be called, such as ACPI _PRx, _PSx
500          * Firmware method after native method ?
501          */
502         if (platform_pci_set_power_state)
503                 platform_pci_set_power_state(dev, state);
504
505         dev->current_state = state;
506
507         /* According to section 5.4.1 of the "PCI BUS POWER MANAGEMENT
508          * INTERFACE SPECIFICATION, REV. 1.2", a device transitioning
509          * from D3hot to D0 _may_ perform an internal reset, thereby
510          * going to "D0 Uninitialized" rather than "D0 Initialized".
511          * For example, at least some versions of the 3c905B and the
512          * 3c556B exhibit this behaviour.
513          *
514          * At least some laptop BIOSen (e.g. the Thinkpad T21) leave
515          * devices in a D3hot state at boot.  Consequently, we need to
516          * restore at least the BARs so that the device will be
517          * accessible to its driver.
518          */
519         if (need_restore)
520                 pci_restore_bars(dev);
521
522         return 0;
523 }
524
525 pci_power_t (*platform_pci_choose_state)(struct pci_dev *dev, pm_message_t state);
526  
527 /**
528  * pci_choose_state - Choose the power state of a PCI device
529  * @dev: PCI device to be suspended
530  * @state: target sleep state for the whole system. This is the value
531  *      that is passed to suspend() function.
532  *
533  * Returns PCI power state suitable for given device and given system
534  * message.
535  */
536
537 pci_power_t pci_choose_state(struct pci_dev *dev, pm_message_t state)
538 {
539         pci_power_t ret;
540
541         if (!pci_find_capability(dev, PCI_CAP_ID_PM))
542                 return PCI_D0;
543
544         if (platform_pci_choose_state) {
545                 ret = platform_pci_choose_state(dev, state);
546                 if (ret != PCI_POWER_ERROR)
547                         return ret;
548         }
549
550         switch (state.event) {
551         case PM_EVENT_ON:
552                 return PCI_D0;
553         case PM_EVENT_FREEZE:
554         case PM_EVENT_PRETHAW:
555                 /* REVISIT both freeze and pre-thaw "should" use D0 */
556         case PM_EVENT_SUSPEND:
557                 return PCI_D3hot;
558         default:
559                 printk("Unrecognized suspend event %d\n", state.event);
560                 BUG();
561         }
562         return PCI_D0;
563 }
564
565 EXPORT_SYMBOL(pci_choose_state);
566
567 static int pci_save_pcie_state(struct pci_dev *dev)
568 {
569         int pos, i = 0;
570         struct pci_cap_saved_state *save_state;
571         u16 *cap;
572         int found = 0;
573
574         pos = pci_find_capability(dev, PCI_CAP_ID_EXP);
575         if (pos <= 0)
576                 return 0;
577
578         save_state = pci_find_saved_cap(dev, PCI_CAP_ID_EXP);
579         if (!save_state)
580                 save_state = kzalloc(sizeof(*save_state) + sizeof(u16) * 4, GFP_KERNEL);
581         else
582                 found = 1;
583         if (!save_state) {
584                 dev_err(&dev->dev, "Out of memory in pci_save_pcie_state\n");
585                 return -ENOMEM;
586         }
587         cap = (u16 *)&save_state->data[0];
588
589         pci_read_config_word(dev, pos + PCI_EXP_DEVCTL, &cap[i++]);
590         pci_read_config_word(dev, pos + PCI_EXP_LNKCTL, &cap[i++]);
591         pci_read_config_word(dev, pos + PCI_EXP_SLTCTL, &cap[i++]);
592         pci_read_config_word(dev, pos + PCI_EXP_RTCTL, &cap[i++]);
593         save_state->cap_nr = PCI_CAP_ID_EXP;
594         if (!found)
595                 pci_add_saved_cap(dev, save_state);
596         return 0;
597 }
598
599 static void pci_restore_pcie_state(struct pci_dev *dev)
600 {
601         int i = 0, pos;
602         struct pci_cap_saved_state *save_state;
603         u16 *cap;
604
605         save_state = pci_find_saved_cap(dev, PCI_CAP_ID_EXP);
606         pos = pci_find_capability(dev, PCI_CAP_ID_EXP);
607         if (!save_state || pos <= 0)
608                 return;
609         cap = (u16 *)&save_state->data[0];
610
611         pci_write_config_word(dev, pos + PCI_EXP_DEVCTL, cap[i++]);
612         pci_write_config_word(dev, pos + PCI_EXP_LNKCTL, cap[i++]);
613         pci_write_config_word(dev, pos + PCI_EXP_SLTCTL, cap[i++]);
614         pci_write_config_word(dev, pos + PCI_EXP_RTCTL, cap[i++]);
615 }
616
617
618 static int pci_save_pcix_state(struct pci_dev *dev)
619 {
620         int pos, i = 0;
621         struct pci_cap_saved_state *save_state;
622         u16 *cap;
623         int found = 0;
624
625         pos = pci_find_capability(dev, PCI_CAP_ID_PCIX);
626         if (pos <= 0)
627                 return 0;
628
629         save_state = pci_find_saved_cap(dev, PCI_CAP_ID_PCIX);
630         if (!save_state)
631                 save_state = kzalloc(sizeof(*save_state) + sizeof(u16), GFP_KERNEL);
632         else
633                 found = 1;
634         if (!save_state) {
635                 dev_err(&dev->dev, "Out of memory in pci_save_pcie_state\n");
636                 return -ENOMEM;
637         }
638         cap = (u16 *)&save_state->data[0];
639
640         pci_read_config_word(dev, pos + PCI_X_CMD, &cap[i++]);
641         save_state->cap_nr = PCI_CAP_ID_PCIX;
642         if (!found)
643                 pci_add_saved_cap(dev, save_state);
644         return 0;
645 }
646
647 static void pci_restore_pcix_state(struct pci_dev *dev)
648 {
649         int i = 0, pos;
650         struct pci_cap_saved_state *save_state;
651         u16 *cap;
652
653         save_state = pci_find_saved_cap(dev, PCI_CAP_ID_PCIX);
654         pos = pci_find_capability(dev, PCI_CAP_ID_PCIX);
655         if (!save_state || pos <= 0)
656                 return;
657         cap = (u16 *)&save_state->data[0];
658
659         pci_write_config_word(dev, pos + PCI_X_CMD, cap[i++]);
660 }
661
662
663 /**
664  * pci_save_state - save the PCI configuration space of a device before suspending
665  * @dev: - PCI device that we're dealing with
666  */
667 int
668 pci_save_state(struct pci_dev *dev)
669 {
670         int i;
671         /* XXX: 100% dword access ok here? */
672         for (i = 0; i < 16; i++)
673                 pci_read_config_dword(dev, i * 4,&dev->saved_config_space[i]);
674         if ((i = pci_save_pcie_state(dev)) != 0)
675                 return i;
676         if ((i = pci_save_pcix_state(dev)) != 0)
677                 return i;
678         return 0;
679 }
680
681 /** 
682  * pci_restore_state - Restore the saved state of a PCI device
683  * @dev: - PCI device that we're dealing with
684  */
685 int 
686 pci_restore_state(struct pci_dev *dev)
687 {
688         int i;
689         u32 val;
690
691         /* PCI Express register must be restored first */
692         pci_restore_pcie_state(dev);
693
694         /*
695          * The Base Address register should be programmed before the command
696          * register(s)
697          */
698         for (i = 15; i >= 0; i--) {
699                 pci_read_config_dword(dev, i * 4, &val);
700                 if (val != dev->saved_config_space[i]) {
701                         printk(KERN_DEBUG "PM: Writing back config space on "
702                                 "device %s at offset %x (was %x, writing %x)\n",
703                                 pci_name(dev), i,
704                                 val, (int)dev->saved_config_space[i]);
705                         pci_write_config_dword(dev,i * 4,
706                                 dev->saved_config_space[i]);
707                 }
708         }
709         pci_restore_pcix_state(dev);
710         pci_restore_msi_state(dev);
711
712         return 0;
713 }
714
715 static int do_pci_enable_device(struct pci_dev *dev, int bars)
716 {
717         int err;
718
719         err = pci_set_power_state(dev, PCI_D0);
720         if (err < 0 && err != -EIO)
721                 return err;
722         err = pcibios_enable_device(dev, bars);
723         if (err < 0)
724                 return err;
725         pci_fixup_device(pci_fixup_enable, dev);
726
727         return 0;
728 }
729
730 /**
731  * pci_reenable_device - Resume abandoned device
732  * @dev: PCI device to be resumed
733  *
734  *  Note this function is a backend of pci_default_resume and is not supposed
735  *  to be called by normal code, write proper resume handler and use it instead.
736  */
737 int pci_reenable_device(struct pci_dev *dev)
738 {
739         if (atomic_read(&dev->enable_cnt))
740                 return do_pci_enable_device(dev, (1 << PCI_NUM_RESOURCES) - 1);
741         return 0;
742 }
743
744 /**
745  * pci_enable_device_bars - Initialize some of a device for use
746  * @dev: PCI device to be initialized
747  * @bars: bitmask of BAR's that must be configured
748  *
749  *  Initialize device before it's used by a driver. Ask low-level code
750  *  to enable selected I/O and memory resources. Wake up the device if it
751  *  was suspended. Beware, this function can fail.
752  */
753 int
754 pci_enable_device_bars(struct pci_dev *dev, int bars)
755 {
756         int err;
757
758         if (atomic_add_return(1, &dev->enable_cnt) > 1)
759                 return 0;               /* already enabled */
760
761         err = do_pci_enable_device(dev, bars);
762         if (err < 0)
763                 atomic_dec(&dev->enable_cnt);
764         return err;
765 }
766
767 static int __pci_enable_device_flags(struct pci_dev *dev,
768                                      resource_size_t flags)
769 {
770         int err;
771         int i, bars = 0;
772
773         if (atomic_add_return(1, &dev->enable_cnt) > 1)
774                 return 0;               /* already enabled */
775
776         for (i = 0; i < DEVICE_COUNT_RESOURCE; i++)
777                 if (dev->resource[i].flags & flags)
778                         bars |= (1 << i);
779
780         err = do_pci_enable_device(dev, bars);
781         if (err < 0)
782                 atomic_dec(&dev->enable_cnt);
783         return err;
784 }
785
786 /**
787  * pci_enable_device_io - Initialize a device for use with IO space
788  * @dev: PCI device to be initialized
789  *
790  *  Initialize device before it's used by a driver. Ask low-level code
791  *  to enable I/O resources. Wake up the device if it was suspended.
792  *  Beware, this function can fail.
793  */
794 int pci_enable_device_io(struct pci_dev *dev)
795 {
796         return __pci_enable_device_flags(dev, IORESOURCE_IO);
797 }
798
799 /**
800  * pci_enable_device_mem - Initialize a device for use with Memory space
801  * @dev: PCI device to be initialized
802  *
803  *  Initialize device before it's used by a driver. Ask low-level code
804  *  to enable Memory resources. Wake up the device if it was suspended.
805  *  Beware, this function can fail.
806  */
807 int pci_enable_device_mem(struct pci_dev *dev)
808 {
809         return __pci_enable_device_flags(dev, IORESOURCE_MEM);
810 }
811
812 /**
813  * pci_enable_device - Initialize device before it's used by a driver.
814  * @dev: PCI device to be initialized
815  *
816  *  Initialize device before it's used by a driver. Ask low-level code
817  *  to enable I/O and memory. Wake up the device if it was suspended.
818  *  Beware, this function can fail.
819  *
820  *  Note we don't actually enable the device many times if we call
821  *  this function repeatedly (we just increment the count).
822  */
823 int pci_enable_device(struct pci_dev *dev)
824 {
825         return __pci_enable_device_flags(dev, IORESOURCE_MEM | IORESOURCE_IO);
826 }
827
828 /*
829  * Managed PCI resources.  This manages device on/off, intx/msi/msix
830  * on/off and BAR regions.  pci_dev itself records msi/msix status, so
831  * there's no need to track it separately.  pci_devres is initialized
832  * when a device is enabled using managed PCI device enable interface.
833  */
834 struct pci_devres {
835         unsigned int enabled:1;
836         unsigned int pinned:1;
837         unsigned int orig_intx:1;
838         unsigned int restore_intx:1;
839         u32 region_mask;
840 };
841
842 static void pcim_release(struct device *gendev, void *res)
843 {
844         struct pci_dev *dev = container_of(gendev, struct pci_dev, dev);
845         struct pci_devres *this = res;
846         int i;
847
848         if (dev->msi_enabled)
849                 pci_disable_msi(dev);
850         if (dev->msix_enabled)
851                 pci_disable_msix(dev);
852
853         for (i = 0; i < DEVICE_COUNT_RESOURCE; i++)
854                 if (this->region_mask & (1 << i))
855                         pci_release_region(dev, i);
856
857         if (this->restore_intx)
858                 pci_intx(dev, this->orig_intx);
859
860         if (this->enabled && !this->pinned)
861                 pci_disable_device(dev);
862 }
863
864 static struct pci_devres * get_pci_dr(struct pci_dev *pdev)
865 {
866         struct pci_devres *dr, *new_dr;
867
868         dr = devres_find(&pdev->dev, pcim_release, NULL, NULL);
869         if (dr)
870                 return dr;
871
872         new_dr = devres_alloc(pcim_release, sizeof(*new_dr), GFP_KERNEL);
873         if (!new_dr)
874                 return NULL;
875         return devres_get(&pdev->dev, new_dr, NULL, NULL);
876 }
877
878 static struct pci_devres * find_pci_dr(struct pci_dev *pdev)
879 {
880         if (pci_is_managed(pdev))
881                 return devres_find(&pdev->dev, pcim_release, NULL, NULL);
882         return NULL;
883 }
884
885 /**
886  * pcim_enable_device - Managed pci_enable_device()
887  * @pdev: PCI device to be initialized
888  *
889  * Managed pci_enable_device().
890  */
891 int pcim_enable_device(struct pci_dev *pdev)
892 {
893         struct pci_devres *dr;
894         int rc;
895
896         dr = get_pci_dr(pdev);
897         if (unlikely(!dr))
898                 return -ENOMEM;
899         WARN_ON(!!dr->enabled);
900
901         rc = pci_enable_device(pdev);
902         if (!rc) {
903                 pdev->is_managed = 1;
904                 dr->enabled = 1;
905         }
906         return rc;
907 }
908
909 /**
910  * pcim_pin_device - Pin managed PCI device
911  * @pdev: PCI device to pin
912  *
913  * Pin managed PCI device @pdev.  Pinned device won't be disabled on
914  * driver detach.  @pdev must have been enabled with
915  * pcim_enable_device().
916  */
917 void pcim_pin_device(struct pci_dev *pdev)
918 {
919         struct pci_devres *dr;
920
921         dr = find_pci_dr(pdev);
922         WARN_ON(!dr || !dr->enabled);
923         if (dr)
924                 dr->pinned = 1;
925 }
926
927 /**
928  * pcibios_disable_device - disable arch specific PCI resources for device dev
929  * @dev: the PCI device to disable
930  *
931  * Disables architecture specific PCI resources for the device. This
932  * is the default implementation. Architecture implementations can
933  * override this.
934  */
935 void __attribute__ ((weak)) pcibios_disable_device (struct pci_dev *dev) {}
936
937 /**
938  * pci_disable_device - Disable PCI device after use
939  * @dev: PCI device to be disabled
940  *
941  * Signal to the system that the PCI device is not in use by the system
942  * anymore.  This only involves disabling PCI bus-mastering, if active.
943  *
944  * Note we don't actually disable the device until all callers of
945  * pci_device_enable() have called pci_device_disable().
946  */
947 void
948 pci_disable_device(struct pci_dev *dev)
949 {
950         struct pci_devres *dr;
951         u16 pci_command;
952
953         dr = find_pci_dr(dev);
954         if (dr)
955                 dr->enabled = 0;
956
957         if (atomic_sub_return(1, &dev->enable_cnt) != 0)
958                 return;
959
960         /* Wait for all transactions are finished before disabling the device */
961         pcie_wait_pending_transaction(dev);
962
963         pci_read_config_word(dev, PCI_COMMAND, &pci_command);
964         if (pci_command & PCI_COMMAND_MASTER) {
965                 pci_command &= ~PCI_COMMAND_MASTER;
966                 pci_write_config_word(dev, PCI_COMMAND, pci_command);
967         }
968         dev->is_busmaster = 0;
969
970         pcibios_disable_device(dev);
971 }
972
973 /**
974  * pcibios_set_pcie_reset_state - set reset state for device dev
975  * @dev: the PCI-E device reset
976  * @state: Reset state to enter into
977  *
978  *
979  * Sets the PCI-E reset state for the device. This is the default
980  * implementation. Architecture implementations can override this.
981  */
982 int __attribute__ ((weak)) pcibios_set_pcie_reset_state(struct pci_dev *dev,
983                                                         enum pcie_reset_state state)
984 {
985         return -EINVAL;
986 }
987
988 /**
989  * pci_set_pcie_reset_state - set reset state for device dev
990  * @dev: the PCI-E device reset
991  * @state: Reset state to enter into
992  *
993  *
994  * Sets the PCI reset state for the device.
995  */
996 int pci_set_pcie_reset_state(struct pci_dev *dev, enum pcie_reset_state state)
997 {
998         return pcibios_set_pcie_reset_state(dev, state);
999 }
1000
1001 /**
1002  * pci_enable_wake - enable PCI device as wakeup event source
1003  * @dev: PCI device affected
1004  * @state: PCI state from which device will issue wakeup events
1005  * @enable: True to enable event generation; false to disable
1006  *
1007  * This enables the device as a wakeup event source, or disables it.
1008  * When such events involves platform-specific hooks, those hooks are
1009  * called automatically by this routine.
1010  *
1011  * Devices with legacy power management (no standard PCI PM capabilities)
1012  * always require such platform hooks.  Depending on the platform, devices
1013  * supporting the standard PCI PME# signal may require such platform hooks;
1014  * they always update bits in config space to allow PME# generation.
1015  *
1016  * -EIO is returned if the device can't ever be a wakeup event source.
1017  * -EINVAL is returned if the device can't generate wakeup events from
1018  * the specified PCI state.  Returns zero if the operation is successful.
1019  */
1020 int pci_enable_wake(struct pci_dev *dev, pci_power_t state, int enable)
1021 {
1022         int pm;
1023         int status;
1024         u16 value;
1025
1026         /* Note that drivers should verify device_may_wakeup(&dev->dev)
1027          * before calling this function.  Platform code should report
1028          * errors when drivers try to enable wakeup on devices that
1029          * can't issue wakeups, or on which wakeups were disabled by
1030          * userspace updating the /sys/devices.../power/wakeup file.
1031          */
1032
1033         status = call_platform_enable_wakeup(&dev->dev, enable);
1034
1035         /* find PCI PM capability in list */
1036         pm = pci_find_capability(dev, PCI_CAP_ID_PM);
1037
1038         /* If device doesn't support PM Capabilities, but caller wants to
1039          * disable wake events, it's a NOP.  Otherwise fail unless the
1040          * platform hooks handled this legacy device already.
1041          */
1042         if (!pm)
1043                 return enable ? status : 0;
1044
1045         /* Check device's ability to generate PME# */
1046         pci_read_config_word(dev,pm+PCI_PM_PMC,&value);
1047
1048         value &= PCI_PM_CAP_PME_MASK;
1049         value >>= ffs(PCI_PM_CAP_PME_MASK) - 1;   /* First bit of mask */
1050
1051         /* Check if it can generate PME# from requested state. */
1052         if (!value || !(value & (1 << state))) {
1053                 /* if it can't, revert what the platform hook changed,
1054                  * always reporting the base "EINVAL, can't PME#" error
1055                  */
1056                 if (enable)
1057                         call_platform_enable_wakeup(&dev->dev, 0);
1058                 return enable ? -EINVAL : 0;
1059         }
1060
1061         pci_read_config_word(dev, pm + PCI_PM_CTRL, &value);
1062
1063         /* Clear PME_Status by writing 1 to it and enable PME# */
1064         value |= PCI_PM_CTRL_PME_STATUS | PCI_PM_CTRL_PME_ENABLE;
1065
1066         if (!enable)
1067                 value &= ~PCI_PM_CTRL_PME_ENABLE;
1068
1069         pci_write_config_word(dev, pm + PCI_PM_CTRL, value);
1070
1071         return 0;
1072 }
1073
1074 int
1075 pci_get_interrupt_pin(struct pci_dev *dev, struct pci_dev **bridge)
1076 {
1077         u8 pin;
1078
1079         pin = dev->pin;
1080         if (!pin)
1081                 return -1;
1082         pin--;
1083         while (dev->bus->self) {
1084                 pin = (pin + PCI_SLOT(dev->devfn)) % 4;
1085                 dev = dev->bus->self;
1086         }
1087         *bridge = dev;
1088         return pin;
1089 }
1090
1091 /**
1092  *      pci_release_region - Release a PCI bar
1093  *      @pdev: PCI device whose resources were previously reserved by pci_request_region
1094  *      @bar: BAR to release
1095  *
1096  *      Releases the PCI I/O and memory resources previously reserved by a
1097  *      successful call to pci_request_region.  Call this function only
1098  *      after all use of the PCI regions has ceased.
1099  */
1100 void pci_release_region(struct pci_dev *pdev, int bar)
1101 {
1102         struct pci_devres *dr;
1103
1104         if (pci_resource_len(pdev, bar) == 0)
1105                 return;
1106         if (pci_resource_flags(pdev, bar) & IORESOURCE_IO)
1107                 release_region(pci_resource_start(pdev, bar),
1108                                 pci_resource_len(pdev, bar));
1109         else if (pci_resource_flags(pdev, bar) & IORESOURCE_MEM)
1110                 release_mem_region(pci_resource_start(pdev, bar),
1111                                 pci_resource_len(pdev, bar));
1112
1113         dr = find_pci_dr(pdev);
1114         if (dr)
1115                 dr->region_mask &= ~(1 << bar);
1116 }
1117
1118 /**
1119  *      pci_request_region - Reserved PCI I/O and memory resource
1120  *      @pdev: PCI device whose resources are to be reserved
1121  *      @bar: BAR to be reserved
1122  *      @res_name: Name to be associated with resource.
1123  *
1124  *      Mark the PCI region associated with PCI device @pdev BR @bar as
1125  *      being reserved by owner @res_name.  Do not access any
1126  *      address inside the PCI regions unless this call returns
1127  *      successfully.
1128  *
1129  *      Returns 0 on success, or %EBUSY on error.  A warning
1130  *      message is also printed on failure.
1131  */
1132 int pci_request_region(struct pci_dev *pdev, int bar, const char *res_name)
1133 {
1134         struct pci_devres *dr;
1135
1136         if (pci_resource_len(pdev, bar) == 0)
1137                 return 0;
1138                 
1139         if (pci_resource_flags(pdev, bar) & IORESOURCE_IO) {
1140                 if (!request_region(pci_resource_start(pdev, bar),
1141                             pci_resource_len(pdev, bar), res_name))
1142                         goto err_out;
1143         }
1144         else if (pci_resource_flags(pdev, bar) & IORESOURCE_MEM) {
1145                 if (!request_mem_region(pci_resource_start(pdev, bar),
1146                                         pci_resource_len(pdev, bar), res_name))
1147                         goto err_out;
1148         }
1149
1150         dr = find_pci_dr(pdev);
1151         if (dr)
1152                 dr->region_mask |= 1 << bar;
1153
1154         return 0;
1155
1156 err_out:
1157         printk (KERN_WARNING "PCI: Unable to reserve %s region #%d:%llx@%llx "
1158                 "for device %s\n",
1159                 pci_resource_flags(pdev, bar) & IORESOURCE_IO ? "I/O" : "mem",
1160                 bar + 1, /* PCI BAR # */
1161                 (unsigned long long)pci_resource_len(pdev, bar),
1162                 (unsigned long long)pci_resource_start(pdev, bar),
1163                 pci_name(pdev));
1164         return -EBUSY;
1165 }
1166
1167 /**
1168  * pci_release_selected_regions - Release selected PCI I/O and memory resources
1169  * @pdev: PCI device whose resources were previously reserved
1170  * @bars: Bitmask of BARs to be released
1171  *
1172  * Release selected PCI I/O and memory resources previously reserved.
1173  * Call this function only after all use of the PCI regions has ceased.
1174  */
1175 void pci_release_selected_regions(struct pci_dev *pdev, int bars)
1176 {
1177         int i;
1178
1179         for (i = 0; i < 6; i++)
1180                 if (bars & (1 << i))
1181                         pci_release_region(pdev, i);
1182 }
1183
1184 /**
1185  * pci_request_selected_regions - Reserve selected PCI I/O and memory resources
1186  * @pdev: PCI device whose resources are to be reserved
1187  * @bars: Bitmask of BARs to be requested
1188  * @res_name: Name to be associated with resource
1189  */
1190 int pci_request_selected_regions(struct pci_dev *pdev, int bars,
1191                                  const char *res_name)
1192 {
1193         int i;
1194
1195         for (i = 0; i < 6; i++)
1196                 if (bars & (1 << i))
1197                         if(pci_request_region(pdev, i, res_name))
1198                                 goto err_out;
1199         return 0;
1200
1201 err_out:
1202         while(--i >= 0)
1203                 if (bars & (1 << i))
1204                         pci_release_region(pdev, i);
1205
1206         return -EBUSY;
1207 }
1208
1209 /**
1210  *      pci_release_regions - Release reserved PCI I/O and memory resources
1211  *      @pdev: PCI device whose resources were previously reserved by pci_request_regions
1212  *
1213  *      Releases all PCI I/O and memory resources previously reserved by a
1214  *      successful call to pci_request_regions.  Call this function only
1215  *      after all use of the PCI regions has ceased.
1216  */
1217
1218 void pci_release_regions(struct pci_dev *pdev)
1219 {
1220         pci_release_selected_regions(pdev, (1 << 6) - 1);
1221 }
1222
1223 /**
1224  *      pci_request_regions - Reserved PCI I/O and memory resources
1225  *      @pdev: PCI device whose resources are to be reserved
1226  *      @res_name: Name to be associated with resource.
1227  *
1228  *      Mark all PCI regions associated with PCI device @pdev as
1229  *      being reserved by owner @res_name.  Do not access any
1230  *      address inside the PCI regions unless this call returns
1231  *      successfully.
1232  *
1233  *      Returns 0 on success, or %EBUSY on error.  A warning
1234  *      message is also printed on failure.
1235  */
1236 int pci_request_regions(struct pci_dev *pdev, const char *res_name)
1237 {
1238         return pci_request_selected_regions(pdev, ((1 << 6) - 1), res_name);
1239 }
1240
1241 /**
1242  * pci_set_master - enables bus-mastering for device dev
1243  * @dev: the PCI device to enable
1244  *
1245  * Enables bus-mastering on the device and calls pcibios_set_master()
1246  * to do the needed arch specific settings.
1247  */
1248 void
1249 pci_set_master(struct pci_dev *dev)
1250 {
1251         u16 cmd;
1252
1253         pci_read_config_word(dev, PCI_COMMAND, &cmd);
1254         if (! (cmd & PCI_COMMAND_MASTER)) {
1255                 pr_debug("PCI: Enabling bus mastering for device %s\n", pci_name(dev));
1256                 cmd |= PCI_COMMAND_MASTER;
1257                 pci_write_config_word(dev, PCI_COMMAND, cmd);
1258         }
1259         dev->is_busmaster = 1;
1260         pcibios_set_master(dev);
1261 }
1262
1263 #ifdef PCI_DISABLE_MWI
1264 int pci_set_mwi(struct pci_dev *dev)
1265 {
1266         return 0;
1267 }
1268
1269 int pci_try_set_mwi(struct pci_dev *dev)
1270 {
1271         return 0;
1272 }
1273
1274 void pci_clear_mwi(struct pci_dev *dev)
1275 {
1276 }
1277
1278 #else
1279
1280 #ifndef PCI_CACHE_LINE_BYTES
1281 #define PCI_CACHE_LINE_BYTES L1_CACHE_BYTES
1282 #endif
1283
1284 /* This can be overridden by arch code. */
1285 /* Don't forget this is measured in 32-bit words, not bytes */
1286 u8 pci_cache_line_size = PCI_CACHE_LINE_BYTES / 4;
1287
1288 /**
1289  * pci_set_cacheline_size - ensure the CACHE_LINE_SIZE register is programmed
1290  * @dev: the PCI device for which MWI is to be enabled
1291  *
1292  * Helper function for pci_set_mwi.
1293  * Originally copied from drivers/net/acenic.c.
1294  * Copyright 1998-2001 by Jes Sorensen, <jes@trained-monkey.org>.
1295  *
1296  * RETURNS: An appropriate -ERRNO error value on error, or zero for success.
1297  */
1298 static int
1299 pci_set_cacheline_size(struct pci_dev *dev)
1300 {
1301         u8 cacheline_size;
1302
1303         if (!pci_cache_line_size)
1304                 return -EINVAL;         /* The system doesn't support MWI. */
1305
1306         /* Validate current setting: the PCI_CACHE_LINE_SIZE must be
1307            equal to or multiple of the right value. */
1308         pci_read_config_byte(dev, PCI_CACHE_LINE_SIZE, &cacheline_size);
1309         if (cacheline_size >= pci_cache_line_size &&
1310             (cacheline_size % pci_cache_line_size) == 0)
1311                 return 0;
1312
1313         /* Write the correct value. */
1314         pci_write_config_byte(dev, PCI_CACHE_LINE_SIZE, pci_cache_line_size);
1315         /* Read it back. */
1316         pci_read_config_byte(dev, PCI_CACHE_LINE_SIZE, &cacheline_size);
1317         if (cacheline_size == pci_cache_line_size)
1318                 return 0;
1319
1320         printk(KERN_DEBUG "PCI: cache line size of %d is not supported "
1321                "by device %s\n", pci_cache_line_size << 2, pci_name(dev));
1322
1323         return -EINVAL;
1324 }
1325
1326 /**
1327  * pci_set_mwi - enables memory-write-invalidate PCI transaction
1328  * @dev: the PCI device for which MWI is enabled
1329  *
1330  * Enables the Memory-Write-Invalidate transaction in %PCI_COMMAND.
1331  *
1332  * RETURNS: An appropriate -ERRNO error value on error, or zero for success.
1333  */
1334 int
1335 pci_set_mwi(struct pci_dev *dev)
1336 {
1337         int rc;
1338         u16 cmd;
1339
1340         rc = pci_set_cacheline_size(dev);
1341         if (rc)
1342                 return rc;
1343
1344         pci_read_config_word(dev, PCI_COMMAND, &cmd);
1345         if (! (cmd & PCI_COMMAND_INVALIDATE)) {
1346                 pr_debug("PCI: Enabling Mem-Wr-Inval for device %s\n",
1347                         pci_name(dev));
1348                 cmd |= PCI_COMMAND_INVALIDATE;
1349                 pci_write_config_word(dev, PCI_COMMAND, cmd);
1350         }
1351         
1352         return 0;
1353 }
1354
1355 /**
1356  * pci_try_set_mwi - enables memory-write-invalidate PCI transaction
1357  * @dev: the PCI device for which MWI is enabled
1358  *
1359  * Enables the Memory-Write-Invalidate transaction in %PCI_COMMAND.
1360  * Callers are not required to check the return value.
1361  *
1362  * RETURNS: An appropriate -ERRNO error value on error, or zero for success.
1363  */
1364 int pci_try_set_mwi(struct pci_dev *dev)
1365 {
1366         int rc = pci_set_mwi(dev);
1367         return rc;
1368 }
1369
1370 /**
1371  * pci_clear_mwi - disables Memory-Write-Invalidate for device dev
1372  * @dev: the PCI device to disable
1373  *
1374  * Disables PCI Memory-Write-Invalidate transaction on the device
1375  */
1376 void
1377 pci_clear_mwi(struct pci_dev *dev)
1378 {
1379         u16 cmd;
1380
1381         pci_read_config_word(dev, PCI_COMMAND, &cmd);
1382         if (cmd & PCI_COMMAND_INVALIDATE) {
1383                 cmd &= ~PCI_COMMAND_INVALIDATE;
1384                 pci_write_config_word(dev, PCI_COMMAND, cmd);
1385         }
1386 }
1387 #endif /* ! PCI_DISABLE_MWI */
1388
1389 /**
1390  * pci_intx - enables/disables PCI INTx for device dev
1391  * @pdev: the PCI device to operate on
1392  * @enable: boolean: whether to enable or disable PCI INTx
1393  *
1394  * Enables/disables PCI INTx for device dev
1395  */
1396 void
1397 pci_intx(struct pci_dev *pdev, int enable)
1398 {
1399         u16 pci_command, new;
1400
1401         pci_read_config_word(pdev, PCI_COMMAND, &pci_command);
1402
1403         if (enable) {
1404                 new = pci_command & ~PCI_COMMAND_INTX_DISABLE;
1405         } else {
1406                 new = pci_command | PCI_COMMAND_INTX_DISABLE;
1407         }
1408
1409         if (new != pci_command) {
1410                 struct pci_devres *dr;
1411
1412                 pci_write_config_word(pdev, PCI_COMMAND, new);
1413
1414                 dr = find_pci_dr(pdev);
1415                 if (dr && !dr->restore_intx) {
1416                         dr->restore_intx = 1;
1417                         dr->orig_intx = !enable;
1418                 }
1419         }
1420 }
1421
1422 /**
1423  * pci_msi_off - disables any msi or msix capabilities
1424  * @dev: the PCI device to operate on
1425  *
1426  * If you want to use msi see pci_enable_msi and friends.
1427  * This is a lower level primitive that allows us to disable
1428  * msi operation at the device level.
1429  */
1430 void pci_msi_off(struct pci_dev *dev)
1431 {
1432         int pos;
1433         u16 control;
1434
1435         pos = pci_find_capability(dev, PCI_CAP_ID_MSI);
1436         if (pos) {
1437                 pci_read_config_word(dev, pos + PCI_MSI_FLAGS, &control);
1438                 control &= ~PCI_MSI_FLAGS_ENABLE;
1439                 pci_write_config_word(dev, pos + PCI_MSI_FLAGS, control);
1440         }
1441         pos = pci_find_capability(dev, PCI_CAP_ID_MSIX);
1442         if (pos) {
1443                 pci_read_config_word(dev, pos + PCI_MSIX_FLAGS, &control);
1444                 control &= ~PCI_MSIX_FLAGS_ENABLE;
1445                 pci_write_config_word(dev, pos + PCI_MSIX_FLAGS, control);
1446         }
1447 }
1448
1449 #ifndef HAVE_ARCH_PCI_SET_DMA_MASK
1450 /*
1451  * These can be overridden by arch-specific implementations
1452  */
1453 int
1454 pci_set_dma_mask(struct pci_dev *dev, u64 mask)
1455 {
1456         if (!pci_dma_supported(dev, mask))
1457                 return -EIO;
1458
1459         dev->dma_mask = mask;
1460
1461         return 0;
1462 }
1463     
1464 int
1465 pci_set_consistent_dma_mask(struct pci_dev *dev, u64 mask)
1466 {
1467         if (!pci_dma_supported(dev, mask))
1468                 return -EIO;
1469
1470         dev->dev.coherent_dma_mask = mask;
1471
1472         return 0;
1473 }
1474 #endif
1475
1476 /**
1477  * pcix_get_max_mmrbc - get PCI-X maximum designed memory read byte count
1478  * @dev: PCI device to query
1479  *
1480  * Returns mmrbc: maximum designed memory read count in bytes
1481  *    or appropriate error value.
1482  */
1483 int pcix_get_max_mmrbc(struct pci_dev *dev)
1484 {
1485         int err, cap;
1486         u32 stat;
1487
1488         cap = pci_find_capability(dev, PCI_CAP_ID_PCIX);
1489         if (!cap)
1490                 return -EINVAL;
1491
1492         err = pci_read_config_dword(dev, cap + PCI_X_STATUS, &stat);
1493         if (err)
1494                 return -EINVAL;
1495
1496         return (stat & PCI_X_STATUS_MAX_READ) >> 12;
1497 }
1498 EXPORT_SYMBOL(pcix_get_max_mmrbc);
1499
1500 /**
1501  * pcix_get_mmrbc - get PCI-X maximum memory read byte count
1502  * @dev: PCI device to query
1503  *
1504  * Returns mmrbc: maximum memory read count in bytes
1505  *    or appropriate error value.
1506  */
1507 int pcix_get_mmrbc(struct pci_dev *dev)
1508 {
1509         int ret, cap;
1510         u32 cmd;
1511
1512         cap = pci_find_capability(dev, PCI_CAP_ID_PCIX);
1513         if (!cap)
1514                 return -EINVAL;
1515
1516         ret = pci_read_config_dword(dev, cap + PCI_X_CMD, &cmd);
1517         if (!ret)
1518                 ret = 512 << ((cmd & PCI_X_CMD_MAX_READ) >> 2);
1519
1520         return ret;
1521 }
1522 EXPORT_SYMBOL(pcix_get_mmrbc);
1523
1524 /**
1525  * pcix_set_mmrbc - set PCI-X maximum memory read byte count
1526  * @dev: PCI device to query
1527  * @mmrbc: maximum memory read count in bytes
1528  *    valid values are 512, 1024, 2048, 4096
1529  *
1530  * If possible sets maximum memory read byte count, some bridges have erratas
1531  * that prevent this.
1532  */
1533 int pcix_set_mmrbc(struct pci_dev *dev, int mmrbc)
1534 {
1535         int cap, err = -EINVAL;
1536         u32 stat, cmd, v, o;
1537
1538         if (mmrbc < 512 || mmrbc > 4096 || !is_power_of_2(mmrbc))
1539                 goto out;
1540
1541         v = ffs(mmrbc) - 10;
1542
1543         cap = pci_find_capability(dev, PCI_CAP_ID_PCIX);
1544         if (!cap)
1545                 goto out;
1546
1547         err = pci_read_config_dword(dev, cap + PCI_X_STATUS, &stat);
1548         if (err)
1549                 goto out;
1550
1551         if (v > (stat & PCI_X_STATUS_MAX_READ) >> 21)
1552                 return -E2BIG;
1553
1554         err = pci_read_config_dword(dev, cap + PCI_X_CMD, &cmd);
1555         if (err)
1556                 goto out;
1557
1558         o = (cmd & PCI_X_CMD_MAX_READ) >> 2;
1559         if (o != v) {
1560                 if (v > o && dev->bus &&
1561                    (dev->bus->bus_flags & PCI_BUS_FLAGS_NO_MMRBC))
1562                         return -EIO;
1563
1564                 cmd &= ~PCI_X_CMD_MAX_READ;
1565                 cmd |= v << 2;
1566                 err = pci_write_config_dword(dev, cap + PCI_X_CMD, cmd);
1567         }
1568 out:
1569         return err;
1570 }
1571 EXPORT_SYMBOL(pcix_set_mmrbc);
1572
1573 /**
1574  * pcie_get_readrq - get PCI Express read request size
1575  * @dev: PCI device to query
1576  *
1577  * Returns maximum memory read request in bytes
1578  *    or appropriate error value.
1579  */
1580 int pcie_get_readrq(struct pci_dev *dev)
1581 {
1582         int ret, cap;
1583         u16 ctl;
1584
1585         cap = pci_find_capability(dev, PCI_CAP_ID_EXP);
1586         if (!cap)
1587                 return -EINVAL;
1588
1589         ret = pci_read_config_word(dev, cap + PCI_EXP_DEVCTL, &ctl);
1590         if (!ret)
1591         ret = 128 << ((ctl & PCI_EXP_DEVCTL_READRQ) >> 12);
1592
1593         return ret;
1594 }
1595 EXPORT_SYMBOL(pcie_get_readrq);
1596
1597 /**
1598  * pcie_set_readrq - set PCI Express maximum memory read request
1599  * @dev: PCI device to query
1600  * @rq: maximum memory read count in bytes
1601  *    valid values are 128, 256, 512, 1024, 2048, 4096
1602  *
1603  * If possible sets maximum read byte count
1604  */
1605 int pcie_set_readrq(struct pci_dev *dev, int rq)
1606 {
1607         int cap, err = -EINVAL;
1608         u16 ctl, v;
1609
1610         if (rq < 128 || rq > 4096 || !is_power_of_2(rq))
1611                 goto out;
1612
1613         v = (ffs(rq) - 8) << 12;
1614
1615         cap = pci_find_capability(dev, PCI_CAP_ID_EXP);
1616         if (!cap)
1617                 goto out;
1618
1619         err = pci_read_config_word(dev, cap + PCI_EXP_DEVCTL, &ctl);
1620         if (err)
1621                 goto out;
1622
1623         if ((ctl & PCI_EXP_DEVCTL_READRQ) != v) {
1624                 ctl &= ~PCI_EXP_DEVCTL_READRQ;
1625                 ctl |= v;
1626                 err = pci_write_config_dword(dev, cap + PCI_EXP_DEVCTL, ctl);
1627         }
1628
1629 out:
1630         return err;
1631 }
1632 EXPORT_SYMBOL(pcie_set_readrq);
1633
1634 /**
1635  * pci_select_bars - Make BAR mask from the type of resource
1636  * @dev: the PCI device for which BAR mask is made
1637  * @flags: resource type mask to be selected
1638  *
1639  * This helper routine makes bar mask from the type of resource.
1640  */
1641 int pci_select_bars(struct pci_dev *dev, unsigned long flags)
1642 {
1643         int i, bars = 0;
1644         for (i = 0; i < PCI_NUM_RESOURCES; i++)
1645                 if (pci_resource_flags(dev, i) & flags)
1646                         bars |= (1 << i);
1647         return bars;
1648 }
1649
1650 static void __devinit pci_no_domains(void)
1651 {
1652 #ifdef CONFIG_PCI_DOMAINS
1653         pci_domains_supported = 0;
1654 #endif
1655 }
1656
1657 static int __devinit pci_init(void)
1658 {
1659         struct pci_dev *dev = NULL;
1660
1661         while ((dev = pci_get_device(PCI_ANY_ID, PCI_ANY_ID, dev)) != NULL) {
1662                 pci_fixup_device(pci_fixup_final, dev);
1663         }
1664         return 0;
1665 }
1666
1667 static int __devinit pci_setup(char *str)
1668 {
1669         while (str) {
1670                 char *k = strchr(str, ',');
1671                 if (k)
1672                         *k++ = 0;
1673                 if (*str && (str = pcibios_setup(str)) && *str) {
1674                         if (!strcmp(str, "nomsi")) {
1675                                 pci_no_msi();
1676                         } else if (!strcmp(str, "noaer")) {
1677                                 pci_no_aer();
1678                         } else if (!strcmp(str, "nodomains")) {
1679                                 pci_no_domains();
1680                         } else if (!strncmp(str, "cbiosize=", 9)) {
1681                                 pci_cardbus_io_size = memparse(str + 9, &str);
1682                         } else if (!strncmp(str, "cbmemsize=", 10)) {
1683                                 pci_cardbus_mem_size = memparse(str + 10, &str);
1684                         } else {
1685                                 printk(KERN_ERR "PCI: Unknown option `%s'\n",
1686                                                 str);
1687                         }
1688                 }
1689                 str = k;
1690         }
1691         return 0;
1692 }
1693 early_param("pci", pci_setup);
1694
1695 device_initcall(pci_init);
1696
1697 EXPORT_SYMBOL(pci_reenable_device);
1698 EXPORT_SYMBOL(pci_enable_device_bars);
1699 EXPORT_SYMBOL(pci_enable_device_io);
1700 EXPORT_SYMBOL(pci_enable_device_mem);
1701 EXPORT_SYMBOL(pci_enable_device);
1702 EXPORT_SYMBOL(pcim_enable_device);
1703 EXPORT_SYMBOL(pcim_pin_device);
1704 EXPORT_SYMBOL(pci_disable_device);
1705 EXPORT_SYMBOL(pci_find_capability);
1706 EXPORT_SYMBOL(pci_bus_find_capability);
1707 EXPORT_SYMBOL(pci_release_regions);
1708 EXPORT_SYMBOL(pci_request_regions);
1709 EXPORT_SYMBOL(pci_release_region);
1710 EXPORT_SYMBOL(pci_request_region);
1711 EXPORT_SYMBOL(pci_release_selected_regions);
1712 EXPORT_SYMBOL(pci_request_selected_regions);
1713 EXPORT_SYMBOL(pci_set_master);
1714 EXPORT_SYMBOL(pci_set_mwi);
1715 EXPORT_SYMBOL(pci_try_set_mwi);
1716 EXPORT_SYMBOL(pci_clear_mwi);
1717 EXPORT_SYMBOL_GPL(pci_intx);
1718 EXPORT_SYMBOL(pci_set_dma_mask);
1719 EXPORT_SYMBOL(pci_set_consistent_dma_mask);
1720 EXPORT_SYMBOL(pci_assign_resource);
1721 EXPORT_SYMBOL(pci_find_parent_resource);
1722 EXPORT_SYMBOL(pci_select_bars);
1723
1724 EXPORT_SYMBOL(pci_set_power_state);
1725 EXPORT_SYMBOL(pci_save_state);
1726 EXPORT_SYMBOL(pci_restore_state);
1727 EXPORT_SYMBOL(pci_enable_wake);
1728 EXPORT_SYMBOL_GPL(pci_set_pcie_reset_state);
1729