cregit-Linux how code gets into the kernel

Release 4.12 include/linux/vga_switcheroo.h

Directory: include/linux
/*
 * vga_switcheroo.h - Support for laptop with dual GPU using one set of outputs
 *
 * Copyright (c) 2010 Red Hat Inc.
 * Author : Dave Airlie <airlied@redhat.com>
 *
 * Copyright (c) 2015 Lukas Wunner <lukas@wunner.de>
 *
 * 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.
 *
 */

#ifndef _LINUX_VGA_SWITCHEROO_H_

#define _LINUX_VGA_SWITCHEROO_H_

#include <linux/fb.h>

struct pci_dev;

/**
 * enum vga_switcheroo_handler_flags_t - handler flags bitmask
 * @VGA_SWITCHEROO_CAN_SWITCH_DDC: whether the handler is able to switch the
 *      DDC lines separately. This signals to clients that they should call
 *      drm_get_edid_switcheroo() to probe the EDID
 * @VGA_SWITCHEROO_NEEDS_EDP_CONFIG: whether the handler is unable to switch
 *      the AUX channel separately. This signals to clients that the active
 *      GPU needs to train the link and communicate the link parameters to the
 *      inactive GPU (mediated by vga_switcheroo). The inactive GPU may then
 *      skip the AUX handshake and set up its output with these pre-calibrated
 *      values (DisplayPort specification v1.1a, section 2.5.3.3)
 *
 * Handler flags bitmask. Used by handlers to declare their capabilities upon
 * registering with vga_switcheroo.
 */

enum vga_switcheroo_handler_flags_t {
	
VGA_SWITCHEROO_CAN_SWITCH_DDC	= (1 << 0),
	
VGA_SWITCHEROO_NEEDS_EDP_CONFIG	= (1 << 1),
};

/**
 * enum vga_switcheroo_state - client power state
 * @VGA_SWITCHEROO_OFF: off
 * @VGA_SWITCHEROO_ON: on
 * @VGA_SWITCHEROO_NOT_FOUND: client has not registered with vga_switcheroo.
 *      Only used in vga_switcheroo_get_client_state() which in turn is only
 *      called from hda_intel.c
 *
 * Client power state.
 */

enum vga_switcheroo_state {
	
VGA_SWITCHEROO_OFF,
	
VGA_SWITCHEROO_ON,
	/* below are referred only from vga_switcheroo_get_client_state() */
	
VGA_SWITCHEROO_NOT_FOUND,
};

/**
 * enum vga_switcheroo_client_id - client identifier
 * @VGA_SWITCHEROO_UNKNOWN_ID: initial identifier assigned to vga clients.
 *      Determining the id requires the handler, so GPUs are given their
 *      true id in a delayed fashion in vga_switcheroo_enable()
 * @VGA_SWITCHEROO_IGD: integrated graphics device
 * @VGA_SWITCHEROO_DIS: discrete graphics device
 * @VGA_SWITCHEROO_MAX_CLIENTS: currently no more than two GPUs are supported
 *
 * Client identifier. Audio clients use the same identifier & 0x100.
 */

enum vga_switcheroo_client_id {
	
VGA_SWITCHEROO_UNKNOWN_ID = -1,
	
VGA_SWITCHEROO_IGD,
	
VGA_SWITCHEROO_DIS,
	
VGA_SWITCHEROO_MAX_CLIENTS,
};

/**
 * struct vga_switcheroo_handler - handler callbacks
 * @init: initialize handler.
 *      Optional. This gets called when vga_switcheroo is enabled, i.e. when
 *      two vga clients have registered. It allows the handler to perform
 *      some delayed initialization that depends on the existence of the
 *      vga clients. Currently only the radeon and amdgpu drivers use this.
 *      The return value is ignored
 * @switchto: switch outputs to given client.
 *      Mandatory. For muxless machines this should be a no-op. Returning 0
 *      denotes success, anything else failure (in which case the switch is
 *      aborted)
 * @switch_ddc: switch DDC lines to given client.
 *      Optional. Should return the previous DDC owner on success or a
 *      negative int on failure
 * @power_state: cut or reinstate power of given client.
 *      Optional. The return value is ignored
 * @get_client_id: determine if given pci device is integrated or discrete GPU.
 *      Mandatory
 *
 * Handler callbacks. The multiplexer itself. The @switchto and @get_client_id
 * methods are mandatory, all others may be set to NULL.
 */

struct vga_switcheroo_handler {
	
int (*init)(void);
	
int (*switchto)(enum vga_switcheroo_client_id id);
	
int (*switch_ddc)(enum vga_switcheroo_client_id id);
	
int (*power_state)(enum vga_switcheroo_client_id id,
			   enum vga_switcheroo_state state);
	
enum vga_switcheroo_client_id (*get_client_id)(struct pci_dev *pdev);
};

/**
 * struct vga_switcheroo_client_ops - client callbacks
 * @set_gpu_state: do the equivalent of suspend/resume for the card.
 *      Mandatory. This should not cut power to the discrete GPU,
 *      which is the job of the handler
 * @reprobe: poll outputs.
 *      Optional. This gets called after waking the GPU and switching
 *      the outputs to it
 * @can_switch: check if the device is in a position to switch now.
 *      Mandatory. The client should return false if a user space process
 *      has one of its device files open
 *
 * Client callbacks. A client can be either a GPU or an audio device on a GPU.
 * The @set_gpu_state and @can_switch methods are mandatory, @reprobe may be
 * set to NULL. For audio clients, the @reprobe member is bogus.
 */

struct vga_switcheroo_client_ops {
	
void (*set_gpu_state)(struct pci_dev *dev, enum vga_switcheroo_state);
	
void (*reprobe)(struct pci_dev *dev);
	
bool (*can_switch)(struct pci_dev *dev);
};

#if defined(CONFIG_VGA_SWITCHEROO)
void vga_switcheroo_unregister_client(struct pci_dev *dev);
int vga_switcheroo_register_client(struct pci_dev *dev,
				   const struct vga_switcheroo_client_ops *ops,
				   bool driver_power_control);
int vga_switcheroo_register_audio_client(struct pci_dev *pdev,
					 const struct vga_switcheroo_client_ops *ops,
					 enum vga_switcheroo_client_id id);

void vga_switcheroo_client_fb_set(struct pci_dev *dev,
				  struct fb_info *info);

int vga_switcheroo_register_handler(const struct vga_switcheroo_handler *handler,
				    enum vga_switcheroo_handler_flags_t handler_flags);
void vga_switcheroo_unregister_handler(void);
enum vga_switcheroo_handler_flags_t vga_switcheroo_handler_flags(void);
int vga_switcheroo_lock_ddc(struct pci_dev *pdev);
int vga_switcheroo_unlock_ddc(struct pci_dev *pdev);

int vga_switcheroo_process_delayed_switch(void);

bool vga_switcheroo_client_probe_defer(struct pci_dev *pdev);
enum vga_switcheroo_state vga_switcheroo_get_client_state(struct pci_dev *dev);

void vga_switcheroo_set_dynamic_switch(struct pci_dev *pdev, enum vga_switcheroo_state dynamic);

int vga_switcheroo_init_domain_pm_ops(struct device *dev, struct dev_pm_domain *domain);
void vga_switcheroo_fini_domain_pm_ops(struct device *dev);
int vga_switcheroo_init_domain_pm_optimus_hdmi_audio(struct device *dev, struct dev_pm_domain *domain);
#else


static inline void vga_switcheroo_unregister_client(struct pci_dev *dev) {}

Contributors

PersonTokensPropCommitsCommitProp
Dave Airlie11100.00%1100.00%
Total11100.00%1100.00%


static inline int vga_switcheroo_register_client(struct pci_dev *dev, const struct vga_switcheroo_client_ops *ops, bool driver_power_control) { return 0; }

Contributors

PersonTokensPropCommitsCommitProp
Dave Airlie2187.50%266.67%
Takashi Iwai312.50%133.33%
Total24100.00%3100.00%


static inline void vga_switcheroo_client_fb_set(struct pci_dev *dev, struct fb_info *info) {}

Contributors

PersonTokensPropCommitsCommitProp
Dave Airlie16100.00%1100.00%
Total16100.00%1100.00%


static inline int vga_switcheroo_register_handler(const struct vga_switcheroo_handler *handler, enum vga_switcheroo_handler_flags_t handler_flags) { return 0; }

Contributors

PersonTokensPropCommitsCommitProp
Dave Airlie1575.00%133.33%
Lukas Wunner525.00%266.67%
Total20100.00%3100.00%


static inline int vga_switcheroo_register_audio_client(struct pci_dev *pdev, const struct vga_switcheroo_client_ops *ops, enum vga_switcheroo_client_id id) { return 0; }

Contributors

PersonTokensPropCommitsCommitProp
Takashi Iwai2392.00%150.00%
Lukas Wunner28.00%150.00%
Total25100.00%2100.00%


static inline void vga_switcheroo_unregister_handler(void) {}

Contributors

PersonTokensPropCommitsCommitProp
Dave Airlie8100.00%1100.00%
Total8100.00%1100.00%


static inline enum vga_switcheroo_handler_flags_t vga_switcheroo_handler_flags(void) { return 0; }

Contributors

PersonTokensPropCommitsCommitProp
Lukas Wunner13100.00%1100.00%
Total13100.00%1100.00%


static inline int vga_switcheroo_lock_ddc(struct pci_dev *pdev) { return -ENODEV; }

Contributors

PersonTokensPropCommitsCommitProp
Lukas Wunner16100.00%1100.00%
Total16100.00%1100.00%


static inline int vga_switcheroo_unlock_ddc(struct pci_dev *pdev) { return -ENODEV; }

Contributors

PersonTokensPropCommitsCommitProp
Lukas Wunner16100.00%1100.00%
Total16100.00%1100.00%


static inline int vga_switcheroo_process_delayed_switch(void) { return 0; }

Contributors

PersonTokensPropCommitsCommitProp
Dave Airlie12100.00%1100.00%
Total12100.00%1100.00%


static inline bool vga_switcheroo_client_probe_defer(struct pci_dev *pdev) { return false; }

Contributors

PersonTokensPropCommitsCommitProp
Lukas Wunner15100.00%1100.00%
Total15100.00%1100.00%


static inline enum vga_switcheroo_state vga_switcheroo_get_client_state(struct pci_dev *dev) { return VGA_SWITCHEROO_ON; }

Contributors

PersonTokensPropCommitsCommitProp
Takashi Iwai1487.50%266.67%
Lukas Wunner212.50%133.33%
Total16100.00%3100.00%


static inline void vga_switcheroo_set_dynamic_switch(struct pci_dev *pdev, enum vga_switcheroo_state dynamic) {}

Contributors

PersonTokensPropCommitsCommitProp
Dave Airlie15100.00%1100.00%
Total15100.00%1100.00%


static inline int vga_switcheroo_init_domain_pm_ops(struct device *dev, struct dev_pm_domain *domain) { return -EINVAL; }

Contributors

PersonTokensPropCommitsCommitProp
Dave Airlie21100.00%1100.00%
Total21100.00%1100.00%


static inline void vga_switcheroo_fini_domain_pm_ops(struct device *dev) {}

Contributors

PersonTokensPropCommitsCommitProp
Alex Deucher11100.00%1100.00%
Total11100.00%1100.00%


static inline int vga_switcheroo_init_domain_pm_optimus_hdmi_audio(struct device *dev, struct dev_pm_domain *domain) { return -EINVAL; }

Contributors

PersonTokensPropCommitsCommitProp
Dave Airlie21100.00%1100.00%
Total21100.00%1100.00%

#endif #endif /* _LINUX_VGA_SWITCHEROO_H_ */

Overall Contributors

PersonTokensPropCommitsCommitProp
Dave Airlie32451.84%315.79%
Lukas Wunner16526.40%947.37%
Takashi Iwai10416.64%421.05%
Alex Deucher203.20%15.26%
Ozan Çağlayan91.44%15.26%
Randy Dunlap30.48%15.26%
Total625100.00%19100.00%
Directory: include/linux
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.
Created with cregit.