Commit 811fe9f5 authored by Michal Wajdeczko's avatar Michal Wajdeczko
Browse files

drm/xe/guc: Introduce Relay Communication for SR-IOV 



There are scenarios where SR-IOV Virtual Function (VF) driver will
need to get additional data that is not available over VF MMIO BAR
nor could be queried from the GuC firmware and must be obtained
from the Physical Function (PF) driver.

To allow such communication between VF and PF drivers, GuC supports
set of H2G and G2H actions which allows relaying embedded messages,
that are otherwise opaque for the GuC.

To allow use of this communication mechanism, provide functions for
sending requests and handling replies and placeholder where we will
put handlers for incoming requests.

Reviewed-by: default avatarPiotr Piórkowski <piotr.piorkowski@intel.com>
Link: https://lore.kernel.org/r/20240104222031.277-8-michal.wajdeczko@intel.com


Signed-off-by: default avatarMichal Wajdeczko <michal.wajdeczko@intel.com>
parent fa6c12e0

drivers/gpu/drm/xe/Makefile

+1 −0
Original line number Diff line number Diff line
@@ -148,6 +148,7 @@ xe-$(CONFIG_HWMON) += xe_hwmon.o 


# graphics virtualization (SR-IOV) support

xe-y += \

	xe_guc_relay.o \

	xe_memirq.o \

	xe_sriov.o

drivers/gpu/drm/xe/xe_guc.c

+5 −0
Original line number Diff line number Diff line
@@ -21,6 +21,7 @@ 
#include "xe_guc_hwconfig.h"

#include "xe_guc_log.h"

#include "xe_guc_pc.h"

#include "xe_guc_relay.h"

#include "xe_guc_submit.h"

#include "xe_memirq.h"

#include "xe_mmio.h"
@@ -263,6 +264,10 @@ int xe_guc_init(struct xe_guc *guc) 
	if (ret)

		goto out;



	ret = xe_guc_relay_init(&guc->relay);

	if (ret)

		goto out;



	ret = xe_guc_pc_init(&guc->pc);

	if (ret)

		goto out;

drivers/gpu/drm/xe/xe_guc_relay.c

0 → 100644
+925 −0

File added.

Preview size limit exceeded, changes collapsed.

drivers/gpu/drm/xe/xe_guc_relay.h

0 → 100644
+37 −0
Original line number Diff line number Diff line 
/* SPDX-License-Identifier: MIT */

/*

 * Copyright © 2023 Intel Corporation

 */



#ifndef _XE_GUC_RELAY_H_

#define _XE_GUC_RELAY_H_



#include <linux/types.h>

#include <linux/errno.h>



struct xe_guc_relay;



int xe_guc_relay_init(struct xe_guc_relay *relay);



int xe_guc_relay_send_to_pf(struct xe_guc_relay *relay,

			    const u32 *msg, u32 len, u32 *buf, u32 buf_size);



int xe_guc_relay_process_guc2vf(struct xe_guc_relay *relay, const u32 *msg, u32 len);



#ifdef CONFIG_PCI_IOV

int xe_guc_relay_send_to_vf(struct xe_guc_relay *relay, u32 target,

			    const u32 *msg, u32 len, u32 *buf, u32 buf_size);

int xe_guc_relay_process_guc2pf(struct xe_guc_relay *relay, const u32 *msg, u32 len);

#else

static inline int xe_guc_relay_send_to_vf(struct xe_guc_relay *relay, u32 target,

					  const u32 *msg, u32 len, u32 *buf, u32 buf_size)

{

	return -ENODEV;

}

static inline int xe_guc_relay_process_guc2pf(struct xe_guc_relay *relay, const u32 *msg, u32 len)

{

	return -ENODEV;

}

#endif



#endif

drivers/gpu/drm/xe/xe_guc_relay_types.h

0 → 100644
+36 −0
Original line number Diff line number Diff line 
/* SPDX-License-Identifier: MIT */

/*

 * Copyright © 2023 Intel Corporation

 */



#ifndef _XE_GUC_RELAY_TYPES_H_

#define _XE_GUC_RELAY_TYPES_H_



#include <linux/mempool.h>

#include <linux/spinlock.h>

#include <linux/workqueue.h>



/**

 * struct xe_guc_relay - Data used by the VF-PF Relay Communication over GuC.

 */

struct xe_guc_relay {

	/**@lock: protects all internal data. */

	spinlock_t lock;



	/** @worker: dispatches incoming action messages. */

	struct work_struct worker;



	/** @pending_relays: list of sent requests that await a response. */

	struct list_head pending_relays;



	/** @incoming_actions: list of incoming relay action messages to process. */

	struct list_head incoming_actions;



	/** @pool: pool of the relay message buffers. */

	mempool_t pool;



	/** @last_rid: last Relay-ID used while sending a message. */

	u32 last_rid;

};



#endif