1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * Tegra host1x Interrupt Management 4 * 5 * Copyright (c) 2010-2013, NVIDIA Corporation. 6 */ 7 8 #ifndef __HOST1X_INTR_H 9 #define __HOST1X_INTR_H 10 11 #include <linux/interrupt.h> 12 #include <linux/workqueue.h> 13 14 struct host1x_syncpt; 15 struct host1x; 16 17 enum host1x_intr_action { 18 /* 19 * Perform cleanup after a submit has completed. 20 * 'data' points to a channel 21 */ 22 HOST1X_INTR_ACTION_SUBMIT_COMPLETE = 0, 23 24 /* 25 * Wake up a task. 26 * 'data' points to a wait_queue_head_t 27 */ 28 HOST1X_INTR_ACTION_WAKEUP, 29 30 /* 31 * Wake up a interruptible task. 32 * 'data' points to a wait_queue_head_t 33 */ 34 HOST1X_INTR_ACTION_WAKEUP_INTERRUPTIBLE, 35 36 HOST1X_INTR_ACTION_SIGNAL_FENCE, 37 38 HOST1X_INTR_ACTION_COUNT 39 }; 40 41 struct host1x_syncpt_intr { 42 spinlock_t lock; 43 struct list_head wait_head; 44 char thresh_irq_name[12]; 45 struct work_struct work; 46 }; 47 48 struct host1x_waitlist { 49 struct list_head list; 50 struct kref refcount; 51 u32 thresh; 52 enum host1x_intr_action action; 53 atomic_t state; 54 void *data; 55 int count; 56 }; 57 58 /* 59 * Schedule an action to be taken when a sync point reaches the given threshold. 60 * 61 * @id the sync point 62 * @thresh the threshold 63 * @action the action to take 64 * @data a pointer to extra data depending on action, see above 65 * @waiter waiter structure - assumes ownership 66 * @ref must be passed if cancellation is possible, else NULL 67 * 68 * This is a non-blocking api. 69 */ 70 int host1x_intr_add_action(struct host1x *host, struct host1x_syncpt *syncpt, 71 u32 thresh, enum host1x_intr_action action, 72 void *data, struct host1x_waitlist *waiter, 73 void **ref); 74 75 /* 76 * Unreference an action submitted to host1x_intr_add_action(). 77 * You must call this if you passed non-NULL as ref. 78 * @ref the ref returned from host1x_intr_add_action() 79 * @flush wait until any pending handlers have completed before returning. 80 */ 81 void host1x_intr_put_ref(struct host1x *host, unsigned int id, void *ref, 82 bool flush); 83 84 /* Initialize host1x sync point interrupt */ 85 int host1x_intr_init(struct host1x *host, unsigned int irq_sync); 86 87 /* Deinitialize host1x sync point interrupt */ 88 void host1x_intr_deinit(struct host1x *host); 89 90 /* Enable host1x sync point interrupt */ 91 void host1x_intr_start(struct host1x *host); 92 93 /* Disable host1x sync point interrupt */ 94 void host1x_intr_stop(struct host1x *host); 95 96 irqreturn_t host1x_syncpt_thresh_fn(void *dev_id); 97 #endif 98