xref: /linux/drivers/gpu/drm/xe/xe_guc.h (revision c21614d5c0e76cf1d7a864f15d495fd3e5876acc)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2022 Intel Corporation
4  */
5 
6 #ifndef _XE_GUC_H_
7 #define _XE_GUC_H_
8 
9 #include "xe_gt.h"
10 #include "xe_guc_types.h"
11 #include "xe_hw_engine_types.h"
12 #include "xe_macros.h"
13 
14 struct drm_printer;
15 
16 void xe_guc_comm_init_early(struct xe_guc *guc);
17 int xe_guc_init(struct xe_guc *guc);
18 int xe_guc_init_post_hwconfig(struct xe_guc *guc);
19 int xe_guc_post_load_init(struct xe_guc *guc);
20 int xe_guc_reset(struct xe_guc *guc);
21 int xe_guc_upload(struct xe_guc *guc);
22 int xe_guc_min_load_for_hwconfig(struct xe_guc *guc);
23 int xe_guc_enable_communication(struct xe_guc *guc);
24 int xe_guc_suspend(struct xe_guc *guc);
25 void xe_guc_notify(struct xe_guc *guc);
26 int xe_guc_auth_huc(struct xe_guc *guc, u32 rsa_addr);
27 int xe_guc_mmio_send(struct xe_guc *guc, const u32 *request, u32 len);
28 int xe_guc_mmio_send_recv(struct xe_guc *guc, const u32 *request, u32 len,
29 			  u32 *response_buf);
30 int xe_guc_self_cfg32(struct xe_guc *guc, u16 key, u32 val);
31 int xe_guc_self_cfg64(struct xe_guc *guc, u16 key, u64 val);
32 void xe_guc_irq_handler(struct xe_guc *guc, const u16 iir);
33 void xe_guc_sanitize(struct xe_guc *guc);
34 void xe_guc_print_info(struct xe_guc *guc, struct drm_printer *p);
35 int xe_guc_reset_prepare(struct xe_guc *guc);
36 void xe_guc_reset_wait(struct xe_guc *guc);
37 void xe_guc_stop_prepare(struct xe_guc *guc);
38 int xe_guc_stop(struct xe_guc *guc);
39 int xe_guc_start(struct xe_guc *guc);
40 bool xe_guc_in_reset(struct xe_guc *guc);
41 
42 static inline u16 xe_engine_class_to_guc_class(enum xe_engine_class class)
43 {
44 	switch (class) {
45 	case XE_ENGINE_CLASS_RENDER:
46 		return GUC_RENDER_CLASS;
47 	case XE_ENGINE_CLASS_VIDEO_DECODE:
48 		return GUC_VIDEO_CLASS;
49 	case XE_ENGINE_CLASS_VIDEO_ENHANCE:
50 		return GUC_VIDEOENHANCE_CLASS;
51 	case XE_ENGINE_CLASS_COPY:
52 		return GUC_BLITTER_CLASS;
53 	case XE_ENGINE_CLASS_COMPUTE:
54 		return GUC_COMPUTE_CLASS;
55 	case XE_ENGINE_CLASS_OTHER:
56 		return GUC_GSC_OTHER_CLASS;
57 	default:
58 		XE_WARN_ON(class);
59 		return -1;
60 	}
61 }
62 
63 static inline struct xe_gt *guc_to_gt(struct xe_guc *guc)
64 {
65 	return container_of(guc, struct xe_gt, uc.guc);
66 }
67 
68 static inline struct xe_device *guc_to_xe(struct xe_guc *guc)
69 {
70 	return gt_to_xe(guc_to_gt(guc));
71 }
72 
73 #endif
74