xref: /openbmc/linux/drivers/gpu/host1x/syncpt.h (revision e3d786a3)
1 /*
2  * Tegra host1x Syncpoints
3  *
4  * Copyright (c) 2010-2013, NVIDIA Corporation.
5  *
6  * This program is free software; you can redistribute it and/or modify it
7  * under the terms and conditions of the GNU General Public License,
8  * version 2, as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope it will be useful, but WITHOUT
11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
13  * more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
17  */
18 
19 #ifndef __HOST1X_SYNCPT_H
20 #define __HOST1X_SYNCPT_H
21 
22 #include <linux/atomic.h>
23 #include <linux/host1x.h>
24 #include <linux/kernel.h>
25 #include <linux/sched.h>
26 
27 #include "intr.h"
28 
29 struct host1x;
30 
31 /* Reserved for replacing an expired wait with a NOP */
32 #define HOST1X_SYNCPT_RESERVED			0
33 
34 struct host1x_syncpt_base {
35 	unsigned int id;
36 	bool requested;
37 };
38 
39 struct host1x_syncpt {
40 	unsigned int id;
41 	atomic_t min_val;
42 	atomic_t max_val;
43 	u32 base_val;
44 	const char *name;
45 	bool client_managed;
46 	struct host1x *host;
47 	struct host1x_client *client;
48 	struct host1x_syncpt_base *base;
49 
50 	/* interrupt data */
51 	struct host1x_syncpt_intr intr;
52 };
53 
54 /* Initialize sync point array  */
55 int host1x_syncpt_init(struct host1x *host);
56 
57 /*  Free sync point array */
58 void host1x_syncpt_deinit(struct host1x *host);
59 
60 /* Return number of sync point supported. */
61 unsigned int host1x_syncpt_nb_pts(struct host1x *host);
62 
63 /* Return number of wait bases supported. */
64 unsigned int host1x_syncpt_nb_bases(struct host1x *host);
65 
66 /* Return number of mlocks supported. */
67 unsigned int host1x_syncpt_nb_mlocks(struct host1x *host);
68 
69 /*
70  * Check sync point sanity. If max is larger than min, there have too many
71  * sync point increments.
72  *
73  * Client managed sync point are not tracked.
74  * */
75 static inline bool host1x_syncpt_check_max(struct host1x_syncpt *sp, u32 real)
76 {
77 	u32 max;
78 	if (sp->client_managed)
79 		return true;
80 	max = host1x_syncpt_read_max(sp);
81 	return (s32)(max - real) >= 0;
82 }
83 
84 /* Return true if sync point is client managed. */
85 static inline bool host1x_syncpt_client_managed(struct host1x_syncpt *sp)
86 {
87 	return sp->client_managed;
88 }
89 
90 /*
91  * Returns true if syncpoint min == max, which means that there are no
92  * outstanding operations.
93  */
94 static inline bool host1x_syncpt_idle(struct host1x_syncpt *sp)
95 {
96 	int min, max;
97 	smp_rmb();
98 	min = atomic_read(&sp->min_val);
99 	max = atomic_read(&sp->max_val);
100 	return (min == max);
101 }
102 
103 /* Load current value from hardware to the shadow register. */
104 u32 host1x_syncpt_load(struct host1x_syncpt *sp);
105 
106 /* Check if the given syncpoint value has already passed */
107 bool host1x_syncpt_is_expired(struct host1x_syncpt *sp, u32 thresh);
108 
109 /* Save host1x sync point state into shadow registers. */
110 void host1x_syncpt_save(struct host1x *host);
111 
112 /* Reset host1x sync point state from shadow registers. */
113 void host1x_syncpt_restore(struct host1x *host);
114 
115 /* Read current wait base value into shadow register and return it. */
116 u32 host1x_syncpt_load_wait_base(struct host1x_syncpt *sp);
117 
118 /* Indicate future operations by incrementing the sync point max. */
119 u32 host1x_syncpt_incr_max(struct host1x_syncpt *sp, u32 incrs);
120 
121 /* Check if sync point id is valid. */
122 static inline int host1x_syncpt_is_valid(struct host1x_syncpt *sp)
123 {
124 	return sp->id < host1x_syncpt_nb_pts(sp->host);
125 }
126 
127 #endif
128