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_request.h"
10 #include "intel_engine_types.h"
11 #include "intel_wakeref.h"
12 
13 static inline bool
intel_engine_pm_is_awake(const struct intel_engine_cs * engine)14 intel_engine_pm_is_awake(const struct intel_engine_cs *engine)
15 {
16 	return intel_wakeref_is_active(&engine->wakeref);
17 }
18 
intel_engine_pm_get(struct intel_engine_cs * engine)19 static inline void intel_engine_pm_get(struct intel_engine_cs *engine)
20 {
21 	intel_wakeref_get(&engine->wakeref);
22 }
23 
intel_engine_pm_get_if_awake(struct intel_engine_cs * engine)24 static inline bool intel_engine_pm_get_if_awake(struct intel_engine_cs *engine)
25 {
26 	return intel_wakeref_get_if_active(&engine->wakeref);
27 }
28 
intel_engine_pm_put(struct intel_engine_cs * engine)29 static inline void intel_engine_pm_put(struct intel_engine_cs *engine)
30 {
31 	intel_wakeref_put(&engine->wakeref);
32 }
33 
intel_engine_pm_put_async(struct intel_engine_cs * engine)34 static inline void intel_engine_pm_put_async(struct intel_engine_cs *engine)
35 {
36 	intel_wakeref_put_async(&engine->wakeref);
37 }
38 
intel_engine_pm_put_delay(struct intel_engine_cs * engine,unsigned long delay)39 static inline void intel_engine_pm_put_delay(struct intel_engine_cs *engine,
40 					     unsigned long delay)
41 {
42 	intel_wakeref_put_delay(&engine->wakeref, delay);
43 }
44 
intel_engine_pm_flush(struct intel_engine_cs * engine)45 static inline void intel_engine_pm_flush(struct intel_engine_cs *engine)
46 {
47 	intel_wakeref_unlock_wait(&engine->wakeref);
48 }
49 
50 static inline struct i915_request *
intel_engine_create_kernel_request(struct intel_engine_cs * engine)51 intel_engine_create_kernel_request(struct intel_engine_cs *engine)
52 {
53 	struct i915_request *rq;
54 
55 	/*
56 	 * The engine->kernel_context is special as it is used inside
57 	 * the engine-pm barrier (see __engine_park()), circumventing
58 	 * the usual mutexes and relying on the engine-pm barrier
59 	 * instead. So whenever we use the engine->kernel_context
60 	 * outside of the barrier, we must manually handle the
61 	 * engine wakeref to serialise with the use inside.
62 	 */
63 	intel_engine_pm_get(engine);
64 	rq = i915_request_create(engine->kernel_context);
65 	intel_engine_pm_put(engine);
66 
67 	return rq;
68 }
69 
70 void intel_engine_init__pm(struct intel_engine_cs *engine);
71 
72 #endif /* INTEL_ENGINE_PM_H */
73