/* SPDX-License-Identifier: GPL-2.0-only */
/* Copyright (c) 2016-2018, The Linux Foundation. All rights reserved.
 */

#ifndef _DPU_CORE_PERF_H_
#define _DPU_CORE_PERF_H_

#include <linux/types.h>
#include <linux/dcache.h>
#include <linux/mutex.h>
#include <drm/drm_crtc.h>

#include "dpu_hw_catalog.h"

/**
 * struct dpu_core_perf_params - definition of performance parameters
 * @max_per_pipe_ib: maximum instantaneous bandwidth request
 * @bw_ctl: arbitrated bandwidth request
 * @core_clk_rate: core clock rate request
 */
struct dpu_core_perf_params {
        u32 max_per_pipe_ib;
        u64 bw_ctl;
        u64 core_clk_rate;
};

/**
 * struct dpu_core_perf_tune - definition of performance tuning control
 * @mode: performance mode
 */
struct dpu_core_perf_tune {
        u32 mode;
};

/**
 * struct dpu_core_perf - definition of core performance context
 * @perf_cfg: Platform-specific performance configuration
 * @core_clk_rate: current core clock rate
 * @max_core_clk_rate: maximum allowable core clock rate
 * @perf_tune: debug control for performance tuning
 * @enable_bw_release: debug control for bandwidth release
 * @fix_core_clk_rate: fixed core clock request in Hz used in mode 2
 * @fix_core_ib_vote: fixed core ib vote in KBps used in mode 2
 * @fix_core_ab_vote: fixed core ab vote in KBps used in mode 2
 */
struct dpu_core_perf {
        const struct dpu_perf_cfg *perf_cfg;
        u64 core_clk_rate;
        u64 max_core_clk_rate;
        struct dpu_core_perf_tune perf_tune;
        u32 enable_bw_release;
        u64 fix_core_clk_rate;
        u32 fix_core_ib_vote;
        u32 fix_core_ab_vote;
};

u64 dpu_core_perf_adjusted_mode_clk(u64 clk_rate,
                                    const struct dpu_perf_cfg *perf_cfg);

int dpu_core_perf_crtc_check(struct drm_crtc *crtc,
                struct drm_crtc_state *state);

int dpu_core_perf_crtc_update(struct drm_crtc *crtc,
                              int params_changed);

void dpu_core_perf_crtc_release_bw(struct drm_crtc *crtc);

int dpu_core_perf_init(struct dpu_core_perf *perf,
                const struct dpu_perf_cfg *perf_cfg,
                unsigned long max_core_clk_rate);

struct dpu_kms;

int dpu_core_perf_debugfs_init(struct dpu_kms *dpu_kms, struct dentry *parent);

#endif /* _DPU_CORE_PERF_H_ */