linux-yocto/drivers/gpu/drm/xe/xe_guc_klv_helpers.h
Michal Wajdeczko e6946ea8fc drm/xe/guc: Add more KLV helper macros
In upcoming patches we will want to generate some of the KLV keys
from other macros. Add MAKE_GUC_KLV_{KEY|LEN} macros for that and
make sure they will correctly expand provided TAG parameter. Also
fix PREP_GUC_KLV_TAG to also work correctly within other macros.

Reviewed-by: Piotr Piórkowski <piotr.piorkowski@intel.com>
Signed-off-by: Michal Wajdeczko <michal.wajdeczko@intel.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20240514190015.2172-2-michal.wajdeczko@intel.com
2024-05-16 18:04:38 +02:00

65 lines
1.7 KiB
C

/* SPDX-License-Identifier: MIT */
/*
* Copyright © 2024 Intel Corporation
*/
#ifndef _XE_GUC_KLV_HELPERS_H_
#define _XE_GUC_KLV_HELPERS_H_
#include <linux/args.h>
#include <linux/types.h>
struct drm_printer;
const char *xe_guc_klv_key_to_string(u16 key);
void xe_guc_klv_print(const u32 *klvs, u32 num_dwords, struct drm_printer *p);
int xe_guc_klv_count(const u32 *klvs, u32 num_dwords);
/**
* PREP_GUC_KLV - Prepare KLV header value based on provided key and len.
* @key: KLV key
* @len: KLV length
*
* Return: value of the KLV header (u32).
*/
#define PREP_GUC_KLV(key, len) \
(FIELD_PREP(GUC_KLV_0_KEY, (key)) | \
FIELD_PREP(GUC_KLV_0_LEN, (len)))
/**
* PREP_GUC_KLV_CONST - Prepare KLV header value based on const key and len.
* @key: const KLV key
* @len: const KLV length
*
* Return: value of the KLV header (u32).
*/
#define PREP_GUC_KLV_CONST(key, len) \
(FIELD_PREP_CONST(GUC_KLV_0_KEY, (key)) | \
FIELD_PREP_CONST(GUC_KLV_0_LEN, (len)))
/**
* MAKE_GUC_KLV_KEY - Prepare KLV KEY name based on unique KLV definition tag.
* @TAG: unique tag of the KLV definition
*/
#define MAKE_GUC_KLV_KEY(TAG) CONCATENATE(CONCATENATE(GUC_KLV_, TAG), _KEY)
/**
* MAKE_GUC_KLV_LEN - Prepare KLV LEN name based on unique KLV definition tag.
* @TAG: unique tag of the KLV definition
*/
#define MAKE_GUC_KLV_LEN(TAG) CONCATENATE(CONCATENATE(GUC_KLV_, TAG), _LEN)
/**
* PREP_GUC_KLV_TAG - Prepare KLV header value based on unique KLV definition tag.
* @TAG: unique tag of the KLV definition
*
* Combine separate KEY and LEN definitions of the KLV identified by the TAG.
*
* Return: value of the KLV header (u32).
*/
#define PREP_GUC_KLV_TAG(TAG) \
PREP_GUC_KLV_CONST(MAKE_GUC_KLV_KEY(TAG), MAKE_GUC_KLV_LEN(TAG))
#endif