pci.c 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952
  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. #include <linux/kernel.h>
  12. #include <linux/delay.h>
  13. #include <linux/init.h>
  14. #include <linux/pci.h>
  15. #include <linux/module.h>
  16. #include <linux/spinlock.h>
  17. #include <linux/string.h>
  18. #include <asm/dma.h> /* isa_dma_bridge_buggy */
  19. #include "pci.h"
  20. /**
  21. * pci_bus_max_busnr - returns maximum PCI bus number of given bus' children
  22. * @bus: pointer to PCI bus structure to search
  23. *
  24. * Given a PCI bus, returns the highest PCI bus number present in the set
  25. * including the given PCI bus and its list of child PCI buses.
  26. */
  27. unsigned char __devinit
  28. pci_bus_max_busnr(struct pci_bus* bus)
  29. {
  30. struct list_head *tmp;
  31. unsigned char max, n;
  32. max = bus->subordinate;
  33. list_for_each(tmp, &bus->children) {
  34. n = pci_bus_max_busnr(pci_bus_b(tmp));
  35. if(n > max)
  36. max = n;
  37. }
  38. return max;
  39. }
  40. EXPORT_SYMBOL_GPL(pci_bus_max_busnr);
  41. #if 0
  42. /**
  43. * pci_max_busnr - returns maximum PCI bus number
  44. *
  45. * Returns the highest PCI bus number present in the system global list of
  46. * PCI buses.
  47. */
  48. unsigned char __devinit
  49. pci_max_busnr(void)
  50. {
  51. struct pci_bus *bus = NULL;
  52. unsigned char max, n;
  53. max = 0;
  54. while ((bus = pci_find_next_bus(bus)) != NULL) {
  55. n = pci_bus_max_busnr(bus);
  56. if(n > max)
  57. max = n;
  58. }
  59. return max;
  60. }
  61. #endif /* 0 */
  62. static int __pci_find_next_cap(struct pci_bus *bus, unsigned int devfn, u8 pos, int cap)
  63. {
  64. u8 id;
  65. int ttl = 48;
  66. while (ttl--) {
  67. pci_bus_read_config_byte(bus, devfn, pos, &pos);
  68. if (pos < 0x40)
  69. break;
  70. pos &= ~3;
  71. pci_bus_read_config_byte(bus, devfn, pos + PCI_CAP_LIST_ID,
  72. &id);
  73. if (id == 0xff)
  74. break;
  75. if (id == cap)
  76. return pos;
  77. pos += PCI_CAP_LIST_NEXT;
  78. }
  79. return 0;
  80. }
  81. int pci_find_next_capability(struct pci_dev *dev, u8 pos, int cap)
  82. {
  83. return __pci_find_next_cap(dev->bus, dev->devfn,
  84. pos + PCI_CAP_LIST_NEXT, cap);
  85. }
  86. EXPORT_SYMBOL_GPL(pci_find_next_capability);
  87. static int __pci_bus_find_cap(struct pci_bus *bus, unsigned int devfn, u8 hdr_type, int cap)
  88. {
  89. u16 status;
  90. u8 pos;
  91. pci_bus_read_config_word(bus, devfn, PCI_STATUS, &status);
  92. if (!(status & PCI_STATUS_CAP_LIST))
  93. return 0;
  94. switch (hdr_type) {
  95. case PCI_HEADER_TYPE_NORMAL:
  96. case PCI_HEADER_TYPE_BRIDGE:
  97. pos = PCI_CAPABILITY_LIST;
  98. break;
  99. case PCI_HEADER_TYPE_CARDBUS:
  100. pos = PCI_CB_CAPABILITY_LIST;
  101. break;
  102. default:
  103. return 0;
  104. }
  105. return __pci_find_next_cap(bus, devfn, pos, cap);
  106. }
  107. /**
  108. * pci_find_capability - query for devices' capabilities
  109. * @dev: PCI device to query
  110. * @cap: capability code
  111. *
  112. * Tell if a device supports a given PCI capability.
  113. * Returns the address of the requested capability structure within the
  114. * device's PCI configuration space or 0 in case the device does not
  115. * support it. Possible values for @cap:
  116. *
  117. * %PCI_CAP_ID_PM Power Management
  118. * %PCI_CAP_ID_AGP Accelerated Graphics Port
  119. * %PCI_CAP_ID_VPD Vital Product Data
  120. * %PCI_CAP_ID_SLOTID Slot Identification
  121. * %PCI_CAP_ID_MSI Message Signalled Interrupts
  122. * %PCI_CAP_ID_CHSWP CompactPCI HotSwap
  123. * %PCI_CAP_ID_PCIX PCI-X
  124. * %PCI_CAP_ID_EXP PCI Express
  125. */
  126. int pci_find_capability(struct pci_dev *dev, int cap)
  127. {
  128. return __pci_bus_find_cap(dev->bus, dev->devfn, dev->hdr_type, cap);
  129. }
  130. /**
  131. * pci_bus_find_capability - query for devices' capabilities
  132. * @bus: the PCI bus to query
  133. * @devfn: PCI device to query
  134. * @cap: capability code
  135. *
  136. * Like pci_find_capability() but works for pci devices that do not have a
  137. * pci_dev structure set up yet.
  138. *
  139. * Returns the address of the requested capability structure within the
  140. * device's PCI configuration space or 0 in case the device does not
  141. * support it.
  142. */
  143. int pci_bus_find_capability(struct pci_bus *bus, unsigned int devfn, int cap)
  144. {
  145. u8 hdr_type;
  146. pci_bus_read_config_byte(bus, devfn, PCI_HEADER_TYPE, &hdr_type);
  147. return __pci_bus_find_cap(bus, devfn, hdr_type & 0x7f, cap);
  148. }
  149. #if 0
  150. /**
  151. * pci_find_ext_capability - Find an extended capability
  152. * @dev: PCI device to query
  153. * @cap: capability code
  154. *
  155. * Returns the address of the requested extended capability structure
  156. * within the device's PCI configuration space or 0 if the device does
  157. * not support it. Possible values for @cap:
  158. *
  159. * %PCI_EXT_CAP_ID_ERR Advanced Error Reporting
  160. * %PCI_EXT_CAP_ID_VC Virtual Channel
  161. * %PCI_EXT_CAP_ID_DSN Device Serial Number
  162. * %PCI_EXT_CAP_ID_PWR Power Budgeting
  163. */
  164. int pci_find_ext_capability(struct pci_dev *dev, int cap)
  165. {
  166. u32 header;
  167. int ttl = 480; /* 3840 bytes, minimum 8 bytes per capability */
  168. int pos = 0x100;
  169. if (dev->cfg_size <= 256)
  170. return 0;
  171. if (pci_read_config_dword(dev, pos, &header) != PCIBIOS_SUCCESSFUL)
  172. return 0;
  173. /*
  174. * If we have no capabilities, this is indicated by cap ID,
  175. * cap version and next pointer all being 0.
  176. */
  177. if (header == 0)
  178. return 0;
  179. while (ttl-- > 0) {
  180. if (PCI_EXT_CAP_ID(header) == cap)
  181. return pos;
  182. pos = PCI_EXT_CAP_NEXT(header);
  183. if (pos < 0x100)
  184. break;
  185. if (pci_read_config_dword(dev, pos, &header) != PCIBIOS_SUCCESSFUL)
  186. break;
  187. }
  188. return 0;
  189. }
  190. #endif /* 0 */
  191. /**
  192. * pci_find_parent_resource - return resource region of parent bus of given region
  193. * @dev: PCI device structure contains resources to be searched
  194. * @res: child resource record for which parent is sought
  195. *
  196. * For given resource region of given device, return the resource
  197. * region of parent bus the given region is contained in or where
  198. * it should be allocated from.
  199. */
  200. struct resource *
  201. pci_find_parent_resource(const struct pci_dev *dev, struct resource *res)
  202. {
  203. const struct pci_bus *bus = dev->bus;
  204. int i;
  205. struct resource *best = NULL;
  206. for(i = 0; i < PCI_BUS_NUM_RESOURCES; i++) {
  207. struct resource *r = bus->resource[i];
  208. if (!r)
  209. continue;
  210. if (res->start && !(res->start >= r->start && res->end <= r->end))
  211. continue; /* Not contained */
  212. if ((res->flags ^ r->flags) & (IORESOURCE_IO | IORESOURCE_MEM))
  213. continue; /* Wrong type */
  214. if (!((res->flags ^ r->flags) & IORESOURCE_PREFETCH))
  215. return r; /* Exact match */
  216. if ((res->flags & IORESOURCE_PREFETCH) && !(r->flags & IORESOURCE_PREFETCH))
  217. best = r; /* Approximating prefetchable by non-prefetchable */
  218. }
  219. return best;
  220. }
  221. /**
  222. * pci_restore_bars - restore a devices BAR values (e.g. after wake-up)
  223. * @dev: PCI device to have its BARs restored
  224. *
  225. * Restore the BAR values for a given device, so as to make it
  226. * accessible by its driver.
  227. */
  228. void
  229. pci_restore_bars(struct pci_dev *dev)
  230. {
  231. int i, numres;
  232. switch (dev->hdr_type) {
  233. case PCI_HEADER_TYPE_NORMAL:
  234. numres = 6;
  235. break;
  236. case PCI_HEADER_TYPE_BRIDGE:
  237. numres = 2;
  238. break;
  239. case PCI_HEADER_TYPE_CARDBUS:
  240. numres = 1;
  241. break;
  242. default:
  243. /* Should never get here, but just in case... */
  244. return;
  245. }
  246. for (i = 0; i < numres; i ++)
  247. pci_update_resource(dev, &dev->resource[i], i);
  248. }
  249. int (*platform_pci_set_power_state)(struct pci_dev *dev, pci_power_t t);
  250. /**
  251. * pci_set_power_state - Set the power state of a PCI device
  252. * @dev: PCI device to be suspended
  253. * @state: PCI power state (D0, D1, D2, D3hot, D3cold) we're entering
  254. *
  255. * Transition a device to a new power state, using the Power Management
  256. * Capabilities in the device's config space.
  257. *
  258. * RETURN VALUE:
  259. * -EINVAL if trying to enter a lower state than we're already in.
  260. * 0 if we're already in the requested state.
  261. * -EIO if device does not support PCI PM.
  262. * 0 if we can successfully change the power state.
  263. */
  264. int
  265. pci_set_power_state(struct pci_dev *dev, pci_power_t state)
  266. {
  267. int pm, need_restore = 0;
  268. u16 pmcsr, pmc;
  269. /* bound the state we're entering */
  270. if (state > PCI_D3hot)
  271. state = PCI_D3hot;
  272. /* Validate current state:
  273. * Can enter D0 from any state, but if we can only go deeper
  274. * to sleep if we're already in a low power state
  275. */
  276. if (state != PCI_D0 && dev->current_state > state)
  277. return -EINVAL;
  278. else if (dev->current_state == state)
  279. return 0; /* we're already there */
  280. /* find PCI PM capability in list */
  281. pm = pci_find_capability(dev, PCI_CAP_ID_PM);
  282. /* abort if the device doesn't support PM capabilities */
  283. if (!pm)
  284. return -EIO;
  285. pci_read_config_word(dev,pm + PCI_PM_PMC,&pmc);
  286. if ((pmc & PCI_PM_CAP_VER_MASK) > 3) {
  287. printk(KERN_DEBUG
  288. "PCI: %s has unsupported PM cap regs version (%u)\n",
  289. pci_name(dev), pmc & PCI_PM_CAP_VER_MASK);
  290. return -EIO;
  291. }
  292. /* check if this device supports the desired state */
  293. if (state == PCI_D1 && !(pmc & PCI_PM_CAP_D1))
  294. return -EIO;
  295. else if (state == PCI_D2 && !(pmc & PCI_PM_CAP_D2))
  296. return -EIO;
  297. pci_read_config_word(dev, pm + PCI_PM_CTRL, &pmcsr);
  298. /* If we're (effectively) in D3, force entire word to 0.
  299. * This doesn't affect PME_Status, disables PME_En, and
  300. * sets PowerState to 0.
  301. */
  302. switch (dev->current_state) {
  303. case PCI_D0:
  304. case PCI_D1:
  305. case PCI_D2:
  306. pmcsr &= ~PCI_PM_CTRL_STATE_MASK;
  307. pmcsr |= state;
  308. break;
  309. case PCI_UNKNOWN: /* Boot-up */
  310. if ((pmcsr & PCI_PM_CTRL_STATE_MASK) == PCI_D3hot
  311. && !(pmcsr & PCI_PM_CTRL_NO_SOFT_RESET))
  312. need_restore = 1;
  313. /* Fall-through: force to D0 */
  314. default:
  315. pmcsr = 0;
  316. break;
  317. }
  318. /* enter specified state */
  319. pci_write_config_word(dev, pm + PCI_PM_CTRL, pmcsr);
  320. /* Mandatory power management transition delays */
  321. /* see PCI PM 1.1 5.6.1 table 18 */
  322. if (state == PCI_D3hot || dev->current_state == PCI_D3hot)
  323. msleep(10);
  324. else if (state == PCI_D2 || dev->current_state == PCI_D2)
  325. udelay(200);
  326. /*
  327. * Give firmware a chance to be called, such as ACPI _PRx, _PSx
  328. * Firmware method after natice method ?
  329. */
  330. if (platform_pci_set_power_state)
  331. platform_pci_set_power_state(dev, state);
  332. dev->current_state = state;
  333. /* According to section 5.4.1 of the "PCI BUS POWER MANAGEMENT
  334. * INTERFACE SPECIFICATION, REV. 1.2", a device transitioning
  335. * from D3hot to D0 _may_ perform an internal reset, thereby
  336. * going to "D0 Uninitialized" rather than "D0 Initialized".
  337. * For example, at least some versions of the 3c905B and the
  338. * 3c556B exhibit this behaviour.
  339. *
  340. * At least some laptop BIOSen (e.g. the Thinkpad T21) leave
  341. * devices in a D3hot state at boot. Consequently, we need to
  342. * restore at least the BARs so that the device will be
  343. * accessible to its driver.
  344. */
  345. if (need_restore)
  346. pci_restore_bars(dev);
  347. return 0;
  348. }
  349. int (*platform_pci_choose_state)(struct pci_dev *dev, pm_message_t state);
  350. /**
  351. * pci_choose_state - Choose the power state of a PCI device
  352. * @dev: PCI device to be suspended
  353. * @state: target sleep state for the whole system. This is the value
  354. * that is passed to suspend() function.
  355. *
  356. * Returns PCI power state suitable for given device and given system
  357. * message.
  358. */
  359. pci_power_t pci_choose_state(struct pci_dev *dev, pm_message_t state)
  360. {
  361. int ret;
  362. if (!pci_find_capability(dev, PCI_CAP_ID_PM))
  363. return PCI_D0;
  364. if (platform_pci_choose_state) {
  365. ret = platform_pci_choose_state(dev, state);
  366. if (ret >= 0)
  367. state.event = ret;
  368. }
  369. switch (state.event) {
  370. case PM_EVENT_ON:
  371. return PCI_D0;
  372. case PM_EVENT_FREEZE:
  373. case PM_EVENT_SUSPEND:
  374. return PCI_D3hot;
  375. default:
  376. printk("They asked me for state %d\n", state.event);
  377. BUG();
  378. }
  379. return PCI_D0;
  380. }
  381. EXPORT_SYMBOL(pci_choose_state);
  382. /**
  383. * pci_save_state - save the PCI configuration space of a device before suspending
  384. * @dev: - PCI device that we're dealing with
  385. */
  386. int
  387. pci_save_state(struct pci_dev *dev)
  388. {
  389. int i;
  390. /* XXX: 100% dword access ok here? */
  391. for (i = 0; i < 16; i++)
  392. pci_read_config_dword(dev, i * 4,&dev->saved_config_space[i]);
  393. return 0;
  394. }
  395. /**
  396. * pci_restore_state - Restore the saved state of a PCI device
  397. * @dev: - PCI device that we're dealing with
  398. */
  399. int
  400. pci_restore_state(struct pci_dev *dev)
  401. {
  402. int i;
  403. for (i = 0; i < 16; i++)
  404. pci_write_config_dword(dev,i * 4, dev->saved_config_space[i]);
  405. return 0;
  406. }
  407. /**
  408. * pci_enable_device_bars - Initialize some of a device for use
  409. * @dev: PCI device to be initialized
  410. * @bars: bitmask of BAR's that must be configured
  411. *
  412. * Initialize device before it's used by a driver. Ask low-level code
  413. * to enable selected I/O and memory resources. Wake up the device if it
  414. * was suspended. Beware, this function can fail.
  415. */
  416. int
  417. pci_enable_device_bars(struct pci_dev *dev, int bars)
  418. {
  419. int err;
  420. err = pci_set_power_state(dev, PCI_D0);
  421. if (err < 0 && err != -EIO)
  422. return err;
  423. err = pcibios_enable_device(dev, bars);
  424. if (err < 0)
  425. return err;
  426. return 0;
  427. }
  428. /**
  429. * pci_enable_device - Initialize device before it's used by a driver.
  430. * @dev: PCI device to be initialized
  431. *
  432. * Initialize device before it's used by a driver. Ask low-level code
  433. * to enable I/O and memory. Wake up the device if it was suspended.
  434. * Beware, this function can fail.
  435. */
  436. int
  437. pci_enable_device(struct pci_dev *dev)
  438. {
  439. int err = pci_enable_device_bars(dev, (1 << PCI_NUM_RESOURCES) - 1);
  440. if (err)
  441. return err;
  442. pci_fixup_device(pci_fixup_enable, dev);
  443. dev->is_enabled = 1;
  444. return 0;
  445. }
  446. /**
  447. * pcibios_disable_device - disable arch specific PCI resources for device dev
  448. * @dev: the PCI device to disable
  449. *
  450. * Disables architecture specific PCI resources for the device. This
  451. * is the default implementation. Architecture implementations can
  452. * override this.
  453. */
  454. void __attribute__ ((weak)) pcibios_disable_device (struct pci_dev *dev) {}
  455. /**
  456. * pci_disable_device - Disable PCI device after use
  457. * @dev: PCI device to be disabled
  458. *
  459. * Signal to the system that the PCI device is not in use by the system
  460. * anymore. This only involves disabling PCI bus-mastering, if active.
  461. */
  462. void
  463. pci_disable_device(struct pci_dev *dev)
  464. {
  465. u16 pci_command;
  466. pci_read_config_word(dev, PCI_COMMAND, &pci_command);
  467. if (pci_command & PCI_COMMAND_MASTER) {
  468. pci_command &= ~PCI_COMMAND_MASTER;
  469. pci_write_config_word(dev, PCI_COMMAND, pci_command);
  470. }
  471. dev->is_busmaster = 0;
  472. pcibios_disable_device(dev);
  473. dev->is_enabled = 0;
  474. }
  475. /**
  476. * pci_enable_wake - enable device to generate PME# when suspended
  477. * @dev: - PCI device to operate on
  478. * @state: - Current state of device.
  479. * @enable: - Flag to enable or disable generation
  480. *
  481. * Set the bits in the device's PM Capabilities to generate PME# when
  482. * the system is suspended.
  483. *
  484. * -EIO is returned if device doesn't have PM Capabilities.
  485. * -EINVAL is returned if device supports it, but can't generate wake events.
  486. * 0 if operation is successful.
  487. *
  488. */
  489. int pci_enable_wake(struct pci_dev *dev, pci_power_t state, int enable)
  490. {
  491. int pm;
  492. u16 value;
  493. /* find PCI PM capability in list */
  494. pm = pci_find_capability(dev, PCI_CAP_ID_PM);
  495. /* If device doesn't support PM Capabilities, but request is to disable
  496. * wake events, it's a nop; otherwise fail */
  497. if (!pm)
  498. return enable ? -EIO : 0;
  499. /* Check device's ability to generate PME# */
  500. pci_read_config_word(dev,pm+PCI_PM_PMC,&value);
  501. value &= PCI_PM_CAP_PME_MASK;
  502. value >>= ffs(PCI_PM_CAP_PME_MASK) - 1; /* First bit of mask */
  503. /* Check if it can generate PME# from requested state. */
  504. if (!value || !(value & (1 << state)))
  505. return enable ? -EINVAL : 0;
  506. pci_read_config_word(dev, pm + PCI_PM_CTRL, &value);
  507. /* Clear PME_Status by writing 1 to it and enable PME# */
  508. value |= PCI_PM_CTRL_PME_STATUS | PCI_PM_CTRL_PME_ENABLE;
  509. if (!enable)
  510. value &= ~PCI_PM_CTRL_PME_ENABLE;
  511. pci_write_config_word(dev, pm + PCI_PM_CTRL, value);
  512. return 0;
  513. }
  514. int
  515. pci_get_interrupt_pin(struct pci_dev *dev, struct pci_dev **bridge)
  516. {
  517. u8 pin;
  518. pin = dev->pin;
  519. if (!pin)
  520. return -1;
  521. pin--;
  522. while (dev->bus->self) {
  523. pin = (pin + PCI_SLOT(dev->devfn)) % 4;
  524. dev = dev->bus->self;
  525. }
  526. *bridge = dev;
  527. return pin;
  528. }
  529. /**
  530. * pci_release_region - Release a PCI bar
  531. * @pdev: PCI device whose resources were previously reserved by pci_request_region
  532. * @bar: BAR to release
  533. *
  534. * Releases the PCI I/O and memory resources previously reserved by a
  535. * successful call to pci_request_region. Call this function only
  536. * after all use of the PCI regions has ceased.
  537. */
  538. void pci_release_region(struct pci_dev *pdev, int bar)
  539. {
  540. if (pci_resource_len(pdev, bar) == 0)
  541. return;
  542. if (pci_resource_flags(pdev, bar) & IORESOURCE_IO)
  543. release_region(pci_resource_start(pdev, bar),
  544. pci_resource_len(pdev, bar));
  545. else if (pci_resource_flags(pdev, bar) & IORESOURCE_MEM)
  546. release_mem_region(pci_resource_start(pdev, bar),
  547. pci_resource_len(pdev, bar));
  548. }
  549. /**
  550. * pci_request_region - Reserved PCI I/O and memory resource
  551. * @pdev: PCI device whose resources are to be reserved
  552. * @bar: BAR to be reserved
  553. * @res_name: Name to be associated with resource.
  554. *
  555. * Mark the PCI region associated with PCI device @pdev BR @bar as
  556. * being reserved by owner @res_name. Do not access any
  557. * address inside the PCI regions unless this call returns
  558. * successfully.
  559. *
  560. * Returns 0 on success, or %EBUSY on error. A warning
  561. * message is also printed on failure.
  562. */
  563. int pci_request_region(struct pci_dev *pdev, int bar, const char *res_name)
  564. {
  565. if (pci_resource_len(pdev, bar) == 0)
  566. return 0;
  567. if (pci_resource_flags(pdev, bar) & IORESOURCE_IO) {
  568. if (!request_region(pci_resource_start(pdev, bar),
  569. pci_resource_len(pdev, bar), res_name))
  570. goto err_out;
  571. }
  572. else if (pci_resource_flags(pdev, bar) & IORESOURCE_MEM) {
  573. if (!request_mem_region(pci_resource_start(pdev, bar),
  574. pci_resource_len(pdev, bar), res_name))
  575. goto err_out;
  576. }
  577. return 0;
  578. err_out:
  579. printk (KERN_WARNING "PCI: Unable to reserve %s region #%d:%lx@%lx for device %s\n",
  580. pci_resource_flags(pdev, bar) & IORESOURCE_IO ? "I/O" : "mem",
  581. bar + 1, /* PCI BAR # */
  582. pci_resource_len(pdev, bar), pci_resource_start(pdev, bar),
  583. pci_name(pdev));
  584. return -EBUSY;
  585. }
  586. /**
  587. * pci_release_regions - Release reserved PCI I/O and memory resources
  588. * @pdev: PCI device whose resources were previously reserved by pci_request_regions
  589. *
  590. * Releases all PCI I/O and memory resources previously reserved by a
  591. * successful call to pci_request_regions. Call this function only
  592. * after all use of the PCI regions has ceased.
  593. */
  594. void pci_release_regions(struct pci_dev *pdev)
  595. {
  596. int i;
  597. for (i = 0; i < 6; i++)
  598. pci_release_region(pdev, i);
  599. }
  600. /**
  601. * pci_request_regions - Reserved PCI I/O and memory resources
  602. * @pdev: PCI device whose resources are to be reserved
  603. * @res_name: Name to be associated with resource.
  604. *
  605. * Mark all PCI regions associated with PCI device @pdev as
  606. * being reserved by owner @res_name. Do not access any
  607. * address inside the PCI regions unless this call returns
  608. * successfully.
  609. *
  610. * Returns 0 on success, or %EBUSY on error. A warning
  611. * message is also printed on failure.
  612. */
  613. int pci_request_regions(struct pci_dev *pdev, const char *res_name)
  614. {
  615. int i;
  616. for (i = 0; i < 6; i++)
  617. if(pci_request_region(pdev, i, res_name))
  618. goto err_out;
  619. return 0;
  620. err_out:
  621. while(--i >= 0)
  622. pci_release_region(pdev, i);
  623. return -EBUSY;
  624. }
  625. /**
  626. * pci_set_master - enables bus-mastering for device dev
  627. * @dev: the PCI device to enable
  628. *
  629. * Enables bus-mastering on the device and calls pcibios_set_master()
  630. * to do the needed arch specific settings.
  631. */
  632. void
  633. pci_set_master(struct pci_dev *dev)
  634. {
  635. u16 cmd;
  636. pci_read_config_word(dev, PCI_COMMAND, &cmd);
  637. if (! (cmd & PCI_COMMAND_MASTER)) {
  638. pr_debug("PCI: Enabling bus mastering for device %s\n", pci_name(dev));
  639. cmd |= PCI_COMMAND_MASTER;
  640. pci_write_config_word(dev, PCI_COMMAND, cmd);
  641. }
  642. dev->is_busmaster = 1;
  643. pcibios_set_master(dev);
  644. }
  645. #ifndef HAVE_ARCH_PCI_MWI
  646. /* This can be overridden by arch code. */
  647. u8 pci_cache_line_size = L1_CACHE_BYTES >> 2;
  648. /**
  649. * pci_generic_prep_mwi - helper function for pci_set_mwi
  650. * @dev: the PCI device for which MWI is enabled
  651. *
  652. * Helper function for generic implementation of pcibios_prep_mwi
  653. * function. Originally copied from drivers/net/acenic.c.
  654. * Copyright 1998-2001 by Jes Sorensen, <jes@trained-monkey.org>.
  655. *
  656. * RETURNS: An appropriate -ERRNO error value on error, or zero for success.
  657. */
  658. static int
  659. pci_generic_prep_mwi(struct pci_dev *dev)
  660. {
  661. u8 cacheline_size;
  662. if (!pci_cache_line_size)
  663. return -EINVAL; /* The system doesn't support MWI. */
  664. /* Validate current setting: the PCI_CACHE_LINE_SIZE must be
  665. equal to or multiple of the right value. */
  666. pci_read_config_byte(dev, PCI_CACHE_LINE_SIZE, &cacheline_size);
  667. if (cacheline_size >= pci_cache_line_size &&
  668. (cacheline_size % pci_cache_line_size) == 0)
  669. return 0;
  670. /* Write the correct value. */
  671. pci_write_config_byte(dev, PCI_CACHE_LINE_SIZE, pci_cache_line_size);
  672. /* Read it back. */
  673. pci_read_config_byte(dev, PCI_CACHE_LINE_SIZE, &cacheline_size);
  674. if (cacheline_size == pci_cache_line_size)
  675. return 0;
  676. printk(KERN_DEBUG "PCI: cache line size of %d is not supported "
  677. "by device %s\n", pci_cache_line_size << 2, pci_name(dev));
  678. return -EINVAL;
  679. }
  680. #endif /* !HAVE_ARCH_PCI_MWI */
  681. /**
  682. * pci_set_mwi - enables memory-write-invalidate PCI transaction
  683. * @dev: the PCI device for which MWI is enabled
  684. *
  685. * Enables the Memory-Write-Invalidate transaction in %PCI_COMMAND,
  686. * and then calls @pcibios_set_mwi to do the needed arch specific
  687. * operations or a generic mwi-prep function.
  688. *
  689. * RETURNS: An appropriate -ERRNO error value on error, or zero for success.
  690. */
  691. int
  692. pci_set_mwi(struct pci_dev *dev)
  693. {
  694. int rc;
  695. u16 cmd;
  696. #ifdef HAVE_ARCH_PCI_MWI
  697. rc = pcibios_prep_mwi(dev);
  698. #else
  699. rc = pci_generic_prep_mwi(dev);
  700. #endif
  701. if (rc)
  702. return rc;
  703. pci_read_config_word(dev, PCI_COMMAND, &cmd);
  704. if (! (cmd & PCI_COMMAND_INVALIDATE)) {
  705. pr_debug("PCI: Enabling Mem-Wr-Inval for device %s\n", pci_name(dev));
  706. cmd |= PCI_COMMAND_INVALIDATE;
  707. pci_write_config_word(dev, PCI_COMMAND, cmd);
  708. }
  709. return 0;
  710. }
  711. /**
  712. * pci_clear_mwi - disables Memory-Write-Invalidate for device dev
  713. * @dev: the PCI device to disable
  714. *
  715. * Disables PCI Memory-Write-Invalidate transaction on the device
  716. */
  717. void
  718. pci_clear_mwi(struct pci_dev *dev)
  719. {
  720. u16 cmd;
  721. pci_read_config_word(dev, PCI_COMMAND, &cmd);
  722. if (cmd & PCI_COMMAND_INVALIDATE) {
  723. cmd &= ~PCI_COMMAND_INVALIDATE;
  724. pci_write_config_word(dev, PCI_COMMAND, cmd);
  725. }
  726. }
  727. /**
  728. * pci_intx - enables/disables PCI INTx for device dev
  729. * @pdev: the PCI device to operate on
  730. * @enable: boolean: whether to enable or disable PCI INTx
  731. *
  732. * Enables/disables PCI INTx for device dev
  733. */
  734. void
  735. pci_intx(struct pci_dev *pdev, int enable)
  736. {
  737. u16 pci_command, new;
  738. pci_read_config_word(pdev, PCI_COMMAND, &pci_command);
  739. if (enable) {
  740. new = pci_command & ~PCI_COMMAND_INTX_DISABLE;
  741. } else {
  742. new = pci_command | PCI_COMMAND_INTX_DISABLE;
  743. }
  744. if (new != pci_command) {
  745. pci_write_config_word(pdev, PCI_COMMAND, new);
  746. }
  747. }
  748. #ifndef HAVE_ARCH_PCI_SET_DMA_MASK
  749. /*
  750. * These can be overridden by arch-specific implementations
  751. */
  752. int
  753. pci_set_dma_mask(struct pci_dev *dev, u64 mask)
  754. {
  755. if (!pci_dma_supported(dev, mask))
  756. return -EIO;
  757. dev->dma_mask = mask;
  758. return 0;
  759. }
  760. int
  761. pci_set_consistent_dma_mask(struct pci_dev *dev, u64 mask)
  762. {
  763. if (!pci_dma_supported(dev, mask))
  764. return -EIO;
  765. dev->dev.coherent_dma_mask = mask;
  766. return 0;
  767. }
  768. #endif
  769. static int __devinit pci_init(void)
  770. {
  771. struct pci_dev *dev = NULL;
  772. while ((dev = pci_get_device(PCI_ANY_ID, PCI_ANY_ID, dev)) != NULL) {
  773. pci_fixup_device(pci_fixup_final, dev);
  774. }
  775. return 0;
  776. }
  777. static int __devinit pci_setup(char *str)
  778. {
  779. while (str) {
  780. char *k = strchr(str, ',');
  781. if (k)
  782. *k++ = 0;
  783. if (*str && (str = pcibios_setup(str)) && *str) {
  784. if (!strcmp(str, "nomsi")) {
  785. pci_no_msi();
  786. } else {
  787. printk(KERN_ERR "PCI: Unknown option `%s'\n",
  788. str);
  789. }
  790. }
  791. str = k;
  792. }
  793. return 1;
  794. }
  795. device_initcall(pci_init);
  796. __setup("pci=", pci_setup);
  797. #if defined(CONFIG_ISA) || defined(CONFIG_EISA)
  798. /* FIXME: Some boxes have multiple ISA bridges! */
  799. struct pci_dev *isa_bridge;
  800. EXPORT_SYMBOL(isa_bridge);
  801. #endif
  802. EXPORT_SYMBOL_GPL(pci_restore_bars);
  803. EXPORT_SYMBOL(pci_enable_device_bars);
  804. EXPORT_SYMBOL(pci_enable_device);
  805. EXPORT_SYMBOL(pci_disable_device);
  806. EXPORT_SYMBOL(pci_find_capability);
  807. EXPORT_SYMBOL(pci_bus_find_capability);
  808. EXPORT_SYMBOL(pci_release_regions);
  809. EXPORT_SYMBOL(pci_request_regions);
  810. EXPORT_SYMBOL(pci_release_region);
  811. EXPORT_SYMBOL(pci_request_region);
  812. EXPORT_SYMBOL(pci_set_master);
  813. EXPORT_SYMBOL(pci_set_mwi);
  814. EXPORT_SYMBOL(pci_clear_mwi);
  815. EXPORT_SYMBOL_GPL(pci_intx);
  816. EXPORT_SYMBOL(pci_set_dma_mask);
  817. EXPORT_SYMBOL(pci_set_consistent_dma_mask);
  818. EXPORT_SYMBOL(pci_assign_resource);
  819. EXPORT_SYMBOL(pci_find_parent_resource);
  820. EXPORT_SYMBOL(pci_set_power_state);
  821. EXPORT_SYMBOL(pci_save_state);
  822. EXPORT_SYMBOL(pci_restore_state);
  823. EXPORT_SYMBOL(pci_enable_wake);
  824. /* Quirk info */
  825. EXPORT_SYMBOL(isa_dma_bridge_buggy);
  826. EXPORT_SYMBOL(pci_pci_problems);