/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
/*
|
*
|
* (C) COPYRIGHT 2022 ARM Limited. All rights reserved.
|
*
|
* This program is free software and is provided to you under the terms of the
|
* GNU General Public License version 2 as published by the Free Software
|
* Foundation, and any use by you of this program is subject to the terms
|
* of such GNU license.
|
*
|
* This program is distributed in the hope that it will be useful,
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
* GNU General Public License for more details.
|
*
|
* You should have received a copy of the GNU General Public License
|
* along with this program; if not, you can access it online at
|
* http://www.gnu.org/licenses/gpl-2.0.html.
|
*
|
*/
|
|
#ifndef _KBASE_CSF_MCU_SHARED_REG_H_
|
#define _KBASE_CSF_MCU_SHARED_REG_H_
|
|
/**
|
* kbase_csf_mcu_shared_set_group_csg_reg_active - Notify that the group is active on-slot with
|
* scheduling action. Essential runtime resources
|
* are bound with the group for it to run
|
*
|
* @kbdev: Instance of a GPU platform device that implements a CSF interface.
|
* @group: Pointer to the group that is placed into active on-slot running by the scheduler.
|
*
|
*/
|
void kbase_csf_mcu_shared_set_group_csg_reg_active(struct kbase_device *kbdev,
|
struct kbase_queue_group *group);
|
|
/**
|
* kbase_csf_mcu_shared_set_group_csg_reg_unused - Notify that the group is placed off-slot with
|
* scheduling action. Some of bound runtime
|
* resources can be reallocated for others to use
|
*
|
* @kbdev: Instance of a GPU platform device that implements a CSF interface.
|
* @group: Pointer to the group that is placed off-slot by the scheduler.
|
*
|
*/
|
void kbase_csf_mcu_shared_set_group_csg_reg_unused(struct kbase_device *kbdev,
|
struct kbase_queue_group *group);
|
|
/**
|
* kbase_csf_mcu_shared_group_update_pmode_map - Request to update the given group's protected
|
* suspend buffer pages to be mapped for supporting
|
* protected mode operations.
|
*
|
* @kbdev: Instance of a GPU platform device that implements a CSF interface.
|
* @group: Pointer to the group for attempting a protected mode suspend buffer binding/mapping.
|
*
|
* Return: 0 for success, the group has a protected suspend buffer region mapped. Otherwise an
|
* error code is returned.
|
*/
|
int kbase_csf_mcu_shared_group_update_pmode_map(struct kbase_device *kbdev,
|
struct kbase_queue_group *group);
|
|
/**
|
* kbase_csf_mcu_shared_clear_evicted_group_csg_reg - Clear any bound regions/mappings as the
|
* given group is evicted out of the runtime
|
* operations.
|
*
|
* @kbdev: Instance of a GPU platform device that implements a CSF interface.
|
* @group: Pointer to the group that has been evicted out of set of operational groups.
|
*
|
* This function will taken away any of the bindings/mappings immediately so the resources
|
* are not tied up to the given group, which has been evicted out of scheduling action for
|
* termination.
|
*/
|
void kbase_csf_mcu_shared_clear_evicted_group_csg_reg(struct kbase_device *kbdev,
|
struct kbase_queue_group *group);
|
|
/**
|
* kbase_csf_mcu_shared_add_queue - Request to add a newly activated queue for a group to be
|
* run on slot.
|
*
|
* @kbdev: Instance of a GPU platform device that implements a CSF interface.
|
* @queue: Pointer to the queue that requires some runtime resource to be bound for joining
|
* others that are already running on-slot with their bound group.
|
*
|
* Return: 0 on success, or negative on failure.
|
*/
|
int kbase_csf_mcu_shared_add_queue(struct kbase_device *kbdev, struct kbase_queue *queue);
|
|
/**
|
* kbase_csf_mcu_shared_drop_stopped_queue - Request to drop a queue after it has been stopped
|
* from its operational state from a group.
|
*
|
* @kbdev: Instance of a GPU platform device that implements a CSF interface.
|
* @queue: Pointer to the queue that has been stopped from operational state.
|
*
|
*/
|
void kbase_csf_mcu_shared_drop_stopped_queue(struct kbase_device *kbdev, struct kbase_queue *queue);
|
|
/**
|
* kbase_csf_mcu_shared_group_bind_csg_reg - Bind some required runtime resources to the given
|
* group for ready to run on-slot.
|
*
|
* @kbdev: Instance of a GPU platform device that implements a CSF interface.
|
* @group: Pointer to the queue group that requires the runtime resources.
|
*
|
* This function binds/maps the required suspend buffer pages and userio pages for the given
|
* group, readying it to run on-slot.
|
*
|
* Return: 0 on success, or negative on failure.
|
*/
|
int kbase_csf_mcu_shared_group_bind_csg_reg(struct kbase_device *kbdev,
|
struct kbase_queue_group *group);
|
|
/**
|
* kbase_csf_mcu_shared_regs_data_init - Allocate and initialize the MCU shared regions data for
|
* the given device.
|
*
|
* @kbdev: Instance of a GPU platform device that implements a CSF interface.
|
*
|
* This function allocate and initialize the MCU shared VA regions for runtime operations
|
* of the CSF scheduler.
|
*
|
* Return: 0 on success, or an error code.
|
*/
|
int kbase_csf_mcu_shared_regs_data_init(struct kbase_device *kbdev);
|
|
/**
|
* kbase_csf_mcu_shared_regs_data_term - Terminate the allocated MCU shared regions data for
|
* the given device.
|
*
|
* @kbdev: Instance of a GPU platform device that implements a CSF interface.
|
*
|
* This function terminates the MCU shared VA regions allocated for runtime operations
|
* of the CSF scheduler.
|
*/
|
void kbase_csf_mcu_shared_regs_data_term(struct kbase_device *kbdev);
|
|
#endif /* _KBASE_CSF_MCU_SHARED_REG_H_ */
|
