root/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_pre_gmdid_get - Determine IP steppings from PCI revid
 * @xe: Xe device
 *
 * Convert the PCI revid into proper IP steppings.  This should only be
 * used on platforms that do not have GMD_ID support.
 */
struct xe_step_info xe_step_pre_gmdid_get(struct xe_device *xe)
{
        const struct xe_step_info *revids = NULL;
        struct xe_step_info step = {};
        u16 revid = xe->info.revid;
        int size = 0;
        const int *basedie_info = NULL;
        int basedie_size = 0;
        int baseid = 0;

        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)
                return step;

        if (revid < size && revids[revid].graphics != STEP_NONE) {
                step = revids[revid];
        } 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);
                        step = revids[revid];
                } else {
                        drm_dbg(&xe->drm, "Using future steppings\n");
                        step.graphics = STEP_FUTURE;
                }
        }

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

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

        return step;
}

/**
 * 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
 *
 * Convert the revid fields of the GMD_ID registers into proper IP steppings.
 *
 * 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.
 */
struct xe_step_info xe_step_gmdid_get(struct xe_device *xe,
                                      u32 graphics_gmdid_revid,
                                      u32 media_gmdid_revid)
{
        struct xe_step_info step = {
                .graphics = STEP_A0 + graphics_gmdid_revid,
                .media = STEP_A0 + media_gmdid_revid,
        };

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

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

        return step;
}

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

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

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