1/*
  2 * Copyright(c) 2011-2016 Intel Corporation. All rights reserved.
  3 *
  4 * Permission is hereby granted, free of charge, to any person obtaining a
  5 * copy of this software and associated documentation files (the "Software"),
  6 * to deal in the Software without restriction, including without limitation
  7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  8 * and/or sell copies of the Software, and to permit persons to whom the
  9 * Software is furnished to do so, subject to the following conditions:
 10 *
 11 * The above copyright notice and this permission notice (including the next
 12 * paragraph) shall be included in all copies or substantial portions of the
 13 * Software.
 14 *
 15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 21 * SOFTWARE.
 22 */
 23
 24#include "i915_drv.h"
 25#include "intel_gvt.h"
 26
 27/**
 28 * DOC: Intel GVT-g host support
 29 *
 30 * Intel GVT-g is a graphics virtualization technology which shares the
 31 * GPU among multiple virtual machines on a time-sharing basis. Each
 32 * virtual machine is presented a virtual GPU (vGPU), which has equivalent
 33 * features as the underlying physical GPU (pGPU), so i915 driver can run
 34 * seamlessly in a virtual machine.
 35 *
 36 * To virtualize GPU resources GVT-g driver depends on hypervisor technology
 37 * e.g KVM/VFIO/mdev, Xen, etc. to provide resource access trapping capability
 38 * and be virtualized within GVT-g device module. More architectural design
 39 * doc is available on https://01.org/group/2230/documentation-list.
 40 */
 41
 42static bool is_supported_device(struct drm_i915_private *dev_priv)
 43{
 44	if (IS_BROADWELL(dev_priv))
 45		return true;
 46	if (IS_SKYLAKE(dev_priv))
 47		return true;
 48	if (IS_KABYLAKE(dev_priv))
 49		return true;
 50	return false;
 51}
 52
 53/**
 54 * intel_gvt_sanitize_options - sanitize GVT related options
 55 * @dev_priv: drm i915 private data
 56 *
 57 * This function is called at the i915 options sanitize stage.
 58 */
 59void intel_gvt_sanitize_options(struct drm_i915_private *dev_priv)
 60{
 61	if (!i915_modparams.enable_gvt)
 62		return;
 63
 64	if (intel_vgpu_active(dev_priv)) {
 65		DRM_INFO("GVT-g is disabled for guest\n");
 66		goto bail;
 67	}
 68
 69	if (!is_supported_device(dev_priv)) {
 70		DRM_INFO("Unsupported device. GVT-g is disabled\n");
 71		goto bail;
 72	}
 73
 74	return;
 75bail:
 76	i915_modparams.enable_gvt = 0;
 77}
 78
 79/**
 80 * intel_gvt_init - initialize GVT components
 81 * @dev_priv: drm i915 private data
 82 *
 83 * This function is called at the initialization stage to create a GVT device.
 84 *
 85 * Returns:
 86 * Zero on success, negative error code if failed.
 87 *
 88 */
 89int intel_gvt_init(struct drm_i915_private *dev_priv)
 90{
 91	int ret;
 92
 93	if (!i915_modparams.enable_gvt) {
 94		DRM_DEBUG_DRIVER("GVT-g is disabled by kernel params\n");
 95		return 0;
 96	}
 97
 98	if (USES_GUC_SUBMISSION(dev_priv)) {
 99		DRM_ERROR("i915 GVT-g loading failed due to Graphics virtualization is not yet supported with GuC submission\n");
100		return -EIO;
101	}
102
103	/*
104	 * We're not in host or fail to find a MPT module, disable GVT-g
105	 */
106	ret = intel_gvt_init_host();
107	if (ret) {
108		DRM_DEBUG_DRIVER("Not in host or MPT modules not found\n");
109		goto bail;
110	}
111
112	ret = intel_gvt_init_device(dev_priv);
113	if (ret) {
114		DRM_DEBUG_DRIVER("Fail to init GVT device\n");
115		goto bail;
116	}
117
118	return 0;
119
120bail:
121	i915_modparams.enable_gvt = 0;
122	return 0;
123}
124
125/**
126 * intel_gvt_cleanup - cleanup GVT components when i915 driver is unloading
127 * @dev_priv: drm i915 private *
128 *
129 * This function is called at the i915 driver unloading stage, to shutdown
130 * GVT components and release the related resources.
131 */
132void intel_gvt_cleanup(struct drm_i915_private *dev_priv)
133{
134	if (!intel_gvt_active(dev_priv))
135		return;
136
137	intel_gvt_clean_device(dev_priv);
138}