root/drivers/gpu/drm/imagination/pvr_dump.c
// SPDX-License-Identifier: GPL-2.0 OR MIT
/* Copyright (c) 2026 Imagination Technologies Ltd. */

#include "pvr_device.h"
#include "pvr_dump.h"
#include "pvr_rogue_fwif.h"

#include <drm/drm_print.h>
#include <linux/types.h>

static const char *
get_reset_reason_desc(enum rogue_context_reset_reason reason)
{
        switch (reason) {
        case ROGUE_CONTEXT_RESET_REASON_NONE:
                return "None";
        case ROGUE_CONTEXT_RESET_REASON_GUILTY_LOCKUP:
                return "Guilty lockup";
        case ROGUE_CONTEXT_RESET_REASON_INNOCENT_LOCKUP:
                return "Innocent lockup";
        case ROGUE_CONTEXT_RESET_REASON_GUILTY_OVERRUNING:
                return "Guilty overrunning";
        case ROGUE_CONTEXT_RESET_REASON_INNOCENT_OVERRUNING:
                return "Innocent overrunning";
        case ROGUE_CONTEXT_RESET_REASON_HARD_CONTEXT_SWITCH:
                return "Hard context switch";
        case ROGUE_CONTEXT_RESET_REASON_WGP_CHECKSUM:
                return "CDM Mission/safety checksum mismatch";
        case ROGUE_CONTEXT_RESET_REASON_TRP_CHECKSUM:
                return "TRP checksum mismatch";
        case ROGUE_CONTEXT_RESET_REASON_GPU_ECC_OK:
                return "GPU ECC error (corrected, OK)";
        case ROGUE_CONTEXT_RESET_REASON_GPU_ECC_HWR:
                return "GPU ECC error (uncorrected, HWR)";
        case ROGUE_CONTEXT_RESET_REASON_FW_ECC_OK:
                return "Firmware ECC error (corrected, OK)";
        case ROGUE_CONTEXT_RESET_REASON_FW_ECC_ERR:
                return "Firmware ECC error (uncorrected, ERR)";
        case ROGUE_CONTEXT_RESET_REASON_FW_WATCHDOG:
                return "Firmware watchdog";
        case ROGUE_CONTEXT_RESET_REASON_FW_PAGEFAULT:
                return "Firmware pagefault";
        case ROGUE_CONTEXT_RESET_REASON_FW_EXEC_ERR:
                return "Firmware execution error";
        case ROGUE_CONTEXT_RESET_REASON_HOST_WDG_FW_ERR:
                return "Host watchdog";
        case ROGUE_CONTEXT_GEOM_OOM_DISABLED:
                return "Geometry OOM disabled";

        default:
                return "Unknown";
        }
}

static const char *
get_dm_name(u32 dm)
{
        switch (dm) {
        case PVR_FWIF_DM_GP:
                return "General purpose";
        /* PVR_FWIF_DM_TDM has the same index, but is discriminated by a device feature */
        case PVR_FWIF_DM_2D:
                return "2D or TDM";
        case PVR_FWIF_DM_GEOM:
                return "Geometry";
        case PVR_FWIF_DM_FRAG:
                return "Fragment";
        case PVR_FWIF_DM_CDM:
                return "Compute";
        case PVR_FWIF_DM_RAY:
                return "Raytracing";
        case PVR_FWIF_DM_GEOM2:
                return "Geometry 2";
        case PVR_FWIF_DM_GEOM3:
                return "Geometry 3";
        case PVR_FWIF_DM_GEOM4:
                return "Geometry 4";

        default:
                return "Unknown";
        }
}

/**
 * pvr_dump_context_reset_notification() - Handle context reset notification from FW
 * @pvr_dev: Device pointer.
 * @data: Data provided by FW.
 *
 * This will decode the data structure provided by FW and print the results via drm_info().
 */
void
pvr_dump_context_reset_notification(struct pvr_device *pvr_dev,
                                    struct rogue_fwif_fwccb_cmd_context_reset_data *data)
{
        struct drm_device *drm_dev = from_pvr_device(pvr_dev);

        if (data->flags & ROGUE_FWIF_FWCCB_CMD_CONTEXT_RESET_FLAG_ALL_CTXS) {
                drm_info(drm_dev, "Received context reset notification for all contexts\n");
        } else {
                drm_info(drm_dev, "Received context reset notification on context %u\n",
                         data->server_common_context_id);
        }

        drm_info(drm_dev, "  Reset reason=%u (%s)\n", data->reset_reason,
                 get_reset_reason_desc((enum rogue_context_reset_reason)data->reset_reason));
        drm_info(drm_dev, "  Data Master=%u (%s)\n", data->dm, get_dm_name(data->dm));
        drm_info(drm_dev, "  Job ref=%u\n", data->reset_job_ref);

        if (data->flags & ROGUE_FWIF_FWCCB_CMD_CONTEXT_RESET_FLAG_PF) {
                drm_info(drm_dev, "  Page fault occurred, fault address=%llx\n",
                         data->fault_address);
        }
}