root/drivers/gpu/drm/msm/adreno/a6xx_gmu.h
/* SPDX-License-Identifier: GPL-2.0 */
/* Copyright (c) 2017 The Linux Foundation. All rights reserved. */

#ifndef _A6XX_GMU_H_
#define _A6XX_GMU_H_

#include <linux/completion.h>
#include <linux/iopoll.h>
#include <linux/interrupt.h>
#include <linux/notifier.h>
#include <linux/soc/qcom/qcom_aoss.h>
#include "msm_drv.h"
#include "a6xx_hfi.h"

struct a6xx_gmu_bo {
        struct drm_gem_object *obj;
        void *virt;
        size_t size;
        u64 iova;
};

#define GMU_MAX_GX_FREQS        32
#define GMU_MAX_CX_FREQS        6
#define GMU_MAX_BCMS            3

struct a6xx_bcm {
        char *name;
        unsigned int buswidth;
        bool fixed;
        unsigned int perfmode;
        unsigned int perfmode_bw;
};

/*
 * These define the different GMU wake up options - these define how both the
 * CPU and the GMU bring up the hardware
 */

/* THe GMU has already been booted and the rentention registers are active */
#define GMU_WARM_BOOT 0

/* the GMU is coming up for the first time or back from a power collapse */
#define GMU_COLD_BOOT 1

/*
 * These define the level of control that the GMU has - the higher the number
 * the more things that the GMU hardware controls on its own.
 */

/* The GMU does not do any idle state management */
#define GMU_IDLE_STATE_ACTIVE 0

/* Unknown power state. Not exposed by the firmware. For documentation purpose only */
#define GMU_IDLE_STATE_RESERVED 1

/* The GMU manages SPTP power collapse */
#define GMU_IDLE_STATE_SPTP 2

/* The GMU does automatic IFPC (intra-frame power collapse) */
#define GMU_IDLE_STATE_IFPC 3

struct a6xx_gmu {
        struct device *dev;

        /* For serializing communication with the GMU: */
        struct mutex lock;

        struct drm_gpuvm *vm;

        void __iomem *mmio;
        u32 mmio_offset;
        void __iomem *rscc;

        int hfi_irq;
        int gmu_irq;

        struct device *gxpd;
        struct device *cxpd;

        int idle_level;

        struct a6xx_gmu_bo hfi;
        struct a6xx_gmu_bo debug;
        struct a6xx_gmu_bo icache;
        struct a6xx_gmu_bo dcache;
        struct a6xx_gmu_bo dummy;
        struct a6xx_gmu_bo log;

        int nr_clocks;
        struct clk_bulk_data *clocks;
        struct clk *core_clk;
        struct clk *hub_clk;

        /* current performance index set externally */
        int current_perf_index;

        int nr_gpu_freqs;
        unsigned long gpu_freqs[GMU_MAX_GX_FREQS];
        u32 gx_arc_votes[GMU_MAX_GX_FREQS];
        u32 dep_arc_votes[GMU_MAX_GX_FREQS];
        struct a6xx_hfi_acd_table acd_table;

        int nr_gpu_bws;
        unsigned long gpu_bw_table[GMU_MAX_GX_FREQS];
        u32 gpu_ib_votes[GMU_MAX_GX_FREQS][GMU_MAX_BCMS];

        int nr_gmu_freqs;
        unsigned long gmu_freqs[GMU_MAX_CX_FREQS];
        u32 cx_arc_votes[GMU_MAX_CX_FREQS];

        unsigned long freq;

        struct a6xx_hfi_queue queues[2];

        bool initialized;
        bool hung;
        bool legacy; /* a618 or a630 */

        /* For power domain callback */
        struct notifier_block pd_nb;
        struct completion pd_gate;

        struct qmp *qmp;
        struct a6xx_hfi_msg_bw_table *bw_table;

/* To check if we can trigger sleep seq at PDC. Cleared in a6xx_rpmh_stop() */
#define GMU_STATUS_FW_START     0
/* To track if PDC sleep seq was done */
#define GMU_STATUS_PDC_SLEEP    1
/* To track Perfcounter OOB set status */
#define GMU_STATUS_OOB_PERF_SET 2
        unsigned long status;
};

#define GMU_BYTE_OFFSET(gmu, offset) (((offset) << 2) - (gmu)->mmio_offset)

static inline u32 gmu_read(struct a6xx_gmu *gmu, u32 offset)
{
        /* The 'offset' is based on GPU's start address. Adjust it */
        return readl(gmu->mmio + GMU_BYTE_OFFSET(gmu, offset));
}

static inline void gmu_write(struct a6xx_gmu *gmu, u32 offset, u32 value)
{
        writel(value, gmu->mmio + GMU_BYTE_OFFSET(gmu, offset));
}

static inline void
gmu_write_bulk(struct a6xx_gmu *gmu, u32 offset, const u32 *data, u32 size)
{
        memcpy_toio(gmu->mmio + GMU_BYTE_OFFSET(gmu, offset), data, size);
        wmb();
}

static inline void gmu_rmw(struct a6xx_gmu *gmu, u32 reg, u32 mask, u32 or)
{
        u32 val = gmu_read(gmu, reg);

        val &= ~mask;

        gmu_write(gmu, reg, val | or);
}

static inline u64 gmu_read64(struct a6xx_gmu *gmu, u32 lo, u32 hi)
{
        u64 val;

        val = gmu_read(gmu, lo);
        val |= ((u64) gmu_read(gmu, hi) << 32);

        return val;
}

#define gmu_poll_timeout(gmu, addr, val, cond, interval, timeout) \
        readl_poll_timeout((gmu)->mmio + (GMU_BYTE_OFFSET(gmu, addr)), val, \
                cond, interval, timeout)
#define gmu_poll_timeout_atomic(gmu, addr, val, cond, interval, timeout) \
        readl_poll_timeout_atomic((gmu)->mmio + (GMU_BYTE_OFFSET(gmu, addr)), val, cond, \
                interval, timeout)

static inline u32 gmu_read_rscc(struct a6xx_gmu *gmu, u32 offset)
{
        return readl(gmu->rscc + (offset << 2));
}

static inline void gmu_write_rscc(struct a6xx_gmu *gmu, u32 offset, u32 value)
{
        writel(value, gmu->rscc + (offset << 2));
}

#define gmu_poll_timeout_rscc(gmu, addr, val, cond, interval, timeout) \
        readl_poll_timeout((gmu)->rscc + ((addr) << 2), val, cond, \
                interval, timeout)

/*
 * These are the available OOB (out of band requests) to the GMU where "out of
 * band" means that the CPU talks to the GMU directly and not through HFI.
 * Normally this works by writing a ITCM/DTCM register and then triggering a
 * interrupt (the "request" bit) and waiting for an acknowledgment (the "ack"
 * bit). The state is cleared by writing the "clear' bit to the GMU interrupt.
 *
 * These are used to force the GMU/GPU to stay on during a critical sequence or
 * for hardware workarounds.
 */

enum a6xx_gmu_oob_state {
        /*
         * Let the GMU know that a boot or slumber operation has started. The value in
         * REG_A6XX_GMU_BOOT_SLUMBER_OPTION lets the GMU know which operation we are
         * doing
         */
        GMU_OOB_BOOT_SLUMBER = 0,
        /*
         * Let the GMU know to not turn off any GPU registers while the CPU is in a
         * critical section
         */
        GMU_OOB_GPU_SET,
        /*
         * Set a new power level for the GPU when the CPU is doing frequency scaling
         */
        GMU_OOB_DCVS_SET,
        /*
         * Used to keep the GPU on for CPU-side reads of performance counters.
         */
        GMU_OOB_PERFCOUNTER_SET,
};

void a6xx_hfi_init(struct a6xx_gmu *gmu);
int a6xx_hfi_start(struct a6xx_gmu *gmu, int boot_state);
void a6xx_hfi_stop(struct a6xx_gmu *gmu);
int a6xx_hfi_send_prep_slumber(struct a6xx_gmu *gmu);
int a6xx_hfi_set_freq(struct a6xx_gmu *gmu, u32 perf_index, u32 bw_index);

bool a6xx_gmu_gx_is_on(struct a6xx_gmu *gmu);
bool a6xx_gmu_sptprac_is_on(struct a6xx_gmu *gmu);
void a6xx_sptprac_disable(struct a6xx_gmu *gmu);
int a6xx_sptprac_enable(struct a6xx_gmu *gmu);

#endif