/* SPDX-License-Identifier: GPL-2.0-only OR MIT */
/* Copyright (c) 2023 Imagination Technologies Ltd. */

#ifndef PVR_ROGUE_FWIF_SHARED_H
#define PVR_ROGUE_FWIF_SHARED_H

#include <linux/compiler.h>
#include <linux/types.h>

#define ROGUE_FWIF_NUM_RTDATAS 2U
#define ROGUE_FWIF_NUM_GEOMDATAS 1U
#define ROGUE_FWIF_NUM_RTDATA_FREELISTS 2U
#define ROGUE_NUM_GEOM_CORES 1U

#define ROGUE_NUM_GEOM_CORES_SIZE 2U

/*
 * Maximum number of UFOs in a CCB command.
 * The number is based on having 32 sync prims (as originally), plus 32 sync
 * checkpoints.
 * Once the use of sync prims is no longer supported, we will retain
 * the same total (64) as the number of sync checkpoints which may be
 * supporting a fence is not visible to the client driver and has to
 * allow for the number of different timelines involved in fence merges.
 */
#define ROGUE_FWIF_CCB_CMD_MAX_UFOS (32U + 32U)

/*
 * This is a generic limit imposed on any DM (GEOMETRY,FRAGMENT,CDM,TDM,2D,TRANSFER)
 * command passed through the bridge.
 * Just across the bridge in the server, any incoming kick command size is
 * checked against this maximum limit.
 * In case the incoming command size is larger than the specified limit,
 * the bridge call is retired with error.
 */
#define ROGUE_FWIF_DM_INDEPENDENT_KICK_CMD_SIZE (1024U)

#define ROGUE_FWIF_PRBUFFER_START (0)
#define ROGUE_FWIF_PRBUFFER_ZSBUFFER (0)
#define ROGUE_FWIF_PRBUFFER_MSAABUFFER (1)
#define ROGUE_FWIF_PRBUFFER_MAXSUPPORTED (2)

struct rogue_fwif_dma_addr {
        aligned_u64 dev_addr;
        u32 fw_addr;
        u32 padding;
} __aligned(8);

struct rogue_fwif_ufo {
        u32 addr;
        u32 value;
};

#define ROGUE_FWIF_UFO_ADDR_IS_SYNC_CHECKPOINT (1)

struct rogue_fwif_sync_checkpoint {
        u32 state;
        u32 fw_ref_count;
};

struct rogue_fwif_cleanup_ctl {
        /* Number of commands received by the FW */
        u32 submitted_commands;
        /* Number of commands executed by the FW */
        u32 executed_commands;
} __aligned(8);

/*
 * Used to share frame numbers across UM-KM-FW,
 * frame number is set in UM,
 * frame number is required in both KM for HTB and FW for FW trace.
 *
 * May be used to house Kick flags in the future.
 */
struct rogue_fwif_cmd_common {
        /* associated frame number */
        u32 frame_num;
};

/*
 * Geometry and fragment commands require set of firmware addresses that are stored in the Kernel.
 * Client has handle(s) to Kernel containers storing these addresses, instead of raw addresses. We
 * have to patch/write these addresses in KM to prevent UM from controlling FW addresses directly.
 * Typedefs for geometry and fragment commands are shared between Client and Firmware (both
 * single-BVNC). Kernel is implemented in a multi-BVNC manner, so it can't use geometry|fragment
 * CMD type definitions directly. Therefore we have a SHARED block that is shared between UM-KM-FW
 * across all BVNC configurations.
 */
struct rogue_fwif_cmd_geom_frag_shared {
        /* Common command attributes */
        struct rogue_fwif_cmd_common cmn;

        /*
         * RTData associated with this command, this is used for context
         * selection and for storing out HW-context, when TA is switched out for
         * continuing later
         */
        u32 hwrt_data_fw_addr;

        /* Supported PR Buffers like Z/S/MSAA Scratch */
        u32 pr_buffer_fw_addr[ROGUE_FWIF_PRBUFFER_MAXSUPPORTED];
};

/*
 * Client Circular Command Buffer (CCCB) control structure.
 * This is shared between the Server and the Firmware and holds byte offsets
 * into the CCCB as well as the wrapping mask to aid wrap around. A given
 * snapshot of this queue with Cmd 1 running on the GPU might be:
 *
 *          Roff                           Doff                 Woff
 * [..........|-1----------|=2===|=3===|=4===|~5~~~~|~6~~~~|~7~~~~|..........]
 *            <      runnable commands       ><   !ready to run   >
 *
 * Cmd 1    : Currently executing on the GPU data master.
 * Cmd 2,3,4: Fence dependencies met, commands runnable.
 * Cmd 5... : Fence dependency not met yet.
 */
struct rogue_fwif_cccb_ctl {
        /* Host write offset into CCB. This must be aligned to 16 bytes. */
        u32 write_offset;
        /*
         * Firmware read offset into CCB. Points to the command that is runnable
         * on GPU, if R!=W
         */
        u32 read_offset;
        /*
         * Firmware fence dependency offset. Points to commands not ready, i.e.
         * fence dependencies are not met.
         */
        u32 dep_offset;
        /* Offset wrapping mask, total capacity in bytes of the CCB-1 */
        u32 wrap_mask;

        /* Only used if SUPPORT_AGP is present. */
        u32 read_offset2;

        /* Only used if SUPPORT_AGP4 is present. */
        u32 read_offset3;
        /* Only used if SUPPORT_AGP4 is present. */
        u32 read_offset4;

        u32 padding;
} __aligned(8);

#define ROGUE_FW_LOCAL_FREELIST (0)
#define ROGUE_FW_GLOBAL_FREELIST (1)
#define ROGUE_FW_FREELIST_TYPE_LAST ROGUE_FW_GLOBAL_FREELIST
#define ROGUE_FW_MAX_FREELISTS (ROGUE_FW_FREELIST_TYPE_LAST + 1U)

struct rogue_fwif_geom_registers_caswitch {
        u64 geom_reg_vdm_context_state_base_addr;
        u64 geom_reg_vdm_context_state_resume_addr;
        u64 geom_reg_ta_context_state_base_addr;

        struct {
                u64 geom_reg_vdm_context_store_task0;
                u64 geom_reg_vdm_context_store_task1;
                u64 geom_reg_vdm_context_store_task2;

                /* VDM resume state update controls */
                u64 geom_reg_vdm_context_resume_task0;
                u64 geom_reg_vdm_context_resume_task1;
                u64 geom_reg_vdm_context_resume_task2;

                u64 geom_reg_vdm_context_store_task3;
                u64 geom_reg_vdm_context_store_task4;

                u64 geom_reg_vdm_context_resume_task3;
                u64 geom_reg_vdm_context_resume_task4;
        } geom_state[2];
};

#define ROGUE_FWIF_GEOM_REGISTERS_CSWITCH_SIZE \
        sizeof(struct rogue_fwif_geom_registers_caswitch)

struct rogue_fwif_cdm_registers_cswitch {
        u64 cdmreg_cdm_context_pds0;
        u64 cdmreg_cdm_context_pds1;
        u64 cdmreg_cdm_terminate_pds;
        u64 cdmreg_cdm_terminate_pds1;

        /* CDM resume controls */
        u64 cdmreg_cdm_resume_pds0;
        u64 cdmreg_cdm_context_pds0_b;
        u64 cdmreg_cdm_resume_pds0_b;
};

struct rogue_fwif_static_rendercontext_state {
        /* Geom registers for ctx switch */
        struct rogue_fwif_geom_registers_caswitch ctxswitch_regs[ROGUE_NUM_GEOM_CORES_SIZE]
                __aligned(8);
};

#define ROGUE_FWIF_STATIC_RENDERCONTEXT_SIZE \
        sizeof(struct rogue_fwif_static_rendercontext_state)

struct rogue_fwif_static_computecontext_state {
        /* CDM registers for ctx switch */
        struct rogue_fwif_cdm_registers_cswitch ctxswitch_regs __aligned(8);
};

#define ROGUE_FWIF_STATIC_COMPUTECONTEXT_SIZE \
        sizeof(struct rogue_fwif_static_computecontext_state)

enum rogue_fwif_prbuffer_state {
        ROGUE_FWIF_PRBUFFER_UNBACKED = 0,
        ROGUE_FWIF_PRBUFFER_BACKED,
        ROGUE_FWIF_PRBUFFER_BACKING_PENDING,
        ROGUE_FWIF_PRBUFFER_UNBACKING_PENDING,
};

struct rogue_fwif_prbuffer {
        /* Buffer ID*/
        u32 buffer_id;
        /* Needs On-demand Z/S/MSAA Buffer allocation */
        bool on_demand __aligned(4);
        /* Z/S/MSAA -Buffer state */
        enum rogue_fwif_prbuffer_state state;
        /* Cleanup state */
        struct rogue_fwif_cleanup_ctl cleanup_sate;
        /* Compatibility and other flags */
        u32 prbuffer_flags;
} __aligned(8);

/* Last reset reason for a context. */
enum rogue_context_reset_reason {
        /* No reset reason recorded */
        ROGUE_CONTEXT_RESET_REASON_NONE = 0,
        /* Caused a reset due to locking up */
        ROGUE_CONTEXT_RESET_REASON_GUILTY_LOCKUP = 1,
        /* Affected by another context locking up */
        ROGUE_CONTEXT_RESET_REASON_INNOCENT_LOCKUP = 2,
        /* Overran the global deadline */
        ROGUE_CONTEXT_RESET_REASON_GUILTY_OVERRUNING = 3,
        /* Affected by another context overrunning */
        ROGUE_CONTEXT_RESET_REASON_INNOCENT_OVERRUNING = 4,
        /* Forced reset to ensure scheduling requirements */
        ROGUE_CONTEXT_RESET_REASON_HARD_CONTEXT_SWITCH = 5,
        /* FW Safety watchdog triggered */
        ROGUE_CONTEXT_RESET_REASON_FW_WATCHDOG = 12,
        /* FW page fault (no HWR) */
        ROGUE_CONTEXT_RESET_REASON_FW_PAGEFAULT = 13,
        /* FW execution error (GPU reset requested) */
        ROGUE_CONTEXT_RESET_REASON_FW_EXEC_ERR = 14,
        /* Host watchdog detected FW error */
        ROGUE_CONTEXT_RESET_REASON_HOST_WDG_FW_ERR = 15,
        /* Geometry DM OOM event is not allowed */
        ROGUE_CONTEXT_GEOM_OOM_DISABLED = 16,
};

struct rogue_context_reset_reason_data {
        enum rogue_context_reset_reason reset_reason;
        u32 reset_ext_job_ref;
};

#include "pvr_rogue_fwif_shared_check.h"

#endif /* PVR_ROGUE_FWIF_SHARED_H */