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,
24 u32 flags, u64 extensions);
25 struct xe_exec_queue *xe_exec_queue_create_bind(struct xe_device *xe,
26 struct xe_tile *tile,
27 u32 flags, u64 extensions);
28
29 void xe_exec_queue_fini(struct xe_exec_queue *q);
30 void xe_exec_queue_destroy(struct kref *ref);
31 void xe_exec_queue_assign_name(struct xe_exec_queue *q, u32 instance);
32
33 static inline struct xe_exec_queue *
xe_exec_queue_get_unless_zero(struct xe_exec_queue * q)34 xe_exec_queue_get_unless_zero(struct xe_exec_queue *q)
35 {
36 if (kref_get_unless_zero(&q->refcount))
37 return q;
38
39 return NULL;
40 }
41
42 struct xe_exec_queue *xe_exec_queue_lookup(struct xe_file *xef, u32 id);
43
xe_exec_queue_get(struct xe_exec_queue * q)44 static inline struct xe_exec_queue *xe_exec_queue_get(struct xe_exec_queue *q)
45 {
46 kref_get(&q->refcount);
47 return q;
48 }
49
xe_exec_queue_put(struct xe_exec_queue * q)50 static inline void xe_exec_queue_put(struct xe_exec_queue *q)
51 {
52 kref_put(&q->refcount, xe_exec_queue_destroy);
53 }
54
xe_exec_queue_is_parallel(struct xe_exec_queue * q)55 static inline bool xe_exec_queue_is_parallel(struct xe_exec_queue *q)
56 {
57 return q->width > 1;
58 }
59
xe_exec_queue_uses_pxp(struct xe_exec_queue * q)60 static inline bool xe_exec_queue_uses_pxp(struct xe_exec_queue *q)
61 {
62 return q->pxp.type;
63 }
64
65 bool xe_exec_queue_is_lr(struct xe_exec_queue *q);
66
67 bool xe_exec_queue_ring_full(struct xe_exec_queue *q);
68
69 bool xe_exec_queue_is_idle(struct xe_exec_queue *q);
70
71 void xe_exec_queue_kill(struct xe_exec_queue *q);
72
73 int xe_exec_queue_create_ioctl(struct drm_device *dev, void *data,
74 struct drm_file *file);
75 int xe_exec_queue_destroy_ioctl(struct drm_device *dev, void *data,
76 struct drm_file *file);
77 int xe_exec_queue_get_property_ioctl(struct drm_device *dev, void *data,
78 struct drm_file *file);
79 enum xe_exec_queue_priority xe_exec_queue_device_get_max_priority(struct xe_device *xe);
80
81 void xe_exec_queue_last_fence_put(struct xe_exec_queue *e, struct xe_vm *vm);
82 void xe_exec_queue_last_fence_put_unlocked(struct xe_exec_queue *e);
83 struct dma_fence *xe_exec_queue_last_fence_get(struct xe_exec_queue *e,
84 struct xe_vm *vm);
85 struct dma_fence *xe_exec_queue_last_fence_get_for_resume(struct xe_exec_queue *e,
86 struct xe_vm *vm);
87 void xe_exec_queue_last_fence_set(struct xe_exec_queue *e, struct xe_vm *vm,
88 struct dma_fence *fence);
89 int xe_exec_queue_last_fence_test_dep(struct xe_exec_queue *q,
90 struct xe_vm *vm);
91 void xe_exec_queue_update_run_ticks(struct xe_exec_queue *q);
92
93 #endif
94