xref: /linux/drivers/gpu/drm/i915/gt/intel_engine_pm.h (revision 03c11eb3b16dc0058589751dfd91f254be2be613)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2019 Intel Corporation
4  */
5 
6 #ifndef INTEL_ENGINE_PM_H
7 #define INTEL_ENGINE_PM_H
8 
9 #include "i915_drv.h"
10 #include "i915_request.h"
11 #include "intel_engine_types.h"
12 #include "intel_wakeref.h"
13 #include "intel_gt.h"
14 #include "intel_gt_pm.h"
15 
16 static inline bool
intel_engine_pm_is_awake(const struct intel_engine_cs * engine)17 intel_engine_pm_is_awake(const struct intel_engine_cs *engine)
18 {
19 	return intel_wakeref_is_active(&engine->wakeref);
20 }
21 
__intel_engine_pm_get(struct intel_engine_cs * engine)22 static inline void __intel_engine_pm_get(struct intel_engine_cs *engine)
23 {
24 	__intel_wakeref_get(&engine->wakeref);
25 }
26 
intel_engine_pm_get(struct intel_engine_cs * engine)27 static inline void intel_engine_pm_get(struct intel_engine_cs *engine)
28 {
29 	intel_wakeref_get(&engine->wakeref);
30 }
31 
intel_engine_pm_get_if_awake(struct intel_engine_cs * engine)32 static inline bool intel_engine_pm_get_if_awake(struct intel_engine_cs *engine)
33 {
34 	return intel_wakeref_get_if_active(&engine->wakeref);
35 }
36 
intel_engine_pm_might_get(struct intel_engine_cs * engine)37 static inline void intel_engine_pm_might_get(struct intel_engine_cs *engine)
38 {
39 	if (!intel_engine_is_virtual(engine)) {
40 		intel_wakeref_might_get(&engine->wakeref);
41 	} else {
42 		struct intel_gt *gt = engine->gt;
43 		struct intel_engine_cs *tengine;
44 		intel_engine_mask_t tmp, mask = engine->mask;
45 
46 		for_each_engine_masked(tengine, gt, mask, tmp)
47 			intel_wakeref_might_get(&tengine->wakeref);
48 	}
49 	intel_gt_pm_might_get(engine->gt);
50 }
51 
intel_engine_pm_put(struct intel_engine_cs * engine)52 static inline void intel_engine_pm_put(struct intel_engine_cs *engine)
53 {
54 	intel_wakeref_put(&engine->wakeref);
55 }
56 
intel_engine_pm_put_async(struct intel_engine_cs * engine)57 static inline void intel_engine_pm_put_async(struct intel_engine_cs *engine)
58 {
59 	intel_wakeref_put_async(&engine->wakeref);
60 }
61 
intel_engine_pm_put_delay(struct intel_engine_cs * engine,unsigned long delay)62 static inline void intel_engine_pm_put_delay(struct intel_engine_cs *engine,
63 					     unsigned long delay)
64 {
65 	intel_wakeref_put_delay(&engine->wakeref, delay);
66 }
67 
intel_engine_pm_flush(struct intel_engine_cs * engine)68 static inline void intel_engine_pm_flush(struct intel_engine_cs *engine)
69 {
70 	intel_wakeref_unlock_wait(&engine->wakeref);
71 }
72 
intel_engine_pm_might_put(struct intel_engine_cs * engine)73 static inline void intel_engine_pm_might_put(struct intel_engine_cs *engine)
74 {
75 	if (!intel_engine_is_virtual(engine)) {
76 		intel_wakeref_might_put(&engine->wakeref);
77 	} else {
78 		struct intel_gt *gt = engine->gt;
79 		struct intel_engine_cs *tengine;
80 		intel_engine_mask_t tmp, mask = engine->mask;
81 
82 		for_each_engine_masked(tengine, gt, mask, tmp)
83 			intel_wakeref_might_put(&tengine->wakeref);
84 	}
85 	intel_gt_pm_might_put(engine->gt);
86 }
87 
88 static inline struct i915_request *
intel_engine_create_kernel_request(struct intel_engine_cs * engine)89 intel_engine_create_kernel_request(struct intel_engine_cs *engine)
90 {
91 	struct i915_request *rq;
92 
93 	/*
94 	 * The engine->kernel_context is special as it is used inside
95 	 * the engine-pm barrier (see __engine_park()), circumventing
96 	 * the usual mutexes and relying on the engine-pm barrier
97 	 * instead. So whenever we use the engine->kernel_context
98 	 * outside of the barrier, we must manually handle the
99 	 * engine wakeref to serialise with the use inside.
100 	 */
101 	intel_engine_pm_get(engine);
102 	rq = i915_request_create(engine->kernel_context);
103 	intel_engine_pm_put(engine);
104 
105 	return rq;
106 }
107 
108 void intel_engine_init__pm(struct intel_engine_cs *engine);
109 
110 void intel_engine_reset_pinned_contexts(struct intel_engine_cs *engine);
111 
112 #endif /* INTEL_ENGINE_PM_H */
113