1 // SPDX-License-Identifier: GPL-2.0-only
3 * Tegra host1x Syncpoints
5 * Copyright (c) 2010-2015, NVIDIA Corporation.
8 #include <linux/module.h>
9 #include <linux/device.h>
10 #include <linux/slab.h>
12 #include <trace/events/host1x.h>
19 #define SYNCPT_CHECK_PERIOD (2 * HZ)
20 #define MAX_STUCK_CHECK_COUNT 15
22 static struct host1x_syncpt_base
*
23 host1x_syncpt_base_request(struct host1x
*host
)
25 struct host1x_syncpt_base
*bases
= host
->bases
;
28 for (i
= 0; i
< host
->info
->nb_bases
; i
++)
29 if (!bases
[i
].requested
)
32 if (i
>= host
->info
->nb_bases
)
35 bases
[i
].requested
= true;
39 static void host1x_syncpt_base_free(struct host1x_syncpt_base
*base
)
42 base
->requested
= false;
45 static struct host1x_syncpt
*host1x_syncpt_alloc(struct host1x
*host
,
46 struct host1x_client
*client
,
49 struct host1x_syncpt
*sp
= host
->syncpt
;
53 mutex_lock(&host
->syncpt_mutex
);
55 for (i
= 0; i
< host
->info
->nb_pts
&& sp
->name
; i
++, sp
++)
58 if (i
>= host
->info
->nb_pts
)
61 if (flags
& HOST1X_SYNCPT_HAS_BASE
) {
62 sp
->base
= host1x_syncpt_base_request(host
);
67 name
= kasprintf(GFP_KERNEL
, "%02u-%s", sp
->id
,
68 client
? dev_name(client
->dev
) : NULL
);
75 if (flags
& HOST1X_SYNCPT_CLIENT_MANAGED
)
76 sp
->client_managed
= true;
78 sp
->client_managed
= false;
80 mutex_unlock(&host
->syncpt_mutex
);
84 host1x_syncpt_base_free(sp
->base
);
87 mutex_unlock(&host
->syncpt_mutex
);
92 * host1x_syncpt_id() - retrieve syncpoint ID
93 * @sp: host1x syncpoint
95 * Given a pointer to a struct host1x_syncpt, retrieves its ID. This ID is
96 * often used as a value to program into registers that control how hardware
97 * blocks interact with syncpoints.
99 u32
host1x_syncpt_id(struct host1x_syncpt
*sp
)
103 EXPORT_SYMBOL(host1x_syncpt_id
);
106 * host1x_syncpt_incr_max() - update the value sent to hardware
107 * @sp: host1x syncpoint
108 * @incrs: number of increments
110 u32
host1x_syncpt_incr_max(struct host1x_syncpt
*sp
, u32 incrs
)
112 return (u32
)atomic_add_return(incrs
, &sp
->max_val
);
114 EXPORT_SYMBOL(host1x_syncpt_incr_max
);
117 * Write cached syncpoint and waitbase values to hardware.
119 void host1x_syncpt_restore(struct host1x
*host
)
121 struct host1x_syncpt
*sp_base
= host
->syncpt
;
124 for (i
= 0; i
< host1x_syncpt_nb_pts(host
); i
++)
125 host1x_hw_syncpt_restore(host
, sp_base
+ i
);
127 for (i
= 0; i
< host1x_syncpt_nb_bases(host
); i
++)
128 host1x_hw_syncpt_restore_wait_base(host
, sp_base
+ i
);
134 * Update the cached syncpoint and waitbase values by reading them
135 * from the registers.
137 void host1x_syncpt_save(struct host1x
*host
)
139 struct host1x_syncpt
*sp_base
= host
->syncpt
;
142 for (i
= 0; i
< host1x_syncpt_nb_pts(host
); i
++) {
143 if (host1x_syncpt_client_managed(sp_base
+ i
))
144 host1x_hw_syncpt_load(host
, sp_base
+ i
);
146 WARN_ON(!host1x_syncpt_idle(sp_base
+ i
));
149 for (i
= 0; i
< host1x_syncpt_nb_bases(host
); i
++)
150 host1x_hw_syncpt_load_wait_base(host
, sp_base
+ i
);
154 * Updates the cached syncpoint value by reading a new value from the hardware
157 u32
host1x_syncpt_load(struct host1x_syncpt
*sp
)
161 val
= host1x_hw_syncpt_load(sp
->host
, sp
);
162 trace_host1x_syncpt_load_min(sp
->id
, val
);
168 * Get the current syncpoint base
170 u32
host1x_syncpt_load_wait_base(struct host1x_syncpt
*sp
)
172 host1x_hw_syncpt_load_wait_base(sp
->host
, sp
);
178 * host1x_syncpt_incr() - increment syncpoint value from CPU, updating cache
179 * @sp: host1x syncpoint
181 int host1x_syncpt_incr(struct host1x_syncpt
*sp
)
183 return host1x_hw_syncpt_cpu_incr(sp
->host
, sp
);
185 EXPORT_SYMBOL(host1x_syncpt_incr
);
188 * Updated sync point form hardware, and returns true if syncpoint is expired,
189 * false if we may need to wait
191 static bool syncpt_load_min_is_expired(struct host1x_syncpt
*sp
, u32 thresh
)
193 host1x_hw_syncpt_load(sp
->host
, sp
);
195 return host1x_syncpt_is_expired(sp
, thresh
);
199 * host1x_syncpt_wait() - wait for a syncpoint to reach a given value
200 * @sp: host1x syncpoint
202 * @timeout: maximum time to wait for the syncpoint to reach the given value
203 * @value: return location for the syncpoint value
205 int host1x_syncpt_wait(struct host1x_syncpt
*sp
, u32 thresh
, long timeout
,
208 DECLARE_WAIT_QUEUE_HEAD_ONSTACK(wq
);
210 struct host1x_waitlist
*waiter
;
211 int err
= 0, check_count
= 0;
217 /* first check cache */
218 if (host1x_syncpt_is_expired(sp
, thresh
)) {
220 *value
= host1x_syncpt_load(sp
);
225 /* try to read from register */
226 val
= host1x_hw_syncpt_load(sp
->host
, sp
);
227 if (host1x_syncpt_is_expired(sp
, thresh
)) {
239 /* allocate a waiter */
240 waiter
= kzalloc(sizeof(*waiter
), GFP_KERNEL
);
246 /* schedule a wakeup when the syncpoint value is reached */
247 err
= host1x_intr_add_action(sp
->host
, sp
, thresh
,
248 HOST1X_INTR_ACTION_WAKEUP_INTERRUPTIBLE
,
254 /* Caller-specified timeout may be impractically low */
258 /* wait for the syncpoint, or timeout, or signal */
260 long check
= min_t(long, SYNCPT_CHECK_PERIOD
, timeout
);
263 remain
= wait_event_interruptible_timeout(wq
,
264 syncpt_load_min_is_expired(sp
, thresh
),
266 if (remain
> 0 || host1x_syncpt_is_expired(sp
, thresh
)) {
268 *value
= host1x_syncpt_load(sp
);
282 if (timeout
&& check_count
<= MAX_STUCK_CHECK_COUNT
) {
283 dev_warn(sp
->host
->dev
,
284 "%s: syncpoint id %u (%s) stuck waiting %d, timeout=%ld\n",
285 current
->comm
, sp
->id
, sp
->name
,
288 host1x_debug_dump_syncpts(sp
->host
);
290 if (check_count
== MAX_STUCK_CHECK_COUNT
)
291 host1x_debug_dump(sp
->host
);
297 host1x_intr_put_ref(sp
->host
, sp
->id
, ref
);
302 EXPORT_SYMBOL(host1x_syncpt_wait
);
305 * Returns true if syncpoint is expired, false if we may need to wait
307 bool host1x_syncpt_is_expired(struct host1x_syncpt
*sp
, u32 thresh
)
314 current_val
= (u32
)atomic_read(&sp
->min_val
);
315 future_val
= (u32
)atomic_read(&sp
->max_val
);
317 /* Note the use of unsigned arithmetic here (mod 1<<32).
319 * c = current_val = min_val = the current value of the syncpoint.
320 * t = thresh = the value we are checking
321 * f = future_val = max_val = the value c will reach when all
322 * outstanding increments have completed.
324 * Note that c always chases f until it reaches f.
329 * Consider all cases:
331 * A) .....c..t..f..... Dtf < Dtc need to wait
332 * B) .....c.....f..t.. Dtf > Dtc expired
333 * C) ..t..c.....f..... Dtf > Dtc expired (Dct very large)
335 * Any case where f==c: always expired (for any t). Dtf == Dcf
336 * Any case where t==c: always expired (for any f). Dtf >= Dtc (because Dtc==0)
337 * Any case where t==f!=c: always wait. Dtf < Dtc (because Dtf==0,
342 * A) .....t..f..c..... Dtf < Dtc need to wait
343 * A) .....f..c..t..... Dtf < Dtc need to wait
344 * A) .....f..t..c..... Dtf > Dtc expired
347 * Dtf >= Dtc implies EXPIRED (return true)
348 * Dtf < Dtc implies WAIT (return false)
350 * Note: If t is expired then we *cannot* wait on it. We would wait
351 * forever (hang the system).
353 * Note: do NOT get clever and remove the -thresh from both sides. It
356 * If future valueis zero, we have a client managed sync point. In that
357 * case we do a direct comparison.
359 if (!host1x_syncpt_client_managed(sp
))
360 return future_val
- thresh
>= current_val
- thresh
;
362 return (s32
)(current_val
- thresh
) >= 0;
365 int host1x_syncpt_init(struct host1x
*host
)
367 struct host1x_syncpt_base
*bases
;
368 struct host1x_syncpt
*syncpt
;
371 syncpt
= devm_kcalloc(host
->dev
, host
->info
->nb_pts
, sizeof(*syncpt
),
376 bases
= devm_kcalloc(host
->dev
, host
->info
->nb_bases
, sizeof(*bases
),
381 for (i
= 0; i
< host
->info
->nb_pts
; i
++) {
383 syncpt
[i
].host
= host
;
386 * Unassign syncpt from channels for purposes of Tegra186
387 * syncpoint protection. This prevents any channel from
388 * accessing it until it is reassigned.
390 host1x_hw_syncpt_assign_to_channel(host
, &syncpt
[i
], NULL
);
393 for (i
= 0; i
< host
->info
->nb_bases
; i
++)
396 mutex_init(&host
->syncpt_mutex
);
397 host
->syncpt
= syncpt
;
400 host1x_syncpt_restore(host
);
401 host1x_hw_syncpt_enable_protection(host
);
403 /* Allocate sync point to use for clearing waits for expired fences */
404 host
->nop_sp
= host1x_syncpt_alloc(host
, NULL
, 0);
412 * host1x_syncpt_request() - request a syncpoint
413 * @client: client requesting the syncpoint
416 * host1x client drivers can use this function to allocate a syncpoint for
417 * subsequent use. A syncpoint returned by this function will be reserved for
418 * use by the client exclusively. When no longer using a syncpoint, a host1x
419 * client driver needs to release it using host1x_syncpt_free().
421 struct host1x_syncpt
*host1x_syncpt_request(struct host1x_client
*client
,
424 struct host1x
*host
= dev_get_drvdata(client
->host
->parent
);
426 return host1x_syncpt_alloc(host
, client
, flags
);
428 EXPORT_SYMBOL(host1x_syncpt_request
);
431 * host1x_syncpt_free() - free a requested syncpoint
432 * @sp: host1x syncpoint
434 * Release a syncpoint previously allocated using host1x_syncpt_request(). A
435 * host1x client driver should call this when the syncpoint is no longer in
436 * use. Note that client drivers must ensure that the syncpoint doesn't remain
437 * under the control of hardware after calling this function, otherwise two
438 * clients may end up trying to access the same syncpoint concurrently.
440 void host1x_syncpt_free(struct host1x_syncpt
*sp
)
445 mutex_lock(&sp
->host
->syncpt_mutex
);
447 host1x_syncpt_base_free(sp
->base
);
452 sp
->client_managed
= false;
454 mutex_unlock(&sp
->host
->syncpt_mutex
);
456 EXPORT_SYMBOL(host1x_syncpt_free
);
458 void host1x_syncpt_deinit(struct host1x
*host
)
460 struct host1x_syncpt
*sp
= host
->syncpt
;
463 for (i
= 0; i
< host
->info
->nb_pts
; i
++, sp
++)
468 * host1x_syncpt_read_max() - read maximum syncpoint value
469 * @sp: host1x syncpoint
471 * The maximum syncpoint value indicates how many operations there are in
472 * queue, either in channel or in a software thread.
474 u32
host1x_syncpt_read_max(struct host1x_syncpt
*sp
)
478 return (u32
)atomic_read(&sp
->max_val
);
480 EXPORT_SYMBOL(host1x_syncpt_read_max
);
483 * host1x_syncpt_read_min() - read minimum syncpoint value
484 * @sp: host1x syncpoint
486 * The minimum syncpoint value is a shadow of the current sync point value in
489 u32
host1x_syncpt_read_min(struct host1x_syncpt
*sp
)
493 return (u32
)atomic_read(&sp
->min_val
);
495 EXPORT_SYMBOL(host1x_syncpt_read_min
);
498 * host1x_syncpt_read() - read the current syncpoint value
499 * @sp: host1x syncpoint
501 u32
host1x_syncpt_read(struct host1x_syncpt
*sp
)
503 return host1x_syncpt_load(sp
);
505 EXPORT_SYMBOL(host1x_syncpt_read
);
507 unsigned int host1x_syncpt_nb_pts(struct host1x
*host
)
509 return host
->info
->nb_pts
;
512 unsigned int host1x_syncpt_nb_bases(struct host1x
*host
)
514 return host
->info
->nb_bases
;
517 unsigned int host1x_syncpt_nb_mlocks(struct host1x
*host
)
519 return host
->info
->nb_mlocks
;
523 * host1x_syncpt_get() - obtain a syncpoint by ID
524 * @host: host1x controller
527 struct host1x_syncpt
*host1x_syncpt_get(struct host1x
*host
, unsigned int id
)
529 if (id
>= host
->info
->nb_pts
)
532 return host
->syncpt
+ id
;
534 EXPORT_SYMBOL(host1x_syncpt_get
);
537 * host1x_syncpt_get_base() - obtain the wait base associated with a syncpoint
538 * @sp: host1x syncpoint
540 struct host1x_syncpt_base
*host1x_syncpt_get_base(struct host1x_syncpt
*sp
)
542 return sp
? sp
->base
: NULL
;
544 EXPORT_SYMBOL(host1x_syncpt_get_base
);
547 * host1x_syncpt_base_id() - retrieve the ID of a syncpoint wait base
548 * @base: host1x syncpoint wait base
550 u32
host1x_syncpt_base_id(struct host1x_syncpt_base
*base
)
554 EXPORT_SYMBOL(host1x_syncpt_base_id
);