2 * Implement the default iomap interfaces
4 * (C) Copyright 2004 Linus Torvalds
9 #include <linux/export.h>
13 * pci_iomap_range - create a virtual mapping cookie for a PCI BAR
14 * @dev: PCI device that owns the BAR
16 * @offset: map memory at the given offset in BAR
17 * @maxlen: max length of the memory to map
19 * Using this function you will get a __iomem address to your device BAR.
20 * You can access it using ioread*() and iowrite*(). These functions hide
21 * the details if this is a MMIO or PIO address space and will just do what
22 * you expect from them in the correct way.
24 * @maxlen specifies the maximum length to map. If you want to get access to
25 * the complete BAR from offset to the end, pass %0 here.
27 void __iomem *pci_iomap_range(struct pci_dev *dev,
32 resource_size_t start = pci_resource_start(dev, bar);
33 resource_size_t len = pci_resource_len(dev, bar);
34 unsigned long flags = pci_resource_flags(dev, bar);
36 if (len <= offset || !start)
40 if (maxlen && len > maxlen)
42 if (flags & IORESOURCE_IO)
43 return __pci_ioport_map(dev, start, len);
44 if (flags & IORESOURCE_MEM)
45 return ioremap(start, len);
49 EXPORT_SYMBOL(pci_iomap_range);
52 * pci_iomap_wc_range - create a virtual WC mapping cookie for a PCI BAR
53 * @dev: PCI device that owns the BAR
55 * @offset: map memory at the given offset in BAR
56 * @maxlen: max length of the memory to map
58 * Using this function you will get a __iomem address to your device BAR.
59 * You can access it using ioread*() and iowrite*(). These functions hide
60 * the details if this is a MMIO or PIO address space and will just do what
61 * you expect from them in the correct way. When possible write combining
64 * @maxlen specifies the maximum length to map. If you want to get access to
65 * the complete BAR from offset to the end, pass %0 here.
67 void __iomem *pci_iomap_wc_range(struct pci_dev *dev,
72 resource_size_t start = pci_resource_start(dev, bar);
73 resource_size_t len = pci_resource_len(dev, bar);
74 unsigned long flags = pci_resource_flags(dev, bar);
77 if (flags & IORESOURCE_IO)
80 if (len <= offset || !start)
85 if (maxlen && len > maxlen)
88 if (flags & IORESOURCE_MEM)
89 return ioremap_wc(start, len);
94 EXPORT_SYMBOL_GPL(pci_iomap_wc_range);
97 * pci_iomap - create a virtual mapping cookie for a PCI BAR
98 * @dev: PCI device that owns the BAR
100 * @maxlen: length of the memory to map
102 * Using this function you will get a __iomem address to your device BAR.
103 * You can access it using ioread*() and iowrite*(). These functions hide
104 * the details if this is a MMIO or PIO address space and will just do what
105 * you expect from them in the correct way.
107 * @maxlen specifies the maximum length to map. If you want to get access to
108 * the complete BAR without checking for its length first, pass %0 here.
110 void __iomem *pci_iomap(struct pci_dev *dev, int bar, unsigned long maxlen)
112 return pci_iomap_range(dev, bar, 0, maxlen);
114 EXPORT_SYMBOL(pci_iomap);
117 * pci_iomap_wc - create a virtual WC mapping cookie for a PCI BAR
118 * @dev: PCI device that owns the BAR
120 * @maxlen: length of the memory to map
122 * Using this function you will get a __iomem address to your device BAR.
123 * You can access it using ioread*() and iowrite*(). These functions hide
124 * the details if this is a MMIO or PIO address space and will just do what
125 * you expect from them in the correct way. When possible write combining
128 * @maxlen specifies the maximum length to map. If you want to get access to
129 * the complete BAR without checking for its length first, pass %0 here.
131 void __iomem *pci_iomap_wc(struct pci_dev *dev, int bar, unsigned long maxlen)
133 return pci_iomap_wc_range(dev, bar, 0, maxlen);
135 EXPORT_SYMBOL_GPL(pci_iomap_wc);
136 #endif /* CONFIG_PCI */