1/* SPDX-License-Identifier: MIT */
 2/*
 3 * Copyright © 2022 Intel Corporation
 4 */
 5
 6#ifndef _XE_GT_H_
 7#define _XE_GT_H_
 8
 9#include <drm/drm_util.h>
10
11#include "xe_device_types.h"
12#include "xe_hw_engine.h"
13
14#define for_each_hw_engine(hwe__, gt__, id__) \
15	for ((id__) = 0; (id__) < ARRAY_SIZE((gt__)->hw_engines); (id__)++) \
16		for_each_if(((hwe__) = (gt__)->hw_engines + (id__)) && \
17			  xe_hw_engine_is_valid((hwe__)))
18
19#define CCS_MASK(gt) (((gt)->info.engine_mask & XE_HW_ENGINE_CCS_MASK) >> XE_HW_ENGINE_CCS0)
20
21#ifdef CONFIG_FAULT_INJECTION
22#include <linux/fault-inject.h> /* XXX: fault-inject.h is broken */
23extern struct fault_attr gt_reset_failure;
24static inline bool xe_fault_inject_gt_reset(void)
25{
26	return should_fail(&gt_reset_failure, 1);
27}
28#else
29static inline bool xe_fault_inject_gt_reset(void)
30{
31	return false;
32}
33#endif
34
35struct xe_gt *xe_gt_alloc(struct xe_tile *tile);
36int xe_gt_init_early(struct xe_gt *gt);
37int xe_gt_init(struct xe_gt *gt);
38int xe_gt_record_default_lrcs(struct xe_gt *gt);
39void xe_gt_suspend_prepare(struct xe_gt *gt);
40int xe_gt_suspend(struct xe_gt *gt);
41int xe_gt_resume(struct xe_gt *gt);
42void xe_gt_reset_async(struct xe_gt *gt);
43void xe_gt_sanitize(struct xe_gt *gt);
44
45/**
46 * xe_gt_any_hw_engine_by_reset_domain - scan the list of engines and return the
47 * first that matches the same reset domain as @class
48 * @gt: GT structure
49 * @class: hw engine class to lookup
50 */
51struct xe_hw_engine *
52xe_gt_any_hw_engine_by_reset_domain(struct xe_gt *gt, enum xe_engine_class class);
53
54struct xe_hw_engine *xe_gt_hw_engine(struct xe_gt *gt,
55				     enum xe_engine_class class,
56				     u16 instance,
57				     bool logical);
58
59static inline bool xe_gt_is_media_type(struct xe_gt *gt)
60{
61	return gt->info.type == XE_GT_TYPE_MEDIA;
62}
63
64static inline bool xe_gt_is_usm_hwe(struct xe_gt *gt, struct xe_hw_engine *hwe)
65{
66	struct xe_device *xe = gt_to_xe(gt);
67
68	return xe->info.has_usm && hwe->class == XE_ENGINE_CLASS_COPY &&
69		hwe->instance == gt->usm.reserved_bcs_instance;
70}
71
72#endif