[PATCH 2/5] drm/xe/pf: Introduce helper functions for use by PF

[Piotr Piórkowski]

Michal Wajdeczko <michal.wajdeczko at intel.com> wrote on śro [2024-kwi-10 14:31:22 +0200]:
> PF driver will maintain VF's configuration data mostly on the
> GT level, but some internal data is located at the device level.
> 
> To allow easy access to that data from the GT level functions, and
> to minimize code duplications, introduce set of helper functions
> and macros for explicit use by the PF driver.
> 
> We will use these helpers in upcoming patches.
> 
> Signed-off-by: Michal Wajdeczko <michal.wajdeczko at intel.com>
> ---
>  drivers/gpu/drm/xe/xe_gt_sriov_pf_helpers.h | 35 ++++++++++++++++
>  drivers/gpu/drm/xe/xe_sriov_pf_helpers.h    | 46 +++++++++++++++++++++
>  2 files changed, 81 insertions(+)
>  create mode 100644 drivers/gpu/drm/xe/xe_gt_sriov_pf_helpers.h
>  create mode 100644 drivers/gpu/drm/xe/xe_sriov_pf_helpers.h
> 
> diff --git a/drivers/gpu/drm/xe/xe_gt_sriov_pf_helpers.h b/drivers/gpu/drm/xe/xe_gt_sriov_pf_helpers.h
> new file mode 100644
> index 000000000000..99472a48ec35
> --- /dev/null
> +++ b/drivers/gpu/drm/xe/xe_gt_sriov_pf_helpers.h
> @@ -0,0 +1,35 @@
> +/* SPDX-License-Identifier: MIT */
> +/*
> + * Copyright © 2023-2024 Intel Corporation
> + */
> +
> +#ifndef _XE_GT_SRIOV_PF_HELPERS_H_
> +#define _XE_GT_SRIOV_PF_HELPERS_H_
> +
> +#include "xe_gt_types.h"
> +#include "xe_sriov_pf_helpers.h"
> +
> +/**
> + * xe_sriov_pf_assert_vfid() - warn if &id is not a supported VF number when debugging.
> + * @gt: the PF &xe_gt to assert on
> + * @vfid: the VF number to assert
> + *
> + * Assert that &gt belongs to the Physical Function (PF) device and provided &vfid
> + * is within a range of supported VF numbers (up to maximum number of VFs that
> + * driver can support, including VF0 that represents the PF itself).
> + *
> + * Note: Effective only on debug builds. See `Xe ASSERTs`_ for more information.
> + */
> +#define xe_gt_sriov_pf_assert_vfid(gt, vfid)	xe_sriov_pf_assert_vfid(gt_to_xe(gt), (vfid))
> +
> +static inline int xe_gt_sriov_pf_get_totalvfs(struct xe_gt *gt)
> +{
> +	return xe_sriov_pf_get_totalvfs(gt_to_xe(gt));
> +}
> +
> +static inline struct mutex *xe_gt_sriov_pf_master_mutex(struct xe_gt *gt)
> +{
> +	return xe_sriov_pf_master_mutex(gt_to_xe(gt));
> +}
> +
> +#endif
> diff --git a/drivers/gpu/drm/xe/xe_sriov_pf_helpers.h b/drivers/gpu/drm/xe/xe_sriov_pf_helpers.h
> new file mode 100644
> index 000000000000..7d156ba82479
> --- /dev/null
> +++ b/drivers/gpu/drm/xe/xe_sriov_pf_helpers.h
> @@ -0,0 +1,46 @@
> +/* SPDX-License-Identifier: MIT */
> +/*
> + * Copyright © 2023-2024 Intel Corporation
> + */
> +
> +#ifndef _XE_SRIOV_PF_HELPERS_H_
> +#define _XE_SRIOV_PF_HELPERS_H_
> +
> +#include "xe_assert.h"
> +#include "xe_device_types.h"
> +#include "xe_sriov.h"
> +#include "xe_sriov_types.h"
> +
> +/**
> + * xe_sriov_pf_assert_vfid() - warn if &id is not a supported VF number when debugging.
> + * @xe: the PF &xe_device to assert on
> + * @vfid: the VF number to assert
> + *
> + * Assert that &xe represents the Physical Function (PF) device and provided &vfid
> + * is within a range of supported VF numbers (up to maximum number of VFs that
> + * driver can support, including VF0 that represents the PF itself).
> + *
> + * Note: Effective only on debug builds. See `Xe ASSERTs`_ for more information.
> + */
> +#define xe_sriov_pf_assert_vfid(xe, vfid) \
> +	xe_assert((xe), (vfid) <= xe_sriov_pf_get_totalvfs(xe))
> +
> +/**
> + * xe_sriov_pf_get_totalvfs() - Get maximum number of VFs that driver can support.
> + * @xe: the &xe_device to query (shall be PF)
> + *
> + * Return: Maximum number of VFs that this PF driver supports.
> + */
> +static inline int xe_sriov_pf_get_totalvfs(struct xe_device *xe)
> +{
> +	xe_assert(xe, IS_SRIOV_PF(xe));
> +	return xe->sriov.pf.driver_max_vfs;
> +}
> +
> +static inline struct mutex *xe_sriov_pf_master_mutex(struct xe_device *xe)
> +{
> +	xe_assert(xe, IS_SRIOV_PF(xe));
> +	return &xe->sriov.pf.master_lock;
> +}
> +
> +#endif

LGTM:
Reviewed-by: Piotr Piórkowski <piotr.piorkowski at intel.com>

> -- 
> 2.43.0
> 

--