drm/i915/mtl: Define GSC Proxy component interface

GSC Proxy component is used for communication between the
Intel graphics driver and MEI driver.

Cc: Alan Previn <alan.previn.teres.alexis@intel.com>
Signed-off-by: Alexander Usyskin <alexander.usyskin@intel.com>
Signed-off-by: Tomas Winkler <tomas.winkler@intel.com>
Signed-off-by: Daniele Ceraolo Spurio <daniele.ceraolospurio@intel.com>
Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Reviewed-by: Alan Previn <alan.previn.teres.alexis@intel.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20230502163854.317653-2-daniele.ceraolospurio@intel.com

diff --git a/include/drm/i915_component.h b/include/drm/i915_component.h
index c1e2a43d2d1e4317dfc9d86a3b0c5019d4d727c3..56a84ee1c64c635a83ab5a3fed0bc809872151cd 100644 (file)
--- a/include/drm/i915_component.h
+++ b/include/drm/i915_component.h
@@ -29,7 +29,8 @@
 enum i915_component_type {
        I915_COMPONENT_AUDIO = 1,
        I915_COMPONENT_HDCP,
-       I915_COMPONENT_PXP
+       I915_COMPONENT_PXP,
+       I915_COMPONENT_GSC_PROXY,
 };
 
 /* MAX_PORT is the number of port

diff --git a/include/drm/i915_gsc_proxy_mei_interface.h b/include/drm/i915_gsc_proxy_mei_interface.h
new file mode 100644 (file)
index 0000000..9462341
--- /dev/null
+++ b/include/drm/i915_gsc_proxy_mei_interface.h
@@ -0,0 +1,53 @@
+/* SPDX-License-Identifier: MIT */
+/*
+ * Copyright (c) 2022-2023 Intel Corporation
+ */
+
+#ifndef _I915_GSC_PROXY_MEI_INTERFACE_H_
+#define _I915_GSC_PROXY_MEI_INTERFACE_H_
+
+#include <linux/types.h>
+
+struct device;
+struct module;
+
+/**
+ * struct i915_gsc_proxy_component_ops - ops for GSC Proxy services.
+ * @owner: Module providing the ops
+ * @send: sends a proxy message from GSC FW to ME FW
+ * @recv: receives a proxy message for GSC FW from ME FW
+ */
+struct i915_gsc_proxy_component_ops {
+       struct module *owner;
+
+       /**
+        * send - Sends a proxy message to ME FW.
+        * @dev: device struct corresponding to the mei device
+        * @buf: message buffer to send
+        * @size: size of the message
+        * Return: bytes sent on success, negative errno value on failure
+        */
+       int (*send)(struct device *dev, const void *buf, size_t size);
+
+       /**
+        * recv - Receives a proxy message from ME FW.
+        * @dev: device struct corresponding to the mei device
+        * @buf: message buffer to contain the received message
+        * @size: size of the buffer
+        * Return: bytes received on success, negative errno value on failure
+        */
+       int (*recv)(struct device *dev, void *buf, size_t size);
+};
+
+/**
+ * struct i915_gsc_proxy_component - Used for communication between i915 and
+ * MEI drivers for GSC proxy services
+ * @mei_dev: device that provide the GSC proxy service.
+ * @ops: Ops implemented by GSC proxy driver, used by i915 driver.
+ */
+struct i915_gsc_proxy_component {
+       struct device *mei_dev;
+       const struct i915_gsc_proxy_component_ops *ops;
+};
+
+#endif /* _I915_GSC_PROXY_MEI_INTERFACE_H_ */