/*
|
*
|
* (C) COPYRIGHT 2012-2015 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 licence.
|
*
|
* A copy of the licence is included with the program, and can also be obtained
|
* from Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
* Boston, MA 02110-1301, USA.
|
*
|
*/
|
|
|
|
|
|
/**
|
* @file mali_kbase_js_ctx_attr.h
|
* Job Scheduler Context Attribute APIs
|
*/
|
|
#ifndef _KBASE_JS_CTX_ATTR_H_
|
#define _KBASE_JS_CTX_ATTR_H_
|
|
/**
|
* @addtogroup base_api
|
* @{
|
*/
|
|
/**
|
* @addtogroup base_kbase_api
|
* @{
|
*/
|
|
/**
|
* @addtogroup kbase_js
|
* @{
|
*/
|
|
/**
|
* Set the initial attributes of a context (when context create flags are set)
|
*
|
* Requires:
|
* - Hold the jsctx_mutex
|
*/
|
void kbasep_js_ctx_attr_set_initial_attrs(struct kbase_device *kbdev, struct kbase_context *kctx);
|
|
/**
|
* Retain all attributes of a context
|
*
|
* This occurs on scheduling in the context on the runpool (but after
|
* is_scheduled is set)
|
*
|
* Requires:
|
* - jsctx mutex
|
* - runpool_irq spinlock
|
* - ctx->is_scheduled is true
|
*/
|
void kbasep_js_ctx_attr_runpool_retain_ctx(struct kbase_device *kbdev, struct kbase_context *kctx);
|
|
/**
|
* Release all attributes of a context
|
*
|
* This occurs on scheduling out the context from the runpool (but before
|
* is_scheduled is cleared)
|
*
|
* Requires:
|
* - jsctx mutex
|
* - runpool_irq spinlock
|
* - ctx->is_scheduled is true
|
*
|
* @return true indicates a change in ctx attributes state of the runpool.
|
* In this state, the scheduler might be able to submit more jobs than
|
* previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock()
|
* or similar is called sometime later.
|
* @return false indicates no change in ctx attributes state of the runpool.
|
*/
|
bool kbasep_js_ctx_attr_runpool_release_ctx(struct kbase_device *kbdev, struct kbase_context *kctx);
|
|
/**
|
* Retain all attributes of an atom
|
*
|
* This occurs on adding an atom to a context
|
*
|
* Requires:
|
* - jsctx mutex
|
* - If the context is scheduled, then runpool_irq spinlock must also be held
|
*/
|
void kbasep_js_ctx_attr_ctx_retain_atom(struct kbase_device *kbdev, struct kbase_context *kctx, struct kbase_jd_atom *katom);
|
|
/**
|
* Release all attributes of an atom, given its retained state.
|
*
|
* This occurs after (permanently) removing an atom from a context
|
*
|
* Requires:
|
* - jsctx mutex
|
* - If the context is scheduled, then runpool_irq spinlock must also be held
|
*
|
* This is a no-op when \a katom_retained_state is invalid.
|
*
|
* @return true indicates a change in ctx attributes state of the runpool.
|
* In this state, the scheduler might be able to submit more jobs than
|
* previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock()
|
* or similar is called sometime later.
|
* @return false indicates no change in ctx attributes state of the runpool.
|
*/
|
bool kbasep_js_ctx_attr_ctx_release_atom(struct kbase_device *kbdev, struct kbase_context *kctx, struct kbasep_js_atom_retained_state *katom_retained_state);
|
|
/**
|
* Requires:
|
* - runpool_irq spinlock
|
*/
|
static inline s8 kbasep_js_ctx_attr_count_on_runpool(struct kbase_device *kbdev, enum kbasep_js_ctx_attr attribute)
|
{
|
struct kbasep_js_device_data *js_devdata;
|
|
KBASE_DEBUG_ASSERT(kbdev != NULL);
|
KBASE_DEBUG_ASSERT(attribute < KBASEP_JS_CTX_ATTR_COUNT);
|
js_devdata = &kbdev->js_data;
|
|
return js_devdata->runpool_irq.ctx_attr_ref_count[attribute];
|
}
|
|
/**
|
* Requires:
|
* - runpool_irq spinlock
|
*/
|
static inline bool kbasep_js_ctx_attr_is_attr_on_runpool(struct kbase_device *kbdev, enum kbasep_js_ctx_attr attribute)
|
{
|
/* In general, attributes are 'on' when they have a non-zero refcount (note: the refcount will never be < 0) */
|
return (bool) kbasep_js_ctx_attr_count_on_runpool(kbdev, attribute);
|
}
|
|
/**
|
* Requires:
|
* - jsctx mutex
|
*/
|
static inline bool kbasep_js_ctx_attr_is_attr_on_ctx(struct kbase_context *kctx, enum kbasep_js_ctx_attr attribute)
|
{
|
struct kbasep_js_kctx_info *js_kctx_info;
|
|
KBASE_DEBUG_ASSERT(kctx != NULL);
|
KBASE_DEBUG_ASSERT(attribute < KBASEP_JS_CTX_ATTR_COUNT);
|
js_kctx_info = &kctx->jctx.sched_info;
|
|
/* In general, attributes are 'on' when they have a refcount (which should never be < 0) */
|
return (bool) (js_kctx_info->ctx.ctx_attr_ref_count[attribute]);
|
}
|
|
/** @} *//* end group kbase_js */
|
/** @} *//* end group base_kbase_api */
|
/** @} *//* end group base_api */
|
|
#endif /* _KBASE_JS_DEFS_H_ */
|
