2 * vga_switcheroo.h - Support for laptop with dual GPU using one set of outputs
4 * Copyright (c) 2010 Red Hat Inc.
5 * Author : Dave Airlie <airlied@redhat.com>
7 * Copyright (c) 2015 Lukas Wunner <lukas@wunner.de>
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:
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
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
31 #ifndef _LINUX_VGA_SWITCHEROO_H_
32 #define _LINUX_VGA_SWITCHEROO_H_
39 * enum vga_switcheroo_state - client power state
40 * @VGA_SWITCHEROO_OFF: off
41 * @VGA_SWITCHEROO_ON: on
42 * @VGA_SWITCHEROO_INIT: client has registered with vga_switcheroo but
43 * vga_switcheroo is not enabled, i.e. no second client or no handler
44 * has registered. Only used in vga_switcheroo_get_client_state() which
45 * in turn is only called from hda_intel.c
46 * @VGA_SWITCHEROO_NOT_FOUND: client has not registered with vga_switcheroo.
47 * Only used in vga_switcheroo_get_client_state() which in turn is only
48 * called from hda_intel.c
52 enum vga_switcheroo_state {
55 /* below are referred only from vga_switcheroo_get_client_state() */
57 VGA_SWITCHEROO_NOT_FOUND,
61 * enum vga_switcheroo_client_id - client identifier
62 * @VGA_SWITCHEROO_IGD: integrated graphics device
63 * @VGA_SWITCHEROO_DIS: discrete graphics device
64 * @VGA_SWITCHEROO_MAX_CLIENTS: currently no more than two GPUs are supported
66 * Client identifier. Audio clients use the same identifier & 0x100.
68 enum vga_switcheroo_client_id {
71 VGA_SWITCHEROO_MAX_CLIENTS,
75 * struct vga_switcheroo_handler - handler callbacks
76 * @init: initialize handler.
77 * Optional. This gets called when vga_switcheroo is enabled, i.e. when
78 * two vga clients have registered. It allows the handler to perform
79 * some delayed initialization that depends on the existence of the
80 * vga clients. Currently only the radeon and amdgpu drivers use this.
81 * The return value is ignored
82 * @switchto: switch outputs to given client.
83 * Mandatory. For muxless machines this should be a no-op. Returning 0
84 * denotes success, anything else failure (in which case the switch is
86 * @power_state: cut or reinstate power of given client.
87 * Optional. The return value is ignored
88 * @get_client_id: determine if given pci device is integrated or discrete GPU.
91 * Handler callbacks. The multiplexer itself. The @switchto and @get_client_id
92 * methods are mandatory, all others may be set to NULL.
94 struct vga_switcheroo_handler {
96 int (*switchto)(enum vga_switcheroo_client_id id);
97 int (*power_state)(enum vga_switcheroo_client_id id,
98 enum vga_switcheroo_state state);
99 int (*get_client_id)(struct pci_dev *pdev);
103 * struct vga_switcheroo_client_ops - client callbacks
104 * @set_gpu_state: do the equivalent of suspend/resume for the card.
105 * Mandatory. This should not cut power to the discrete GPU,
106 * which is the job of the handler
107 * @reprobe: poll outputs.
108 * Optional. This gets called after waking the GPU and switching
110 * @can_switch: check if the device is in a position to switch now.
111 * Mandatory. The client should return false if a user space process
112 * has one of its device files open
114 * Client callbacks. A client can be either a GPU or an audio device on a GPU.
115 * The @set_gpu_state and @can_switch methods are mandatory, @reprobe may be
116 * set to NULL. For audio clients, the @reprobe member is bogus.
118 struct vga_switcheroo_client_ops {
119 void (*set_gpu_state)(struct pci_dev *dev, enum vga_switcheroo_state);
120 void (*reprobe)(struct pci_dev *dev);
121 bool (*can_switch)(struct pci_dev *dev);
124 #if defined(CONFIG_VGA_SWITCHEROO)
125 void vga_switcheroo_unregister_client(struct pci_dev *dev);
126 int vga_switcheroo_register_client(struct pci_dev *dev,
127 const struct vga_switcheroo_client_ops *ops,
128 bool driver_power_control);
129 int vga_switcheroo_register_audio_client(struct pci_dev *pdev,
130 const struct vga_switcheroo_client_ops *ops,
133 void vga_switcheroo_client_fb_set(struct pci_dev *dev,
134 struct fb_info *info);
136 int vga_switcheroo_register_handler(struct vga_switcheroo_handler *handler);
137 void vga_switcheroo_unregister_handler(void);
139 int vga_switcheroo_process_delayed_switch(void);
141 int vga_switcheroo_get_client_state(struct pci_dev *dev);
143 void vga_switcheroo_set_dynamic_switch(struct pci_dev *pdev, enum vga_switcheroo_state dynamic);
145 int vga_switcheroo_init_domain_pm_ops(struct device *dev, struct dev_pm_domain *domain);
146 void vga_switcheroo_fini_domain_pm_ops(struct device *dev);
147 int vga_switcheroo_init_domain_pm_optimus_hdmi_audio(struct device *dev, struct dev_pm_domain *domain);
150 static inline void vga_switcheroo_unregister_client(struct pci_dev *dev) {}
151 static inline int vga_switcheroo_register_client(struct pci_dev *dev,
152 const struct vga_switcheroo_client_ops *ops, bool driver_power_control) { return 0; }
153 static inline void vga_switcheroo_client_fb_set(struct pci_dev *dev, struct fb_info *info) {}
154 static inline int vga_switcheroo_register_handler(struct vga_switcheroo_handler *handler) { return 0; }
155 static inline int vga_switcheroo_register_audio_client(struct pci_dev *pdev,
156 const struct vga_switcheroo_client_ops *ops,
157 int id) { return 0; }
158 static inline void vga_switcheroo_unregister_handler(void) {}
159 static inline int vga_switcheroo_process_delayed_switch(void) { return 0; }
160 static inline int vga_switcheroo_get_client_state(struct pci_dev *dev) { return VGA_SWITCHEROO_ON; }
162 static inline void vga_switcheroo_set_dynamic_switch(struct pci_dev *pdev, enum vga_switcheroo_state dynamic) {}
164 static inline int vga_switcheroo_init_domain_pm_ops(struct device *dev, struct dev_pm_domain *domain) { return -EINVAL; }
165 static inline void vga_switcheroo_fini_domain_pm_ops(struct device *dev) {}
166 static inline int vga_switcheroo_init_domain_pm_optimus_hdmi_audio(struct device *dev, struct dev_pm_domain *domain) { return -EINVAL; }
169 #endif /* _LINUX_VGA_SWITCHEROO_H_ */