1 /* drm_pci.h -- PCI DMA memory management wrappers for DRM -*- linux-c -*- */
4 * \brief Functions and ioctls to manage PCI memory
6 * \warning These interfaces aren't stable yet.
8 * \todo Implement the remaining ioctl's for the PCI pools.
9 * \todo The wrappers here are so thin that they would be better off inlined..
11 * \author José Fonseca <jrfonseca@tungstengraphics.com>
12 * \author Leif Delgass <ldelgass@retinalburn.net>
16 * Copyright 2003 José Fonseca.
17 * Copyright 2003 Leif Delgass.
18 * All Rights Reserved.
20 * Permission is hereby granted, free of charge, to any person obtaining a
21 * copy of this software and associated documentation files (the "Software"),
22 * to deal in the Software without restriction, including without limitation
23 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
24 * and/or sell copies of the Software, and to permit persons to whom the
25 * Software is furnished to do so, subject to the following conditions:
27 * The above copyright notice and this permission notice (including the next
28 * paragraph) shall be included in all copies or substantial portions of the
31 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
32 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
33 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
34 * AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
35 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
36 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
39 #include <linux/pci.h>
40 #include <linux/slab.h>
41 #include <linux/dma-mapping.h>
42 #include <linux/export.h>
45 /**********************************************************************/
46 /** \name PCI memory */
50 * \brief Allocate a PCI consistent memory block, for DMA.
52 drm_dma_handle_t *drm_pci_alloc(struct drm_device * dev, size_t size, size_t align)
54 drm_dma_handle_t *dmah;
58 /* pci_alloc_consistent only guarantees alignment to the smallest
59 * PAGE_SIZE order which is greater than or equal to the requested size.
60 * Return NULL here for now to make sure nobody tries for larger alignment
65 dmah = kmalloc(sizeof(drm_dma_handle_t), GFP_KERNEL);
70 dmah->vaddr = dma_alloc_coherent(&dev->pdev->dev, size, &dmah->busaddr, GFP_KERNEL | __GFP_COMP);
72 if (dmah->vaddr == NULL) {
77 memset(dmah->vaddr, 0, size);
79 /* XXX - Is virt_to_page() legal for consistent mem? */
81 for (addr = (unsigned long)dmah->vaddr, sz = size;
82 sz > 0; addr += PAGE_SIZE, sz -= PAGE_SIZE) {
83 SetPageReserved(virt_to_page((void *)addr));
89 EXPORT_SYMBOL(drm_pci_alloc);
92 * \brief Free a PCI consistent memory block without freeing its descriptor.
94 * This function is for internal use in the Linux-specific DRM core code.
96 void __drm_pci_free(struct drm_device * dev, drm_dma_handle_t * dmah)
102 /* XXX - Is virt_to_page() legal for consistent mem? */
104 for (addr = (unsigned long)dmah->vaddr, sz = dmah->size;
105 sz > 0; addr += PAGE_SIZE, sz -= PAGE_SIZE) {
106 ClearPageReserved(virt_to_page((void *)addr));
108 dma_free_coherent(&dev->pdev->dev, dmah->size, dmah->vaddr,
114 * \brief Free a PCI consistent memory block
116 void drm_pci_free(struct drm_device * dev, drm_dma_handle_t * dmah)
118 __drm_pci_free(dev, dmah);
122 EXPORT_SYMBOL(drm_pci_free);
126 static int drm_get_pci_domain(struct drm_device *dev)
129 /* For historical reasons, drm_get_pci_domain() is busticated
130 * on most archs and has to remain so for userspace interface
131 * < 1.4, except on alpha which was right from the beginning
133 if (dev->if_version < 0x10004)
135 #endif /* __alpha__ */
137 return pci_domain_nr(dev->pdev->bus);
140 static const char *drm_pci_get_name(struct drm_device *dev)
142 struct pci_driver *pdriver = dev->driver->kdriver.pci;
143 return pdriver->name;
146 static int drm_pci_set_busid(struct drm_device *dev, struct drm_master *master)
149 struct pci_driver *pdriver = dev->driver->kdriver.pci;
150 master->unique_len = 40;
151 master->unique_size = master->unique_len;
152 master->unique = kmalloc(master->unique_size, GFP_KERNEL);
153 if (master->unique == NULL)
157 len = snprintf(master->unique, master->unique_len,
158 "pci:%04x:%02x:%02x.%d",
159 drm_get_pci_domain(dev),
160 dev->pdev->bus->number,
161 PCI_SLOT(dev->pdev->devfn),
162 PCI_FUNC(dev->pdev->devfn));
164 if (len >= master->unique_len) {
165 DRM_ERROR("buffer overflow");
169 master->unique_len = len;
172 kmalloc(strlen(pdriver->name) +
173 master->unique_len + 2, GFP_KERNEL);
175 if (dev->devname == NULL) {
180 sprintf(dev->devname, "%s@%s", pdriver->name,
188 int drm_pci_set_unique(struct drm_device *dev,
189 struct drm_master *master,
190 struct drm_unique *u)
192 int domain, bus, slot, func, ret;
193 const char *bus_name;
195 master->unique_len = u->unique_len;
196 master->unique_size = u->unique_len + 1;
197 master->unique = kmalloc(master->unique_size, GFP_KERNEL);
198 if (!master->unique) {
203 if (copy_from_user(master->unique, u->unique, master->unique_len)) {
208 master->unique[master->unique_len] = '\0';
210 bus_name = dev->driver->bus->get_name(dev);
211 dev->devname = kmalloc(strlen(bus_name) +
212 strlen(master->unique) + 2, GFP_KERNEL);
218 sprintf(dev->devname, "%s@%s", bus_name,
221 /* Return error if the busid submitted doesn't match the device's actual
224 ret = sscanf(master->unique, "PCI:%d:%d:%d", &bus, &slot, &func);
233 if ((domain != drm_get_pci_domain(dev)) ||
234 (bus != dev->pdev->bus->number) ||
235 (slot != PCI_SLOT(dev->pdev->devfn)) ||
236 (func != PCI_FUNC(dev->pdev->devfn))) {
245 static int drm_pci_irq_by_busid(struct drm_device *dev, struct drm_irq_busid *p)
247 if ((p->busnum >> 8) != drm_get_pci_domain(dev) ||
248 (p->busnum & 0xff) != dev->pdev->bus->number ||
249 p->devnum != PCI_SLOT(dev->pdev->devfn) || p->funcnum != PCI_FUNC(dev->pdev->devfn))
252 p->irq = dev->pdev->irq;
254 DRM_DEBUG("%d:%d:%d => IRQ %d\n", p->busnum, p->devnum, p->funcnum,
260 * Get interrupt from bus id.
262 * \param inode device inode.
263 * \param file_priv DRM file private.
264 * \param cmd command.
265 * \param arg user argument, pointing to a drm_irq_busid structure.
266 * \return zero on success or a negative number on failure.
268 * Finds the PCI device with the specified bus id and gets its IRQ number.
269 * This IOCTL is deprecated, and will now return EINVAL for any busid not equal
270 * to that of the device that this DRM instance attached to.
272 int drm_irq_by_busid(struct drm_device *dev, void *data,
273 struct drm_file *file_priv)
275 struct drm_irq_busid *p = data;
277 if (drm_core_check_feature(dev, DRIVER_MODESET))
280 /* UMS was only ever support on PCI devices. */
281 if (WARN_ON(!dev->pdev))
284 if (!drm_core_check_feature(dev, DRIVER_HAVE_IRQ))
287 return drm_pci_irq_by_busid(dev, p);
290 static void drm_pci_agp_init(struct drm_device *dev)
292 if (drm_core_check_feature(dev, DRIVER_USE_AGP)) {
293 if (drm_pci_device_is_agp(dev))
294 dev->agp = drm_agp_init(dev);
296 dev->agp->agp_mtrr = arch_phys_wc_add(
297 dev->agp->agp_info.aper_base,
298 dev->agp->agp_info.aper_size *
304 void drm_pci_agp_destroy(struct drm_device *dev)
307 arch_phys_wc_del(dev->agp->agp_mtrr);
314 static struct drm_bus drm_pci_bus = {
315 .get_name = drm_pci_get_name,
316 .set_busid = drm_pci_set_busid,
322 * \param pdev - PCI device structure
323 * \param ent entry from the PCI ID table with device type flags
324 * \return zero on success or a negative number on failure.
326 * Attempt to gets inter module "drm" information. If we are first
327 * then register the character device and inter module information.
328 * Try and register, if we fail to register, backout previous work.
330 int drm_get_pci_dev(struct pci_dev *pdev, const struct pci_device_id *ent,
331 struct drm_driver *driver)
333 struct drm_device *dev;
338 dev = drm_dev_alloc(driver, &pdev->dev);
342 ret = pci_enable_device(pdev);
348 dev->hose = pdev->sysdata;
351 if (drm_core_check_feature(dev, DRIVER_MODESET))
352 pci_set_drvdata(pdev, dev);
354 drm_pci_agp_init(dev);
356 ret = drm_dev_register(dev, ent->driver_data);
360 DRM_INFO("Initialized %s %d.%d.%d %s for %s on minor %d\n",
361 driver->name, driver->major, driver->minor, driver->patchlevel,
362 driver->date, pci_name(pdev), dev->primary->index);
364 /* No locking needed since shadow-attach is single-threaded since it may
365 * only be called from the per-driver module init hook. */
366 if (!drm_core_check_feature(dev, DRIVER_MODESET))
367 list_add_tail(&dev->legacy_dev_list, &driver->legacy_dev_list);
372 drm_pci_agp_destroy(dev);
373 pci_disable_device(pdev);
378 EXPORT_SYMBOL(drm_get_pci_dev);
381 * PCI device initialization. Called direct from modules at load time.
383 * \return zero on success or a negative number on failure.
385 * Initializes a drm_device structures,registering the
386 * stubs and initializing the AGP device.
388 * Expands the \c DRIVER_PREINIT and \c DRIVER_POST_INIT macros before and
389 * after the initialization for driver customization.
391 int drm_pci_init(struct drm_driver *driver, struct pci_driver *pdriver)
393 struct pci_dev *pdev = NULL;
394 const struct pci_device_id *pid;
399 driver->kdriver.pci = pdriver;
400 driver->bus = &drm_pci_bus;
402 if (driver->driver_features & DRIVER_MODESET)
403 return pci_register_driver(pdriver);
405 /* If not using KMS, fall back to stealth mode manual scanning. */
406 INIT_LIST_HEAD(&driver->legacy_dev_list);
407 for (i = 0; pdriver->id_table[i].vendor != 0; i++) {
408 pid = &pdriver->id_table[i];
410 /* Loop around setting up a DRM device for each PCI device
411 * matching our ID and device class. If we had the internal
412 * function that pci_get_subsys and pci_get_class used, we'd
413 * be able to just pass pid in instead of doing a two-stage
418 pci_get_subsys(pid->vendor, pid->device, pid->subvendor,
419 pid->subdevice, pdev)) != NULL) {
420 if ((pdev->class & pid->class_mask) != pid->class)
423 /* stealth mode requires a manual probe */
425 drm_get_pci_dev(pdev, pid, driver);
431 int drm_pcie_get_speed_cap_mask(struct drm_device *dev, u32 *mask)
433 struct pci_dev *root;
440 root = dev->pdev->bus->self;
442 /* we've been informed via and serverworks don't make the cut */
443 if (root->vendor == PCI_VENDOR_ID_VIA ||
444 root->vendor == PCI_VENDOR_ID_SERVERWORKS)
447 pcie_capability_read_dword(root, PCI_EXP_LNKCAP, &lnkcap);
448 pcie_capability_read_dword(root, PCI_EXP_LNKCAP2, &lnkcap2);
450 if (lnkcap2) { /* PCIe r3.0-compliant */
451 if (lnkcap2 & PCI_EXP_LNKCAP2_SLS_2_5GB)
452 *mask |= DRM_PCIE_SPEED_25;
453 if (lnkcap2 & PCI_EXP_LNKCAP2_SLS_5_0GB)
454 *mask |= DRM_PCIE_SPEED_50;
455 if (lnkcap2 & PCI_EXP_LNKCAP2_SLS_8_0GB)
456 *mask |= DRM_PCIE_SPEED_80;
457 } else { /* pre-r3.0 */
458 if (lnkcap & PCI_EXP_LNKCAP_SLS_2_5GB)
459 *mask |= DRM_PCIE_SPEED_25;
460 if (lnkcap & PCI_EXP_LNKCAP_SLS_5_0GB)
461 *mask |= (DRM_PCIE_SPEED_25 | DRM_PCIE_SPEED_50);
464 DRM_INFO("probing gen 2 caps for device %x:%x = %x/%x\n", root->vendor, root->device, lnkcap, lnkcap2);
467 EXPORT_SYMBOL(drm_pcie_get_speed_cap_mask);
471 int drm_pci_init(struct drm_driver *driver, struct pci_driver *pdriver)
476 void drm_pci_agp_destroy(struct drm_device *dev) {}
478 int drm_irq_by_busid(struct drm_device *dev, void *data,
479 struct drm_file *file_priv)
484 int drm_pci_set_unique(struct drm_device *dev,
485 struct drm_master *master,
486 struct drm_unique *u)
492 EXPORT_SYMBOL(drm_pci_init);
495 void drm_pci_exit(struct drm_driver *driver, struct pci_driver *pdriver)
497 struct drm_device *dev, *tmp;
500 if (driver->driver_features & DRIVER_MODESET) {
501 pci_unregister_driver(pdriver);
503 list_for_each_entry_safe(dev, tmp, &driver->legacy_dev_list,
505 list_del(&dev->legacy_dev_list);
509 DRM_INFO("Module unloaded\n");
511 EXPORT_SYMBOL(drm_pci_exit);