1 | /* SPDX-License-Identifier: MIT */ |
2 | |
3 | /* |
4 | * The VGA aribiter manages VGA space routing and VGA resource decode to |
5 | * allow multiple VGA devices to be used in a system in a safe way. |
6 | * |
7 | * (C) Copyright 2005 Benjamin Herrenschmidt <benh@kernel.crashing.org> |
8 | * (C) Copyright 2007 Paulo R. Zanoni <przanoni@gmail.com> |
9 | * (C) Copyright 2007, 2009 Tiago Vignatti <vignatti@freedesktop.org> |
10 | */ |
11 | |
12 | #ifndef LINUX_VGA_H |
13 | #define LINUX_VGA_H |
14 | |
15 | #include <video/vga.h> |
16 | |
17 | struct pci_dev; |
18 | |
19 | /* Legacy VGA regions */ |
20 | #define VGA_RSRC_NONE 0x00 |
21 | #define VGA_RSRC_LEGACY_IO 0x01 |
22 | #define VGA_RSRC_LEGACY_MEM 0x02 |
23 | #define VGA_RSRC_LEGACY_MASK (VGA_RSRC_LEGACY_IO | VGA_RSRC_LEGACY_MEM) |
24 | /* Non-legacy access */ |
25 | #define VGA_RSRC_NORMAL_IO 0x04 |
26 | #define VGA_RSRC_NORMAL_MEM 0x08 |
27 | |
28 | #ifdef CONFIG_VGA_ARB |
29 | void vga_set_legacy_decoding(struct pci_dev *pdev, unsigned int decodes); |
30 | int vga_get(struct pci_dev *pdev, unsigned int rsrc, int interruptible); |
31 | void vga_put(struct pci_dev *pdev, unsigned int rsrc); |
32 | struct pci_dev *vga_default_device(void); |
33 | void vga_set_default_device(struct pci_dev *pdev); |
34 | int vga_remove_vgacon(struct pci_dev *pdev); |
35 | int vga_client_register(struct pci_dev *pdev, |
36 | unsigned int (*set_decode)(struct pci_dev *pdev, bool state)); |
37 | #else /* CONFIG_VGA_ARB */ |
38 | static inline void vga_set_legacy_decoding(struct pci_dev *pdev, |
39 | unsigned int decodes) |
40 | { |
41 | }; |
42 | static inline int vga_get(struct pci_dev *pdev, unsigned int rsrc, |
43 | int interruptible) |
44 | { |
45 | return 0; |
46 | } |
47 | static inline void vga_put(struct pci_dev *pdev, unsigned int rsrc) |
48 | { |
49 | } |
50 | static inline struct pci_dev *vga_default_device(void) |
51 | { |
52 | return NULL; |
53 | } |
54 | static inline void vga_set_default_device(struct pci_dev *pdev) |
55 | { |
56 | } |
57 | static inline int vga_remove_vgacon(struct pci_dev *pdev) |
58 | { |
59 | return 0; |
60 | } |
61 | static inline int vga_client_register(struct pci_dev *pdev, |
62 | unsigned int (*set_decode)(struct pci_dev *pdev, bool state)) |
63 | { |
64 | return 0; |
65 | } |
66 | #endif /* CONFIG_VGA_ARB */ |
67 | |
68 | /** |
69 | * vga_get_interruptible |
70 | * @pdev: pci device of the VGA card or NULL for the system default |
71 | * @rsrc: bit mask of resources to acquire and lock |
72 | * |
73 | * Shortcut to vga_get with interruptible set to true. |
74 | * |
75 | * On success, release the VGA resource again with vga_put(). |
76 | */ |
77 | static inline int vga_get_interruptible(struct pci_dev *pdev, |
78 | unsigned int rsrc) |
79 | { |
80 | return vga_get(pdev, rsrc, interruptible: 1); |
81 | } |
82 | |
83 | /** |
84 | * vga_get_uninterruptible - shortcut to vga_get() |
85 | * @pdev: pci device of the VGA card or NULL for the system default |
86 | * @rsrc: bit mask of resources to acquire and lock |
87 | * |
88 | * Shortcut to vga_get with interruptible set to false. |
89 | * |
90 | * On success, release the VGA resource again with vga_put(). |
91 | */ |
92 | static inline int vga_get_uninterruptible(struct pci_dev *pdev, |
93 | unsigned int rsrc) |
94 | { |
95 | return vga_get(pdev, rsrc, interruptible: 0); |
96 | } |
97 | |
98 | static inline void vga_client_unregister(struct pci_dev *pdev) |
99 | { |
100 | vga_client_register(pdev, NULL); |
101 | } |
102 | |
103 | #endif /* LINUX_VGA_H */ |
104 | |