android_kernel_samsung_sm8650-modules/qcom/opensource/graphics-kernel/adreno_gen8_hwsched.h

/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * Copyright (c) 2021, The Linux Foundation. All rights reserved.
 * Copyright (c) 2023, Qualcomm Innovation Center, Inc. All rights reserved.
 */

#ifndef _ADRENO_GEN8_HWSCHED_H_
#define _ADRENO_GEN8_HWSCHED_H_

#include "adreno_gen8_hwsched_hfi.h"

/**
 * struct gen8_hwsched_device - Container for the gen8 hwscheduling device
 */
struct gen8_hwsched_device {
	/** @gen8_dev: Container for the gen8 device */
	struct gen8_device gen8_dev;
	/** @hwsched_hfi: Container for hwscheduling specific hfi resources */
	struct gen8_hwsched_hfi hwsched_hfi;
};

/**
 * gen8_hwsched_probe - Target specific probe for hwsched
 * @pdev: Pointer to the platform device
 * @chipid: Chipid of the target
 * @gpucore: Pointer to the gpucore
 *
 * The target specific probe function for hwsched enabled gmu targets.
 *
 * Return: 0 on success or negative error on failure
 */
int gen8_hwsched_probe(struct platform_device *pdev,
		u32 chipid, const struct adreno_gpu_core *gpucore);

/**
 * gen8_hwsched_reset_replay - Restart the gmu and gpu and replay inflight cmdbatches
 * @adreno_dev: Pointer to the adreno device
 *
 * Return: 0 on success or negative error on failure
 */
int gen8_hwsched_reset_replay(struct adreno_device *adreno_dev);

/**
 * gen8_hwsched_snapshot - take gen8 hwsched snapshot
 * @adreno_dev: Pointer to the adreno device
 * @snapshot: Pointer to the snapshot instance
 *
 * Snapshot the faulty ib and then snapshot rest of gen8 gmu things
 */
void gen8_hwsched_snapshot(struct adreno_device *adreno_dev,
		struct kgsl_snapshot *snapshot);

/**
 * gen8_hwsched_handle_watchdog - Handle watchdog interrupt
 * @adreno_dev: Pointer to the adreno device
 */
void gen8_hwsched_handle_watchdog(struct adreno_device *adreno_dev);

/**
 * gen8_hwsched_active_count_get - Increment the active count
 * @adreno_dev: Pointer to the adreno device
 *
 * This function increments the active count. If active count
 * is 0, this function also powers up the device.
 *
 * Return: 0 on success or negative error on failure
 */
int gen8_hwsched_active_count_get(struct adreno_device *adreno_dev);

/**
 * gen8_hwsched_active_count_put - Put back the active count
 * @adreno_dev: Pointer to the adreno device
 *
 * This function decrements the active count sets the idle
 * timer if active count is zero.
 */
void gen8_hwsched_active_count_put(struct adreno_device *adreno_dev);

/**
 * gen8_hwsched_add_to_minidump - Register hwsched_device with va minidump
 * @adreno_dev: Pointer to the adreno device
 */
int gen8_hwsched_add_to_minidump(struct adreno_device *adreno_dev);

/**
 * gen8_hwsched_send_recurring_cmdobj - Dispatch IBs to GMU
 * @adreno_dev: Pointer to adreno device structure
 * @cmdobj: The command object which needs to be submitted
 *
 * This function is used to register the context if needed and submit
 * recurring IBs to the GMU. Upon receiving ipc interrupt GMU will submit
 * recurring IBs to GPU.

 * Return: 0 on success and negative error on failure
 */
int gen8_hwsched_send_recurring_cmdobj(struct adreno_device *adreno_dev,
		struct kgsl_drawobj_cmd *cmdobj);

/**
 * gen8_hwsched_fault - Set hwsched fault to request recovery
 * @adreno_dev: A handle to adreno device
 * @fault: The type of fault
 */
void gen8_hwsched_fault(struct adreno_device *adreno_dev, u32 fault);

#endif