Commit | Line | Data |
---|---|---|
6a9ee8af | 1 | /* |
a645654b LW |
2 | * vga_switcheroo.h - Support for laptop with dual GPU using one set of outputs |
3 | * | |
6a9ee8af DA |
4 | * Copyright (c) 2010 Red Hat Inc. |
5 | * Author : Dave Airlie <airlied@redhat.com> | |
6 | * | |
a645654b LW |
7 | * Copyright (c) 2015 Lukas Wunner <lukas@wunner.de> |
8 | * | |
9 | * Permission is hereby granted, free of charge, to any person obtaining a | |
10 | * copy of this software and associated documentation files (the "Software"), | |
11 | * to deal in the Software without restriction, including without limitation | |
12 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, | |
13 | * and/or sell copies of the Software, and to permit persons to whom the | |
14 | * Software is furnished to do so, subject to the following conditions: | |
15 | * | |
16 | * The above copyright notice and this permission notice (including the next | |
17 | * paragraph) shall be included in all copies or substantial portions of the | |
18 | * Software. | |
19 | * | |
20 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
21 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
22 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL | |
23 | * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
24 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING | |
25 | * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER | |
26 | * DEALINGS | |
27 | * IN THE SOFTWARE. | |
6a9ee8af | 28 | * |
6a9ee8af DA |
29 | */ |
30 | ||
d3decf3a OÇ |
31 | #ifndef _LINUX_VGA_SWITCHEROO_H_ |
32 | #define _LINUX_VGA_SWITCHEROO_H_ | |
33 | ||
6a9ee8af DA |
34 | #include <linux/fb.h> |
35 | ||
f8fee8f5 RD |
36 | struct pci_dev; |
37 | ||
a645654b LW |
38 | /** |
39 | * enum vga_switcheroo_state - client power state | |
40 | * @VGA_SWITCHEROO_OFF: off | |
41 | * @VGA_SWITCHEROO_ON: on | |
a645654b LW |
42 | * @VGA_SWITCHEROO_NOT_FOUND: client has not registered with vga_switcheroo. |
43 | * Only used in vga_switcheroo_get_client_state() which in turn is only | |
44 | * called from hda_intel.c | |
45 | * | |
46 | * Client power state. | |
47 | */ | |
6a9ee8af DA |
48 | enum vga_switcheroo_state { |
49 | VGA_SWITCHEROO_OFF, | |
50 | VGA_SWITCHEROO_ON, | |
c8e9cf7b | 51 | /* below are referred only from vga_switcheroo_get_client_state() */ |
c8e9cf7b | 52 | VGA_SWITCHEROO_NOT_FOUND, |
6a9ee8af DA |
53 | }; |
54 | ||
a645654b LW |
55 | /** |
56 | * enum vga_switcheroo_client_id - client identifier | |
21c5ba8c LW |
57 | * @VGA_SWITCHEROO_UNKNOWN_ID: initial identifier assigned to vga clients. |
58 | * Determining the id requires the handler, so GPUs are given their | |
59 | * true id in a delayed fashion in vga_switcheroo_enable() | |
a645654b LW |
60 | * @VGA_SWITCHEROO_IGD: integrated graphics device |
61 | * @VGA_SWITCHEROO_DIS: discrete graphics device | |
62 | * @VGA_SWITCHEROO_MAX_CLIENTS: currently no more than two GPUs are supported | |
63 | * | |
64 | * Client identifier. Audio clients use the same identifier & 0x100. | |
65 | */ | |
6a9ee8af | 66 | enum vga_switcheroo_client_id { |
21c5ba8c | 67 | VGA_SWITCHEROO_UNKNOWN_ID = -1, |
6a9ee8af DA |
68 | VGA_SWITCHEROO_IGD, |
69 | VGA_SWITCHEROO_DIS, | |
70 | VGA_SWITCHEROO_MAX_CLIENTS, | |
71 | }; | |
72 | ||
a645654b LW |
73 | /** |
74 | * struct vga_switcheroo_handler - handler callbacks | |
75 | * @init: initialize handler. | |
76 | * Optional. This gets called when vga_switcheroo is enabled, i.e. when | |
77 | * two vga clients have registered. It allows the handler to perform | |
78 | * some delayed initialization that depends on the existence of the | |
79 | * vga clients. Currently only the radeon and amdgpu drivers use this. | |
80 | * The return value is ignored | |
81 | * @switchto: switch outputs to given client. | |
82 | * Mandatory. For muxless machines this should be a no-op. Returning 0 | |
83 | * denotes success, anything else failure (in which case the switch is | |
84 | * aborted) | |
85 | * @power_state: cut or reinstate power of given client. | |
86 | * Optional. The return value is ignored | |
87 | * @get_client_id: determine if given pci device is integrated or discrete GPU. | |
88 | * Mandatory | |
89 | * | |
90 | * Handler callbacks. The multiplexer itself. The @switchto and @get_client_id | |
91 | * methods are mandatory, all others may be set to NULL. | |
92 | */ | |
6a9ee8af | 93 | struct vga_switcheroo_handler { |
a645654b | 94 | int (*init)(void); |
6a9ee8af DA |
95 | int (*switchto)(enum vga_switcheroo_client_id id); |
96 | int (*power_state)(enum vga_switcheroo_client_id id, | |
97 | enum vga_switcheroo_state state); | |
fa3e967f | 98 | enum vga_switcheroo_client_id (*get_client_id)(struct pci_dev *pdev); |
6a9ee8af DA |
99 | }; |
100 | ||
a645654b LW |
101 | /** |
102 | * struct vga_switcheroo_client_ops - client callbacks | |
103 | * @set_gpu_state: do the equivalent of suspend/resume for the card. | |
104 | * Mandatory. This should not cut power to the discrete GPU, | |
105 | * which is the job of the handler | |
106 | * @reprobe: poll outputs. | |
107 | * Optional. This gets called after waking the GPU and switching | |
108 | * the outputs to it | |
109 | * @can_switch: check if the device is in a position to switch now. | |
110 | * Mandatory. The client should return false if a user space process | |
111 | * has one of its device files open | |
112 | * | |
113 | * Client callbacks. A client can be either a GPU or an audio device on a GPU. | |
114 | * The @set_gpu_state and @can_switch methods are mandatory, @reprobe may be | |
115 | * set to NULL. For audio clients, the @reprobe member is bogus. | |
116 | */ | |
26ec685f TI |
117 | struct vga_switcheroo_client_ops { |
118 | void (*set_gpu_state)(struct pci_dev *dev, enum vga_switcheroo_state); | |
119 | void (*reprobe)(struct pci_dev *dev); | |
120 | bool (*can_switch)(struct pci_dev *dev); | |
121 | }; | |
6a9ee8af DA |
122 | |
123 | #if defined(CONFIG_VGA_SWITCHEROO) | |
124 | void vga_switcheroo_unregister_client(struct pci_dev *dev); | |
125 | int vga_switcheroo_register_client(struct pci_dev *dev, | |
0d69704a DA |
126 | const struct vga_switcheroo_client_ops *ops, |
127 | bool driver_power_control); | |
3e9e63db TI |
128 | int vga_switcheroo_register_audio_client(struct pci_dev *pdev, |
129 | const struct vga_switcheroo_client_ops *ops, | |
fa3e967f | 130 | enum vga_switcheroo_client_id id); |
6a9ee8af DA |
131 | |
132 | void vga_switcheroo_client_fb_set(struct pci_dev *dev, | |
133 | struct fb_info *info); | |
134 | ||
5d170139 | 135 | int vga_switcheroo_register_handler(const struct vga_switcheroo_handler *handler); |
6a9ee8af DA |
136 | void vga_switcheroo_unregister_handler(void); |
137 | ||
138 | int vga_switcheroo_process_delayed_switch(void); | |
139 | ||
203d027d | 140 | enum vga_switcheroo_state vga_switcheroo_get_client_state(struct pci_dev *dev); |
c8e9cf7b | 141 | |
0d69704a DA |
142 | void vga_switcheroo_set_dynamic_switch(struct pci_dev *pdev, enum vga_switcheroo_state dynamic); |
143 | ||
144 | int vga_switcheroo_init_domain_pm_ops(struct device *dev, struct dev_pm_domain *domain); | |
766a53d0 | 145 | void vga_switcheroo_fini_domain_pm_ops(struct device *dev); |
0d69704a | 146 | int vga_switcheroo_init_domain_pm_optimus_hdmi_audio(struct device *dev, struct dev_pm_domain *domain); |
6a9ee8af DA |
147 | #else |
148 | ||
149 | static inline void vga_switcheroo_unregister_client(struct pci_dev *dev) {} | |
150 | static inline int vga_switcheroo_register_client(struct pci_dev *dev, | |
0d69704a | 151 | const struct vga_switcheroo_client_ops *ops, bool driver_power_control) { return 0; } |
6a9ee8af | 152 | static inline void vga_switcheroo_client_fb_set(struct pci_dev *dev, struct fb_info *info) {} |
5d170139 | 153 | static inline int vga_switcheroo_register_handler(const struct vga_switcheroo_handler *handler) { return 0; } |
3e9e63db TI |
154 | static inline int vga_switcheroo_register_audio_client(struct pci_dev *pdev, |
155 | const struct vga_switcheroo_client_ops *ops, | |
fa3e967f | 156 | enum vga_switcheroo_client_id id) { return 0; } |
6a9ee8af DA |
157 | static inline void vga_switcheroo_unregister_handler(void) {} |
158 | static inline int vga_switcheroo_process_delayed_switch(void) { return 0; } | |
203d027d | 159 | static inline enum vga_switcheroo_state vga_switcheroo_get_client_state(struct pci_dev *dev) { return VGA_SWITCHEROO_ON; } |
c8e9cf7b | 160 | |
0d69704a DA |
161 | static inline void vga_switcheroo_set_dynamic_switch(struct pci_dev *pdev, enum vga_switcheroo_state dynamic) {} |
162 | ||
163 | static inline int vga_switcheroo_init_domain_pm_ops(struct device *dev, struct dev_pm_domain *domain) { return -EINVAL; } | |
766a53d0 | 164 | static inline void vga_switcheroo_fini_domain_pm_ops(struct device *dev) {} |
0d69704a | 165 | static inline int vga_switcheroo_init_domain_pm_optimus_hdmi_audio(struct device *dev, struct dev_pm_domain *domain) { return -EINVAL; } |
6a9ee8af DA |
166 | |
167 | #endif | |
d3decf3a | 168 | #endif /* _LINUX_VGA_SWITCHEROO_H_ */ |