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