Blame view
include/linux/vgaarb.h
8.46 KB
deb2d2ecd PCI/GPU: implemen... |
1 |
/* |
e2d4304b7 PCI: fix VGA arbi... |
2 3 |
* The VGA aribiter manages VGA space routing and VGA resource decode to * allow multiple VGA devices to be used in a system in a safe way. |
deb2d2ecd PCI/GPU: implemen... |
4 5 6 7 |
* * (C) Copyright 2005 Benjamin Herrenschmidt <benh@kernel.crashing.org> * (C) Copyright 2007 Paulo R. Zanoni <przanoni@gmail.com> * (C) Copyright 2007, 2009 Tiago Vignatti <vignatti@freedesktop.org> |
c0db9cbc7 vgaarb: use MIT l... |
8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
* * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice (including the next * paragraph) shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * DEALINGS * IN THE SOFTWARE. * |
deb2d2ecd PCI/GPU: implemen... |
29 30 31 |
*/ #ifndef LINUX_VGA_H |
a6a1a095e include/linux/vga... |
32 |
#define LINUX_VGA_H |
deb2d2ecd PCI/GPU: implemen... |
33 |
|
deb2d2ecd PCI/GPU: implemen... |
34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 |
/* Legacy VGA regions */ #define VGA_RSRC_NONE 0x00 #define VGA_RSRC_LEGACY_IO 0x01 #define VGA_RSRC_LEGACY_MEM 0x02 #define VGA_RSRC_LEGACY_MASK (VGA_RSRC_LEGACY_IO | VGA_RSRC_LEGACY_MEM) /* Non-legacy access */ #define VGA_RSRC_NORMAL_IO 0x04 #define VGA_RSRC_NORMAL_MEM 0x08 /* Passing that instead of a pci_dev to use the system "default" * device, that is the one used by vgacon. Archs will probably * have to provide their own vga_default_device(); */ #define VGA_DEFAULT_DEVICE (NULL) /* For use by clients */ /** * vga_set_legacy_decoding * * @pdev: pci device of the VGA card * @decodes: bit mask of what legacy regions the card decodes * * Indicates to the arbiter if the card decodes legacy VGA IOs, * legacy VGA Memory, both, or none. All cards default to both, * the card driver (fbdev for example) should tell the arbiter * if it has disabled legacy decoding, so the card can be left * out of the arbitration process (and can be safe to take * interrupts at any time. */ extern void vga_set_legacy_decoding(struct pci_dev *pdev, |
7c329288d vgaarb: make clie... |
66 |
unsigned int decodes); |
deb2d2ecd PCI/GPU: implemen... |
67 68 69 70 |
/** * vga_get - acquire & locks VGA resources * |
6ac3bd527 PCI/vgaarb: clean... |
71 72 73 |
* @pdev: pci device of the VGA card or NULL for the system default * @rsrc: bit mask of resources to acquire and lock * @interruptible: blocking should be interruptible by signals ? |
deb2d2ecd PCI/GPU: implemen... |
74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 |
* * This function acquires VGA resources for the given * card and mark those resources locked. If the resource requested * are "normal" (and not legacy) resources, the arbiter will first check * wether the card is doing legacy decoding for that type of resource. If * yes, the lock is "converted" into a legacy resource lock. * The arbiter will first look for all VGA cards that might conflict * and disable their IOs and/or Memory access, inlcuding VGA forwarding * on P2P bridges if necessary, so that the requested resources can * be used. Then, the card is marked as locking these resources and * the IO and/or Memory accesse are enabled on the card (including * VGA forwarding on parent P2P bridges if any). * This function will block if some conflicting card is already locking * one of the required resources (or any resource on a different bus * segment, since P2P bridges don't differenciate VGA memory and IO * afaik). You can indicate wether this blocking should be interruptible * by a signal (for userland interface) or not. * Must not be called at interrupt time or in atomic context. * If the card already owns the resources, the function succeeds. * Nested calls are supported (a per-resource counter is maintained) */ extern int vga_get(struct pci_dev *pdev, unsigned int rsrc, int interruptible); /** * vga_get_interruptible * * Shortcut to vga_get */ static inline int vga_get_interruptible(struct pci_dev *pdev, |
6ac3bd527 PCI/vgaarb: clean... |
106 |
unsigned int rsrc) |
deb2d2ecd PCI/GPU: implemen... |
107 108 109 110 111 |
{ return vga_get(pdev, rsrc, 1); } /** |
6ac3bd527 PCI/vgaarb: clean... |
112 |
* vga_get_uninterruptible |
deb2d2ecd PCI/GPU: implemen... |
113 114 115 116 117 |
* * Shortcut to vga_get */ static inline int vga_get_uninterruptible(struct pci_dev *pdev, |
6ac3bd527 PCI/vgaarb: clean... |
118 |
unsigned int rsrc) |
deb2d2ecd PCI/GPU: implemen... |
119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 |
{ return vga_get(pdev, rsrc, 0); } /** * vga_tryget - try to acquire & lock legacy VGA resources * * @pdev: pci devivce of VGA card or NULL for system default * @rsrc: bit mask of resources to acquire and lock * * This function performs the same operation as vga_get(), but * will return an error (-EBUSY) instead of blocking if the resources * are already locked by another card. It can be called in any context */ extern int vga_tryget(struct pci_dev *pdev, unsigned int rsrc); /** * vga_put - release lock on legacy VGA resources * * @pdev: pci device of VGA card or NULL for system default * @rsrc: but mask of resource to release * * This function releases resources previously locked by vga_get() * or vga_tryget(). The resources aren't disabled right away, so * that a subsequence vga_get() on the same card will succeed * immediately. Resources have a counter, so locks are only * released if the counter reaches 0. */ extern void vga_put(struct pci_dev *pdev, unsigned int rsrc); /** * vga_default_device * * This can be defined by the platform. The default implementation * is rather dumb and will probably only work properly on single * vga card setups and/or x86 platforms. * * If your VGA default device is not PCI, you'll have to return * NULL here. In this case, I assume it will not conflict with * any PCI card. If this is not true, I'll have to define two archs * hooks for enabling/disabling the VGA default device if that is * possible. This may be a problem with real _ISA_ VGA cards, in * addition to a PCI one. I don't know at this point how to deal * with that card. Can theirs IOs be disabled at all ? If not, then * I suppose it's a matter of having the proper arch hook telling * us about it, so we basically never allow anybody to succeed a * vga_get()... */ #ifndef __ARCH_HAS_VGA_DEFAULT_DEVICE extern struct pci_dev *vga_default_device(void); #endif /** * vga_conflicts * * Architectures should define this if they have several * independant PCI domains that can afford concurrent VGA * decoding */ #ifndef __ARCH_HAS_VGA_CONFLICT static inline int vga_conflicts(struct pci_dev *p1, struct pci_dev *p2) { return 1; } #endif |
6ac3bd527 PCI/vgaarb: clean... |
189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 |
/** * vga_client_register * * @pdev: pci device of the VGA client * @cookie: client cookie to be used in callbacks * @irq_set_state: irq state change callback * @set_vga_decode: vga decode change callback * * return value: 0 on success, -1 on failure * Register a client with the VGA arbitration logic * * Clients have two callback mechanisms they can use. * irq enable/disable callback - * If a client can't disable its GPUs VGA resources, then we * need to be able to ask it to turn off its irqs when we * turn off its mem and io decoding. * set_vga_decode * If a client can disable its GPU VGA resource, it will * get a callback from this to set the encode/decode state |
deb2d2ecd PCI/GPU: implemen... |
208 209 210 211 212 213 |
* * Rationale: we cannot disable VGA decode resources unconditionally * some single GPU laptops seem to require ACPI or BIOS access to the * VGA registers to control things like backlights etc. * Hopefully newer multi-GPU laptops do something saner, and desktops * won't have any special ACPI for this. |
6ac3bd527 PCI/vgaarb: clean... |
214 215 |
* They driver will get a callback when VGA arbitration is first used * by userspace since we some older X servers have issues. |
deb2d2ecd PCI/GPU: implemen... |
216 |
*/ |
7c329288d vgaarb: make clie... |
217 |
#if defined(CONFIG_VGA_ARB) |
deb2d2ecd PCI/GPU: implemen... |
218 219 220 |
int vga_client_register(struct pci_dev *pdev, void *cookie, void (*irq_set_state)(void *cookie, bool state), unsigned int (*set_vga_decode)(void *cookie, bool state)); |
7c329288d vgaarb: make clie... |
221 222 223 224 225 226 227 228 |
#else static inline int vga_client_register(struct pci_dev *pdev, void *cookie, void (*irq_set_state)(void *cookie, bool state), unsigned int (*set_vga_decode)(void *cookie, bool state)) { return 0; } #endif |
deb2d2ecd PCI/GPU: implemen... |
229 230 |
#endif /* LINUX_VGA_H */ |