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;
46 * host1x_syncpt_alloc() - allocate a syncpoint
47 * @host: host1x device data
48 * @flags: bitfield of HOST1X_SYNCPT_* flags
49 * @name: name for the syncpoint for use in debug prints
51 * Allocates a hardware syncpoint for the caller's use. The caller then has
52 * the sole authority to mutate the syncpoint's value until it is freed again.
54 * If no free syncpoints are available, or a NULL name was specified, returns
57 struct host1x_syncpt *host1x_syncpt_alloc(struct host1x *host,
61 struct host1x_syncpt *sp = host->syncpt;
68 mutex_lock(&host->syncpt_mutex);
70 for (i = 0; i < host->info->nb_pts && kref_read(&sp->ref); i++, sp++)
73 if (i >= host->info->nb_pts)
76 if (flags & HOST1X_SYNCPT_HAS_BASE) {
77 sp->base = host1x_syncpt_base_request(host);
82 full_name = kasprintf(GFP_KERNEL, "%u-%s", sp->id, name);
88 if (flags & HOST1X_SYNCPT_CLIENT_MANAGED)
89 sp->client_managed = true;
91 sp->client_managed = false;
95 mutex_unlock(&host->syncpt_mutex);
99 host1x_syncpt_base_free(sp->base);
102 mutex_unlock(&host->syncpt_mutex);
105 EXPORT_SYMBOL(host1x_syncpt_alloc);
108 * host1x_syncpt_id() - retrieve syncpoint ID
109 * @sp: host1x syncpoint
111 * Given a pointer to a struct host1x_syncpt, retrieves its ID. This ID is
112 * often used as a value to program into registers that control how hardware
113 * blocks interact with syncpoints.
115 u32 host1x_syncpt_id(struct host1x_syncpt *sp)
119 EXPORT_SYMBOL(host1x_syncpt_id);
122 * host1x_syncpt_incr_max() - update the value sent to hardware
123 * @sp: host1x syncpoint
124 * @incrs: number of increments
126 u32 host1x_syncpt_incr_max(struct host1x_syncpt *sp, u32 incrs)
128 return (u32)atomic_add_return(incrs, &sp->max_val);
130 EXPORT_SYMBOL(host1x_syncpt_incr_max);
133 * Write cached syncpoint and waitbase values to hardware.
135 void host1x_syncpt_restore(struct host1x *host)
137 struct host1x_syncpt *sp_base = host->syncpt;
140 for (i = 0; i < host1x_syncpt_nb_pts(host); i++)
141 host1x_hw_syncpt_restore(host, sp_base + i);
143 for (i = 0; i < host1x_syncpt_nb_bases(host); i++)
144 host1x_hw_syncpt_restore_wait_base(host, sp_base + i);
150 * Update the cached syncpoint and waitbase values by reading them
151 * from the registers.
153 void host1x_syncpt_save(struct host1x *host)
155 struct host1x_syncpt *sp_base = host->syncpt;
158 for (i = 0; i < host1x_syncpt_nb_pts(host); i++) {
159 if (host1x_syncpt_client_managed(sp_base + i))
160 host1x_hw_syncpt_load(host, sp_base + i);
162 WARN_ON(!host1x_syncpt_idle(sp_base + i));
165 for (i = 0; i < host1x_syncpt_nb_bases(host); i++)
166 host1x_hw_syncpt_load_wait_base(host, sp_base + i);
170 * Updates the cached syncpoint value by reading a new value from the hardware
173 u32 host1x_syncpt_load(struct host1x_syncpt *sp)
177 val = host1x_hw_syncpt_load(sp->host, sp);
178 trace_host1x_syncpt_load_min(sp->id, val);
184 * Get the current syncpoint base
186 u32 host1x_syncpt_load_wait_base(struct host1x_syncpt *sp)
188 host1x_hw_syncpt_load_wait_base(sp->host, sp);
194 * host1x_syncpt_incr() - increment syncpoint value from CPU, updating cache
195 * @sp: host1x syncpoint
197 int host1x_syncpt_incr(struct host1x_syncpt *sp)
199 return host1x_hw_syncpt_cpu_incr(sp->host, sp);
201 EXPORT_SYMBOL(host1x_syncpt_incr);
204 * Updated sync point form hardware, and returns true if syncpoint is expired,
205 * false if we may need to wait
207 static bool syncpt_load_min_is_expired(struct host1x_syncpt *sp, u32 thresh)
209 host1x_hw_syncpt_load(sp->host, sp);
211 return host1x_syncpt_is_expired(sp, thresh);
215 * host1x_syncpt_wait() - wait for a syncpoint to reach a given value
216 * @sp: host1x syncpoint
218 * @timeout: maximum time to wait for the syncpoint to reach the given value
219 * @value: return location for the syncpoint value
221 int host1x_syncpt_wait(struct host1x_syncpt *sp, u32 thresh, long timeout,
224 DECLARE_WAIT_QUEUE_HEAD_ONSTACK(wq);
226 struct host1x_waitlist *waiter;
227 int err = 0, check_count = 0;
233 /* first check cache */
234 if (host1x_syncpt_is_expired(sp, thresh)) {
236 *value = host1x_syncpt_load(sp);
241 /* try to read from register */
242 val = host1x_hw_syncpt_load(sp->host, sp);
243 if (host1x_syncpt_is_expired(sp, thresh)) {
255 /* allocate a waiter */
256 waiter = kzalloc(sizeof(*waiter), GFP_KERNEL);
262 /* schedule a wakeup when the syncpoint value is reached */
263 err = host1x_intr_add_action(sp->host, sp, thresh,
264 HOST1X_INTR_ACTION_WAKEUP_INTERRUPTIBLE,
270 /* Caller-specified timeout may be impractically low */
274 /* wait for the syncpoint, or timeout, or signal */
276 long check = min_t(long, SYNCPT_CHECK_PERIOD, timeout);
279 remain = wait_event_interruptible_timeout(wq,
280 syncpt_load_min_is_expired(sp, thresh),
282 if (remain > 0 || host1x_syncpt_is_expired(sp, thresh)) {
284 *value = host1x_syncpt_load(sp);
298 if (timeout && check_count <= MAX_STUCK_CHECK_COUNT) {
299 dev_warn(sp->host->dev,
300 "%s: syncpoint id %u (%s) stuck waiting %d, timeout=%ld\n",
301 current->comm, sp->id, sp->name,
304 host1x_debug_dump_syncpts(sp->host);
306 if (check_count == MAX_STUCK_CHECK_COUNT)
307 host1x_debug_dump(sp->host);
313 host1x_intr_put_ref(sp->host, sp->id, ref, true);
318 EXPORT_SYMBOL(host1x_syncpt_wait);
321 * Returns true if syncpoint is expired, false if we may need to wait
323 bool host1x_syncpt_is_expired(struct host1x_syncpt *sp, u32 thresh)
329 current_val = (u32)atomic_read(&sp->min_val);
331 return ((current_val - thresh) & 0x80000000U) == 0U;
334 int host1x_syncpt_init(struct host1x *host)
336 struct host1x_syncpt_base *bases;
337 struct host1x_syncpt *syncpt;
340 syncpt = devm_kcalloc(host->dev, host->info->nb_pts, sizeof(*syncpt),
345 bases = devm_kcalloc(host->dev, host->info->nb_bases, sizeof(*bases),
350 for (i = 0; i < host->info->nb_pts; i++) {
352 syncpt[i].host = host;
355 * Unassign syncpt from channels for purposes of Tegra186
356 * syncpoint protection. This prevents any channel from
357 * accessing it until it is reassigned.
359 host1x_hw_syncpt_assign_to_channel(host, &syncpt[i], NULL);
362 for (i = 0; i < host->info->nb_bases; i++)
365 mutex_init(&host->syncpt_mutex);
366 host->syncpt = syncpt;
369 host1x_syncpt_restore(host);
370 host1x_hw_syncpt_enable_protection(host);
372 /* Allocate sync point to use for clearing waits for expired fences */
373 host->nop_sp = host1x_syncpt_alloc(host, 0, "reserved-nop");
377 if (host->info->reserve_vblank_syncpts) {
378 kref_init(&host->syncpt[26].ref);
379 kref_init(&host->syncpt[27].ref);
386 * host1x_syncpt_request() - request a syncpoint
387 * @client: client requesting the syncpoint
390 * host1x client drivers can use this function to allocate a syncpoint for
391 * subsequent use. A syncpoint returned by this function will be reserved for
392 * use by the client exclusively. When no longer using a syncpoint, a host1x
393 * client driver needs to release it using host1x_syncpt_put().
395 struct host1x_syncpt *host1x_syncpt_request(struct host1x_client *client,
398 struct host1x *host = dev_get_drvdata(client->host->parent);
400 return host1x_syncpt_alloc(host, flags, dev_name(client->dev));
402 EXPORT_SYMBOL(host1x_syncpt_request);
404 static void syncpt_release(struct kref *ref)
406 struct host1x_syncpt *sp = container_of(ref, struct host1x_syncpt, ref);
408 atomic_set(&sp->max_val, host1x_syncpt_read(sp));
412 mutex_lock(&sp->host->syncpt_mutex);
414 host1x_syncpt_base_free(sp->base);
418 sp->client_managed = false;
420 mutex_unlock(&sp->host->syncpt_mutex);
424 * host1x_syncpt_put() - free a requested syncpoint
425 * @sp: host1x syncpoint
427 * Release a syncpoint previously allocated using host1x_syncpt_request(). A
428 * host1x client driver should call this when the syncpoint is no longer in
431 void host1x_syncpt_put(struct host1x_syncpt *sp)
436 kref_put(&sp->ref, syncpt_release);
438 EXPORT_SYMBOL(host1x_syncpt_put);
440 void host1x_syncpt_deinit(struct host1x *host)
442 struct host1x_syncpt *sp = host->syncpt;
445 for (i = 0; i < host->info->nb_pts; i++, sp++)
450 * host1x_syncpt_read_max() - read maximum syncpoint value
451 * @sp: host1x syncpoint
453 * The maximum syncpoint value indicates how many operations there are in
454 * queue, either in channel or in a software thread.
456 u32 host1x_syncpt_read_max(struct host1x_syncpt *sp)
460 return (u32)atomic_read(&sp->max_val);
462 EXPORT_SYMBOL(host1x_syncpt_read_max);
465 * host1x_syncpt_read_min() - read minimum syncpoint value
466 * @sp: host1x syncpoint
468 * The minimum syncpoint value is a shadow of the current sync point value in
471 u32 host1x_syncpt_read_min(struct host1x_syncpt *sp)
475 return (u32)atomic_read(&sp->min_val);
477 EXPORT_SYMBOL(host1x_syncpt_read_min);
480 * host1x_syncpt_read() - read the current syncpoint value
481 * @sp: host1x syncpoint
483 u32 host1x_syncpt_read(struct host1x_syncpt *sp)
485 return host1x_syncpt_load(sp);
487 EXPORT_SYMBOL(host1x_syncpt_read);
489 unsigned int host1x_syncpt_nb_pts(struct host1x *host)
491 return host->info->nb_pts;
494 unsigned int host1x_syncpt_nb_bases(struct host1x *host)
496 return host->info->nb_bases;
499 unsigned int host1x_syncpt_nb_mlocks(struct host1x *host)
501 return host->info->nb_mlocks;
505 * host1x_syncpt_get_by_id() - obtain a syncpoint by ID
506 * @host: host1x controller
509 struct host1x_syncpt *host1x_syncpt_get_by_id(struct host1x *host,
512 if (id >= host->info->nb_pts)
515 if (kref_get_unless_zero(&host->syncpt[id].ref))
516 return &host->syncpt[id];
520 EXPORT_SYMBOL(host1x_syncpt_get_by_id);
523 * host1x_syncpt_get_by_id_noref() - obtain a syncpoint by ID but don't
524 * increase the refcount.
525 * @host: host1x controller
528 struct host1x_syncpt *host1x_syncpt_get_by_id_noref(struct host1x *host,
531 if (id >= host->info->nb_pts)
534 return &host->syncpt[id];
536 EXPORT_SYMBOL(host1x_syncpt_get_by_id_noref);
539 * host1x_syncpt_get() - increment syncpoint refcount
542 struct host1x_syncpt *host1x_syncpt_get(struct host1x_syncpt *sp)
548 EXPORT_SYMBOL(host1x_syncpt_get);
551 * host1x_syncpt_get_base() - obtain the wait base associated with a syncpoint
552 * @sp: host1x syncpoint
554 struct host1x_syncpt_base *host1x_syncpt_get_base(struct host1x_syncpt *sp)
556 return sp ? sp->base : NULL;
558 EXPORT_SYMBOL(host1x_syncpt_get_base);
561 * host1x_syncpt_base_id() - retrieve the ID of a syncpoint wait base
562 * @base: host1x syncpoint wait base
564 u32 host1x_syncpt_base_id(struct host1x_syncpt_base *base)
568 EXPORT_SYMBOL(host1x_syncpt_base_id);
570 static void do_nothing(struct kref *ref)
575 * host1x_syncpt_release_vblank_reservation() - Make VBLANK syncpoint
576 * available for allocation
578 * @client: host1x bus client
579 * @syncpt_id: syncpoint ID to make available
581 * Makes VBLANK<i> syncpoint available for allocatation if it was
582 * reserved at initialization time. This should be called by the display
583 * driver after it has ensured that any VBLANK increment programming configured
584 * by the boot chain has been disabled.
586 void host1x_syncpt_release_vblank_reservation(struct host1x_client *client,
589 struct host1x *host = dev_get_drvdata(client->host->parent);
591 if (!host->info->reserve_vblank_syncpts)
594 kref_put(&host->syncpt[syncpt_id].ref, do_nothing);
596 EXPORT_SYMBOL(host1x_syncpt_release_vblank_reservation);