xref: /linux/drivers/gpu/drm/xe/xe_guc_ct.h (revision 917b10d90990fd2138b5dbc2d22cfa428c070ade)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2022 Intel Corporation
4  */
5 
6 #ifndef _XE_GUC_CT_H_
7 #define _XE_GUC_CT_H_
8 
9 #include "xe_guc_ct_types.h"
10 
11 struct drm_printer;
12 struct xe_device;
13 
14 int xe_guc_ct_init(struct xe_guc_ct *ct);
15 int xe_guc_ct_enable(struct xe_guc_ct *ct);
16 void xe_guc_ct_disable(struct xe_guc_ct *ct);
17 void xe_guc_ct_stop(struct xe_guc_ct *ct);
18 void xe_guc_ct_fast_path(struct xe_guc_ct *ct);
19 
20 struct xe_guc_ct_snapshot *xe_guc_ct_snapshot_capture(struct xe_guc_ct *ct);
21 void xe_guc_ct_snapshot_print(struct xe_guc_ct_snapshot *snapshot, struct drm_printer *p);
22 void xe_guc_ct_snapshot_free(struct xe_guc_ct_snapshot *snapshot);
23 void xe_guc_ct_print(struct xe_guc_ct *ct, struct drm_printer *p, bool want_ctb);
24 
25 void xe_guc_ct_fixup_messages_with_ggtt(struct xe_guc_ct *ct, s64 ggtt_shift);
26 
27 static inline bool xe_guc_ct_initialized(struct xe_guc_ct *ct)
28 {
29 	return ct->state != XE_GUC_CT_STATE_NOT_INITIALIZED;
30 }
31 
32 static inline bool xe_guc_ct_enabled(struct xe_guc_ct *ct)
33 {
34 	return ct->state == XE_GUC_CT_STATE_ENABLED;
35 }
36 
37 static inline void xe_guc_ct_irq_handler(struct xe_guc_ct *ct)
38 {
39 	if (!xe_guc_ct_enabled(ct))
40 		return;
41 
42 	wake_up_all(&ct->wq);
43 	queue_work(ct->g2h_wq, &ct->g2h_worker);
44 	xe_guc_ct_fast_path(ct);
45 }
46 
47 /* Basic CT send / receives */
48 int xe_guc_ct_send(struct xe_guc_ct *ct, const u32 *action, u32 len,
49 		   u32 g2h_len, u32 num_g2h);
50 int xe_guc_ct_send_locked(struct xe_guc_ct *ct, const u32 *action, u32 len,
51 			  u32 g2h_len, u32 num_g2h);
52 int xe_guc_ct_send_recv(struct xe_guc_ct *ct, const u32 *action, u32 len,
53 			u32 *response_buffer);
54 static inline int
55 xe_guc_ct_send_block(struct xe_guc_ct *ct, const u32 *action, u32 len)
56 {
57 	return xe_guc_ct_send_recv(ct, action, len, NULL);
58 }
59 
60 /* This is only version of the send CT you can call from a G2H handler */
61 int xe_guc_ct_send_g2h_handler(struct xe_guc_ct *ct, const u32 *action,
62 			       u32 len);
63 
64 /* Can't fail because a GT reset is in progress */
65 int xe_guc_ct_send_recv_no_fail(struct xe_guc_ct *ct, const u32 *action,
66 				u32 len, u32 *response_buffer);
67 static inline int
68 xe_guc_ct_send_block_no_fail(struct xe_guc_ct *ct, const u32 *action, u32 len)
69 {
70 	return xe_guc_ct_send_recv_no_fail(ct, action, len, NULL);
71 }
72 
73 long xe_guc_ct_queue_proc_time_jiffies(struct xe_guc_ct *ct);
74 
75 #endif
76