1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun *
4*4882a593Smuzhiyun * (C) COPYRIGHT 2013-2014, 2016, 2019-2021 ARM Limited. All rights reserved.
5*4882a593Smuzhiyun *
6*4882a593Smuzhiyun * This program is free software and is provided to you under the terms of the
7*4882a593Smuzhiyun * GNU General Public License version 2 as published by the Free Software
8*4882a593Smuzhiyun * Foundation, and any use by you of this program is subject to the terms
9*4882a593Smuzhiyun * of such GNU license.
10*4882a593Smuzhiyun *
11*4882a593Smuzhiyun * This program is distributed in the hope that it will be useful,
12*4882a593Smuzhiyun * but WITHOUT ANY WARRANTY; without even the implied warranty of
13*4882a593Smuzhiyun * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14*4882a593Smuzhiyun * GNU General Public License for more details.
15*4882a593Smuzhiyun *
16*4882a593Smuzhiyun * You should have received a copy of the GNU General Public License
17*4882a593Smuzhiyun * along with this program; if not, you can access it online at
18*4882a593Smuzhiyun * http://www.gnu.org/licenses/gpl-2.0.html.
19*4882a593Smuzhiyun *
20*4882a593Smuzhiyun */
21*4882a593Smuzhiyun
22*4882a593Smuzhiyun /*
23*4882a593Smuzhiyun * Job manager common APIs
24*4882a593Smuzhiyun */
25*4882a593Smuzhiyun
26*4882a593Smuzhiyun #ifndef _KBASE_JM_H_
27*4882a593Smuzhiyun #define _KBASE_JM_H_
28*4882a593Smuzhiyun
29*4882a593Smuzhiyun #if !MALI_USE_CSF
30*4882a593Smuzhiyun /**
31*4882a593Smuzhiyun * kbase_jm_kick() - Indicate that there are jobs ready to run.
32*4882a593Smuzhiyun * @kbdev: Device pointer
33*4882a593Smuzhiyun * @js_mask: Mask of the job slots that can be pulled from.
34*4882a593Smuzhiyun *
35*4882a593Smuzhiyun * Caller must hold the hwaccess_lock and schedule_sem semaphore
36*4882a593Smuzhiyun *
37*4882a593Smuzhiyun * Return: Mask of the job slots that can still be submitted to.
38*4882a593Smuzhiyun */
39*4882a593Smuzhiyun u32 kbase_jm_kick(struct kbase_device *kbdev, u32 js_mask);
40*4882a593Smuzhiyun
41*4882a593Smuzhiyun /**
42*4882a593Smuzhiyun * kbase_jm_kick_all() - Indicate that there are jobs ready to run on all job
43*4882a593Smuzhiyun * slots.
44*4882a593Smuzhiyun * @kbdev: Device pointer
45*4882a593Smuzhiyun *
46*4882a593Smuzhiyun * Caller must hold the hwaccess_lock and schedule_sem semaphore
47*4882a593Smuzhiyun *
48*4882a593Smuzhiyun * Return: Mask of the job slots that can still be submitted to.
49*4882a593Smuzhiyun */
kbase_jm_kick_all(struct kbase_device * kbdev)50*4882a593Smuzhiyun static inline u32 kbase_jm_kick_all(struct kbase_device *kbdev)
51*4882a593Smuzhiyun {
52*4882a593Smuzhiyun return kbase_jm_kick(kbdev, (1 << kbdev->gpu_props.num_job_slots) - 1);
53*4882a593Smuzhiyun }
54*4882a593Smuzhiyun
55*4882a593Smuzhiyun /**
56*4882a593Smuzhiyun * kbase_jm_try_kick - Attempt to call kbase_jm_kick
57*4882a593Smuzhiyun * @kbdev: Device pointer
58*4882a593Smuzhiyun * @js_mask: Mask of the job slots that can be pulled from
59*4882a593Smuzhiyun * Context: Caller must hold hwaccess_lock
60*4882a593Smuzhiyun *
61*4882a593Smuzhiyun * If schedule_sem can be immediately obtained then this function will call
62*4882a593Smuzhiyun * kbase_jm_kick() otherwise it will do nothing.
63*4882a593Smuzhiyun */
64*4882a593Smuzhiyun void kbase_jm_try_kick(struct kbase_device *kbdev, u32 js_mask);
65*4882a593Smuzhiyun
66*4882a593Smuzhiyun /**
67*4882a593Smuzhiyun * kbase_jm_try_kick_all() - Attempt to call kbase_jm_kick_all
68*4882a593Smuzhiyun * @kbdev: Device pointer
69*4882a593Smuzhiyun * Context: Caller must hold hwaccess_lock
70*4882a593Smuzhiyun *
71*4882a593Smuzhiyun * If schedule_sem can be immediately obtained then this function will call
72*4882a593Smuzhiyun * kbase_jm_kick_all() otherwise it will do nothing.
73*4882a593Smuzhiyun */
74*4882a593Smuzhiyun void kbase_jm_try_kick_all(struct kbase_device *kbdev);
75*4882a593Smuzhiyun #endif /* !MALI_USE_CSF */
76*4882a593Smuzhiyun
77*4882a593Smuzhiyun #if !MALI_USE_CSF
78*4882a593Smuzhiyun /**
79*4882a593Smuzhiyun * kbase_jm_idle_ctx() - Mark a context as idle.
80*4882a593Smuzhiyun * @kbdev: Device pointer
81*4882a593Smuzhiyun * @kctx: Context to mark as idle
82*4882a593Smuzhiyun *
83*4882a593Smuzhiyun * No more atoms will be pulled from this context until it is marked as active
84*4882a593Smuzhiyun * by kbase_js_use_ctx().
85*4882a593Smuzhiyun *
86*4882a593Smuzhiyun * The context should have no atoms currently pulled from it
87*4882a593Smuzhiyun * (kbase_jsctx_atoms_pulled(kctx) == 0).
88*4882a593Smuzhiyun *
89*4882a593Smuzhiyun * Caller must hold the hwaccess_lock
90*4882a593Smuzhiyun */
91*4882a593Smuzhiyun void kbase_jm_idle_ctx(struct kbase_device *kbdev, struct kbase_context *kctx);
92*4882a593Smuzhiyun
93*4882a593Smuzhiyun /**
94*4882a593Smuzhiyun * kbase_jm_return_atom_to_js() - Return an atom to the job scheduler that has
95*4882a593Smuzhiyun * been soft-stopped or will fail due to a
96*4882a593Smuzhiyun * dependency
97*4882a593Smuzhiyun * @kbdev: Device pointer
98*4882a593Smuzhiyun * @katom: Atom that has been stopped or will be failed
99*4882a593Smuzhiyun *
100*4882a593Smuzhiyun * Return: Atom that has now been unblocked and can now be run, or NULL if none
101*4882a593Smuzhiyun */
102*4882a593Smuzhiyun struct kbase_jd_atom *kbase_jm_return_atom_to_js(struct kbase_device *kbdev,
103*4882a593Smuzhiyun struct kbase_jd_atom *katom);
104*4882a593Smuzhiyun
105*4882a593Smuzhiyun /**
106*4882a593Smuzhiyun * kbase_jm_complete() - Complete an atom
107*4882a593Smuzhiyun * @kbdev: Device pointer
108*4882a593Smuzhiyun * @katom: Atom that has completed
109*4882a593Smuzhiyun * @end_timestamp: Timestamp of atom completion
110*4882a593Smuzhiyun *
111*4882a593Smuzhiyun * Return: Atom that has now been unblocked and can now be run, or NULL if none
112*4882a593Smuzhiyun */
113*4882a593Smuzhiyun struct kbase_jd_atom *kbase_jm_complete(struct kbase_device *kbdev,
114*4882a593Smuzhiyun struct kbase_jd_atom *katom, ktime_t *end_timestamp);
115*4882a593Smuzhiyun #endif /* !MALI_USE_CSF */
116*4882a593Smuzhiyun
117*4882a593Smuzhiyun #endif /* _KBASE_JM_H_ */
118