xref: /linux/drivers/gpu/drm/xe/xe_exec_queue.h (revision f879306834818ebd1722a4372079610cdd466fec)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2021 Intel Corporation
4  */
5 
6 #ifndef _XE_EXEC_QUEUE_H_
7 #define _XE_EXEC_QUEUE_H_
8 
9 #include "xe_exec_queue_types.h"
10 #include "xe_vm_types.h"
11 
12 struct drm_device;
13 struct drm_file;
14 struct xe_device;
15 struct xe_file;
16 
17 struct xe_exec_queue *xe_exec_queue_create(struct xe_device *xe, struct xe_vm *vm,
18 					   u32 logical_mask, u16 width,
19 					   struct xe_hw_engine *hw_engine, u32 flags,
20 					   u64 extensions);
21 struct xe_exec_queue *xe_exec_queue_create_class(struct xe_device *xe, struct xe_gt *gt,
22 						 struct xe_vm *vm,
23 						 enum xe_engine_class class, u32 flags);
24 
25 void xe_exec_queue_fini(struct xe_exec_queue *q);
26 void xe_exec_queue_destroy(struct kref *ref);
27 void xe_exec_queue_assign_name(struct xe_exec_queue *q, u32 instance);
28 
29 static inline struct xe_exec_queue *
30 xe_exec_queue_get_unless_zero(struct xe_exec_queue *q)
31 {
32 	if (kref_get_unless_zero(&q->refcount))
33 		return q;
34 
35 	return NULL;
36 }
37 
38 struct xe_exec_queue *xe_exec_queue_lookup(struct xe_file *xef, u32 id);
39 
40 static inline struct xe_exec_queue *xe_exec_queue_get(struct xe_exec_queue *q)
41 {
42 	kref_get(&q->refcount);
43 	return q;
44 }
45 
46 static inline void xe_exec_queue_put(struct xe_exec_queue *q)
47 {
48 	kref_put(&q->refcount, xe_exec_queue_destroy);
49 }
50 
51 static inline bool xe_exec_queue_is_parallel(struct xe_exec_queue *q)
52 {
53 	return q->width > 1;
54 }
55 
56 bool xe_exec_queue_is_lr(struct xe_exec_queue *q);
57 
58 bool xe_exec_queue_ring_full(struct xe_exec_queue *q);
59 
60 bool xe_exec_queue_is_idle(struct xe_exec_queue *q);
61 
62 void xe_exec_queue_kill(struct xe_exec_queue *q);
63 
64 int xe_exec_queue_create_ioctl(struct drm_device *dev, void *data,
65 			       struct drm_file *file);
66 int xe_exec_queue_destroy_ioctl(struct drm_device *dev, void *data,
67 				struct drm_file *file);
68 int xe_exec_queue_get_property_ioctl(struct drm_device *dev, void *data,
69 				     struct drm_file *file);
70 enum xe_exec_queue_priority xe_exec_queue_device_get_max_priority(struct xe_device *xe);
71 
72 void xe_exec_queue_last_fence_put(struct xe_exec_queue *e, struct xe_vm *vm);
73 void xe_exec_queue_last_fence_put_unlocked(struct xe_exec_queue *e);
74 struct dma_fence *xe_exec_queue_last_fence_get(struct xe_exec_queue *e,
75 					       struct xe_vm *vm);
76 void xe_exec_queue_last_fence_set(struct xe_exec_queue *e, struct xe_vm *vm,
77 				  struct dma_fence *fence);
78 void xe_exec_queue_update_run_ticks(struct xe_exec_queue *q);
79 
80 #endif
81