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.h" 12 #include "xe_device_types.h" 13 #include "xe_hw_engine.h" 14 15 #define for_each_hw_engine(hwe__, gt__, id__) \ 16 for ((id__) = 0; (id__) < ARRAY_SIZE((gt__)->hw_engines); (id__)++) \ 17 for_each_if(((hwe__) = (gt__)->hw_engines + (id__)) && \ 18 xe_hw_engine_is_valid((hwe__))) 19 20 #define CCS_MASK(gt) (((gt)->info.engine_mask & XE_HW_ENGINE_CCS_MASK) >> XE_HW_ENGINE_CCS0) 21 22 #ifdef CONFIG_FAULT_INJECTION 23 #include <linux/fault-inject.h> /* XXX: fault-inject.h is broken */ 24 extern struct fault_attr gt_reset_failure; 25 static inline bool xe_fault_inject_gt_reset(void) 26 { 27 return should_fail(>_reset_failure, 1); 28 } 29 #else 30 static inline bool xe_fault_inject_gt_reset(void) 31 { 32 return false; 33 } 34 #endif 35 36 struct xe_gt *xe_gt_alloc(struct xe_tile *tile); 37 int xe_gt_init_hwconfig(struct xe_gt *gt); 38 int xe_gt_init_early(struct xe_gt *gt); 39 int xe_gt_init(struct xe_gt *gt); 40 void xe_gt_declare_wedged(struct xe_gt *gt); 41 int xe_gt_record_default_lrcs(struct xe_gt *gt); 42 43 /** 44 * xe_gt_record_user_engines - save data related to engines available to 45 * usersapce 46 * @gt: GT structure 47 * 48 * Walk the available HW engines from gt->info.engine_mask and calculate data 49 * related to those engines that may be used by userspace. To be used whenever 50 * available engines change in runtime (e.g. with ccs_mode) or during 51 * initialization 52 */ 53 void xe_gt_record_user_engines(struct xe_gt *gt); 54 55 void xe_gt_suspend_prepare(struct xe_gt *gt); 56 int xe_gt_suspend(struct xe_gt *gt); 57 int xe_gt_resume(struct xe_gt *gt); 58 void xe_gt_reset_async(struct xe_gt *gt); 59 void xe_gt_sanitize(struct xe_gt *gt); 60 int xe_gt_sanitize_freq(struct xe_gt *gt); 61 void xe_gt_remove(struct xe_gt *gt); 62 63 /** 64 * xe_gt_any_hw_engine_by_reset_domain - scan the list of engines and return the 65 * first that matches the same reset domain as @class 66 * @gt: GT structure 67 * @class: hw engine class to lookup 68 */ 69 struct xe_hw_engine * 70 xe_gt_any_hw_engine_by_reset_domain(struct xe_gt *gt, enum xe_engine_class class); 71 72 /** 73 * xe_gt_any_hw_engine - scan the list of engines and return the 74 * first available 75 * @gt: GT structure 76 */ 77 struct xe_hw_engine *xe_gt_any_hw_engine(struct xe_gt *gt); 78 79 struct xe_hw_engine *xe_gt_hw_engine(struct xe_gt *gt, 80 enum xe_engine_class class, 81 u16 instance, 82 bool logical); 83 84 static inline bool xe_gt_has_indirect_ring_state(struct xe_gt *gt) 85 { 86 return gt->info.has_indirect_ring_state && 87 xe_device_uc_enabled(gt_to_xe(gt)); 88 } 89 90 static inline bool xe_gt_is_media_type(struct xe_gt *gt) 91 { 92 return gt->info.type == XE_GT_TYPE_MEDIA; 93 } 94 95 static inline bool xe_gt_is_usm_hwe(struct xe_gt *gt, struct xe_hw_engine *hwe) 96 { 97 struct xe_device *xe = gt_to_xe(gt); 98 99 return xe->info.has_usm && hwe->class == XE_ENGINE_CLASS_COPY && 100 hwe->instance == gt->usm.reserved_bcs_instance; 101 } 102 103 #endif 104