drivers/gpu/drm/xe/xe_step.c

// SPDX-License-Identifier: MIT
/*
 * Copyright © 2022 Intel Corporation
 */

#include "xe_step.h"

#include <drm/drm_print.h>
#include <kunit/visibility.h>
#include <linux/bitfield.h>

#include "xe_device_types.h"
#include "xe_platform_types.h"

/*
 * Provide mapping between PCI's revision ID to the individual GMD
 * (Graphics/Media/Display) stepping values that can be compared numerically.
 *
 * Some platforms may have unusual ways of mapping PCI revision ID to GMD
 * steppings.  E.g., in some cases a higher PCI revision may translate to a
 * lower stepping of the GT and/or display IP.
 *
 * Also note that some revisions/steppings may have been set aside as
 * placeholders but never materialized in real hardware; in those cases there
 * may be jumps in the revision IDs or stepping values in the tables below.
 */

/*
 * Some platforms always have the same stepping value for GT and display;
 * use a macro to define these to make it easier to identify the platforms
 * where the two steppings can deviate.
 */
#define COMMON_STEP(x_)			\
	.graphics = STEP_##x_,		\
	.media = STEP_##x_

__diag_push();
__diag_ignore_all("-Woverride-init", "Allow field overrides in table");

/* Same GT stepping between tgl_uy_revids and tgl_revids don't mean the same HW */
static const struct xe_step_info tgl_revids[] = {
	[0] = { COMMON_STEP(A0) },
	[1] = { COMMON_STEP(B0) },
};

static const struct xe_step_info dg1_revids[] = {
	[0] = { COMMON_STEP(A0) },
	[1] = { COMMON_STEP(B0) },
};

static const struct xe_step_info adls_revids[] = {
	[0x0] = { COMMON_STEP(A0) },
	[0x1] = { COMMON_STEP(A0) },
	[0x4] = { COMMON_STEP(B0) },
	[0x8] = { COMMON_STEP(C0) },
	[0xC] = { COMMON_STEP(D0) },
};

static const struct xe_step_info adls_rpls_revids[] = {
	[0x4] = { COMMON_STEP(D0) },
	[0xC] = { COMMON_STEP(D0) },
};

static const struct xe_step_info adlp_revids[] = {
	[0x0] = { COMMON_STEP(A0) },
	[0x4] = { COMMON_STEP(B0) },
	[0x8] = { COMMON_STEP(C0) },
	[0xC] = { COMMON_STEP(C0) },
};

static const struct xe_step_info adlp_rpl_revids[] = {
	[0x4] = { COMMON_STEP(C0) },
};

static const struct xe_step_info adln_revids[] = {
	[0x0] = { COMMON_STEP(A0) },
};

static const struct xe_step_info dg2_g10_revid_step_tbl[] = {
	[0x0] = { COMMON_STEP(A0) },
	[0x1] = { COMMON_STEP(A1) },
	[0x4] = { COMMON_STEP(B0) },
	[0x8] = { COMMON_STEP(C0) },
};

static const struct xe_step_info dg2_g11_revid_step_tbl[] = {
	[0x0] = { COMMON_STEP(A0) },
	[0x4] = { COMMON_STEP(B0) },
	[0x5] = { COMMON_STEP(B1) },
};

static const struct xe_step_info dg2_g12_revid_step_tbl[] = {
	[0x0] = { COMMON_STEP(A0) },
	[0x1] = { COMMON_STEP(A1) },
};

static const struct xe_step_info pvc_revid_step_tbl[] = {
	[0x5] = { .graphics = STEP_B0 },
	[0x6] = { .graphics = STEP_B1 },
	[0x7] = { .graphics = STEP_C0 },
};

static const int pvc_basedie_subids[] = {
	[0x3] = STEP_B0,
	[0x4] = STEP_B1,
	[0x5] = STEP_B3,
};

__diag_pop();

/**
 * xe_step_platform_get - Determine platform-level stepping from PCI revid
 * @platform: The Xe platform
 * @revid: The PCI revid
 * @step: Pointer to the step struct to update
 *
 * Convert the PCI revid into a platform-level stepping value and store that
 * in @step->platform.
 */
void xe_step_platform_get(enum xe_platform platform, u8 revid, struct xe_step_info *step)
{
	/*
	 * Not all platforms map PCI revid directly into our symbolic stepping
	 * enumeration. Some platforms will have a single PCI revid used for a
	 * range platform level steppings and some might even require specific
	 * mappings. So prefer to err on the side of caution and include only
	 * the platforms from which we need the stepping info for workaround
	 * checks.
	 */

	if (platform == XE_NOVALAKE_P)
		step->platform = STEP_A0 + revid;
}

/**
 * xe_step_pre_gmdid_get - Determine IP steppings from PCI revid
 * @xe: Xe device
 * @step: Pointer to the step struct to update
 *
 * Convert the PCI revid into proper IP steppings and update @step->basedie,
 * @step->graphics and @step->media accordingly.
 *
 * This should only be used on platforms that do not have GMD_ID support.
 */
void xe_step_pre_gmdid_get(struct xe_device *xe, struct xe_step_info *step)
{
	const struct xe_step_info *revids = NULL;
	u16 revid = xe->info.revid;
	int size = 0;
	const int *basedie_info = NULL;
	int basedie_size = 0;
	int baseid = 0;
	u8 graphics = STEP_NONE;
	u8 media = STEP_NONE;
	u8 basedie = STEP_NONE;

	if (xe->info.platform == XE_PVC) {
		baseid = FIELD_GET(GENMASK(5, 3), xe->info.revid);
		revid = FIELD_GET(GENMASK(2, 0), xe->info.revid);
		revids = pvc_revid_step_tbl;
		size = ARRAY_SIZE(pvc_revid_step_tbl);
		basedie_info = pvc_basedie_subids;
		basedie_size = ARRAY_SIZE(pvc_basedie_subids);
	} else if (xe->info.subplatform == XE_SUBPLATFORM_DG2_G10) {
		revids = dg2_g10_revid_step_tbl;
		size = ARRAY_SIZE(dg2_g10_revid_step_tbl);
	} else if (xe->info.subplatform == XE_SUBPLATFORM_DG2_G11) {
		revids = dg2_g11_revid_step_tbl;
		size = ARRAY_SIZE(dg2_g11_revid_step_tbl);
	} else if (xe->info.subplatform == XE_SUBPLATFORM_DG2_G12) {
		revids = dg2_g12_revid_step_tbl;
		size = ARRAY_SIZE(dg2_g12_revid_step_tbl);
	} else if (xe->info.platform == XE_ALDERLAKE_N) {
		revids = adln_revids;
		size = ARRAY_SIZE(adln_revids);
	} else if (xe->info.subplatform == XE_SUBPLATFORM_ALDERLAKE_S_RPLS) {
		revids = adls_rpls_revids;
		size = ARRAY_SIZE(adls_rpls_revids);
	} else if (xe->info.subplatform == XE_SUBPLATFORM_ALDERLAKE_P_RPLU) {
		revids = adlp_rpl_revids;
		size = ARRAY_SIZE(adlp_rpl_revids);
	} else if (xe->info.platform == XE_ALDERLAKE_P) {
		revids = adlp_revids;
		size = ARRAY_SIZE(adlp_revids);
	} else if (xe->info.platform == XE_ALDERLAKE_S) {
		revids = adls_revids;
		size = ARRAY_SIZE(adls_revids);
	} else if (xe->info.platform == XE_DG1) {
		revids = dg1_revids;
		size = ARRAY_SIZE(dg1_revids);
	} else if (xe->info.platform == XE_TIGERLAKE) {
		revids = tgl_revids;
		size = ARRAY_SIZE(tgl_revids);
	}

	/* Not using the stepping scheme for the platform yet. */
	if (!revids)
		goto done;

	if (revid < size && revids[revid].graphics != STEP_NONE) {
		graphics = revids[revid].graphics;
		media = revids[revid].media;
		basedie = revids[revid].basedie;
	} else {
		drm_warn(&xe->drm, "Unknown revid 0x%02x\n", revid);

		/*
		 * If we hit a gap in the revid array, use the information for
		 * the next revid.
		 *
		 * This may be wrong in all sorts of ways, especially if the
		 * steppings in the array are not monotonically increasing, but
		 * it's better than defaulting to 0.
		 */
		while (revid < size && revids[revid].graphics == STEP_NONE)
			revid++;

		if (revid < size) {
			drm_dbg(&xe->drm, "Using steppings for revid 0x%02x\n",
				revid);
			graphics = revids[revid].graphics;
			media = revids[revid].media;
			basedie = revids[revid].basedie;
		} else {
			drm_dbg(&xe->drm, "Using future steppings\n");
			graphics = STEP_FUTURE;
		}
	}

	drm_WARN_ON(&xe->drm, graphics == STEP_NONE);

	if (basedie_info && basedie_size) {
		if (baseid < basedie_size && basedie_info[baseid] != STEP_NONE) {
			basedie = basedie_info[baseid];
		} else {
			drm_warn(&xe->drm, "Unknown baseid 0x%02x\n", baseid);
			basedie = STEP_FUTURE;
		}
	}

done:
	step->graphics = graphics;
	step->media = media;
	step->basedie = basedie;
}

/**
 * xe_step_gmdid_get - Determine IP steppings from GMD_ID revid fields
 * @xe: Xe device
 * @graphics_gmdid_revid: value of graphics GMD_ID register's revid field
 * @media_gmdid_revid: value of media GMD_ID register's revid field
 * @step: Poninter to the step struct to update.
 *
 * Convert the revid fields of the GMD_ID registers into proper IP steppings
 * and update @step->graphics and @step->media accordingly.
 *
 * GMD_ID revid values are currently expected to have consistent meanings on
 * all platforms:  major steppings (A0, B0, etc.) are 4 apart, with minor
 * steppings (A1, A2, etc.) taking the values in between.
 */
void xe_step_gmdid_get(struct xe_device *xe,
		       u32 graphics_gmdid_revid,
		       u32 media_gmdid_revid,
		       struct xe_step_info *step)
{
	u8 graphics = STEP_A0 + graphics_gmdid_revid;
	u8 media = STEP_A0 + media_gmdid_revid;

	if (graphics >= STEP_FUTURE) {
		graphics = STEP_FUTURE;
		drm_dbg(&xe->drm, "Graphics GMD_ID revid value %d treated as future stepping\n",
			graphics_gmdid_revid);
	}

	if (media >= STEP_FUTURE) {
		media = STEP_FUTURE;
		drm_dbg(&xe->drm, "Media GMD_ID revid value %d treated as future stepping\n",
			media_gmdid_revid);
	}

	step->graphics = graphics;
	step->media = media;
}

#define STEP_NAME_CASE(name)	\
	case STEP_##name:	\
		return #name;

const char *xe_step_name(enum intel_step step)
{
	switch (step) {
	STEP_NAME_LIST(STEP_NAME_CASE);

	default:
		return "**";
	}
}
EXPORT_SYMBOL_IF_KUNIT(xe_step_name);