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
13static inline bool
14intel_engine_pm_is_awake(const struct intel_engine_cs *engine)
15{
16	return intel_wakeref_is_active(&engine->wakeref);
17}
18
19static inline void intel_engine_pm_get(struct intel_engine_cs *engine)
20{
21	intel_wakeref_get(&engine->wakeref);
22}
23
24static 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
29static inline void intel_engine_pm_put(struct intel_engine_cs *engine)
30{
31	intel_wakeref_put(&engine->wakeref);
32}
33
34static inline void intel_engine_pm_put_async(struct intel_engine_cs *engine)
35{
36	intel_wakeref_put_async(&engine->wakeref);
37}
38
39static 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
45static inline void intel_engine_pm_flush(struct intel_engine_cs *engine)
46{
47	intel_wakeref_unlock_wait(&engine->wakeref);
48}
49
50static inline struct i915_request *
51intel_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
70void intel_engine_init__pm(struct intel_engine_cs *engine);
71
72#endif /* INTEL_ENGINE_PM_H */