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_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
48 enum vga_switcheroo_state {
51 /* below are referred only from vga_switcheroo_get_client_state() */
52 VGA_SWITCHEROO_NOT_FOUND,
56 * enum vga_switcheroo_client_id - client identifier
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()
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
64 * Client identifier. Audio clients use the same identifier & 0x100.
66 enum vga_switcheroo_client_id {
67 VGA_SWITCHEROO_UNKNOWN_ID = -1,
70 VGA_SWITCHEROO_MAX_CLIENTS,
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
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.
90 * Handler callbacks. The multiplexer itself. The @switchto and @get_client_id
91 * methods are mandatory, all others may be set to NULL.
93 struct vga_switcheroo_handler {
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);
98 enum vga_switcheroo_client_id (*get_client_id)(struct pci_dev *pdev);
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
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
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.
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);
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,
126 const struct vga_switcheroo_client_ops *ops,
127 bool driver_power_control);
128 int vga_switcheroo_register_audio_client(struct pci_dev *pdev,
129 const struct vga_switcheroo_client_ops *ops,
130 enum vga_switcheroo_client_id id);
132 void vga_switcheroo_client_fb_set(struct pci_dev *dev,
133 struct fb_info *info);
135 int vga_switcheroo_register_handler(const struct vga_switcheroo_handler *handler);
136 void vga_switcheroo_unregister_handler(void);
138 int vga_switcheroo_process_delayed_switch(void);
140 enum vga_switcheroo_state vga_switcheroo_get_client_state(struct pci_dev *dev);
142 void vga_switcheroo_set_dynamic_switch(struct pci_dev *pdev, enum vga_switcheroo_state dynamic);
144 int vga_switcheroo_init_domain_pm_ops(struct device *dev, struct dev_pm_domain *domain);
145 void vga_switcheroo_fini_domain_pm_ops(struct device *dev);
146 int vga_switcheroo_init_domain_pm_optimus_hdmi_audio(struct device *dev, struct dev_pm_domain *domain);
149 static inline void vga_switcheroo_unregister_client(struct pci_dev *dev) {}
150 static inline int vga_switcheroo_register_client(struct pci_dev *dev,
151 const struct vga_switcheroo_client_ops *ops, bool driver_power_control) { return 0; }
152 static inline void vga_switcheroo_client_fb_set(struct pci_dev *dev, struct fb_info *info) {}
153 static inline int vga_switcheroo_register_handler(const struct vga_switcheroo_handler *handler) { return 0; }
154 static inline int vga_switcheroo_register_audio_client(struct pci_dev *pdev,
155 const struct vga_switcheroo_client_ops *ops,
156 enum vga_switcheroo_client_id id) { return 0; }
157 static inline void vga_switcheroo_unregister_handler(void) {}
158 static inline int vga_switcheroo_process_delayed_switch(void) { return 0; }
159 static inline enum vga_switcheroo_state vga_switcheroo_get_client_state(struct pci_dev *dev) { return VGA_SWITCHEROO_ON; }
161 static inline void vga_switcheroo_set_dynamic_switch(struct pci_dev *pdev, enum vga_switcheroo_state dynamic) {}
163 static inline int vga_switcheroo_init_domain_pm_ops(struct device *dev, struct dev_pm_domain *domain) { return -EINVAL; }
164 static inline void vga_switcheroo_fini_domain_pm_ops(struct device *dev) {}
165 static inline int vga_switcheroo_init_domain_pm_optimus_hdmi_audio(struct device *dev, struct dev_pm_domain *domain) { return -EINVAL; }
168 #endif /* _LINUX_VGA_SWITCHEROO_H_ */